Salida simple
Cuando necesite devolver un valor de cadena de una asignación, puede usar un componente de salida simple. En el área de asignación los componentes de salida simples desempeñan el papel de componente de destino que tiene un tipo de datos de cadena en lugar de una estructura de elementos y secuencias. Por tanto, puede crear un componente de salida simple en lugar de (o además de) un componente de destino basado en un archivo. Por ejemplo, puede usar un componente de salida simple para probar y obtener una vista previa del resultado de una función (véase Ejemplo: vista previa de resultados de una función).
Los componentes de entrada simples no se deben confundir con los parámetros de salida de las funciones definidas por el usuario (véase Funciones definidas por el usuario). En esta tabla puede ver en qué se parecen y en qué se diferencian:
Componentes de salida | Parámetros de salida de funciones definidas por el usuario |
Se añaden desde el comando de menú Función | Insertar componente de salida. | Se añaden desde el comando de menú Función | Insertar componente de salida. |
Tienen el tipo de datos "string". | Puede tener tipos de datos simples y complejos. |
Afectan a toda la asignación. | Afectan solo al contexto de la función donde se definen. |
Si lo necesita, puede añadir varios componentes de salida simples a la asignación. También puede usar componentes de salida simples junto con componentes de destino basados en archivos. Si la asignación contiene varios componentes de destino, puede consultar la vista previa de los datos que devuelve cada componente haciendo clic en el botón Vista previa ( 
) de la barra de título del componente correspondiente y haciendo clic en el panel Resultados de la ventana de asignación.
Los componentes de salida simples se pueden usar en estos lenguajes de transformación de MapForce:
Lenguaje | Funcionamiento | |
XSLT 1.0, XSLT 2.0, XSLT 3.0 | En los archivos XSLT que se generan, el componente de salida simple definido en la asignación se convierte en el resultado de la transformación XSLT.
Si usa un servidor RaptorXML Server, puede ordenar al servidor que escriba el resultado de la asignación en el archivo que se pasa como valor del parámetro --output.
Para escribir el resultado en un archivo, añada o edite el parámetro --output en el archivo DoTransform.bat. Por ejemplo, el archivo DoTransform.bat que aparece en el comando siguiente se editó para que se escriba el resultado de la asignación en el archivo Resultado.txt (véase el texto resaltado).
Si no se definió el parámetro --output, el resultado de la asignación se escribirá en la secuencia de datos de salida estándar (stdout) cuando se ejecute la asignación. |
Cuando cree una asignación invertida (con el comando de menú Herramientas | Crear asignación inversa), los componentes de salida simples se convertirán en componentes de entrada simples.