Em orquestrações, as variáveis fornecem locais de armazenamento temporário
para armazenar os dados de entrada e de saída das atividades.
Isso é mostrado na orquestração de exemplo da figura a seguir:
Durante o tempo de execução, essa orquestração extrai dados
e armazena dados em variáveis, conforme descrito nas etapas a seguir:
- A atividade Sondar Diretório de FTP sonda
um Arquivo Simples em um Servidor FTP e coloca o conteúdo do Arquivo Simples
no parâmetro de saída data. O parâmetro de saída data é
mapeado para a variável de sequência denominada flatFileRawContent.
- Os dados do Arquivo Simples retornados da atividade Sondar Diretório de FTP são
armazenados como uma cadeia na variável flatFileRawContent.
- A variável flatFileRawContent é mapeada para
o parâmetro de entrada Dados da atividade Read Flat File. Os dados do Arquivo Simples são analisados pela atividade Read Flat File e retornados da atividade no parâmetro de
saída XML.
- O parâmetro de saída XML é mapeado para a variável de Esquema de
Arquivo Simples batchOrderXML. Os dados estão disponíveis na orquestração a partir
da variável de Esquema de Arquivo Simples batchOrderXML. Por
exemplo, se uma atividade for incluída na orquestração à direita
da atividade Read Flat File, ela poderá usar
esses dados como entrada.
As variáveis devem ser inicializadas em uma orquestração para que
a orquestração seja considerada válida. Isso inclui variáveis
que são inicializadas nas ramificações de uma atividade
If.. Then.
A variável deve ser inicializada em todas as ramificações. Para obter informações adicionais,
consulte
Validando
a Orquestração.
Escopo de variável
Variáveis definidas dentro das atividades Group, Try/Catch, If Then,
While Loop ou For Each são consideradas como variáveis locais.
Quando tal variável é utilizada como entrada de uma atividade Map Inputs Tasks
ou Map Variables que esteja fora de, e seguindo a atividade Group, Try/Catch,
If Then, While Loop ou For Each, a variável é considerada
como não inicializada, porque ela está fora do escopo das atividades
em que ela foi declarada. Portanto, estas variáveis devem ser
inicializadas com um valor padrão.
Para obter mais informações sobre
a especificação de um valor padrão, consulte a seção do Especificando um Valor-padrão.
A Guia Variáveis
A guia
Variáveis contém
as seguintes áreas de janela:
- Variáveis: Exibe as variáveis que
estão definidas e disponíveis para uso no Editor de Mapeamento. Uma
variável predefinida chamada JobInfo está disponível na
área de janela Variáveis da guia Variáveis por
padrão.
- Esquema de <variável>: Exibe o esquema
para a variável selecionada.
- Atividades Usando <variável>: Exibe
todas as atividades na orquestração que usam a variável.
- Propriedades de <variável>: Onde você
define ou edita propriedades de variáveis ou especifica um valor-padrão.
A Variável JobInfo
Por padrão, o Studio fornece
a variável
JobInfo. O Integration Appliance
fornece os valores para os nós de
JobInfo durante o
tempo de execução. A variável
JobInfo contém os nós
definidos na tabela a seguir:
Nome do Nó de JobInfo |
Tipo de Dados |
Descrição |
jobId |
Cadeia |
Contém o número do ID da tarefa designado à
instância da orquestração. Quando a orquestração inicia o processamento
das atividades contidas na orquestração, um número de ID da tarefa é
designado a essa instância da orquestração. Este número de ID da tarefa
também está visível a partir do Web Management Console (WMC). |
jobStartTime |
Tipo de dado do Esquema XML xsd:dateTime |
Contém a data e hora em que a instância
da orquestração iniciou o processamento. Nota: O
jobStartTime é a data e hora em que a orquestração
inicia o processamento das mensagens ou dos eventos e tem um número de ID
da tarefa designado. O jobStartTime não
é a data e hora em que a orquestração foi implementada no Integration Appliance e tornou-se ativa — pronta para iniciar o processamento de mensagens e
eventos. Por exemplo, uma orquestração contém uma atividade Sondar
Diretório de FTP (uma atividade iniciadora) que é implementada
no Integration Appliance. A orquestração se torna ativa aguardando que um
arquivo seja mostrado no Servidor FTP em um diretório específico. Quando a
orquestração determina que um arquivo foi colocado em um diretório
específico no Servidor FTP, ela inicia o processamento da atividade
Pesquisar Diretório do FTP. Quando a orquestração
inicia o processamento, a data e hora atuais são armazenadas no nó
jobStartTime.
|
projectName |
Cadeia |
O nome do projeto que contém a orquestração
atual. |
configurationName |
Cadeia |
O nome da configuração associado
à instância atual da orquestração. Diferentes configurações
de projetos são criadas usando o Web Management Console (WMC). |
orchestrationName |
Cadeia |
O nome da orquestração atualmente em processamento. |
routerHostName |
Cadeia |
O nome do host do Integration Appliance em que a
instância atual da orquestração está em execução. |
Nota: A variável JobInfo ou os nós
da variável JobInfo não podem ser removidos.