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