Pular para o conteúdo principal
Funções

Obter propriedade de um objeto

Obter propriedade de um objeto

Obtém o valor de uma propriedade específica de um objeto retornado por outra ação. Essencial para acessar dados de objetos estruturados — como registros de banco de dados, respostas de APIs ou itens de um loop — extraindo apenas o campo de interesse sem precisar escrever código personalizado.


Opções​

Objeto​

Selecione um campo de saída do tipo objeto de uma ação anterior. Apenas campos que retornem objetos ou valores do tipo "qualquer" são exibidos como opção.

Informe a propriedade do objeto​

Informe o nome exato da propriedade que deseja extrair do objeto. Para propriedades aninhadas — ou seja, objetos dentro de objetos — é possível usar a notação de ponto para navegar entre os níveis, como endereco.cidade.

Retornos​

Código customizado​

js
actions["id-da-acao"].value // valor da propriedade acessada no objeto (Qualquer)
actions["id-da-acao"].property // nome da propriedade que foi acessada (Texto)

Seleção de campos​

  • value — valor da propriedade do objeto (Qualquer)
  • property — nome da propriedade acessada (Texto)

Regras e Condições​

  • Os campos Objeto e Propriedade são obrigatórios.
  • O nome da propriedade deve corresponder exatamente ao nome presente no objeto — incluindo maiúsculas e minúsculas.
  • Para acessar propriedades aninhadas, use a notação de ponto separando os níveis, como cliente.endereco.cidade.
  • Se a propriedade não existir no objeto, o retorno de value será vazio.
  • Apenas campos de saída do tipo objeto ou qualquer são listados como opções para o campo Objeto.