Web service com.senior.g5.rh.cs.apurarAvaliacao

Tipo de execução

Para cada tipo de execução, existem parâmetros específicos, alguns dos quais podem ser comuns a todas as portas de web service.

Autenticação

Quando for utilizada alguma forma de autenticação na integração de informações por meio de web services, é necessário informar o tipo correspondente no parâmetro <encryption>, conforme os valores possíveis.

WSDL

Porta

Apurar

Web service para apurar as avaliações. Utiliza o resultado das avaliações anteriores e calcula, por cargo, os percentuais de treinamento e habilidades gerais em cada um.

**Necessita autenticação: **Sim

**Situação de versão: ** Atual

**Versão: **1

**Requisição: **

<soapenv:Envelope xmlns:soapenv=“http://schemas.xmlsoap.org/soap/envelope/” xmlns:ser=“http://services.senior.com.br”> <soapenv:Body> <ser:Apurar> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <numEmp>Integer</numEmp> <codCic>Integer</codCic> <perIni>String</perIni> <perFim>String</perFim> <cmpGer>String</cmpGer> <gerDem>String</gerDem> <regAnt>Integer</regAnt> <codReg>Integer</codReg> <lotExc>Integer</lotExc> <tipOpe>String</tipOpe> <codLot>Integer</codLot> <abrEmp>String</abrEmp> <abrTcl>String</abrTcl> <abrCad>String</abrCad> <abrLoc>String</abrLoc> <abrCar>String</abrCar> <abrSis>String</abrSis> </parameters> </ser:Apurar> </soapenv:Body> </soapenv:Envelope>

Parâmetros da requisição:

Nome

Preenchimento

Tipo

Descrição

numEmp

Opcional

Integer

Abrangência de empresas


codCic

Opcional

Integer

Campo do Ciclo



  • Deve-se informar de qual ciclo serão buscadas as avaliações a serem apuradas.

  • Este campo somente será considerado caso o assinalamento ‘Identifica Ciclo’ da tela de Definições Gerais de Avaliações de Desempenho e Competência for diferente de ‘3-Não’.

perIni

Opcional

DateTime

Data de Início da Apuração



  • Máscara: DD/MM/YYYY

perFim

Opcional

DateTime

Data de Término da Apuração



  • Máscara: DD/MM/YYYY

cmpGer

Opcional

DateTime

Data de Geração em que deverão ser considerados os percentuais verificados.



  • Máscara: MM/YYYY

gerDem

Opcional

String

Indica se os colaboradores demitidos no período deverão ser considerados.




Valores


S - Sim


N - Não

regAnt

Opcional

Integer

Regra Antes Incluir


codReg

Opcional

Integer

Regra Após Incluir


lotExc

Opcional

Integer

Lote de processamento


, caso o tipo da operação for “E - Excluir”

tipOpe

Obrigatório

String

Operação a ser realizada




Valores


P - Processar


E - Excluir

codLot

Opcional

Integer

Lote de processamento


abrEmp

Opcional

String

Abrangência de empresas


abrTcl

Opcional

String

Abrangência de tipos de colaborador




Valores:


1 - Empregado


2 - Terceiro


3 - Parceiro

abrCad

Opcional

String

Abrangência de cadastros de colaborador


abrLoc

Opcional

String

Abrangência de locais do organograma


abrCar

Opcional

String

Abrangência de cargos


abrSis

Opcional

String

Abrangência de sistemas


Resposta:

Nota

O envelope SOAP é retornado como resposta para requisições síncronas. Já para requisições assíncronas ou agendamentos, a resposta consiste apenas em uma string chamada result, que retorna o valor “OK” quando a execução ocorre com sucesso ou, em caso de falha, a mensagem do erro ocorrido.

<soapenv:Envelope xmlns:soapenv=“http://schemas.xmlsoap.org/soap/envelope/” xmlns:ser=“http://services.senior.com.br”> <soapenv:Body> <ser:ApurarResponse> <result> <erroExecucao>String</erroExecucao> </result> </ser:ApurarResponse> </soapenv:Body> </soapenv:Envelope>

Atributos da resposta:

Nome

Preenchimento

Tipo

Descrição

erroExecucao

Opcional

String

Indica erros ocorridos no servidor ao executar o serviço, podendo conter os seguintes valores:


  • Vazio ou nulo, indicando que a execução foi feita com sucesso;

  • A mensagem do erro ocorrido no servidor.

Este artigo ajudou você?