Transformar XML utilizando XSLT |
La acción Transformar XML utilizando XSLT utiliza una hoja de datos XSLT para transformar el XML de salida de otra aplicación desde su formato XML original a otro formato XML. El XML reformateado se coloca en una variable de salida.
Puede configurar las propiedades de la acción Transformar XML utilizando XSLT en las siguientes fichas.
Origen
Origen: Especifica el origen del XML Script.
Valor: Utilice el cuadro de entrada para indicar la plantilla que quiera que utilice la acción. Alternativamente, puede añadir una variable para especificar la plantilla o añadir un carácter especial al valor que haya introducido.
Importar: Abre el cuadro de diálogo Abrir archivo para que pueda navegar y seleccionar un archivo que contenga el archivo de comandos que quiere. El contenido del archivo se importa al cuadro de entrada Valor.
Exportar: Abre el cuadro de diálogo Guardar archivo para que pueda guardar el contenido del cuadro de entrada Valor como un archivo externo. Puede guardar el valor como un nuevo archivo, o sustituir el contenido de un archivo existente.
Editar valor incrustado : Abre el cuadro de diálogo Valor para origen incrustado donde puede editar el valor del origen incrustado.
Variable:
Variable: Escriba la variable que quiera utilizar como origen. Alternativamente, puede añadir una variable.
Archivo externo:
Ubicación: Especifica el sistema de archivos donde se encuentra la carpeta de origen. Los sistemas o ubicaciones de archivos pueden incluir sistemas de archivos o recursos de red, Librarian, o una ubicación de almacenamiento en la nube compatible. Para obtener más información sobre las ubicaciones de almacenamiento en la nube compatibles, consulte la
Nombre de archivo: Especifica la ruta del archivo. Puede escribir la ubicación de la carpeta o el nombre del archivo, o hacer clic en Examinar para localizar y seleccionar el archivo que quiera. Alternativamente, puede añadir una variable para especificar el archivo o añadir un carácter especial al valor que haya introducido.
Codificación de archivos: Especifica la codificación que utiliza por un archivo de origen.
Hoja de estilos XSLT
Origen: Especifica que la hoja de datos XSLT está contenida en una plantilla incrustada, una variable o un archivo externo.
Valor: Utilice el cuadro de entrada para indicar la plantilla que quiera que utilice la acción. Alternativamente, puede añadir una variable para especificar la plantilla o añadir un carácter especial al valor que haya introducido.
Importar: Abre el cuadro de diálogo Abrir archivo para que pueda navegar y seleccionar un archivo que contenga el archivo de comandos que quiere. El contenido del archivo se importa al cuadro de entrada Valor.
Exportar: Abre el cuadro de diálogo Guardar archivo para que pueda guardar el contenido del cuadro de entrada Valor como un archivo externo. Puede guardar el valor como un nuevo archivo, o sustituir el contenido de un archivo existente.
Editar valor incrustado : Abre el cuadro de diálogo Valor para origen incrustado donde puede editar el valor del origen incrustado.
Variable:
Variable: Escriba la variable que quiera utilizar como origen. Alternativamente, puede añadir una variable.
Archivo externo:
Ubicación: Especifica el sistema de archivos donde se encuentra la carpeta de origen. Los sistemas o ubicaciones de archivos pueden incluir sistemas de archivos o recursos de red, Librarian, o una ubicación de almacenamiento en la nube compatible. Para obtener más información sobre las ubicaciones de almacenamiento en la nube compatibles, consulte la
Nombre de archivo: Especifica la ruta del archivo. Puede escribir la ubicación de la carpeta o el nombre del archivo, o hacer clic en Examinar para localizar y seleccionar el archivo que quiera. Alternativamente, puede añadir una variable para especificar el archivo o añadir un carácter especial al valor que haya introducido.
Codificación de archivos: Especifica la codificación que utiliza por un archivo de origen.
Salida
Guardar resultado a variable: Especifica la variable en la que quiera guardar el BTXML de salida. Introduzca el valor que desee. Alternativamente, puede añadir una variable.
Acción
Nombre: Especifica el nombre de la acción. Puede sustituir el nombre predeterminado escribiendo un nuevo nombre en este campo.
Descripción: Especifica una descripción para la acción.
Ejecutar acción: Especifica la frecuencia con la que quiere ejecutar la acción.
Siempre: Especifica que la acción se ejecuta la acción cada vez que se ejecuta el archivo de proceso.
Nunca: Especifica que la acción no se ejecuta cuando se ejecuta el archivo de proceso.
Condicionalmente, en base a una variable: Especifica que la acción se ejecuta solo cuando una variable seleccionada cumple una condición específica. Utilice esta opción en situaciones en las que solo haya una condición que determine si la acción se ejecutará o no. Después de seleccionar esta opción, puede crear la instrucción condicional en el cuadro de entrada.
Controles del cuadro de entrada
Variable: Especifica la variable que quiera utilizar como instrucción condicional. Introduzca la variable en el cuadro de entrada. Haga clic en para ver una lista de variables utilizadas recientemente, o haga clic en Variable o Más variables para abrir el cuadro de diálogo Insertar variable.
[Operador relacional]: Especifica el operador relacional que se utilizará para la instrucción condicional. Haga clic en el operador existente para que se muestre una lista de operadores adicionales y seleccione el que quiera utilizar. Para obtener más información, consulte Operadores ralacionales. Los operadores disponibles en la lista dependen de si ha seleccionado Texto o Decimal para la opción Tipo.
Valor: Especifica los valores que se utilizarán para la instrucción condicional. Para añadir un valor, haga clic en , haga clic en <introducir un valor>, introduzca el valor que desee y, a continuación, pulse Enter
. Para eliminar un valor, utilice el botón secundario del ratón para hacer clic en él y, a continuación, haga clic en Eliminar. Algunos operadores, como Is blank y Is not blank, no requieren que se especifique ningún valor. En estas situaciones, el campo Valor no estará disponible.
Tipo: Especifica si la declaración condicional evalúa un valor de texto o decimal.
Condicionalmente, en base a una expresión: Especifica las condiciones en las que se ejecuta la acción. Utilice esta opción para situaciones que requieran más de una instrucción condicional. Cuando selecciona esta opción, puede crear la expresión condicional en el cuadro de entrada creando las instrucciones condicionales que desee. Cree y edite su expresión condicional en la ficha Vista del árbol. Haga clic en la ficha Vista del texto para ver una vista del texto de solo lectura de la expresión condicional.
Controles del cuadro de entrada (Ficha Vista del árbol)
[Unión condicional]: Especifica la unión condicional para las instrucciones condicionales del grupo. La unión condicional predeterminada es Y.
Haga clic en la unión condicional existente para mostrar un menú que le permite configurar su expresión condicional de una de las siguientes maneras:
And, Or, NotAnd, NotOr: Haga clic en la unión condicional de la lista que quiera utilizar como instrucción condicional. Para obtener más información sobre las uniones condicionales compatibles, consulte Uniones condicionales.
Añadir condición: Haga clic para añadir otra instrucción condicional para el grupo actual.
Añadir grupo: Haga clic para añadir un subgrupo de instrucciones condicionales para el grupo actual.
Eliminar grupo: Haga clic para eliminar el subgrupo. Disponible cuando se abre el menú desde un subgrupo.
Eliminarlo todo: Haga clic para eliminar todas las declaraciones condicionales (incluyendo subgrupos). Disponible cuando se abre el menú desde el grupo más alto.
: Haga clic para añadir una declaración condicional para el grupo asociado con dicha unión. Visible a la derecha de cada unión condicional de su expresión.
: Haga clic para eliminar la declaración condicional. Visible a la derecha de una expresión condicional existente cuando se señala la expresión.
Variable: Especifica la variable que quiera utilizar como instrucción condicional. Introduzca la variable en el cuadro de entrada. Haga clic en para ver una lista de variables utilizadas recientemente, o haga clic en Variable o Más variables para abrir el cuadro de diálogo Insertar variable.
[Operador relacional]: Especifica el operador relacional que se utilizará para la instrucción condicional. Haga clic en el operador existente para que se muestre una lista de operadores adicionales y seleccione el que quiera utilizar. Para obtener más información, consulte Operadores ralacionales. Los operadores disponibles en la lista dependen de si ha seleccionado Texto o Decimal para la opción Tipo.
Valor: Especifica los valores que se utilizarán para la instrucción condicional. Para añadir un valor, haga clic en , haga clic en <introducir un valor>, introduzca el valor que desee y, a continuación, pulse Enter
. Para eliminar un valor, utilice el botón secundario del ratón para hacer clic en él y, a continuación, haga clic en Eliminar. Algunos operadores, como Is blank y Is not blank, no requieren que se especifique ningún valor. En estas situaciones, el campo Valor no estará disponible.
Tipo: Especifica si la declaración condicional evalúa un valor de texto o decimal.
Cuenta de usuario
Heredar de la acción principal: Especifica que la acción hereda las credenciales de la cuenta de usuario especificada en la ficha de propiedades Acciones. Alternativamente, si la acción es parte de una acción Agrupar, hereda las credenciales de la cuenta de usuario que se especifican en la página de propiedades de la acción Agrupar inmediatamente superior.
Especificar credenciales de usuario: Especifica que la acción se ejecuta utilizando las credenciales especificadas.
Gestión de errores y diagnósticos
Ignorar errores y continuar ejecutando acciones: Especifica que en caso de que la acción falle, las demás acciones siguen ejecutándose. Cuando no se selecciona esta opción y la acción falle, el comportamiento resultante depende de varios factores, como son:
La acción está dentro de una Acción de grupo
Si ha especificado Secuencialmente para la propiedad Ejecutar acciones en la ficha Ejecución de la acción Agrupar, no se ejecutan más acciones dentro de esa Acción de grupo. No afecta a ninguna acción ajena a esta Acción de grupo.
Si ha especificado En paralelo para la propiedad Ejecutar acciones en la ficha Ejecución de la acción Agrupar, los errores se ignoran y se ejecutan las demás acciones de esa Acción de grupo. No afecta a ninguna acción ajena a esta Acción de grupo.
La acción no está dentro de una Acción de grupo
Si ha especificado Secuencialmente para la propiedad Ejecutar acciones de la ficha Ejecución de Acciones, no se ejecutan más acciones dentro del proceso.
Si ha especificado En paralelo para la propiedad Ejecutar acciones de la ficha Ejecución de Acciones, los errores se ignoran y se ejecutan las demás acciones del proceso.
Reintentar si falla: Especifica que en caso de que la acción falle, Integration Service intenta ejecutarlo de nuevo.
Máximo de reintentos: Especifica la cantidad máxima de veces que Integration Service vuelve a intentar ejecutar la acción. Disponible cuando se haya seleccionado la opción Reintentar si falla.
Reintentar intervalo: Especifica el tiempo que Integration Service espera después de que la acción falle y antes de volver a ejecutarla. Disponible cuando se haya seleccionado la opción Reintentar si falla.