ER_Talent Management - API

Informações Gerais

   Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos). 

(Obrigatório)

Objetivo

Desenvolver o Arquitetura Organizacional(SIGAORG) utilizando o TOTVS HTMLFramework.
Com o novo Arquitetura Organizacional será possível cadastrar departamentos, visões e  montar suas estruturas de forma rápida e fácil dentro do Fluig. 

Alguns Objetivos:

• Power-Up Fluig -  Pode ser utilizado em conjunto com os mecanismos de atribuição
• SOA - 100% Stateless
• Arquitetura Unica - Sistema único de aprovadores que possa atender todos os módulos

(Obrigatório)

Definição da Regra de Negócio

O Intuito é facilitar a criação das estruturas de aprovação da empresa para isso vamos desenvolver as rotinas utilizando o novo TOTVS HTMLFramework integrado com o Fluig.
Toda a comunicação com o ERP será feita através de Rest/Json, que deverá seguir algumas regras descritas abaixo, a interface será em HTML5 com AngularJs e Bootstrap.

A tela inicial(protótipo abaixo) terá as visões já cadastradas com opção de editar/excluir/Clonar/Incluir e um menu com os cadastros auxiliares, como Departamento, Centro de Custo, Função, Cargo.

Uma alteração importante será realizada na estrutura de tabelas responsáveis por guardar os dados do nível hierárquico, por isso será necessário ao gravar essas novas tabelas atualizar as antigas e vice versa para que alterações feitas tanto pelo ERP quanto pela Web funcionem corretamente.

Vamos prover serviços Rest para que outros sistemas como o Fluig possam consultar o próximo aprovador e assim poder distribuir corretamente os WorkFlow's.

Interfaces

Todas as interfaces devem respeitar as características do dicionário de dados, como mascara, validação, obrigatoriedade, consulta F3, tamanho. Como a integração interface X dicionário não é automática, no desenvolvimento prestar muita atenção a esses pontos

• Tela Inicial 
• Cadastro de Departamentos
• Cadastro de Cargos
• Cadastro de Funções
• Cadastro de Entidades
• Cadastro de Visões
  
• Consulta Padrão Departamento
• Consulta Padrão Cargos
• Consulta Padrão Funções
• Consulta Padrão Centro de Custos

Alterar CSAA100

Alterar a rotina de gravação Cs100Grava() para quando for Execauto não utilizar o "ConfirmSX8()" e fazer o rollback da numeração, pois o código do departamento virá do serviço REST

Alterar APDA020

Alterar a rotina Apda020ChkDel() de Static para Function.

Alterar GPER030

Alterar a Rotina GPER030() para receber mais dois parâmetros, lRest e cPatchFile, assim quando for solicitado o relatório pelo serviço Rest será possível mostrar o PDF no novo portal.

o Parâmetro cPatchFile conterá o diretório e o nome do arquivo pdf gerado pela função fImprPdf, e o parâmetro lRest servirá para tratar desvios de interface por exemplo.

Alterar WSPON040

 Criar a função GetMarcPortal() que irá buscar período e marcações do funcionário, de forma que possa ser utilizada no WebService e no Serviço ORGW022(ORGESPELHOPONTO), para isso desmembrar o Método do webservice. 

Criar a Função RhRestRet(oObj,nTam)

Essa função será utilizada para montar o retorno em Json dos métodos. Ela adiciona as propriedades especificas que o HTMLFramework necessita.
O retorno sempre utilizará o objeto JsonObject, para isso é preciso ter Build a partir de outubro/2015 

Criar a Função RhRestERR(cCod,cMsg)

Essa função será utilizada para montar o retorno de erro em Json dos métodos. Ela adiciona as propriedades especificas que o HTMLFramework necessita.
O retorno sempre utilizará o objeto JsonObject, para isso é preciso ter Build a partir de outubro/2015
 

Criar a Função RhRestDt(cData)

Essa função converte uma string no no formato "1412305200000" para date() podendo assim gravar o conteúdo nos campos tipo Date.
Para envio de campo tipo Date não é preciso converter, a função FWJsonSerialize já faz isso. 
 

Criar a Função RHcBoxJ(aDados)

