Acerca de las variables

En las orquestaciones, las variables ofrecen ubicaciones de almacenamiento temporal para conservar los datos de entrada y salida de las actividades.

Esto se muestra en el ejemplo de orquestación de la siguiente ilustración:
Flujo de variables
Durante el tiempo de ejecución, la orquestación extrae datos y los almacena dentro de las variables, como se describe en los siguientes pasos:
  1. La actividad Sondear directorio FTP sondea el servidor FTP en busca de un archivo sin formato y coloca el contenido de este archivo en el parámetro de salida data. El parámetro de salida data se correlaciona con la variable de tipo serie denominada flatFileRawContent.
  2. Los datos devueltos por la actividad Sondear directorio FTP se almacenan como una serie en la variable flatFileRawContent.
  3. La variable flatFileRawContent se correlaciona con el parámetro de salida Data en la actividad Leer archivo sin formato. La actividad Leer archivo sin formato analiza los datos del archivo sin formato y los devuelve en el parámetro de salida XML.
  4. El parámetro de salida XML se correlaciona con la variable de esquema de archivo sin formato batchOrderXML. Los datos del esquema de archivo sin formato batchOrderXML están disponibles en la orquestación. Por ejemplo, si se añade una actividad a la orquestación a la derecha de la actividad Leer archivo sin formato, estos datos se pueden utilizar como entrada.
Las variables se deben inicializar en una orquestación para que esta pueda considerarse válida. Esto incluye las variables inicializadas en las ramificaciones de una actividad If.. Then. La variable debe inicializarse en todas las ramificaciones. Para obtener más información. consulte Validación de la orquestación.

Ámbito de las variables

Las variables definidas en las actividades Group (agrupar), Try/Catch, If Then, While Loop (Bucle while) o For Each (Para cada) se consideran variables locales. Cuando una variable de este tipo se utiliza como entrada de una actividad Map Inputs Tasks (Correlacionar tareas de entrada) o Map Variables (Correlacionar variables) que está fuera y a continuación de la actividad Group, Try/Catch, If Then, While Loop, o For Each, la variable se considera como no inicializada porque se encuentra fuera del ámbito de las actividades donde se declaró. Por lo tanto, estas variables se deben inicializar con un valor predeterminado.

Para obtener más información sobre cómo especificar un valor predeterminado, consulte la sección Especificación de un valor predeterminado.

El separador Variables

El separador Variables contiene los siguientes paneles:
  • Variables: muestra las variables que se han definido y están disponibles para utilizar en el Editor de correlaciones. Una variable predefinida denominada JobInfo se encuentra disponible en el panel Variables del separador Variables de forma predeterminada.
  • Esquema de <variable>: muestra el esquema de la variable seleccionada.
  • Actividades que utilizan <variable>: muestra todas las actividades de la orquestación que utilizan la variable.
  • Propiedades de <variable>: aquí podrá definir o editar las propiedades de las variables o especificar un valor predeterminado.

La variable JobInfo

Studio ofrece de forma predeterminada la variable JobInfo. El Dispositivo de integración proporciona los valores de los nodos JobInfo durante el tiempo de ejecución. La variable JobInfo contiene los nodos definidos en la siguiente tabla:
Nombre de nodo de JobInfo Tipo de datos Descripción
jobId Serie Contiene el número de ID de trabajo asignado a la instancia de la orquestación. Cuando la orquestación inicia el proceso de las actividades contenidas en la orquestación, se asigna un número de ID de trabajo a esa instancia de la orquestación. Este número de ID de trabajo está también visible en la Consola de gestión web (WMC).
jobStartTime Tipo de datos de esquema XML xsd:dateTime Contiene la fecha y la hora en que la instancia de la orquestación inició el proceso.
Nota: La variable jobStartTime es la fecha y la hora en que la orquestación inicia el proceso de los mensajes o eventos y tiene asignado un número de ID de trabajo. La variable jobStartTime no es la fecha y la hora en que se desplegó la orquestación en el Dispositivo de integración y pasó a estar activa (lista para iniciar el proceso de los mensajes y los sucesos).  Por ejemplo, una orquestación contiene una actividad Sondear directorio FTP (una actividad de iniciador) que se despliega en el Dispositivo de integración. La orquestación pasa a estar activa a la espera de que se muestre un archivo en el servidor FTP en un directorio concreto. Una vez que la orquestación determina que un archivo se ha colocado en un directorio concreto del servidor FTP, comienza a procesar la actividad Sondear directorio FTP. Una vez iniciado el proceso por la orquestación, la fecha y hora actuales se almacenan en el nodo jobStartTime.
projectName Serie Nombre del proyecto que contiene la orquestación actual.
configurationName Serie Nombre de la configuración asociada con la instancia actual de la orquestación. Se crean diferentes configuraciones de proyectos mediante la Consola de gestión web (WMC).
orchestrationName Serie Nombre de la orquestación actualmente en proceso.
routerHostName Serie Nombre de host del Dispositivo de integración en el que se está ejecutando la instancia actual de la orquestación.
Nota: No se pueden eliminar la variable JobInfo ni el nodo de la variable JobInfo.