Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Nota
titleAtenção

A utilização da hAPI só está disponivel na versão nas versões igual ou superior à 1.5.12

É possível realizar a consulta a um Dataset da Plataforma (interno, formulários ou customizado), a fim, de elaborar o resultado final dos usuários que poderão ser listados para escolha da execução da próxima atividade. Este procedimento pode ser realizado conforme o exemplo a seguir:É possível obter informações da API de Workflow utilizando a variável global hAPI. Os seguintes métodos estão disponíveis através da hAPIsão recomendados para utilização:

MétodoEspecificação
getCardValue("nomeCampo")

Permite acessar o valor de um campo do formulário do processo, onde:

  • nomeCampo: nome do campo do formulário.

 

Dica
titleDica

Campos do tipo checkbox retornam os valores on para marcado ou "" (vazio) para não marcado. Para trabalhar de uma maneira mais fácil, é possível transformá-los em booleanos.

Exemplo:

Bloco de código
languagejavascript
themeEclipse
firstline1
linenumberstrue
var campoCheckbox = hAPI.getCardValue("campoCheckbox") == "on" ? true : false;
getCardData(numProcesso)

Retorna um Mapa com todos os campos e valores do formulário da solicitação.

  • numProcesso: número da solicitação de processo.

 

Informações

Para formulários pai e filho, os campos são identificados da seguinte forma: campo1___1, sendo campo1 o nome atribuído ao campo através da tag name do campo HTML + ___ (3 underlines) + número sequencial do registro.

 

Por exemplo, em um formulário de nota fiscal com os seguintes campos:

  • Formulário pai:
    • Número da Nota - numNota;
  • Formulário filho:
    • Código do item - codItem;
    • Descrição do item - desItem;
    • Quantidade do item - qtdItem;

O retorno do Mapa seria:

  • numNota = 99999
  • codItem___1 = 91
  • desItem___1 = Caneta
  • qtdItem___1 = 100
  • codItem___2 = 92
  • desItem___2 = Lápis
  • qtdItem___2 = 200
  • codItem___3 = 93
  • desItem___3 = Borracha
  • qtdItem___3 = 150

Exibindo usuários conforme campo selecionado

Um exemplo de retorno de usuários utilização da hAPI, onde será retornado usuário considenrando o campo selecionado no formulário da solicitação:

Bloco de código
languagejavascript
function resolve(process, colleague) {

	var userList = new java.util.ArrayList();

	var produtoSelecionado = hAPI.getCardValue("produto");
	var grupo;
	switch (produtoSelecionado) {
		case "coordenacao":
			grupo = "coordenacao";
			break;
		case "administracao":
			grupo = "administracao";
			break;
		case "recursos_humanos":
			grupo = "recursos_humanos";
			break;
		default:
			grupo = "geral";
	}
	var cGrupo = DatasetFactory.createConstraint("colleagueGroupPK.groupId",
			grupo, grupo, ConstraintType.MUST);
	
	var constraintsGroup = new Array(cGrupo);
	
	var colleagues = DatasetFactory.getDataset("colleagueGroup", null,
			constraintsGroup, null);
	
 for (var i = 0; i < colleagues.values.length; i++) {
		var colleagueId = colleagues
				.getValue(i, "colleagueGroupPK.colleagueId");
		userList.add(colleagueId);
	}
	return userList;

}

Utilizando Datasets

É possível realizar a consulta a um Dataset da Plataforma (interno, formulários ou customizado), a fim, de elaborar o resultado final dos usuários que poderão ser listados para escolha da execução da próxima atividade. Este procedimento pode ser realizado conforme o exemplo a seguir:

...