Essa função receberá como parâmetro o retorno da função RetSx3Box(), que devolve o conteudo do campo X3_CBOX ja no idioma correto.
O Retorno deverá ser um objeto JsonObject() com a seguinte estrutura:

oItem := JsonObject():New()
oItem["id"] := aDados[nI][2]
oItem["descricao"] := aDadosnI][3]

Criação de serviços Rest

Os retorno sempre deverão conter a seguinte estrutura:

É através da propriedade CODIGO  que os registros são localizados para edição/deleção. Iremos sempre utilizar propriedades com nomes em minusculo, pois o javascript é casesensitive e assim ficará mais fácil para não digitarmos errado.
 

Em caso de erro a estrutura de retorno deve ser Utilizar a função RhRestERR(cCod,cMsg) para retornar essa estrutura:

ORGVisão (ORGW001)

Consultar tabela de visões(RDK)

Criar campo RDK_ENTIDA, para gravar o código da Entidade que esta relacionada.

Estrutura de Retorno: Utilizar a função RhRestRet() para transformar o retorno em Json.

WSDATA filial AS string
WSDATA codigo AS string
WSDATA descricao AS string
WSDATA status AS string
WSDATA hierarquia AS string
WSDATA tipo AS string
WSDATA dataInclusao AS date
WSDATA dataSuspensao AS date
WSDATA categoria AS string
WSDATA descricaocategoria AS string
WSDATA entidade AS string
WSDATA descricaoentidade AS string
WSDATA descricaotipo AS string 
WSDATA descricaohierarquia AS string 
WSDATA descricaostatus AS string 

(GET)\ORGvisao

Retorna uma lista com os dados das visões respeitando os parâmetros start e Limit, que definem a partir de quando começa a pesquisa e quantos registros devem retornar.

(GET)\ORGvisao\[idVisao]

Retorna os dados da visão respeitando o parâmetro recebido.

(GET)\ORGvisao\[idVisao]\entidade

WSSTRUCT TVisaoEntidade
WSDATA codigo AS string
ENDWSSTRUCT

Retorna o código da Entidade da Visao

(GET)\ORGvisao\[idVisao]\entidade\elementosdisponiveis

Parametros entrada : start,filter,limit,rascunho

Caso o parâmetro filter seja passado o filtro será realizado na tabela da Entidade(Codigo/Descrição) e na tabela de funcionários.
o parâmetro  rascunho define qual estrutura será utilizada.

Retorna Elementos disponíveis da Entidade que possam ser adicionados na estrutura
  

(GET)\ORGvisao\[idVisao]\categoria

WSSTRUCT TVisaoCategoria
WSDATA codigo AS string
WSDATA descricaoAS string
ENDWSSTRUCT

Retorna as categorias definidas para esta visão

(GET)\ORGvisao\[idVisao]\estrutura

WSSTRUCT TVisaoEstrutura
WSDATA codigo AS string
WSDATA versao AS string
ENDWSSTRUCT

Retorna as Estruturas(QN0) definidas para esta visão.

Caso seja informados os parametros Data1 e data2, será filtrado pela datas inicial e final da estrutura

(GET)\ORGvisao\[idVisao]\estruturaativa

Retorna a Estrutura Ativa(QN0) definidas para esta visão.

(Post)\ORGvisao

Insere os dados de visão e retorna o código do mesmo.
Quando se tratar de uma nova visão incluir também uma nova estrutura vinculada a esta visão(QN0). 

(Post)\ORGvisao\[visaoaclonar]\clonar

Clona a Visão e a estrutura da visão passada como parâmetro.

(Put)\ORGvisao\[idVisao]

Atualiza os dados da Visão e retorna o código do mesmo.

(Put)\ORGvisao\[idVisao]\padrao

Torna a visão passada como parâmetro como a Default

(Put)\ORGvisao\[idVisao]\publicar

Torna a estrutura(QN0) de rascunho(RDK_RASCUN) como a estrutura definitiva a partir de uma data passada como parâmetro(data1), ate uma outra data, também passada como parâmetro(data2).

Somar 1 na versao da Estrutura(QN0_VERSAO) e finalizar a estrutura anterior(QN0_DTFIM), aterar a estrutura antiga do SIGAORG nesse momento(RD4)

(DELETE)\ORGvisao\[idvisao]

