--- title: "Melhores práticas de funcionamento" slug: "functions-best-practices" updated: 2026-10-22T11:28:27Z published: 2026-10-22T11:28:27Z canonical: "support.tulip.co/functions-best-practices" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Melhores práticas de funcionamento Who can use Functions As of r380, Functions is generally available. **Read more in the [Community thread](https://community.tulip.co/t/functions-production-release-available-for-early-access/15658).** --- ## Use o Functions para gravar em tabelas ### Abordagem recomendada Crie funções quando vários aplicativos ou etapas de aplicativos gravarem na mesma tabela e quando for necessário garantir: - Campos obrigatórios - Valores válidos (por exemplo, o status deve estar em uma lista aprovada) - Metadados consistentes (criado por, criado em) **Por que isso é importante** Quando desenvolvedores leigos criam registros de tabela diretamente em gatilhos, eles podem: - Não seguir as convenções de nomenclatura de IDs - Esquecer campos obrigatórios - Escrever incorretamente os valores dos campos (“em andamento” vs. “em andamento”) - Preencher metadados de forma inconsistente Uma função impõe o mesmo esquema e evita esses erros. **Exemplo** Em vez de permitir que cada desenvolvedor de aplicativo crie registros “Amostra” com campos e conteúdo inconsistentes, crie uma função **“Criar Amostra”** que: - Exija entradas consistentes (ID da tarefa, tipo de amostra, quantidade, carimbo de data/hora, usuário, nome do aplicativo) - Valide se o tipo de amostra está em uma lista aprovada **Função**:**CreateSampleEntradas:** - job_id (texto) - sample_type (texto) - quantity (número) - app name (texto) - user requesting (usuário) **Lógica**: 1. Valide se sample_type está em ["A", "B", "C"] 2. Se inválido, retorne uma mensagem de erro 3. Criar registro na tabela com: - ID: gerado dentro da função - ID do trabalho: entrada - Tipo de amostra: entrada - Quantidade: entrada - Número do lote: entrada (ou vazio se não for fornecido) - Criado por: entrada4. Retornar mensagem de sucesso **Saídas**: - status (texto): “sucesso” ou “erro” - mensagem (texto): descrição do erro em caso de falha Quando for necessário criar um registro na tabela para uma amostra, passe os dados de entrada para uma função, e a função cuidará do resto. ### Padrão a ser evitado Não crie uma função para cada operação de gravação na tabela, mesmo que sejam simples. **Por que isso causa problemas** - Gera uma proliferação de funções (centenas de funções de uso único) - Aumenta a complexidade sem trazer benefícios para gravações simples - Dificulta a depuração (mais lugares para verificar) **Quando evitar funções para gravações em tabelas** - Atualizar um registro existente na tabela (por exemplo, atualizar o status ou diminuir a quantidade) - Gravações de um único aplicativo em uma tabela - Não há necessidade de governança ou validação ## Use funções para lógicas repetitivas de várias etapas ### Abordagem recomendada Se a mesma sequência de ações de gatilho ocorrer em várias etapas em múltiplos aplicativos, extraia-a para uma função. **Exemplo: Obter o código ZPL para imprimir uma etiqueta** **Função**: Obter**código** ZPLEntradas: - ID do material (texto) **Variáveis**: - Variável de código ZPL (texto) **Saídas**: - Código ZPL (texto) **Lógica**: 1. Atualizar dados: Configuração “Variável de código ZPL” – Definir como – [Expressão para o código ZPL incluindo @Inputs.ID do material] 2. Retornar: “Código ZPL” Fonte de dados “Variável de código ZPL” ### Padrão a ser evitado Não crie funções para lógicas que ocorram apenas 1 ou 2 vezes no total em todos os aplicativos. **Por que isso causa problemas** - A sobrecarga para gerenciar a função excede o benefício - Obriga os desenvolvedores de aplicativos a aprender a interface da função para um caso raro - Torna a depuração mais difícil, devido à alternância entre funções e aplicativos ## Incorpore funções do Connector em funções ### Abordagem recomendada Ao usar uma função de conector, passe as entradas dessa função para uma função que a chame. Assim, essa função poderá lidar com tentativas de reconexão em caso de tempo limite e com o tratamento de erros de maneira mais fácil e centralizada, permitindo que você simplifique a lógica do aplicativo em toda a sua solução. Incorporar funções de conector em funções também pode minimizar o esforço de uma possível migração futura de ERP, reduzindo a quantidade de alterações necessárias em aplicativos individuais. **Exemplo** **Função**: Atualizar**Pedido de** ProcessoEntradas: - ID do pedido (texto) - Status (texto) **Saídas**: - Mensagem de erro (texto) **Variáveis**: - Código HTTP (inteiro) - Tentativas de reconexão em caso de tempo limite (inteiro) - Mensagem de erro (texto) **Lógica**: 1. Executar função do conector 2. Se o código HTTP indicar sucesso, encerrar a função 3. Se o código HTTP indicar tempo limite e o valor de “Tentativas de reconexão” for menor ou igual a um valor especificado, incremente o valor de “Tentativas de reconexão” e retorne para “Executar função do conector”4. Se o código HTTP for um código que não possa ser resolvido pela lógica da função, retorne uma mensagem útil na saída “Mensagem de erro” ## Passe os IDs dos registros, não os campos individuais dos registros da tabela ### Abordagem recomendada Quando uma função precisar de dados de um registro da tabela, passe o ID do registro e carregue o registro dentro da função. **Exemplo** Embora o exemplo a seguir seja logicamente correto (onde “ID do pedido” é o ID da tabela Pedidos e os outros campos são colunas dessa tabela), existe uma configuração mais simples. **Função**: Processar**PedidosEntradas**: - ID do pedido (texto) - Nome do cliente (texto) - ID do produto (texto) - Quantidade (número) - Data de vencimento (data e hora) - Prioridade (texto) **Lógica**: 1. [Executar lógica usando os campos de entrada] O exemplo abaixo usa o mínimo de entradas para alcançar o mesmo resultado: **Função**: Processar**PedidoEntradas**: - ID do pedido (texto) **Lógica**: 1. Obter registro da tabela: tabela “Orders” onde ID = “ID do pedido” (entrada) 2. [Executar lógica usando os campos do registro da tabela] **Por que o segundo exemplo é uma abordagem melhor:** - Menos entradas (1 em vez de 6+) - A função pode se adaptar facilmente se o esquema da tabela mudar - Chamadas de função mais claras nos aplicativos - Reduz a chance de mapear o campo errado para a entrada errada ## Nomeie e descreva funções e entradas de maneira consistente ### Abordagem recomendada Use uma convenção de nomenclatura consistente em todas as funções do seu espaço de trabalho. **Nomes de funções** - Use verbo + substantivo: Criar Amostra, Atualizar Status da Tarefa, Validar Número de Série - Não use apenas substantivo: Amostra, Trabalho, Número de série **Descrição da função** - Escreva uma descrição intuitiva do que a função faz. Por exemplo, para uma função chamada “Criar Defeito”, escreva uma descrição como “Cria um novo registro na tabela Defeitos com o status ABERTO”. **Nomes de entrada** - Use terminologia consistente: sempre “ID da Ordem de Serviço” (não “ID da Ordem” ou “Work_id” em alguns casos) - Corresponda aos nomes dos campos da tabela sempre que possível **Nomes de blocos lógicos** - Seja explícito: “Obter Registro de Trabalho”, e não “Obter Registro da Tabela” - Ajude os futuros leitores: “Validar tipo de amostra”, e não “Verificar valor” **Por que isso é importante** - Os desenvolvedores de aplicativos compreendem rapidamente a finalidade das funções - Reduz a carga cognitiva ao usar várias funções - Facilita a análise de “onde é usado” - Melhora a documentação e o treinamento ## Lida com a validação de entradas e mensagens de erro do usuário de maneira integrada ### Abordagem recomendada Sempre marque as entradas das funções como campos obrigatórios e utilize regras de validação de entradas quando apropriado. Não valide entradas dentro das funções. **Por que isso é importante** - Os usuários do aplicativo recebem feedback claro ao inserir valores - Simplifica a lógica da função, fazendo com que o aplicativo cuide da validação de entradas e permitindo que a função seja executada com entradas válidas e conhecidas - Evita que dados incorretos causem corrupção de dados ### Padrão a ser evitado Não valide entradas dentro da função. **Por que isso causa problemas** - É redundante, já que o editor do aplicativo oferece recursos de validação de entradas - Latência adicional desnecessária ao verificar novamente a validade das entradas dentro da função NOTE App builders can bypass the system by passing blank static values in function inputs. For functions where validated data is critical, it may be best practice to validate inputs in the function itself (in addition to marking required fields in the app). ## Minimize consultas a tabelas dentro de loops Se sua função percorrer um array em um loop, evite consultar tabelas a cada iteração. Em vez disso, faça a consulta uma única vez antes do loop e utilize o resultado. ## Use funções para lógica, não para simples referências Não crie funções que apenas busquem um único registro de tabela — é para isso que servem as instruções `record placeholders`. Reserve as funções para a lógica que transforma dados. ## Limite o tamanho da saída Se sua função retornar objetos ou matrizes grandes, considere retornar apenas os campos de que o aplicativo precisa, e não a matriz de objetos inteira. --- ## Recursos adicionais {{snippet.Você encontrou o que estava procurando?}}