Dados de referência no fluxo de trabalho

Dados de referência do tempo de execução

O tempo de execução é onde os dados acionadores de uma integração são armazenados. A referência para os dados de tempo de execução é {{runtime}}.

Você pode fazer referência a partes de dados armazenadas no tempo de execução. Ao fazer uma referência desses dados, você deve especificar o nome de cada item.

Por exemplo, se uma planilha no Smartsheet acionar um fluxo de trabalho e você precisar fazer referência ao ID da linha envolvida, a referência poderá ser assim: {{runtime.event.rowId}}.

A estrutura exata e a convenção de nomenclatura variam conforme o acionador e o tipo de evento. 

Para verificar se você está usando a referência correta:

1. No Registro de execução, passe o cursor sobre um objeto do acionador. 
2. Selecione 
   Brandfolder Image

   
   .
3. Na lista exibida, selecione Copiar referência de dados.

Brandfolder Image

Dados de referência de um estado

Você pode querer fazer referência a um estado quando os dados são passados de um fluxo de trabalho pai. O formato da referência é {{states.state name.value}}.

Para fazer referência a dados de um módulo abaixo de um estado, o estado ainda terá uma função importante. Nesse caso, a estrutura da referência seria {{states.state name.integration or utility name.module name}}.

Se um módulo puder gerar vários valores de dados, adicione o caminho para esses dados específicos na referência de dados (assim como você faz referência a fragmentos individuais de dados do tempo de execução).

Por exemplo, o módulo Smartsheet: Get Row retorna, por padrão, os dados da imagem abaixo. 

Brandfolder Image

Para fazer referência ao valor inserido na célula Address na linha, a referência seria:
{{states.GetRow.smartsheet.get_row.row.cells.Address.value}}.

Dados de referência de um fluxo de trabalho filho

Você pode fazer referência a dados de um fluxo de trabalho filho dentro do fluxo de trabalho pai. Para fazer isso, siga as seguintes etapas:

1. Copie a referência de dados que deseja usar do fluxo de trabalho pai.
2. Adicione um módulo Run Child Workflow ao fluxo de trabalho pai e dê um nome a ele.

No fluxo de trabalho pai, no módulo filho:

3. Selecione Valores da entidade filho. 
4. Adicione uma chave, um nome que você usará para fazer referência aos dados no fluxo de trabalho filho.
5. Adicione o valor correspondente, a referência de dados que você copiou na etapa 1. Pode ser algo como {{states.startstate.stringtools.compose_text}}

um fluxo de trabalho filho.

3. Selecione o módulo em que deseja fazer referência aos dados do fluxo de trabalho pai.
4. No campo em que você deseja fazer referência aos dados do fluxo de trabalho pai, insira {{runtime.entities.text}}, onde “text” é a chave adicionada na etapa 4.

Se você quiser fazer referência a {{runtime.entities.text}} como {{states.text.value}} dentro do fluxo de trabalho filho , será necessário criar um estado com o nome "text" em o fluxo de trabalho filho

Dados de referência de um fluxo de trabalho filho

Você pode fazer referência a dados de um fluxo de trabalho filho dentro do fluxo de trabalho pai. Para isso, a referência de dados poderia ser assim:

• states.{{state that runs the child}}.child.{{state in child}}.value.; ou
• states.{{state that runs the child}}.child.{{state in child}}.integration ou utility.module.

Opções para referências de dados vazias

Quando a próxima etapa do fluxo de trabalho depende de um valor específico, que pode ou não existir, você pode usar barras verticais (||) para lidar com dois cenários.

Por exemplo, você deseja usar o valor em uma célula do Smartsheet para determinar qual caminho de uma junção o fluxo de trabalho deve seguir. Porém, não há como ter certeza de que a célula sempre conterá um valor. 

Se a célula estiver vazia, o fluxo de trabalho será interrompido quando chegar à junção. Você pode adicionar barras verticais (||) ao final da referência de dados para evitar isso. Se esse valor tiver dados, o fluxo de trabalho usará a referência à esquerda das barras. Se os dados não existirem nessa célula, o fluxo de trabalho usará o que está à direita das barras.

Confira as duas situações possíveis nesta referência:
{{states.GetRow.smartsheet.get_row.row.cells.Address.value||116 George Street, Edinburgh, UK}}

1. Primeiro, o fluxo de trabalho tentará usar o endereço da linha que obteve primeiro: GetRow.smartsheet.get_row.row.cells.Address.value.
2. Porém, se essa célula estiver em branco, ela passará a usar o endereço especificado após as barras verticais: 116 George Street, Edinburgh, UK.

Dicas para usar barras verticais

Você pode usar: 

• outra referência de dados após as barras verticais em vez de um valor digitado;
• várias barras verticais para lidar com vários cenários diferentes possíveis.

Misturar referências de texto e dados

Na maioria dos módulos, você pode combinar referências de texto escrito e dados. Você pode digitar as partes do e-mail que devem ser sempre as mesmas e usar referências de dados para as partes que podem não ser sempre as mesmas, como o nome de um destinatário ou uma data.

Se você criou o fluxo de trabalho meteorológico no artigo Iniciar um fluxo de trabalho em branco para o serviço meteorológico dos EUA, deve ter notado que o URL usado na chamada de API para o serviço continha duas referências de dados.