Altera o status da Visão para inativa e preencho o campo de data de suspensão.

ORGEntidade(ORGW002)

Consultar tabela de Entidades(QN6)

Estrutura de Retorno: Utilizar a função RhRestRet() para transformar o retorno em Json.

WSDATA filial AS string
WSDATA Codigo AS string
WSDATA Descricao AS string 
WSDATA Alias AS string 
WSDATA Chave AS string  -> Gravar o campo Filial do responsável pela entidade, exemplo QB_FILRESP
WSDATA CampoDescrEntidade AS string -> Gravar o campo da Descrição da entidade, exemplo QB_DESCRIC
WSDATA CampoDetalheEntidade AS string  -> Gravar o campo matricula do responsável pela entidade, exemplo QB_MATRESP

(GET)\ORGentidade

Retorna uma lista com os dados das Entidades respeitando os parâmetros start e Limit, que definem a partir de quando começa a pesquisa e quantos registros devem retornar.

(GET)\ORGentidade\[idEntidade]

Retorna os dados da Entidade respeitando o parâmetro recebido.

(GET)\ORGentidade\[idEntidade]\visoes

Retorna todas as visões(RDK) que estão cadastradas para esta entidade, através do campo RDK_ENTIDA.

WSSTRUCT TEntidadeVisao
WSDATA filial AS string
WSDATA codigo AS string
WSDATA descricao AS string
WSDATA status AS string
ENDWSSTRUCT

(GET)\ORGentidade\[idEntidade]\relacionamentos

(Post)\ORGentidade

Insere os dados da Entidade e retorna o código do mesmo.

(Put)\ORGentidade\[identidade]

Atualiza os dados da Entidadee retorna o código do mesmo.

(DELETE)\ORGentidade\[idEntidade]

Exclui a Entidade e retorna o código do mesmo.

ORGFunções (ORGW003)

Consultar tabela de Funções(SRJ)

Estrutura de Retorno: Utilizar a função RhRestRet() para transformar o retorno em Json.

WSDATA filial AS string
WSDATA codigo AS string
WSDATA descricao AS string
WSDATA cbo2002 AS string
WSDATA cbo1994 AS string
WSDATA maodeobra AS string
WSDATA descricaomaodeobra AS string
WSDATA cargo AS string

WSDATA descrcargo AS string
WSDATA salario AS float
WSDATA requisitos AS string
WSDATA imprimeppp AS string
WSDATA funcaolider AS string
WSDATA descricaofuncaolider AS string
WSDATA descricaoimprimeppp AS string 

(GET)\ORGfuncao

Retorna uma lista com os dados das funções respeitando os parâmetros start e Limit, que definem a partir de quando começa a pesquisa e quantos registros devem retornar.

Temos também as propriedades filter e filtercampo que serão recebidos por querystring para poder fazer filtro da Consulta padrão(F3). Caso a propriedade filtercampo não seja informada o filtro é realizado fazendo a busca nos camposRJ_FUNCAO e RJ__DESC utilizando Like na expressão sql. 

(GET)\ORGfuncao\[idFuncao]

Retorna os dados da Função de acordo com o Id recebido.

(Post)\ORGfuncao

Insere os dados de Função e retorna o código do mesmo.

(Put)\ORGfuncao\[idFuncao]

Atualiza os dados da Função e retorna o código do mesmo.

(DELETE)\ORGfuncao\[idfuncao]

Exclui a Função e retorna o código do mesmo.

ORGCargos (ORGW004)

Consultar tabela de Cargos(SQ3)

Estrutura de Retorno: Utilizar a função RhRestRet() para transformar o retorno em Json.

WSSTRUCT TCargo
WSDATA filial AS string
WSDATA codigo AS string
WSDATA descricao AS string
WSDATA centrocusto AS string
WSDATA descrcc AS string
WSDATA descrdet AS string
WSDATA responsabilidade AS string
WSDATA relacionamento AS string
WSDATA habilidades AS string
WSDATA grupo AS string
WSDATA descrgrupo AS string
WSDATA departamento AS string
WSDATA descricaodepartamento AS string
ENDWSSTRUCT

(GET)\ORGcargo

