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

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

Para editar o valor de um campo do formulário do workflow deve-se utilizar o método setEntityAttributeValue passando os parâmetros: identificador da entidade na qual o formulário pertence, identificador do atributo da entidade e o novo valor.

$workflow_api->setEntityAttributeValue("Identificador da entidade", "Identificador do atributo da entidade", "Novo valor");

Exemplos

1. Atualizar atributo do tipo Boolean

$workflow_api->setEntityAttributeValue("ENT01", "fgboolean", "1");

Neste exemplo, o método setEntityAttributeValue está atualizando o valor do atributo de identificador "fgboolean" na entidade de identificador "ENT01" para "1", que corresponde à opção marcada.

Para atributos do tipo Boolean, os valores possíveis são "0" para a opção desmarcada e "1" para a opção marcada.

2. Atributo do tipo Hora

$workflow_api->setEntityAttributeValue("ENT01", "hrtime", "20:00");

Neste exemplo, o método setEntityAttributeValue está atualizando o valor do atributo de identificador "hrtime" na entidade de identificador "ENT01" para "20:00", que corresponde a uma hora no formato "HH:MM".

Para atributos do tipo Hora, o novo valor deve estar no formato "HH:MM", onde HH representa a hora e MM representa os minutos.

3. Atributo do tipo Número inteiro

$workflow_api->setEntityAttributeValue("ENT01", "vlinteger", "123456");

Neste exemplo, o método setEntityAttributeValue está atualizando o valor do atributo de identificador "vlinteger" na entidade de identificador "ENT01" para "123456", que corresponde a um número inteiro.

Para atributos do tipo Número inteiro, o novo valor deve ser um número inteiro sem casas decimais.

4. Atributo do tipo Texto

$workflow_api->setEntityAttributeValue("ENT01", "nmtext", "ABC");

Neste exemplo, o método setEntityAttributeValue está atualizando o valor do atributo de identificador "nmtext" na entidade de identificador "ENT01" para "ABC", que corresponde a um texto.

Para atributos do tipo Texto, o novo valor pode ser uma sequência de caracteres.

5. Atributo do tipo Data

$workflow_api->setEntityAttributeValue("ENT01", "dtdate", "2019-07-31");

Neste exemplo, o método setEntityAttributeValue está atualizando o valor do atributo de identificador "dtdate" na entidade de identificador "ENT01" para "2019-07-31", que corresponde a uma data no formato "YYYY-MM-DD".

Para atributos do tipo Data, o novo valor deve estar no formato "YYYY-MM-DD", onde YYYY representa o ano, MM representa o mês e DD representa o dia.

6. Atributo do tipo Número decimal

$workflow_api->setEntityAttributeValue("ENT01", "vlnumber", "1234.56");

Neste exemplo, o método setEntityAttributeValue está atualizando o valor do atributo de identificador "vlnumber" na entidade de identificador "ENT01" para "1234.56", que corresponde a um número decimal.

Para atributos do tipo Número decimal, o novo valor deve ser um número com casas decimais, separando a parte inteira da parte decimal com um ponto ".".