<task>.getTaskSystemResponsible(name: String)
Essa função retorna o nome do usuário superior direto do usuário informado no parâmetro.
- Possuindo líder, o nome do líder;
- Não possuindo líder, será retornado zero vazio ("").
Nos seguintes casos, é retornada uma exceção do tipo EBusinessException que deve ser tratada no processo:
- Se o usuário informado não existir;
- Se o usuário informado tiver mais de um superior (válido apenas para Posto de trabalho);
- Se não for possível buscar as informações no Gestão de Pessoas.
A busca pelo superior ocorre através da execução de um Web service, definido em algum dos módulos do produto Gestão de Pessoas. O módulo onde será definido o Web service deve ser configurado em Central de Configurações > Sistemas > Performance Corporativa > Workflow > Web services.
Devido a execução dessa função se tratar de um Web service, ela respeita uma configuração de timeout - assim como os demais serviços - porém, esse não pode ser configurado na função. O timeout respeitado é sempre o tempo padrão configurado em Central de Configurações > Sistemas > Performance Corporativa > Workflow > Web services.
Nota
Não é possível definir a hierarquia a ser utilizada em cada chamada da função. Essa configuração é feita por processo, diretamente em algum dos módulos do Gestão de Pessoas em Hierarquia de Processos do Workflow.
Esta função está disponível para os scripts BeforeExecute e AfterExecute.
Sintaxe: <task>.getTaskSystemResponsible(name: String)
Parâmetros:
| Nome | Tipo | Descrição |
|---|---|---|
| name | String | Nome correspondente ao do usuário que deseja-se obter o superior direto. |
Tipo de retorno: String.
Exemplo do utilização:
Essa função pode ser utilizada em diversos casos. Abaixo, existem os dados que serão utilizados como entrada para este exemplo, onde se tem um usuário e é necessário buscar seu líder, para que esse seja notificado. Nesse caso será utilizado como exemplo a execução do processo Solicitação de Desligamento – o processo aqui é relevante pois este define a hierarquia que será utilizada para buscar o líder.
| Código do processo | Nome do Processo | Configuração da Hierarquia | Estrutura do posto |
|---|---|---|---|
| 1 | Solicitação de Férias | Chefias | - |
| 2 | Solicitação de Desligamento | Posto de trabalho | 001 - Estrutura padrão |
Hierarquia dentro da estrutura 001 de postos de trabalho:
| Colaborador | Associado ao usuário | Líder |
|---|---|---|
| Cristian Armando | 10 - Cristian | - |
| Carla Silva | 20 - Carla | Cristian |
| Carlos Augusto | 30 - Carlos | Carla |
Script definido no beforeExecute:
// Busca a tarefa
var task = context.getTask();
// Busca a variável que contém o nome do usuário (no caso, será utilizado o usuário Carla)
var userName = context.getVars().getString("colabName");
// Busca o superior do usuário contido na variável
var userSuperior = task.getTaskSystemResponsible(userName);
// A variável “userSuperior” recebe “Cristian” - Que é o superior da Carla.
// Agora vamos buscar o superior do superior retornado no passo acima (no caso, do usuário Cristian)
var superiorOfSuperior = task.getTaskSystemResponsible(userSuperior);
// A variável “superiorOfSuperior” recebe "" e retorna vazio, pois Cristian não possui líder.
English
Español