Retorna uma lista com os dados dos Cargos respeitando os parâmetros start e Limit, que definem a partir de quando começa a pesquisa e quantos registros devem retornar.

(GET)\ORGcargo\[idCargo]

Retorna os dados do Cargo de acordo com o Id recebido.

(Post)\ORGcargo

Insere os dados de Cargo e retorna o código do mesmo.

(Put)\ORGcargo\[idCargo]

Atualiza os dados do Cargo e retorna o código do mesmo.

(DELETE)\ORGcargo\[idCargo]

Exclui o Cargo e retorna o código do mesmo.
 

ORGCentroCusto(ORGW005)

Consultar tabela de Centro de Custo(CTT) para utilizar em consulta F3

Estrutura de Retorno: Utilizar a função RhRestRet() para transformar o retorno em Json.

WSSTRUCT TCentroCusto
WSDATA filial AS string
WSDATA codigo AS string
WSDATA descricao AS string
ENDWSSTRUCT

(GET)\ORGcentrocusto

Retorna uma lista com os dados dos Centros de Custo respeitando os parâmetros start e Limit, que definem a partir de quando começa a pesquisa e quantos registros devem retornar.

(GET)\ORGcentrocusto\[idcentrocusto]

Retorna os dados do Centro de Custo respeitando o parâmetro recebido.
 

ORGFuncionario(ORGW006)

Consultar tabela deFuncionários(SRA) para utilizar em consulta F3

Estrutura de Retorno: Utilizar a função RhRestRet() para transformar o retorno em Json.

WSSTRUCT TFuncionario
WSDATA filial AS string
WSDATA codigo AS string
WSDATA nome AS string
WSDATA admissao AS date
WSDATA cpf AS string
WSDATA status AS string
WSDATA centrocusto AS string
WSDATA departamento AS string
WSDATA cargo AS string
WSDATA funcao AS string
WSDATA nascimento AS date
WSDATA email AS string
WSDATA foto as string
ENDWSSTRUCT

O Parâmetro de entrada por querystring "foto" é do tipo boolean e quando está setado como True retorna junto com as outras informações um codigo encode64 com a foto do funcionário. o Default desse parâmetro é False.

(GET)\ORGfuncionario

Retorna uma lista com os dados dos funcionários respeitando os parâmetros start e Limit, que definem a partir de quando começa a pesquisa e quantos registros devem retornar.

(GET)\ORGfuncionario\busca

Retorna uma lista com os dados dos funcionários respeitando os parâmetros Limit e filter, que definem  quantos registros devem retornar e a informação a ser buscada.
Caso o parametro limit esteja com -1, retornará todos os dados.
A busca irá selecionar todos os funcionários que correspondem a propriedade FILTER, levando em consideração os campos RA_MAT, RA_NOME, QB_DESCRIC, RA_APELIDO e RA_NOMECMP. 

(GET)\ORGfuncionario\[idfuncionario]

Retorna os dados do funcionário respeitando o parâmetro recebido.

ORGEstrutura(ORGW007)

Consultar tabela de Estrutura de Visões(QN0).

Estrutura de Retorno: Utilizar a função RhRestRet() para transformar o retorno em Json.

(GET)\ORGEstrutura\[idEstrutura]

WSSTRUCT TFuncionario
WSDATA filial AS string
WSDATA codigo AS string
WSDATA CodigoVisao AS string
WSDATA datainicio AS date
WSDATA datafim AS date
WSDATA versao AS string
ENDWSSTRUCT 

Retorna os dados da estrutura da Visão conforme ID passado como parâmetro.
 

ORGDepartamento (ORGW010)

Consultar tabela de departamentos(SQB)

Estrutura de Retorno: Utilizar a função RhRestRet() para transformar o retorno em Json.

WSDATA filial AS string
WSDATA codigo AS string
WSDATA descricao AS string
WSDATA centrocustro AS string
WSDATA descrcentrocusto AS string
WSDATA filialresp AS string
WSDATA matricularesp AS string
WSDATA departamentosup AS string

(GET)\ORGdepartamento

Retorna uma lista com os dados dos departamentos respeitando os parâmetros start e Limit, que definem a partir de quando começa a pesquisa e quantos registros devem retornar.
Temos também as propriedades filter e filtercampo que serão recebidos por querystring para poder fazer filtro da Consulta padrão(F3). Caso a propriedade filtercampo não seja informada o filtro é realizado fazendo a busca nos campos QB_DEPTO e QB_DESCRIC utilizando Like na expressão sql. 

