Referência do módulo JavaScript

Utilitários do Bridge: JavaScript

A utilidade JavaScript no Bridge inclui apenas um módulo: Executar Script. Use este módulo para escrever e executar funções JavaScript.

Configurar o utilitário JavaScript

1. Faça login no Bridge.
2. Acesse a página Integrações.
3. Encontre e selecione JavaScript.

Módulo Executar Script

O módulo contém os seguintes campos, você pode usar referências de dados em todos eles:

• Nome do Script: O nome do script a ser executado.
• Parâmetros do Script: Os parâmetros que o script espera ao executar, representados como um mapa de objetos chave:valor.
  • Chave: O nome do parâmetro que aparece no script.
  • Valor: O valor atribuído à chave que o script usa durante a execução do script.

O número de parâmetros de script permitidos é ilimitado e adicionado dinamicamente.

Para configurar o script que você deseja executar:

1. Selecione o ícone de engrenagem no topo do módulo.
2. Expanda a seção Scripts.
3. Selecione Adicionar aos Scripts.
4. Preencha os campos Nome do Script e Corpo do Script.
5. Selecione Salvar.

Brandfolder Image

Assim que o Bridge executar o módulo Executar Script, as seguintes informações estarão disponíveis no painel Registro de Execução:

• Dados
  • resultado: A saída do JavaScript
• Estado: Seção que indica se o módulo funcionou ou não
  • Code (Código): o código de sucesso/erro que o módulo retorna do Smartsheet
  • Message (Mensagem): uma mensagem gerada pelo sistema que o módulo retorna do Smartsheet. Por exemplo, se o módulo não conseguir encontrar um valor, a mensagem que aparece é Not found (Não encontrado).
  • Status (Status): o status que o módulo retorna do Smartsheet. Os rótulos de status que você pode encontrar são Succeeded (Sucesso) e Failed (Falha).

Exemplos

Exemplo 1: Hello world (Olá, mundo)

1. Crie um script em que o Script Body seja: return “Hello” + a.

Você deve digitar return em cada script para produzir uma resposta.

2. No módulo, adicione o parâmetro a com o valor world (mundo).
3. Execute o fluxo de trabalho.

Certifique-se de que Key (Chave) no gerador de módulos corresponda ao parâmetro no campo Script Body (Corpo do script). 

Value (Valor) é a entrada intercambiável. Por exemplo, pode vir de uma saída da resposta de um módulo anterior.

O Script Name (Nome do Script) não requer aspas para entradas de string, mas o Script Body (Corpo do Script) requer. Caso contrário, você receberá uma mensagem de erro.

Exemplo 2: Operações básicas

Para concatenar duas strings:

1. Crie um script com o Script Body: return a + b.
2. No módulo, adicione os parâmetros a e b com os valores 3 e 2, respectivamente. 
3. Execute o fluxo de trabalho.

Brandfolder Image

Este método concatena os dois valores, mas não os soma. 

Brandfolder Image

Variáveis definidas através do Bridge são tratadas como strings.

Para somar números:

1. Crie um script com o campo Script Body: return Number(a) + Number(b).
2. Execute o fluxo de trabalho.

Com os mesmos parâmetros do exemplo abaixo, o resultado desta vez é 5.

Brandfolder Image

Exemplo 3: iterar sobre uma matriz

Para este exemplo, temos um fluxo de trabalho com o módulo List Sheets. Quando o fluxo de trabalho é executado, o log de execução fornece as saídas abaixo, onde dados está marcado como Array [100]. Isso significa que o campo é um array.

Brandfolder Image

Você precisa executar o fluxo de trabalho para obter as informações do log de execução.

1. Selecione os três pontos ao lado de dados, em seguida, selecione Copiar Referência de Dados.

Brandfolder Image

2. Adicione um novo módulo Executar Script ao fluxo de trabalho.
3. Crie um novo script JavaScript. Para este exemplo, o nomeamos de getFirstElementOfListSheets, e o Corpo do Script é returnlistSheets[0]. Isso retorna o primeiro elemento do array de dados.

O número nos colchetes define qual elemento do array é retornado. 0 retorna o primeiro, 1 retorna o segundo, e assim por diante.

No módulo JavaScript:

4. Defina getFirstElementOfListSheets como o Nome do Script.
5. Adicione um parâmetro de script com Chave #1 chamado listSheets.
6. Cole a referência de dados copiada na Etapa 1 em Valor #1

Brandfolder Image

Se executarmos o fluxo de trabalho, o log de execução fornece as saídas abaixo. 

Brandfolder Image

Os itens abaixo resultado são parte do primeiro elemento no array.

Limitações do produto/recurso

• Só é possível processar solicitações e respostas de carga útil de 6 MB.

  Sujeito a alterações nas próximas atualizações.

• Não há validação de script mediante a criação do script. Se um script apresenta defeito, é responsabilidade do desenvolvedor depurar e corrigir quaisquer problemas e erros retornados ao executar o script.
• A equipe Smartsheet não rastreia nem gerencia versões e históricos de scripts.
• O Bridge é apropriado para fluxos de trabalho baseados em eventos ou cronogramas fixos. Ele não é um substituto para a funcionalidade de sincronização de espelho unidirecional ou bidirecional fornecida pelos conectores. O Bridge não oferece garantias de pedidos e não tem qualquer responsabilidade sobre as alterações feitas em um sistema ou outro. Portanto, configurações semelhantes a conectores não são confiáveis e são fortemente desencorajadas.