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.
É 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.