(GET)\ORGdepartamento\[idDepartamento]

Retorna os dados do departamento de acordo com o Id recebido.

(Post)\ORGdepartamento

Insere os dados de departamento e retorna o código do mesmo.

(Put)\ORGdepartamento\[idDepartamento]

Atualiza os dados de departamento e retorna o código do mesmo.

(DELETE)\ORGdepartamento\[idDepartamento]

Exclui o departamento e retorna o código do mesmo.

ORGCaminho (ORGW011)

Consultar tabela de Caminhos do Nó da Visão(QDW)

Estrutura de Retorno: Utilizar a função RhRestRet() para transformar o retorno em Json.

WSSTRUCT Tcaminho
WSDATA filial AS string
WSDATA codigo AS string
WSDATA noorigem AS string
WSDATA nodestino AS string
ENDWSSTRUCT

(GET)\ORGCaminho\[idCaminho]

Retorna os dados do Caminho de acordo com o Id recebido.

(Post)\ORGCaminho

Insere os dados do Caminho e retorna o código do mesmo.

(Put)\ORGCaminho\[idCaminho]

Atualiza os dados do Caminho e retorna o código do mesmo.

(DELETE)\ORGCaminho\[idCaminho]

Exclui o Caminhoe retorna o código do mesmo.

ORGACTION (ORGW012)

Serviço responsável por retornar os filhos e pais de um nó.

Pode receber alguns parâmetros:

WSDATA visao AS String
WSDATA empresa AS String
WSDATA filial AS String
WSDATA matricula AS String
WSDATA no AS String
WSDATA foto as boolean
WSDATA rascunho as boolean 
WSDATA estruturaas boolean  

O Parâmetro de entrada por querystring "foto" é do tipo boolean e quando está setado como True retorna junto com as outras informações um codigo encode64 com a foto do funcionário. o Default desse parâmetro é False.

Caso a propriedade "no" não seja informada, o sistema buscará o nó corrente utilizando os demais parâmetros.

Com a propriedade "rascunho"  é possível achar o nó(caso não informado) na estrutura ativa ou rascunho, caso o rascunho ainda não exista será criado automaticamente.

A propriedade "estrutura" é utilizada para retornar o nó de uma estrutura especifica independente se está ativa ou não.

(GET)\ORGACTION\raiz

Parametros :

visao -> codigo da visao que deseja
estrutura  -> caso seja informada retorna os dados dessa estrutura, mas o parametro rascunho dever estar false

Com a propriedade rascunho(Boolean)  é possível retornar a raiz da estrutura ativa ou do rascunho. Caso ainda não exista a estrutura rascunho ela será criada automaticamente.

Retorna a estrutura do Nó raiz da estrutura da Visão selecionada

(GET)\ORGACTION\raizlogado

Parametros :

Retorna a estrutura do Nó raiz da estrutura da Visão padrão e do usuário logado, ele deve ser o responsável pelo nó.

(GET)\ORGACTION\filhos

Retorna todos os nós(QN3) filhos de acordo com o nó atual
A estrutura de retorno será a mesma da função RetQN3("entidade") 

(GET)\ORGACTION\arvore

Retorna a arvóre completa de acordo com o nó atual
A estrutura de retorno será a mesma da função RetQN3("entidade") 

(GET)\ORGACTION\trilha

Retorna todos os nós(QN3) pais a partir do nó atual
A estrutura de retorno será a mesma da função RetQN3() 

(GET)\ORGACTION\proximo

Retorna o próximo nó(QN3) pai de acordo com o nó atual
A estrutura de retorno será a mesma da função RetQN3() 

(GET)\ORGACTION\busca

Busca nó da pessoa através dos parâmetros visao, filial, empresa, e matricula
A estrutura de retorno será a mesma da função RetQN3() 

(GET)\ORGACTION\pessoas

Retorna todas as pessoas relacionadas com a entidade do No atual e os responsáveis dos Nós Filhos.

Para esse serviço é obrigatório as propriedades Empresa. Filial e Matricula.

