Web service com.senior.g5.rh.rs.cursos
Tipo de execução
Para cada tipo de execução, existem diferentes parâmetros que podem ser comuns a todas as portas.
Autenticação
Caso seja utilizada alguma forma de autenticação para integração de informações através de web services, é necessário identificado o tipo no parâmetro <encryption>, conforme seus valores possíveis.
WSDL
- Síncrono: http://example.com/g5-senior-services/rs_Synccom_senior_g5_rh_rs_cursos?wsdl
- Assíncrono: http://example.com/g5-senior-services/rs_Asynccom_senior_g5_rh_rs_cursos?wsdl
- Agendado: http://example.com/g5-senior-services/rs_Scheduledcom_senior_g5_rh_rs_cursos?wsdl
Portas
CursosFormacao
Web service usado para cadastrar os cursos de formação que serão utilizados nos requisitos dos cargos como também aqueles indicados no currículo dos candidatos. Também deverão ser cadastrados os cursos que farão parte do histórico de cursos de formação dos colaboradores.
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:CursosFormacao> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <tipOpe>String</tipOpe> <numEmp>Integer</numEmp> <codCuf>Integer</codCuf> <nomCuf>String</nomCuf> <nomRed>String</nomRed> <codAss>Integer</codAss> <nivCuf>Integer</nivCuf> <seqNiv>Integer</seqNiv> <tipDur>Integer</tipDur> <temDur>Integer</temDur> <chrCuf>String</chrCuf> <conWeb>String</conWeb> </parameters> </ser:CursosFormacao> </soapenv:Body> </soapenv:Envelope>
Parâmetros da requisição:
Nome | Preenchimento | Tipo | Descrição |
---|---|---|---|
tipOpe | Obrigatório | String | Tipo de operação
Valores: I - Inclusão A - Alteração E - Exclusão |
numEmp | Obrigatório | Integer | Código da empresa que será utilizada na integração.
|
codCuf | Opcional | Integer | Código do curso de formação.
- Chave Observações: Na inclusão, este campo poderá ser deixado em branco e o sistema encontrará o próximo código livre. |
nomCuf | Opcional | String | Descrição do curso de formação.
Exemplo: 1º grau incompleto, 1º grau completo, 2º completo. -Obrigatório |
nomRed | Opcional | String | Nome reduzido do curso de formação.
Exemplo: Primário, Ginásio. -Obrigatório |
codAss | Opcional | Integer | Assunto no qual se refere o curso de formação.
Exemplo: Engenharias, profissionalizante, ensino básico. -Obrigatório |
nivCuf | Opcional | Integer | Nível de cada curso de formação.
-Obrigatório |
seqNiv | Opcional | Integer | Sequência do nível de curso de formação. Para um mesmo nível é possível cadastrar várias sequências, caso sejam oferecidos cursos de um mesmo nível com o número de fases diferentes.
-Obrigatório |
tipDur | Opcional | Integer | Indicar o tipo de duração do curso:
1 - Horas 2 - Dias 3 - Meses 4 - Anos 5 - Semestre -Opcional Quando executado pelo CS ou RS, deixar a informação deste campo nula. |
temDur | Opcional | Integer | Quantidade do tipo de duração que foi informado no campo anterior.
Exemplo: Se foi indicado 3-Meses no campo anterior, e este curso tem duração de 6 meses, indicar 6 neste campo. -Opcional Quando executado pelo CS ou RS, deixar a informação deste campo nula. |
chrCuf | Opcional | Time | Carga horária correspondente para o curso em questão.
-Opcional Quando executado pelo CS ou RS, deixar a informação deste campo nula. |
conWeb | Opcional | String | Identifica se o curso será disponibilizado no currículo web.
Valores: - S (Sim) - N (Não) -Obrigatório Quando executado pelo CS ou TR, deixar a informação deste campo nula. |
Resposta:
Observação
Envelope SOAP de resposta de requisições síncronas. Para requisições assíncronas ou agendamentos, a resposta é apenas uma String chamada "result" com o valor "OK", se foi executado com sucesso ou, caso contrário, 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:CursosFormacaoResponse> <result> <codCuf>Integer</codCuf> <erroExecucao>String</erroExecucao> </result> </ser:CursosFormacaoResponse> </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. |
codCuf | Opcional | Integer | Código do curso de formação.
- Chave Observações: Na inclusão, este campo poderá ser deixado em branco e o sistema encontrará o próximo código livre. |
CursosAperfeicoamento_2
Este web service nos possibilita incluir cursos exigidos a título de aperfeiçoamento do ocupante do cargo. Também podemos cadastrar os cursos ministrados na empresa e os cursos que os colaboradores trazem em seu currículo.
Necessita autenticação: Sim
Situação de versão: Atual
Versão: 2
Requisição:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br"> <soapenv:Body> <ser:CursosAperfeicoamento_2> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <tipOpe>String</tipOpe> <nomRed>String</nomRed> <tipOpeGrid2>String</tipOpeGrid2> <tipOpeGrid3>String</tipOpeGrid3> <tipOpeGrid4>String</tipOpeGrid4> <tipOpeGrid5>String</tipOpeGrid5> <tipOpeGrid6>String</tipOpeGrid6> <tipOpeGrid7>String</tipOpeGrid7> <tipOpeGrid8>String</tipOpeGrid8> <tipOpeGrid9a>String</tipOpeGrid9a> <tipOpeGrid9b>String</tipOpeGrid9b> <tipOpeGrid0>String</tipOpeGrid0> <datAlt>String</datAlt> <tipOpeGrid12>String</tipOpeGrid12> <qtdRecDis>String</qtdRecDis> <numEmp>Integer</numEmp> <codAss>Integer</codAss> <wGD128RCF> <curso>Integer</curso> </wGD128RCF> <wGD128RCA> <curso>Integer</curso> </wGD128RCA> <wGD128RCN> <familia>String</familia> <conhecimento>String</conhecimento> </wGD128RCN> <wGD128FAS> <fase>String</fase> <descricao>String</descricao> </wGD128FAS> <wGD128CUR> <recurso>Integer</recurso> <quantidade>Integer</quantidade> </wGD128CUR> <wGD128HOR> <codigo>Integer</codigo> </wGD128HOR> <wGD128TES> <teste>String</teste> <qtdPerguntas>Integer</qtdPerguntas> </wGD128TES> <wGD128CUN> <itemNota>Integer</itemNota> <peso>Integer</peso> </wGD128CUN> <wGD128COM> <codigo>Integer</codigo> </wGD128COM> <obsRev>String</obsRev> <wGD128COA> <familia>String</familia> <conhecimento>Integer</conhecimento> </wGD128COA> <codCua>Integer</codCua> <tipCua>String</tipCua> <tipOpeGrid11>String</tipOpeGrid11> <nomCua>String</nomCua> <emiCer>String</emiCer> <wGD128PAN> <itemNota>Integer</itemNota> <peso>Integer</peso> </wGD128PAN> <valCua>Integer</valCua> <conFre>Integer</conFre> <tipDur>Integer</tipDur> <temDur>Integer</temDur> <chrCua>String</chrCua> <freCua>Double</freCua> <medCua>Double</medCua> <tipCer>String</tipCer> <codTst>String</codTst> <iniEfi>Integer</iniEfi> <praAva>Integer</praAva> <metEfi>Integer</metEfi> <praARe>Integer</praARe> <tipRea>Integer</tipRea> <turCua>String</turCua> <codFlt>Integer</codFlt> <regInc>Integer</regInc> <regExc>Integer</regExc> <regTrf>Integer</regTrf> <regSub>Integer</regSub> <perRsv>String</perRsv> <codUsu>Integer</codUsu> <desCon>String</desCon> <desObu>String</desObu> <metCua>String</metCua> <pubAlv>String</pubAlv> <nomArq>String</nomArq> <conWeb>String</conWeb> <conPdi>String</conPdi> <criRep>Integer</criRep> <datExp>String</datExp> <curTlt>Integer</curTlt> <abrLoc>String</abrLoc> <avaTlt>Integer</avaTlt> </parameters> </ser:CursosAperfeicoamento_2> </soapenv:Body> </soapenv:Envelope>
Parâmetros da requisição:
Nome | Preenchimento | Tipo | Descrição |
---|---|---|---|
tipOpe | Opcional | String | Tipo da operação a ser efetuada na integração
Valores: I - Inclusão A - Alteração E - Exclusão |
nomRed | Opcional | String | Nome reduzido do curso.
Exemplo: Curso de Inglês. -Obrigatório |
tipOpeGrid2 | Opcional | String | |
tipOpeGrid3 | Opcional | String | |
tipOpeGrid4 | Opcional | String | |
tipOpeGrid5 | Opcional | String | |
tipOpeGrid6 | Opcional | String | |
tipOpeGrid7 | Opcional | String | |
tipOpeGrid8 | Opcional | String | |
tipOpeGrid9a | Opcional | String | |
tipOpeGrid9b | Opcional | String | |
tipOpeGrid0 | Opcional | String | |
datAlt | Opcional | DateTime | |
tipOpeGrid12 | Opcional | String | Ação a ser efetuada na integração
Valores: I - Inclusão A - Alteração E - Exclusão |
qtdRecDis | Opcional | String | Informar se deseja proceguir quando a quantidade digitada for maior que a quantidade de recurso disponível
Valores: S - Sim N - Não |
numEmp | Obrigatório | Integer | Código da empresa que será utilizada na integração.
|
codAss | Opcional | Integer | Informar o código do assunto que será abordado no curso.
|
wGD128RCF | Opcional | Set | |
wGD128RCF.curso | Opcional | Integer | |
wGD128RCA | Opcional | Set | |
wGD128RCA.curso | Opcional | Integer | |
wGD128RCN | Opcional | Set | |
wGD128RCN.familia | Opcional | String | |
wGD128RCN.conhecimento | Opcional | String | |
wGD128FAS | Opcional | Set | |
wGD128FAS.fase | Opcional | String | |
wGD128FAS.descricao | Opcional | String | |
wGD128CUR | Opcional | Set | |
wGD128CUR.recurso | Opcional | Integer | |
wGD128CUR.quantidade | Opcional | Integer | |
wGD128HOR | Opcional | Set | |
wGD128HOR.codigo | Opcional | Integer | |
wGD128TES | Opcional | Set | |
wGD128TES.teste | Opcional | String | |
wGD128TES.qtdPerguntas | Opcional | Integer | |
wGD128CUN | Opcional | Set | Informar os ítens de avaliação do curso. |
wGD128CUN.itemNota | Opcional | Integer | Indicar o código do item nota referente ao ítens de avaliação dos participantes.
|
wGD128CUN.peso | Opcional | Integer | Indicar o peso referente ao item nota.
|
wGD128COM | Opcional | Set | Informar as disciplinas que serão ministradas no curso. |
wGD128COM.codigo | Opcional | Integer | Indicar o código da disciplina a ser ministrada no curso.
|
obsRev | Opcional | String | |
wGD128COA | Opcional | Set | Informar os conhecimentos adquiridos.
Identificar a família e conhecimento. |
wGD128COA.familia | Opcional | String | Indicar o código da família referente aos conhecimento adquiridos que serão informados.
OBS.: Este campo é obrigatório mesmo quando definido família padrão. |
wGD128COA.conhecimento | Opcional | Integer | Indicar o código do curso de conhecimento adquirido referente a família escolhida.
|
codCua | Opcional | Integer | Código do curso de aperfeiçoamento.
- Chave Observações: Na inclusão, este campo poderá ser deixado em branco e o sistema encontrará o próximo código livre. |
tipCua | Opcional | String | Neste item deve ser indicado se o curso é modular ou não.
Na pasta Disciplinas, serão informados os cursos que compõem o curso modular. Exemplo: Curso modular: Mecânica e como Disciplinas: Interpretação de Desenho, Matemática básica, Práticas em Mecânica, etc. S-Sim, este curso será utilizado como modular N-Não, o tratamento para este curso será o padrão -Obrigatório |
tipOpeGrid11 | Opcional | String | |
nomCua | Opcional | String | Descrição completa do curso de aperfeiçoamento.
Exemplo: Técnico em Segurança do Trabalho. -Obrigatório |
emiCer | Opcional | String | Informações válidas:
S-Sim, os certificados para cada disciplina serão emitidos N-Não, somente o certificado do curso modular será emitido -Obrigatório |
wGD128PAN | Opcional | Set | Informar os ítens de avaliação dos participantes. |
wGD128PAN.itemNota | Opcional | Integer | Indicar o código do item nota referente ao ítens de avaliação dos participantes.
|
wGD128PAN.peso | Opcional | Integer | Indicar o peso referente ao item nota.
|
valCua | Opcional | Integer | Informar o número de meses de validade do curso, se não houver, deixar em branco. É com base nesta informação comparada com a data do fim do curso no histórico do colaborador ou candidato que o curso é considerado válido ou vencido.
|
conFre | Opcional | Integer | Este campo define a forma de controlar a frequência no curso.
0 - Quantidade de aulas 1 - Carga horária |
tipDur | Opcional | Integer | Indicar o tipo de duração do curso, conforme a seguir:
1-Horas 2-Dias 3-Meses 4-Anos 5-Semestre Quando for informado tipo de duração horas, não será necessário o registro da duração, pois a informação carga horária será suficiente. |
temDur | Opcional | Integer | Indicar a quantidade do tipo de duração que foi informado no dado anterior.
Exemplo: Se foi indicado 3=meses no dado anterior, e este curso tem duração de 06 meses, indicar 6 neste campo. -Opcional |
chrCua | Opcional | Time | Informar a carga horária total do curso.
Este valor será sugerido no cadastramento de uma turma, no histórico de curso do colaborador e no histórico geral de cursos. |
freCua | Opcional | Double | Informar o percentual de frequência necessário para aprovação no curso.
Este percentual será considerado na avaliação do participante. |
medCua | Opcional | Double | Informar a média mínima para aprovação no curso.
|
tipCer | Opcional | String | Identifica qual o tipo de certificado será emitido ao participantes que fizeram este curso.
A-Aproveitamento - será gerado para o colaborador um histórico de curso com o tipo A P-Participação - será gerado para o colaborador um histórico de curso com o tipo P N-Nenhum - não será gerado o histórico de curso para o colaborador -Opcional |
codTst | Opcional | String | Informar o código do questionário que será utilizado na avaliação de eficácia do treinamento. Este questionário deverá estar previamente cadastrado em Treinamento/Turmas/Avaliação de Eficácia/Questionário.
|
iniEfi | Opcional | Integer | Informar a quantidade de dias que será utilizado para a contagem da data que a avaliação ficará disponível para o usuário responder.
Será contado a partir do dia seguinte da data de término do treinamento. |
praAva | Opcional | Integer | Informar a quantidade de dias que o avaliador possui para executar a avaliação de eficácia.
Será utilizada para a contagem do prazo, que inicia no dia seguinte da data de término do treinamento. |
metEfi | Opcional | Integer | Informar a meta para avaliação de eficácia.
É um percentual de 0 a 100 que indica qual percentual mínimo dos avaliadores devem avaliar evento como eficaz para o evento como um todo ser considerado eficaz. |
praARe | Opcional | Integer | Informar a quantidade de dias que o participante possui para responder a avaliação de reação.
Será utilizada para a contagem do prazo, que inicia no dia seguinte da data de término do treinamento. |
tipRea | Opcional | Integer | Informar a forma de realização do curso de aperfeiçoamento. Exemplos:
Interno Externo Aberto Externo Fechado Efeito Multiplicador Externo Fechado Efeito Multiplicador Externo Aberto No Exterior - Aberto No Exterior - Fechado E-Learning Síncrono E-Learning Assíncrono -Obrigatório |
turCua | Opcional | String | Informar o período de realização do curso, conforme abaixo:
M - Matutino V - Vespertino N - Noturno D - Diurno -Obrigatório |
codFlt | Opcional | Integer | Informar o código da regra a ser utilizado em cada curso de aperfeiçoamento, para pré-requisitos não previstos pelo sistema.
|
regInc | Opcional | Integer | Informar o código da regra que será utilizada na Inclusão de participantes e/ou integrantes da lista de espera.
Esta regra somente terá validade para a versão WEB. |
regExc | Opcional | Integer | Informar o código da regra que será utilizada na exclusão de participantes e/ou integrantes da lista de espera.
Esta regra somente terá validade para a versão WEB. |
regTrf | Opcional | Integer | Informar o código da regra que será utilizada na transferência de participantes desta turma para a lista de espera de uma outra turma.
Esta regra terá validade somente na versão WEB. |
regSub | Opcional | Integer | Informar o código da regra que será utilizada na substituição de participante para este curso/turma.
Esta regra terá validade somente na versão WEB. O substituto ficará relacionado na lista de espera da turma do substituído e este será excluído da sua turma voltando para a lista de espera. |
perRsv | Opcional | String | Informar quem possui permissão para efetuar reservas em cursos de aperfeiçoamento:
T - Todos C - Coordenador do Curso Se informar T=Todos, qualquer pessoa da empresa poderá efetuar reserva em cursos de aperfeiçoamento, caso informar C=Coordenador do Curso, somente o coordenador indicado na tela do Curso de Aperfeiçoamento poderá efetuar esta reserva. -Obrigatório |
codUsu | Opcional | Integer | Informar o código do coordenador do curso.
Existe uma associação entre o código de usuário e um colaborador cadastrado (empregado, terceiro ou parceiro) através da ficha cadastral. |
desCon | Opcional | String | Espaço para registro do conteúdo programático de cada curso.
|
desObu | Opcional | String | Espaço para registrar os objetivos de cada curso.
|
metCua | Opcional | String | Espaço para registrar a metodologia utilizada ou exigida para o curso.
|
pubAlv | Opcional | String | Espaço para informar o público alvo do curso.
|
nomArq | Opcional | String | Espaço para informar caminho do arquivo
|
conWeb | Opcional | String | Considerar no preenchimento do currículo Web.
Este campo só está disponível no módulo RS. |
conPdi | Opcional | String | Define se o curso será considerado na rotina de Plano de Desenvolvimento Individual (PDI).
Apenas poderá informar 'S' quando o assunto associado ao curso de aperfeiçoamento estiver cadastrado com o campo Auxilia Avaliação = 'S'. |
criRep | Opcional | Integer | Define se a reprovação será por média ou frequência quando ambas estiverem abaixo do mínimo.
0 - Reprovar por média 1 - Reprovar por frequência |
datExp | Opcional | DateTime | - Permite informar a data de expiração do curso.
- Ao alterar, a data de expiração não deve ser inferior a data de início ou térnmino do curso. |
curTlt | Opcional | Integer | - Permite informar se o curso será um TLT.
1 - Sim 2 - Não |
abrLoc | Opcional | String | - Permite especificar a abrangência dos locais que utilizam o TLT.
Obs: Somente ficará habilitado caso o campo Treinamento Local Trabalho esteja com "1". |
avaTlt | Opcional | Integer | - Permite informar se o TLT terá avaliação.
Obs: Somente ficará habilitado caso o campo Treinamento Local Trabalho esteja com "1". 1 - Sim 2 - Não |
Resposta:
Observação
Envelope SOAP de resposta de requisições síncronas. Para requisições assíncronas ou agendamentos, a resposta é apenas uma String chamada "result" com o valor "OK", se foi executado com sucesso ou, caso contrário, 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:CursosAperfeicoamento_2Response> <result> <codCua>Integer</codCua> <erroExecucao>String</erroExecucao> </result> </ser:CursosAperfeicoamento_2Response> </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. |
codCua | Opcional | Integer | Código do curso de aperfeiçoamento.
- Chave Observações: Na inclusão, este campo poderá ser deixado em branco e o sistema encontrará o próximo código livre. |