Atualizar as colunas suspensas com os fluxos de trabalho do Bridge

O que você precisa para começar

• Uma planilha 
  • O 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)
• Bridge
  • Integração do Smartsheet
  • Acionador do fluxo de trabalho do Bridge: Smartsheet - When Column Values are Changed (Quando os valores da coluna são alterados)
  • Módulos de fluxo de trabalho do Bridge
    • Smartsheet - Get Sheet (Obter planilha)
    • Smartsheet - Update Column (Atualizar coluna)
    • Array Management - Extract Field from Array (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. 

Leia as etapas sobre como configurar a integração do Smartsheet para o 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

Antes de mais nada, extraia todos os módulos necessários para o fluxo de trabalho. 

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:

   	Módulo
   1	Smartsheet - Get Sheet (Obter planilha)
   2	Array Management - Extract Field from Array (Gerenciamento de matriz - Extrair campo da matriz)
   3	Smartsheet - Update Column (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

Depois de criar o modelo de fluxo de trabalho básico, comece a configurar o acionador do fluxo de trabalho.

1. Selecione o módulo Trigger (Acionador).
2. Para abrir o painel de Integration (Integração) em uma nova guia, na seção Integrations (Integrações), selecione a Integrations Page (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 de Triggers (Acionadores).
5. Para criar um acionador, selecione .
6. Preencha os campos a seguir:
   • Trigger Name (Nome do acionador): crie um rótulo personalizado para o seu acionador.
   • Sheet ID (ID da planilha): cole o ID da planilha de origem (de onde extrairemos os valores).
   • Event Type (Tipo de evento): selecione When Column Values are Changed (Quando os valores da coluna são alterados). 
   • Column Name or ID (ID ou nome da coluna): digite o nome da coluna do Smartsheet que será a origem dos valores da sua lista suspensa.
   • Select Workflow (Selecionar fluxo de trabalho): selecione na lista suspensa o novo fluxo de trabalho que você acabou de criar.
7. Selecione Save (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 os acionadores, ele executa as ações necessárias na mesma planilha. Portanto, usaremos 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 (Extrair campo da matriz).

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 (Obter planilha). 
5. Expanda a linha da planilha.

6. Localize a entrada de linhas.
    

   Ficará assim: linhas: Matriz[#].

7. No lado direito da entrada de linhas, selecione .
8. Selecione Copy data reference (Copiar referência de dados).

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

O módulo Extract Field from Array (Extrair campo da matriz) permite extrair valores dos objetos de uma matriz. Com este módulo, você pode fazer uma lista apenas dos valores desse campo. 

No exemplo que você verá neste artigo, o Bridge extrairá o campo de valor Source Values. O Bridge extrairá todos os valores da coluna Source Values da planilha e a transformará em uma lista.

1. Para abrir o painel de edição, selecione o módulo Extract from Array (Extrair campo da matriz). 

2. No campo Array (Matriz), cole a referência de dados. 
    

   Ela será longa e começará com {{.

3. No campo Key (Chave), 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 (Saída), verifique novamente se a opção Array (Matriz) 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 (Atualizar coluna) usa a lista que você criou nas configurações da coluna para preencher esses valores na lista suspensa da coluna de lista suspensa. Toda vez que o fluxo de trabalho for executado, o Bridge criará a lista mais recente e a atualizará para essa coluna na planilha.

1. No campo Sheet ID (ID da planilha), insira o valor {{runtime.sheetID}}.
2. Pegue o ID da coluna. 
3. Retorne ao painel de edição do módulo Update Column (Atualizar coluna).
4. No campo Column ID (ID da coluna), cole a referência de dados.
5. No campo Column Name (Nome da coluna), digite o nome da coluna que conterá seus valores de lista suspensa.
6. No campo Type (Tipo), selecione Dropdown (Single Select) (Lista suspensa (Seleção única)) ou Dropdown (Multi Select) (Lista suspensa (Seleção múltipla)).
7. No campo Values (Valores), insira a matriz criada pelo módulo Extract Field from Array (Extrair campo da matriz) 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 (Registro de execução). 
2. Para retornar à Run List (Lista de execução), selecione All Runs (Todas as execuções).
3. Atualize o Run Log.
4. Expanda a entrada de execução mais recente.
5. Expanda a linha Array Management: Extract Field from Array (Gerenciamento de matriz - Extrair campo da matriz).
6. No lado direito da entrada de resultados, selecione .
7. Selecione Copy data reference (Copiar referência de 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 serão 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 exigirá que você altere o acionador para responder a uma planilha diferente. Você também precisará 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 extrairá os dados para o fluxo de trabalho. 
• Use um acionador de agenda. Ao usar esse acionador, não será necessário responder às alterações, pois ele fará o seguinte para você:
  • Extrairá os dados e os inserirá em seu fluxo de trabalho, e 
  • Atualizará a lista suspensa uma vez por dia, por semana ou por mês.