Retorno:
oItem["empresa"] := cEmpEnt
oItem["filial"] := (cQry)->RA_FILIAL
oItem["matricula"] := (cQry)->RA_MAT
oItem["nome"] := Alltrim((cQry)->RA_NOME)
oItem["admissao"] := STOD((cQry)->RA_ADMISSA)
oItem["no"] := QN3->QN3_CODIGO

ORGEMPRESA (ORGW013)

Serviço responsável por retornar as Empresas / Filiais (SM0) para utilização no Zoom(F3) das telas de cadastros

(GET)\ORGEMPRESA \

Retorna uma lista com os dados das empresas respeitando os parâmetros start e Limit, que definem a partir de quando começa a pesquisa e quantos registros devem retornar.
Temos também as propriedades filter e filtercampo que serão recebidos por querystring para poder fazer filtro da Consulta padrão(F3). Caso a propriedade filtercampo não seja informada o filtro é realizado fazendo a busca nos campos Codigo  e descrição

Consultar as empresas utilizando a função FWAllGrpCompany()

(GET)\ORGEMPRESA\[Empresa]\filial

Retorna uma lista com os dados das filiais respeitando os parâmetros start e Limit, que definem a partir de quando começa a pesquisa e quantos registros devem retornar.
Temos também as propriedades filter e filtercampo que serão recebidos por querystring para poder fazer filtro da Consulta padrão(F3). Caso a propriedade filtercampo não seja informada o filtro é realizado fazendo a busca nos campos Codigo  e descrição

Consultar as empresas utilizando a função FWAllFilial(,,::aURLParms[1],.F.) filtrando pela empresa passada como parâmetro.

ORGGrupo(ORGW014)

Consultar tabela de Grupos(SQ0) para utilizar em consulta F3

Estrutura de Retorno: Utilizar a função RhRestRet() para transformar o retorno em Json.

(GET)\ORGGrupo

Retorna uma lista com os dados dos Grupos respeitando os parâmetros start e Limit, que definem a partir de quando começa a pesquisa e quantos registros devem retornar.

(GET)\ORGGrupo\[idGrupo]

Retorna os dados do Grupo respeitando o parâmetro recebido.

ORGBANCODEHORAS(ORGW021)

Retorna informações de banco de Horas(SPI) por período do funcionário logado ou de um funcionário da minha equipe.

Receber o usuário do Fluig e com essa informação buscar a Filial/Matricula do funcionário logado.

Caso parâmetro equipe esteja true, através da Visão informada e da matricula do usuário logado encontro meu nó(ACHARNO - ORGW012) e retorno as pessoas que são minhas subordinadas(RETPESSOAS- ORGW012). Com as pessoas já selecionadas verificar a matricula passada como parâmetro(cfilfun+cMatFun) para verificar se pertence a equipe, pertencendo consultaremos a tabela de Banco de Horas(SPI) .
Caso o parâmetro equipe esteja False, consultar os dados do usuário logado. 

ORGESPELHOPONTO(ORGW022)

Exemplo Chamada : orgespelhoponto?visao=000001&data1=2014-01-01&data2=2014-02-28
Paâmetros :

WSDATA visao AS string
WSDATA cmatfun AS string
WSDATA cfilfun AS string
WSDATA equipe AS boolean
WSDATA data1 as date
WSDATA data2 as date 

Lista marcações e apontamentos do período  solicitado do funcionário logado ou de um funcionário da minha equipe. Caso não seja passada os parâmetros de data, será considerado período de 1 mês

Receber o usuário do Fluig e com essa informação buscar a Filial/Matricula do funcionário logado.

Caso parâmetro equipe esteja true, através da Visão informada e da matricula do usuário logado encontro meu nó(ACHARNO - ORGW012) e retorno as pessoas que são minhas subordinadas(RETPESSOAS- ORGW012). Com as pessoas já selecionadas verificar a matricula passada como parâmetro(cfilfun+cMatFun) para verificar se pertence a equipe, pertencendo consultaremos a função GETMARCACOES() para o funcionário no período atual de acordo como o parâmetro de período do Ponto Eletrônico. 
Caso o parâmetro equipe esteja False, consultar os dados do usuário logado. 

