Conecta-seEntrar na plataforma

Transformar dados

Executar uma lógica personalizada em código dentro do fluxo.

Lógica e processamentoRecurso internoConexão: Credencial protegida

O que faz

Execute código JavaScript, Python ou Shell personalizado dentro do seu fluxo. JavaScript sem imports roda localmente, para uma execução rápida; já o código com imports, Python e Shell rodam em um sandbox remoto.

Quando usar: Use quando o seu fluxo precisar executar uma lógica personalizada em código dentro do fluxo.

Exemplo de situação: Processar os dados antes de seguir para a próxima etapa.

Código personalizado deve ser revisado e testado com entradas controladas. Não coloque chaves, senhas ou tokens diretamente no código.

Antes de começar

Conexão necessária: Credencial protegida.

Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.

Passo a passo

  1. Adicione Transformar dados ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.
  3. Revise a ação principal descrita no cartão do bloco.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Campos

  • Linguagem

    Selecione a linguagem.

    Opções:
    JavaScript · Python
    Padrão:
    JavaScript

  • Código

    Contém a lógica personalizada executada por este bloco.

    Exemplo:
    { "chave": "valor" }

  • Sandbox

    Em campos adicionais

    Dependências, pacotes do sistema e CLIs do sandbox disponíveis para este bloco.

    Exemplo:
    id-do-recurso

  • Escopo de segredos

    Dado protegido

    O código pode ler qualquer segredo do workspace, inclusive os adicionados depois. Restrinja para anunciar um conjunto específico ao modelo.

    Opções:
    Todos os segredos · Segredos selecionados
    Padrão:
    Segredo protegido

  • Segredos disponíveis

    Dado protegido

    Selecione os segredos que este bloco pode ler.

    Quando aparece:
    Quando o campo “Escopo de segredos” for “Segredos selecionados”
    Padrão:
    Segredo protegido

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <transformardados.result>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<transformardados.result>jsonResultado estruturado gerado pelo código executado.
<transformardados.stdout>stringSaída do console e mensagens de depuração da execução da função.
<transformardados.files>file[]Arquivos que o código gravou em /tmp/sim/outputs, prontos para anexar ou enviar nos blocos seguintes.

Exemplo de uso

Objetivo: Processar os dados antes de seguir para a próxima etapa.

InícioTransformar dadospróxima etapa
Linguagem
JavaScript
Código
{ "chave": "valor" }

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa
Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal
Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte
Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <transformardados.result>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
Credencial ausente ou recusada
Escolha uma conexão válida do workspace. Se a senha ou a chave mudou no serviço, atualize a conexão cadastrada em vez de colar o segredo no bloco.

Blocos relacionados