Pular para o conteúdo

Dados e variáveis

Entradas, contexto e resultados

Use informações tipadas desde a primeira etapa, sem criar uma etapa artificial.

Nesta página

Três fontes de informação

Entradas vêm do comando ou gatilho: descrição, cargo, canal e outras opções. Contexto vem da execução: pessoa que iniciou, servidor e canal. Resultados são produzidos por ações: por exemplo, o canal retornado por Criar canal ou o status de Requisição HTTP.

A primeira etapa já pode usar entradas e contexto. Você não precisa de uma ação anterior para inserir a descrição de um argumento na resposta. Um resultado de ação, por outro lado, só existe depois que aquela ação executou com sucesso no caminho apropriado.

Captura atual de componentes reais em ambiente isolado, com dados fictícios. Não representa uma publicação ou execução no Discord.
  1. 1. Busque uma informação pelo nome.
  2. 2. Entradas e contexto estão disponíveis desde o início.

Tipo correto evita ambiguidades

Texto, número, verdadeiro/falso, pessoa, cargo, canal, listas e valores opcionais não são intercambiáveis. Use conversões apenas quando a referência permitir. Um ID do Discord não é uma quantidade: nunca converta para número para comparar ou guardar.

Quando precisar mostrar uma entidade, escolha a representação oferecida, como ID, nome ou menção. Para dar permissão de cargo, passe o próprio cargo ou a representação que o campo pede; imprimir uma menção em texto não concede permissão.

Ausência e caminhos alternativos

Um valor opcional exige tratamento antes de alimentar um campo obrigatório. Uma etapa ligada apenas ao caminho Sim não fornece seu resultado no caminho Não. Use condições, valores alternativos ou uma reorganização do fluxo para deixar a origem inequívoca.

Registros persistem dados entre execuções; resultados temporários não são armazenamento. Para mudanças que precisam ocorrer juntas, consulte a ação de transação e seus limites, sem presumir que todo o fluxo é uma única transação.