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.