Atualizar as colunas suspensas com os fluxos de trabalho do Bridge

O que você precisa para começar

• No Smartsheet
  • ID da planilha
  • Uma coluna de origem que contém os valores para sua lista suspensa (em nosso exemplo, a coluna é chamada de Source Values)
  • Uma coluna de destino que o Bridge pode atualizar (no nosso exemplo, a coluna é chamada de Dropdown)
• No Bridge
  • Integração do Smartsheet
  • Acionador do fluxo de trabalho do Bridge: Smartsheet > Quando os valores da coluna são alterados
  • Módulos de fluxo de trabalho do Bridge
    • Integrações > Smartsheet > Obter planilha
    • Integrações > Smartsheet > Atualizar coluna
    • Utilitários > Gerenciamento de matriz > Extrair campo da matriz
• Opcional: um sistema de origem diferente à sua escolha

Introdução

Para criar este fluxo de trabalho no Bridge, autentique a integração do Smartsheet para sua área de trabalho do Bridge. 

Ao criar o fluxo de trabalho, mantenha a planilha e o fluxo de trabalho do Bridge abertos em duas guias separadas. Isso facilitará a navegação no processo de criação.

Criar o modelo de fluxo de trabalho básico

1. Crie um fluxo de trabalho no Bridge. 
2. No gerador de fluxo de trabalho, use o painel para adicionar três módulos nesta ordem:
   1. Integrações > Smartsheet > Obter planilha
   2. Utilitários > Gerenciamento de matriz > Extrair campo da matriz
   3. Integrações > Smartsheet > Atualizar coluna
3. Salve o fluxo de trabalho.

Quando terminar, você deverá ver isto no fluxo de trabalho:

Brandfolder Image

Configurar o acionador do fluxo de trabalho

1. Selecione o módulo Acionador.
2. Selecione a Página de Integrações.

3. Localize o Smartsheet na lista de integrações.

   Você pode usar a opção Connected (Conectado) no logotipo do Bridge para ver uma lista apenas das integrações autenticadas para essa área de trabalho.

4. Expanda a linha Acionadores.
5. Selecione Adicionar a Acionadores.
6. Preencha os campos a seguir:
   • Nome do Acionador: crie um rótulo personalizado para o seu acionador.
   • ID da Planilha: cole o ID da planilha de origem (de onde copiamos os valores).
   • Tipo de Evento: selecione Quando os valores da coluna são alterados. 
   • Nome ou ID da Coluna: digite o nome da coluna do Smartsheet que é a origem dos valores da sua lista suspensa.
   • Select Workflow (Selecionar fluxo de trabalho): selecione o novo fluxo de trabalho que você acabou de criar na lista suspensa.
7. Selecione Salvar.

8. Retorne ao fluxo de trabalho.

   Se você quiser retornar à guia original, atualize a página para ver o acionador.

Configurar os módulos do fluxo de trabalho

As ações em uma planilha acionam esse fluxo de trabalho. Depois que esse fluxo de trabalho detecta o acionador, ele executa as ações na mesma planilha. Use as referências de dados de tempo de execução (Run Log) do acionador para preencher os módulos do Smartsheet.

Etapa 1: configurar o módulo Get Sheet (Obter planilha)

O módulo Get Sheet extrai dados da planilha que acionou o fluxo de trabalho. 

Quando o módulo Get Sheet é executado, o Bridge extrai os dados da planilha e os envia para o Run Log do fluxo de trabalho como objetos. Objetos são itens retornados de APIs que contêm valores para campos referentes a esse objeto. 

Uma matriz é uma coleção de objetos com seus campos correspondentes. Veja aqui um exemplo de como uma matriz de 13 linhas do módulo Get Sheet pode aparecer no seu Run Log, com os detalhes da primeira linha expandidos:

Brandfolder Image

1. No campo Sheet ID (ID da planilha), insira o valor {{runtime.sheetID}}. 
2. Salve o fluxo de trabalho.
3. Na planilha, adicione um novo valor à coluna que contém seus valores de origem em qualquer linha.
4. Salve a planilha.

Etapa 2: localizar os dados trazidos para o fluxo de trabalho

