Funções de gerenciamento de mudanças

Prev Next

Who can use Functions

As of r380, Functions is generally available.

Read more in the Community thread.


Alterações nas entradas ou saídas

Breaking change alert:

Adding, removing, or renaming inputs and outputs requires changes to app trigger actions that call the function.

Siga este processo para alterar a assinatura de uma função:

  1. Projete cuidadosamente a estrutura de entradas e saídas antes de adotar a função amplamente.
  2. Entradas: Ao criar uma função para gerar um novo registro na tabela, considere todas as colunas típicas que a função deve preencher na criação do registro, não apenas as colunas para o primeiro caso de uso.
  3. Saídas: as saídas comuns que você pode incorporar a uma função incluem:
    • IDs dos registros da tabela criados pela função
    • Mensagens visíveis ao operador (definidas em uma variável pela lógica da função)
  4. Notifique todos os desenvolvedores de aplicativos antes de fazer alterações.
  5. Atualize a função de forma sistemática:
  6. Altere a função.
  7. Teste a função com o botão “Testar” usando entradas representativas.
  8. Teste a função de ponta a ponta em um aplicativo de desenvolvimento.
  9. Atualize cada aplicativo para mapear novas entradas e saídas.
    • A partir da versão r351, há visibilidade limitada sobre onde uma função é usada (tanto em quais aplicativos quanto em que parte de um aplicativo). Na guia “Versões” de um aplicativo, você pode ver quais funções uma versão utiliza.
    • Para aplicativos que utilizam uma função, clique no botão “Exibir erros” no editor do aplicativo. Uma janela modal exibe todas as referências à função no aplicativo que estão com erros.
  10. Teste cada aplicativo no modo de desenvolvedor.
  11. Publique os aplicativos.

Abordagem alternativa para grandes alterações

Crie uma nova função com uma assinatura atualizada e migre os aplicativos gradualmente:

  1. Crie uma nova versão da função com novas entradas (por exemplo, CreateSample_v2).
  2. Migre os aplicativos de alta prioridade para a nova versão.
  3. Migre os aplicativos restantes ao longo do tempo.
  4. Desative e arquive a versão antiga da função.

Altere a lógica interna da função

Info

Changes to internal function logic (decision trees, calculations, table operations) do not break apps. However, you need to publish apps with a new version to associate the new function logic.

Siga este processo:

  1. Atualize a lógica da função.
  2. Teste a função com o botão “Testar”, utilizando entradas representativas.
  3. Teste a função em um aplicativo de desenvolvimento de ponta a ponta.
  4. Publique uma nova versão do aplicativo ( version ) para associá-la à função atualizada.
  5. Monitore os aplicativos de produção para detectar comportamentos inesperados.

Prática recomendada: utilize um procedimento de fluxo de trabalho de aprovação para funções utilizadas em aplicativos de produção.


Recursos adicionais

{{snippet.Você encontrou o que estava procurando?}}