Descrição
O Campo Orquestra é um tipo de campo para ser utilizado quando se deseja preencher automaticamente o formulário eletrônico com dados de uma instância de processo que já existe, isto é, resgatar os dados de uma instância antiga em um nova instância.
Exemplo: você possui uma instância de processo com todos os dados de um cliente e deseja trazer estes dados populando o formulário de uma tafefa.
Uma das características principais desse tipo de campo é ele ter aparência e comportamento similar ao campo do tipo Sugestão.
Para permitir o preenchimento dos campos automaticamente os identificadores dos campos do processo de origem devem ser iguais aos do processo de destino.
Somente campos habilitados ou visíveis serão preenchidos, campos ocultos não são afetados pelo preenchimento do Campo Orquestra.
Configurando a Fonte de Dados
Assim como o campo Sugestão também é necessário o uso de uma fonte de dados com este campo.
Exemplo de Fonte de Dados 1
Buscando os dados de uma instância através do seu código.
SELECT CodFlowExecute CodAttributeCustomValue, CodFlowExecute DsAttributeValueName
FROM wfFLOW_EXECUTE
WHERE CodFlow = 113
Exemplo de Fonte de Dados 2
Buscando os dados de uma instância através de um campo do formulário.
SELECT CodFlowExecute CodAttributeCustomValue, DsFormFieldValue DsAttributeValueName
FROM wfVWFLOW_FORM_FIELD_LOG
WHERE CodFlow = 149
AND DsFieldName = 'nome'
1. Possuimos uma instância de processo com todos os dados de um cliente:
2. Na tela de execução de tarefa iniciamos o preenchimento do nome do cliente no campo Orquestra:
3. Ao selecionar o cliente na lista todos os campos do formulário foram preenchidos com os mesmos dados da instância original, inclusive os campos dentro da tabela multivalorada:
Você pode utilizar um 'atributo personalizado HTML para listar os identificadores dos campos que não devem ser preenchidos pelo campo Orquestra.
Para isso na configuração do campo de formulário em Configurações de programação avançadas/Código de Script utilize o atributo "noFill" conforme modelo abaixo:
noFill="idcampo01,idcampo02"
Lembre-se de que o campo Código de Script possui limite de 512 caracteres, caso o conteúdo do campo ultrapasse esse limite utilize o preenchimento do atributo "noFill" através de códigos Javascript conforme artigo Conceitos Básicos para programação Javascript / jQuery no Orquestra
Este tipo de campo não pode ser utilizado em Tabelas Multivaloradas.
Restrição de Uso
Ao utilizar fonte de dados com as colunas "CodAttributeCustomValue" e "DsAttributeValueName" o campo Orquestra ficará populado apenas com o código, isto é, apenas com o valor trazido na coluna "CodAttributeCustomValue".
Evento OnBlur
Este campo do formulário é um campo composto, este campo possui um campo texto (input type="text" do HTML) e um painel flutuante com os resultados (DIV do HTML).
Quando o usuário clica em um item da lista de resultado o usuário está tirando o foco do campo texto, ou seja, no momento do clique é ativado o evento onBlur do campo texto e, este, ainda não possui o valor selecionado pelo usuário na lista. Esse é o comportamento padrão nos navegadores.
Para contornar o cenário citado acima, isto é, para buscar o valor do campo texto é necessário utilizar rotinas Javascript setTimeout no evento onBlur de forma a buscar o valor do campo texto com certo atraso em relação ao momento da ativação do evento onBlur.