Retorne ao Bridge para copiar os dados necessários para o módulo Extract Field from Array.

1. Abra o Run Log (Registro de execução). 
2. Atualize o painel do Run Log.
3. Para ver o detalhamento das etapas do acionador e do módulo do fluxo de trabalho, expanda a entrada superior.
4. Para ver os dados retornados, expanda a linha Smartsheet: Get Sheet. 
5. Expanda a linha da planilha row.
6. Localize a entrada de rows. Parece assim: rows: Array[#].
7. No lado direito da entrada da linha, selecione .
8. Selecione Copy data reference (Copiar referência dos dados).

Etapa 3: configurar o módulo Extract Field from Array

O módulo Extract Field from Array permite extrair valores dos objetos de uma matriz. Com este módulo, você pode listar apenas os valores desse campo. 

Neste exemplo, o Bridge extrai o valor do campo Source Values. O Bridge extrai todos os valores da coluna Source Values da planilha e os transforma em uma lista.

1. Selecione o módulo Extract from Array. 
2. No campo Array (Matriz), cole a referência de dados.  
3. No campo Key, especifique a coluna que deseja transformar em uma lista. 
4. Ao especificar a coluna que deseja transformar em uma lista, use este formato: cells.[Column Name].value. Por exemplo: cells.Source Values.value.
5. No campo Output, verifique novamente se a opção Array está selecionada. 
6. Salve o fluxo de trabalho.
7. Na planilha, adicione um novo valor à coluna que contém seus valores de origem em qualquer linha.
8. Salve a planilha.

Etapa 4: atualizar coluna

O módulo Update Column usa a lista que você criou para preencher esses valores na lista suspensa da coluna nas configurações da coluna. Toda vez que o fluxo de trabalho é executado, o Bridge cria a lista mais recente e a atualiza para essa coluna na planilha.

1. No campo Sheet ID, insira o valor {{runtime.sheetID}}.
2. Pegue o column ID. 
3. Retorne ao painel de edição do módulo Update Column.
4. No campo Column ID, cole a referência de dados.
5. No campo Column Name, digite o nome da coluna que contém seus valores de lista suspensa.
6. No campo Type, selecione Dropdown (Single Select) ou Dropdown (Multi Select).
7. No campo Values, insira a matriz criada pelo módulo Extract Field from Array durante a última execução. 
8. Salve o fluxo de trabalho. 

Para obter a referência de dados para o módulo Extract Field from Array

1. Abra o painel do Run Log. 
2. Para retornar à Run List, selecione All Runs.
3. Atualize o Run Log.
4. Expanda a entrada de execução mais recente.
5. Expanda a linha Array Management: Extract Field from Array.
6. No lado direito da entrada de resultados, selecione .
7. Selecione Copy data reference (Copiar referência dos dados). 
8. Salve o fluxo de trabalho.

Outras opções

Você não precisa usar a mesma planilha ou mesmo o Smartsheet para criar sua lista de valores. Se você quiser extrair os valores da lista suspensa de outro lugar, o acionador e o primeiro módulo do fluxo de trabalho devem ser diferentes de acordo com o seu caso de uso. 

Aqui estão algumas ideias sobre como você pode personalizar esse fluxo de trabalho:

• Use uma lista da coluna de uma planilha diferente. Isso exige que você altere o acionador para responder a uma planilha diferente. Você também deve atualizar os campos Sheet ID (ID da planilha) e Column ID (ID da coluna) no módulo Update Column (Atualizar coluna). 
• Use uma lista do Resource Management ou do Brandfolder. Você pode responder a alterações específicas no Resource Management ou no Brandfolder para gerar uma lista de valores desse sistema. Substitua o acionador por um acionador apropriado de uma dessas integrações. Em seguida, substitua o módulo Get Sheet por um módulo que extrai os dados para o fluxo de trabalho. 
• Use um acionador de agenda. Ao usar esse acionador, você não precisa responder a alterações, pois ele faz o seguinte para você:
  • Extrair dados e inseri-los em seu fluxo de trabalho, e 
  • Atualizará a lista suspensa uma vez por dia, por semana ou por mês.