O parâmetro MV_COLMARC será utilizado para obter quantidade de Entradas padrão, ou seja, se o parâmetro estiver preenchido com “2”, serão apresentadas na tela do portal quatro colunas (duas entradas e duas saídas). Caso exista mais marcações do que a quantidade padrão definida, serão apresentadas colunas até o limite de marcações do dia, ou seja, existindo 16 marcações, serão apresentadas 16 colunas. O limite mínimo sempre será composto baseado no parâmetro MV_COLMARC. A propriedade totalmarcações indica a quantidade de colunas a serem exibidas na interface.

ORGHISTORICOSALARIAL(ORGW023)

Paâmetros :

WSDATA visao AS string
WSDATA cmatfun AS string
WSDATA cfilfun AS string
WSDATA equipe AS boolean

Lista todas as alterações salariais do funcionário logado ou de um funcionário da minha equipe.

Receber o usuário do Fluig e com essa informação buscar a Filial/Matricula do funcionário logado.

Caso parâmetro equipe esteja true, através da Visão informada e da matricula do usuário logado encontro meu nó(ACHARNO - ORGW012) e retorno as pessoas que são minhas subordinadas(RETPESSOAS- ORGW012). Com as pessoas já selecionadas verificar a matricula passada como parâmetro(cfilfun+cMatFun) para verificar se pertence a equipe.
Caso o parâmetro equipe esteja False, consultar os dados do usuário logado. 

Retorno :

data: [6]

ORGPESSOAS(ORGW024)

Consultar tabela de Pessoas(RD0)

Estrutura de Retorno: Utilizar a função RhRestRet() para transformar o retorno em Json.

Caso passe a propriedade foto como true irá retornar a foto em base64.

(GET)\ORGPESSOAS

Retorna uma lista com os dados das Pessoas respeitando os parâmetros start e Limit, que definem a partir de quando começa a pesquisa e quantos registros devem retornar. Filter e FilterCampo para poder filtrar nas telas de zoom

(GET)\ORGPESSOAS\[idPessoa]

Retorna os dados da pessoa de acordo com o Id recebido.

(Post)\ORGPESSOAS

Insere os dados da Pessoa e retorna o código do mesmo.

(Put)\ORGPESSOAS\[idPessoa]

Atualiza os dados da Pessoa e retorna o código do mesmo.

(DELETE)\ORGPESSOAS\[idPessoa]

Exclui a Pessoa desde que não tenha relacionamento com a tabela de funcionários e retorna o código do mesmo.

ORGPESSOASCOMBO(ORGW025)

Método GET para retorno dos valores disponíveis para os combos da entidade Pessoas(RD0)

ORGUF(ORGW026)

Consultar tabela de Generica (SX5) tabela = 12 para utilizar em consulta F3

(GET)\ORGUF

Retorna uma lista com os dados de Estado respeitando os parâmetros start e Limit, que definem a partir de quando começa a pesquisa e quantos registros devem retornar.
Caso o parametro limit esteja com -1, retornará todos os dados. 

A busca irá selecionar todos os Estados que correspondem a propriedade FILTER e FilterCampo(codigo/descricao), caso a propriedade filtercampo não seja informada busca o conteúdo de FILTER nos campos codigo e descricao

(GET)\ORGUF\[idUF]

Retorna os dados do Estado respeitando o parâmetro recebido.

ORGFORNECEDOR(ORGW027)

Consultar tabela de Fornecedor (SA2) para utilizar em consulta F3

(GET)\ORGFORNECEDOR

Retorna uma lista com os dados dos Fornecedores respeitando os parâmetros start e Limit, que definem a partir de quando começa a pesquisa e quantos registros devem retornar.
Caso o parametro limit esteja com -1, retornará todos os dados. 

A busca irá selecionar todos os Fornecedores que correspondem a propriedade FILTER e FilterCampo(codigo/nome), caso a propriedade filtercampo não seja informada busca o conteúdo de FILTER nos campos codigo e nome

(GET)\ORGFORNECEDOR\[id]

Retorna os dados do Fornecedor respeitando o parâmetro recebido.

ORGUSUARIOPORTAL(ORGW028)

Consultar tabela de Usuarios do Portal(AI3) para utilizar em consulta F3

(GET)\ORGUSUARIOPORTAL

