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

Editar o valor de um campo lista de valores do formulário do workflow

Para editar o valor de um campo do tipo lista de valores do formulário do workflow, deve-se utilizar o método setEntityRelationshipValue passando os seguintes parâmetros: o identificador da entidade na qual o formulário pertence, o identificador do relacionamento com a entidade da lista de valores e um array contendo o identificador do atributo e o valor. O sistema utiliza o valor para buscar o código do registro correspondente.

Caso exista a possibilidade de haver valores repetidos na lista, é necessário passar mais de um atributo para desempate. Por exemplo, ao selecionar o valor "Jordan" na lista de valores "usuário", se houver dois "Jordan" o sistema não saberá qual selecionar. Nesse caso, é preciso passar além do nome outro valor, como a matrícula do usuário.

Segue a sintaxe do método:

setEntityRelationshipValue("Identificador da entidade", "Identificador do relacionamento", "Array com identificador do atributo da entidade da lista e valor")

Exemplos:

Primeiro Exemplo

$workflow_api->setEntityRelationshipValue("ENT01", "RelationshipID",
array("nmtext" => "Value 1"));

Segundo Exemplo

$workflow_api->setEntityRelationshipValue("ENT01", "RelationshipID",
array("nmtext"=>"Value 1","nmmat"=>"789"));

No primeiro exemplo, o método setEntityRelationshipValue está atualizando o valor do relacionamento de identificador "RelationshipID" na entidade de identificador "ENT01" para "Value 1". No segundo exemplo, além do valor "Value 1", é fornecido o valor da matrícula "789" para evitar ambiguidade caso haja mais de um "Value 1" na lista de valores.