Pular para o conteúdo principal
Versão: 2.2.0

Busca o valor de um campo do formulário do workflow

Para buscar o valor de um campo do formulário do workflow, é necessário utilizar o método getEntityAttributeValue, passando os parâmetros: o identificador da entidade à qual o formulário pertence e o identificador do atributo da entidade.

O código para isso seria:

getEntityAttributeValue("identificador_da_entidade", "identificador_do_atributo_da_entidade")

Exemplos

1. Atributo do tipo Boolean

$value = $workflow_api->getEntityAttributeValue("ENT01", "fgboolean");

Neste exemplo, o método getEntityAttributeValue está buscando o valor do atributo de identificador "fgboolean" na entidade de identificador "ENT01".

O valor retornado pode ser 1 ou 0, indicando se o campo está marcado ou desmarcado, respectivamente.

2. Atributo do tipo Hora

$value = $workflow_api->getEntityAttributeValue("ENT01","hrtime");

Neste exemplo, o método getEntityAttributeValue está buscando o valor do atributo de identificador "hrtime" na entidade de identificador "ENT01".

O valor retornado será uma string no formato "HH:MM" (Ex.: 08:00), representando a hora do atributo.

3. Atributo do tipo Número inteiro

$value = $workflow_api->getEntityAttributeValue("ENT01","vlinteger");

Neste exemplo, o método getEntityAttributeValue está buscando o valor do atributo de identificador "vlinteger" na entidade de identificador "ENT01".

O valor retornado será um número inteiro (Ex.: 123456), representando o valor do atributo.

4. Atributo do tipo Texto

$value = $workflow_api->getEntityAttributeValue("ENT01","nmtext");

Neste exemplo, o método getEntityAttributeValue está buscando o valor do atributo de identificador "nmtext" na entidade de identificador "ENT01".

O valor retornado será uma string (Ex.: ABC), representando o valor do atributo.

5. Atributo do tipo Data

$value = $workflow_api->getEntityAttributeValue("ENT01","dtdate");

Neste exemplo, o método getEntityAttributeValue está buscando o valor do atributo de identificador "dtdate" na entidade de identificador "ENT01".

O valor retornado será uma string no formato "YYYY-MM-DD" (1999-01-01), representando a data do atributo.

6. Atributo do tipo Decimal

$value = $workflow_api->getEntityAttributeValue("ENT01","vlnumber");

Neste exemplo, o método getEntityAttributeValue está buscando o valor do atributo de identificador "vlnumber" na entidade de identificador "ENT01".

O valor retornado será um número decimal (Ex.:1234.56000000), representando o valor do atributo. É possível que o valor contenha zeros à direita, pois o valor retornado mantém a precisão definida para o atributo.

cuidado

É importante lembrar que o identificador da entidade e o identificador do atributo da entidade devem ser fornecidos corretamente para que o método funcione corretamente e retorne o valor esperado. Além disso, é recomendável verificar se a entidade e o atributo existem e se estão devidamente configurados antes de buscar seu valor.