Retorna uma lista com os dados dos Usuários respeitando os parâmetros start e Limit, que definem a partir de quando começa a pesquisa e quantos registros devem retornar.
Caso o parametro limit esteja com -1, retornará todos os dados. 

A busca irá selecionar todos os Usuários que correspondem a propriedade FILTER e FilterCampo(codigo/nome), caso a propriedade filtercampo não seja informada busca o conteúdo de FILTER nos campos codigo e nome

(GET)\ORGUSUARIOPORTAL\[id]

Retorna os dados do Usuário respeitando o parâmetro recebido.

ORGUSUARIOPROTHEUS(ORGW029)

Consultar Usuários do Protheus para utilizar em consulta F3

(GET)\ORGUSUARIOPROTHEUS

Retorna uma lista com os dados dos Usuários respeitando os parâmetros start e Limit, que definem a partir de quando começa a pesquisa e quantos registros devem retornar.
Caso o parametro limit esteja com -1, retornará todos os dados. 

A busca irá selecionar todos os Usuários que correspondem a propriedade FILTER e FilterCampo(codigo/nome), caso a propriedade filtercampo não seja informada busca o conteúdo de FILTER nos campos codigo e nome

(GET)\ORGUSUARIOPROTHEUS\[id]

Retorna os dados do Usuário respeitando o parâmetro recebido.

ORGNIVELCARGO(ORGW030)

Consultar tabela de Nível de Cargo (FL3) para utilizar em consulta F3

(GET)\ORGNIVELCARGO

Retorna uma lista com os dados dos Nível de Cargo respeitando os parâmetros start e Limit, que definem a partir de quando começa a pesquisa e quantos registros devem retornar.
Caso o parametro limit esteja com -1, retornará todos os dados. 

A busca irá selecionar todos os  Nível de Cargo que correspondem a propriedade FILTER e FilterCampo(codigo/nome), caso a propriedade filtercampo não seja informada busca o conteúdo de FILTER nos campos codigo e nome

(GET)\ORGNIVELCARGO\[id]

Retorna os dados do Nível de Cargo respeitando o parâmetro recebido.

ORGABSENTEISMO(ORGW031)

Retorna informações de absenteísmo da equipe do funcionário logado.
Férias : Total de férias no mês corrente, Número de funcionários que retornam no mês, número de funcionários que retornam nos próximos meses.
Afastamento : Total de funcionários afastados, sub total : Afastamento por doença, Acidente de trabalho e Outros.

Retorna uma lista de funcionários para cada tipo de ausência(ferias/Afastamento) com data inicial e final. 

Parametros : Data1 e Data2 -> referente a data inicial e final de férias(SRF/SR8)

Retorna informações de férias da equipe do funcionário logado.

Tabelas Utilizadas

• • SQB – Cadastro de Departamentos
  • RDK – Cadastro de Visões
  • RD4 - Itens da Visão
  • QN6 - Cadastro de Entidades
  • SRJ - Cadastro de Funções
  • SQ3 - Cadastro de Cargos
  • CTT - Cadastro de Centro de Custos
  • SRA - Cadastro de Funcionários
  • QN0 - Cadastro de Estrutura de Visão
  • QN1 - Cadastro de Categoria de Visão
  • QN3 - Cadastro de Nós da Visão
  • QDW - Caminhos dos Nós da Visão
  • SP8 - Marcações
  • SPG - Acumulado Marcações
  • SPC - Apontamentos
  • SPH - Acumulado Apontametos
  • RD0 - Cadastro de Participantes

Opcional

Protótipo de Tela

Fluxo do Processo

Criar Visão:

Editar Visão:

Posicionar nó:

Opcional

Dicionário de Dados

Arquivo : RDK – Cabeçalho de Visões  

Arquivo : QN6 – Cadastro de Entidades  

Arquivo : QN0 – Cadastro de Estrutura de Visões  

Arquivo : QN1 – Cadastro de Categorias 

Arquivo : QN3 – Cadastro de Nós da Visão

Tabela

Campos

Índices

Parâmetros do Sistema

(Opcional)

Grupo de Perguntas

<Informações utilizadas na linha Protheus>.

(Opcional)

Consulta Padrão

<Informações utilizadas na linha Protheus>