Skip to content
Renato Crivano edited this page Apr 16, 2018 · 2 revisions

Introdução

A transferência de dados entre o Siga e um sistema qualquer de RH é realizada através de um arquivo XML, com um formato específico para essa transferência.

O arquivo de transferência sempre carrega a totalidade dos dados existentes no momento da transferência, na situação em que se encontram. Mesmo se não houver nenhuma alteração na informação, ela é enviada. No caso de alguma exclusão, o dado ou registro excluído não é enviado. Nos casos em que há alteração de alguma espécie, o dado ou registro enviado é apenas o alterado. A disposição básica do arquivo é a seguinte:

Primeira linha: obrigatoriamente o conteúdo abaixo.

<?xml version="1.0" encoding="ISO-8859-1"?>

Elemento ‘base’: O elemento raiz do XML é o elemento ‘base’, contém a especificação do “órgão usuário”, que é um órgão interno da instituição a qual se deseja separar dos demais para fins administrativos.

   <base orgao="ZZ">

Abaixo do elemento ‘base’ são encontrados os seguites elementos:

  • cargos: cargos existentes no órgão/empresa em questão
    • cargo: dados de cada cargo
  • funcoes: funções exercidas no órgão
    • funcao: dados de cada função
  • orgaos: órgãos externos e outras empresas que se relacionam com o órgão
    • orgao: dados de cada órgão externo
  • lotacoes: lotações funcionais, unidades ou setores do órgão
    • lotacao: dados de cada lotação
  • pessoas: pessoas lotadas no órgão
    • pessoa: dados de cada pessoa vinculada ao órgão
      • papel dados sobre cada papel que determinada pessoa desempenha no órgão. uma mesma pessoa pode desempenhar vários papéis. A informação do papel é opcional

Segue abaixo um exemplo da estrutura do arquivo XML:

<?xml version="1.0" encoding="ISO-8859-1"?>
<base orgaoUsuario="ZZ">
	<cargos>
		<cargo nome="ANALISTA JUDICIARIO" id="240001"/>
	</cargos>
	<funcoes>
		<funcao nome="ASSISTENTE I" id="3"/>
	</funcoes>
	<lotacoes>
		<lotacao nome="DESENVOLVIMENTO" id="8631" idPai="8630" sigla="DESENV" /> 
		<lotacao nome="SECRETARIA DE INFORMÁTICA" id="8630" idPai="" sigla="INFO" /> 
	</lotacoes>
	<pessoas>
		<pessoa nome="ANGELICA" id="148238" funcaoConfianca="" email="[email protected]" lotacao="8631" situacao="1" cargo="240001" matricula="32017" grauInstrucao="" tipoSanguineo="A+" naturalidade="SC" nacionalidade="BRASILEIRA" dtNascimento="17091976" sexo="F" cpf="11111111111" rua="" bairro="" cidade="" uf="" cep="" dtInicioExercicio="" atoNomeacao="" dtNomeacao="" dtAtoPublicacao="" dtPosse="" padraoReferencia="" rg="12345678-9" rgOrgao="DIC" rgUf="" rgDtExp="02072008" estCivil="" sigla="AHP" tipo="" />
	</pessoas>
</base>

ATRIBUTOS

Cada um dos elementos cujo nome está no singular, a partir do elemento ‘base’, possui uma série de atributos que serão descritos a seguir.

base

  • orgaoUsuario: Atributo que contém a sigla do órgão do usuário.
  • dataHora: Atributo que contém a data e hora da geração do arquivo. Formato: "DD/MM/YYYY HH:MI:SS"
  • versao: Atributo que contém oúmero da versão do XML. Tamanho máximo de 3 caracteres.
  • aditionalEmails: Atributo que contém uma lista de endereços de e-mails separados por vírgula, para envido de e-mails para enderços que não constam do arquivo de configuração. Formato: “a@b, c@d, e@f”

Exemplo:

<base orgaoUsuario="TT" dataHora="01/02/2011 15:53:13" versao="2"  aditionalEmails=”[email protected],[email protected]”>   

cargo

  • id: atributo que contém o código identificador numérico do cargo no sistema de origem. Único.
  • nome: atributo que contém o nome do cargo. Tamanho máximo de 100 caracteres.
  • sigla: atributo que contém a sigla do cargo. Tamanho máximo de 30 caracteres. Único.

Exemplo:

<cargo id="2015" nome="ANALISTA JUDICIARIO/ANALISE DE SISTEMAS"  sigla="AAS” />

funcao

  • id: atributo que contém o código identificador numérico da função no sistema de origem. Único.
  • nome: atributo que contém o nome da função. Tamanho máximo de 100 caracteres.
  • sigla: atributo que contém a sigla da função. Tamanho máximo de 30 caracteres. Único.

Exemplo:

<funcao id="10" nome="DIRETOR DE SUBSECRETARIA" sigla=”DSS” />

orgao

  • id: atributo que contém o código identificador numérico do órgão no sistema de origem. Obrigatório. Único.
  • nome: atributo que contém o nome do órgão. Tamanho máximo de 256 caracteres alfanuméricos. Obrigatório.
  • sigla: atributo que contém a sigla do órgão. Tamanho máximo de 30 caracteres alfanuméricos. Obrigatório. Único.

Exemplo:

<orgao id="316" nome="Fundação Getúlio Vargas" sigla="FGV" />

lotacao

  • id: atributo que contém o código identificador numérico da lotação no sistema de origem. Obrigatório. Único.
  • nome: atributo que contém o nome da lotação. Tamanho máximo de 120 caracteres alfanuméricos. Obrigatório.
  • sigla: atributo que contém a sigla do órgão. Tamanho máximo de 20 caracteres alfanuméricos. Obrigatório. Único.
  • idPai: atributo que contém o código identificador numérico da lotação superior no sistema de origem. Não Obrigatório.
  • tipoLotação: atributo que contém a DESCRIÇÃO do tipo de lotação. Tamanho máximo de 200 caracteres alfanuméricos. Obrigatório.

Exemplo:

<lotacao id=" 625" nome=" Coordenadoria de Sistemas de Informação" sigla=" CSIS" idPai="" tipoLotacao="Unidade da Administração" />

pessoa

  • id: atributo que contém o código identificador numérico da pessoa no sistema de origem. Obrigatório. Único para quando o atributo ‘situacao’ contiver o valor “1”.
  • cpf: atributo que contém o CPF da pessoa, que normalmente é o ‘id’ no sistema de origem. Tamanho: 11 caracteres numéricos. Obrigatório. Único para quando o atributo ‘situacao’ contiver o valor “1”.
  • nome: atributo que contém o nome da pessoa. Tamanho máximo de 60 caracteres alfanuméricos. Obrigatório.
  • sexo: atributo que contém o sexo da pessoa. ‘F’ ou ‘M’. Obrigatório.
  • dtNascimento: atributo que contém a data de nascimento da pessoa. Formato: ‘DDMMYYYY’. Obrigatório.
  • nacionalidade: atributo que contém a descrição da nacionalidade da pessoa. Tamanho máximo de 60 caracteres alfanuméricos. Obrigatório.
  • rua: atributo que contém o logradouro, numero e complemento do enderço da pessoa. Tamanho máximo de 100 caracteres alfanuméricos. Obrigatório.
  • bairro: Atributo que contém o bairro do endereço da pessoa. Tamanho máximo de 50 caracteres alfanuméricos. Obrigatório.
  • cidade: Atributo que contém a cidade do endereço da pessoa. Tamanho máximo de 30 caracteres alfanuméricos. Obrigatório.
  • uf: Atributo que contém a UF do endereço da pessoa. Tamanho de 2 caracteres alfanuméricos. Obrigatório.
  • cep: Atributo que contém o CEP do endereço da pessoa. Tamanho de 8 caracteres numéricos. Obrigatório.
  • telefone: Atributo que contém o telefone da pessoa. Tamanho máximo de 30 caracteres alfanuméricos. Obrigatório.
  • naturalidade: Atributo que contém a naturalidade da pessoa. Tamanho máximo de 60 caracteres alfanuméricos. Obrigatório.
  • tipoSanguineo: Atributo que contém o tipo sanguíneo da pessoa. Tamanho de 3 caracteres alfanuméricos. Obrigatório.
  • grauInstrucao: Atributo que contém a descrição do grau de instrução da pessoa. Tamanho máximo de 50 caracteres alfanuméricos. Obrigatório.
  • matricula: Atributo que contém a matrícula da pessoa. Tamanho máximo de 8 caracteres numéricos. Obrigatório. Único.
  • dtInicioExercicio: Atributo que contém a data de início de exercício da pessoa. Formato: ‘DDMMYYYY’.
  • atoNomeacao: Atributo que contém o número do ato de nomeação da pessoa. Tamanho máximo de 50 caracteres alfanuméricos. Obrigatório.
  • dtNomeacao: Atributo que contém a data de nomeação da pessoa. Formato: ‘DDMMYYYY’.
  • dtAtoPublicacao: Atributo que contém a data de publicação da nomeação da pessoa. Formato: ‘DDMMYYYY’.
  • dtPosse: Atributo que contém a data de posse da pessoa. Formato: ‘DDMMYYYY’.
  • cargo: Atributo que contém o ‘id’ do cargo, atributo existente em um elemento ‘cargo’. Tamanho máximo de 10 caracteres numéricos. Obrigatório.
  • padraoReferencia: Atributo que contém a composição da classe com o nível do cargo e com o nível dentro do cargo. Os elementos desta composição vêm separados por ‘-‘ (traço). Tamanho máximo de 16 caracteres alfanuméricos. Obrigatório.
  • situacao: Atributo que possui o código da situação funcional (id na tabela da entidade) da pessoa. Tamanho máximo de 5 caracteres numéricos. Obrigatório.
  • lotacao: Atributo que possui o identificador da lotação de uma pessoa, existente em um elemento ‘lotacao’. Tamanho máximo de 5 caracteres numéricos. Obrigatório.
  • rg: Atributo que possui o número do RG de uma pessoa. Tamanho máximo de 20 caracteres alfanuméricos. Obrigatório.
  • rgOrgao: Atributo que possui a descrição do órgão expedidor do RG da pessoa. Tamanho máximo de 50 caracteres alfanuméricos. Obrigatório.
  • rgUf: Atributo que possui a sigla da unidade da Federação do órgão emissor do RG da pessoa. Tamanho de 2 caracteres. Obrigatório.
  • rgDtExp: Atributo que possui a data de expedição do RG da pessoa. Formato: ‘DDMMYYYY’.
  • estCivil: Atributo que possui o código do estado civil da pessoa. Tamanho máximo de 22 caracteres numéricos. Obrigatório.
  • sigla: Atributo que possui a sigla da pessoa. Tamanho máximo de 10 caracteres alfanuméricos. Obrigatório. Único.
  • email: Atributo que possui o endereço de e-mail da pessoa. Tamanho máximo de 60 caracteres alfanuméricos. Obrigatório.
  • funcaoConfianca: Atributo que contém o ‘id’ da função da pessoa, atributo existente em um elemento ‘funcao’. Tamanho máximo de 10 caracteres numéricos.
  • tipo: Atributo que contém a descrição do tipo de pessoa. Tamanho de 60 caracteres alfanuméricos. Obrigatório.

Exemplo:

<pessoa id="22222222222" cpf="22222222222" nome="CARLOS JOSE MANOEL" sexo="M"     
  dtNascimento="02111966"  nacionalidade="BRASILEIRA" rua="Av. Presidente Vargas" bairro="CENTRO" 
  cidade="RIO DE JANEIRO" uf="RJ" cep="20000000" telefone="222-2222" naturalidade="" tipoSanguineo="O+" 
  grauInstrucao="SUPERIOR COMPLETO" matricula="64262" dtInicioExercicio="14121972" atoNomeacao="000" 
  dtNomeacao="14121972" dtAtoPublicacao="" dtPosse="14121972" cargo="46" padraoReferencia="C-NS-15" 
  situacao="1" lotacao="1410000000000" rg="0120123456" rgOrgao="IFP" rgUf="RJ" rgDtExp="01021982" 
  estCivil="1" sigla="CJM" email="[email protected]" funcaoConfianca="90">  
    <papel> ... </papel>
	...
</pessoa>

papel

  • id: atributo que contém o código identificador numérico do papel da pessoa no sistema de origem. Obrigatório. Único.
  • tipo: atributo que contém a descrição do tipo de papel da pessoa. Tamanho de 60 caracteres alfanuméricos. Obrigatório.
  • cargo: Atributo que contém o ‘id’ do cargo, atributo existente em um elemento ‘cargo’. Tamanho máximo de 10 caracteres numéricos. Obrigatório.
  • funcaoConfianca: Atributo que contém o ‘id’ da função do papel da pessoa, atributo existente em um elemento ‘funcao’. Tamanho máximo de 10 caracteres numéricos. Obrigatório.
  • lotacao: Atributo que possui o identificador da lotação do papel da pessoa, existente em um elemento ‘lotacao’. Tamanho máximo de 5 caracteres numéricos. Obrigatório.

Exemplo:

<papel 	id="4532" tipo="Principal" cargo="8" funcaoConfianca="52" lotacao="1120000000000" />

Notas

  1. Os atributos que não são obrigatórios devem existir no elemento, com conteúdo “” . Ex: idPai=”” .
  2. Os atributos que são únicos devem possuir o seu conteúdo apenas em um elemento de mesmo nome.
  3. todos os campos de nome ‘id’ do XML de importação possuem um tamanho máximo de 256 caracteres.
  4. Futuramente, os tributos ‘cargo’, ‘funcaoConfianca’ e ‘lotacao’ deixarão de existir no elemento ‘pessoa’ e somente existirão no elemento ‘papel’.

Códigos Utilizados nos Atributos

Tipo de Lotação

O tipo de lotação define uma classificação funcional da lotação. Por exemplo, pode definir se uma determinada lotação é uma unidade da administração, se é uma unidade jurídica, etc.; podendo ainda ir a um nível de detalhe mais específico, determinando se é uma vara criminal, etc.

Id Descrição Sigla
1 Unidade da Administração ADM
100 Unidade Judicial JUD

Tipo de Pessoa

O tipo de pessoa define uma classificação da pessoa em relação a sua origem funcional. Por exemplo, pode definir se uma determinada pessoa é um estagiário, um servidor, um juiz ou um tercerizado.

Id Descrição
1 Magistrado
2 Servidor
3 Estagiário
4 Terceirizado

Situação funcional

Define a situação em que se encontra a pessoa em termos funcionais.

Id Descrição
1 ATIVO
2 CEDIDO
3 POSSE EM CARGO INACUMULAVEL
4 APOSENTADO
5 EXONERADO
6 DEMITIDO
7 FALECIDO
9 RETORNO PARA ORGAO DE ORIGEM
10 TRANSFERIDO
11 LICENCA PARA ACOMPANHAR CONJUJE SEM REMUNERACAO
12 LICENCA PARA ACOMPANHAR CONJUJE COM EXERCICIO PROVISORIO
13 LICENCA PARA MANDATO CLASSISTA
14 LICENCA PARA ASSUNTOS PARTICULARES
15 ESTAGIARIO DESLIGADO (SADES)
16 DISPONIBILIDADE
17 REMOVIDO
18 AFASTAMENTO POR DECISAO JUDICIAL
19 POSSE ANULADA
20 REDISTRIBUIDO
21 PROMOVIDO TRF
23 LICENCA PARA CURSO DE FORMACAO
25 LICENCA PARA ATIVIDADE POLITICA
26 AFASTAMENTO PARA MANDATO ELETIVO
29 LICENCA PARA CAPACITACAO
30 AFASTAMENTO PARA ESTUDO/MISSAO EXTERIOR
31 REMOVIDO - LEI 11.416/06

Tipo de Papel

Define a situação em que se encontra a pessoa em termos funcionais.

Id Descrição
1 Principal
2 Funcional

Exemplo de XML Completo

Segue um exemplo de um arquivo de importação com todos os elementos (dados incompletos e com informações fictícias):

<?xml version="1.0" encoding="UTF-8"?>
<base orgaoUsuario="TT" dataHora="08/02/2011 14:34:22" versao="2" aditionalEmails="[email protected]">
   <cargos>
      <cargo id="7" nome="JUIZ FEDERAL" sigla="JFD" />
      <cargo id="8" nome="JUIZ SUBSTITUTO - 2" sigla="JSB" />
      <cargo id="10" nome="TÉCNICO JUDICIÁRIO" sigla="TJD" />
      <cargo id="14" nome="OFICIAL DE JUSTIÇA AVALIADOR" sigla="OJA" />
      <cargo id="16" nome="TAQUIGRAFO JUDICIARIO" sigla="TQJ" />
      <cargo id="46" nome="ENGENHEIRO" sigla="ENG" />
      <cargo id="64" nome="ANALISTA DE SISTEMAS" sigla="ANL" />
      <cargo id="2131" nome="ANALISTA JUDICIARIO/INFORMATICA" sigla="AJI" />
      <cargo id="2132" nome="TECNICO JUDICIARIO/INFORMATICA" sigla="TJI" />
   </cargos>
   <funcoes>
      <funcao id="1" nome="DIRETOR GERAL" sigla="DGG" />
      <funcao id="5" nome="DIRETOR DE SECRETARIA - 2" sigla="DSC" />
      <funcao id="10" nome="DIRETOR DE SUBSECRETARIA" sigla="DSS" />
      <funcao id="65" nome="SUPERVISOR" sigla="SUP" />
      <funcao id="70" nome="SUPERVISOR ASSISTENTE" sigla="SPA" />
      <funcao id="75" nome="ASSISTENTE DE INFORMATICA" sigla="ASI" />
      <funcao id="80" nome="ASSISTENTE DATILÓGRAFO" sigla="DTL" />
      <funcao id="85" nome="SECRETÁRIO" sigla="SEC" />
      <funcao id="90" nome="AUXILIAR ESPECIALIZADO" sigla="AUE" />
      <funcao id="95" nome="AUXILIAR" sigla="AUX" />
      <funcao id="105" nome="OPERADOR XEROX E TELEX" sigla="OXT" />
      <funcao id="106" nome="OPERADOR DE VÍDEO" sigla="OVD" />
      <funcao id="110" nome="EXECUTANTE DE MANDADOS" sigla="EMD" />
   </funcoes>
   <orgaos>
      <orgao id="316" nome="FUNDACAO GETULIO VARGAS" sigla="FGV" />
      <orgao id="278" nome="BOLSA DE VALORES DE SAO PAULO" sigla="BOVESPA" />
   </orgaos>
   <lotacoes>
      <lotacao id="0" nome="SEÇÃO JUDICIÁRIA da GUANABARA" idPai="" sigla="SJGN" tipoLotacao="Unidade Judicial" />
      <lotacao id="1040000000000" nome="DIR. DE INFORMATICA" sigla="DIINFO" idPai="0" tipoLotacao="Unidade da Administração" />
      <lotacao id="1380000000000" nome="GERÊNCIA DE RISCOS" sigla="GERISC" idPai="1040000000000" tipoLotacao="Unidade da Administração" />
      <lotacao id="1390000000000" nome="VARA FEDERAL VXIIM" sigla="VFXIIM" idPai="0" tipoLotacao="Unidade Judicial" />
      <lotacao id="1400000000000" nome="VARA FEDERAL MXXVII" sigla="VFXXVI" idPai="0" tipoLotacao="Unidade Judicial" />
      <lotacao id="1410000000000" nome="VARA FEDERAL VLMXXI" sigla="VFLMXX" idPai="0" tipoLotacao="Unidade Judicial" />
   </lotacoes>
   <pessoas>
      <pessoa id="11111111111" cpf="11111111111" nome="JOSE JORGE DA SILVA PEREIRA" dtNascimento="17031965" nacionalidade="BRASILEIRA" rua="Av. Rio Branco 1/ ap.10017" bairro="CENTRO" cidade="RIO DE JANEIRO" uf="RJ" cep="20000000" telefone="333-2212" naturalidade="RIO DE JANEIRO" tipoSanguineo="O+" grauInstrucao="SUPERIOR COMPLETO" matricula="60022" dtInicioExercicio="07011971" atoNomeacao="000" dtNomeacao="07011971" dtAtoPublicacao="" dtPosse="07011971" cargo="10" padraoReferencia="C-NS-15" situacao="1" lotacao="1380000000000" rg="765412334" rgOrgao="CAER" rgUf="RJ" rgDtExp="01012020" sigla="XWM" email="[email protected]" funcaoConfianca="75" tipo="Servidor">
         <papel id="3128" tipo="Principal" cargo="10" funcaoConfianca="75" lotacao="1380000000000" />
      </pessoa>
      <pessoa id="22222222222" cpf="22222222222" nome="CARLOS JOSE MANOEL" sexo="M" dtNascimento="02111966" nacionalidade="BRASILEIRA" rua="Av. Presidente Vargas" bairro="CENTRO" cidade="RIO DE JANEIRO" uf="RJ" cep="20000000" telefone="222-2222" naturalidade="" tipoSanguineo="O+" grauInstrucao="SUPERIOR COMPLETO" matricula="64262" dtInicioExercicio="14121972" atoNomeacao="000" dtNomeacao="14121972" dtAtoPublicacao="" dtPosse="14121972" cargo="46" padraoReferencia="C-NS-15" situacao="1" lotacao="1410000000000" rg="0120123456" rgOrgao="IFP" rgUf="RJ" rgDtExp="01021982" estCivil="1" sigla="CJM" email="[email protected]" funcaoConfianca="90" tipo="Magistrado">
         <papel id="3129" tipo="Principal" cargo="46" funcaoConfianca="90" lotacao="1380000000000" />
         <papel id="3131" tipo="Funcional" cargo="46" funcaoConfianca="75" lotacao="1400000000000" />
      </pessoa>
      <pessoa id="33333333333" cpf="33333333333" nome="SILVIA AUREA PLATINA" sexo="F" dtNascimento="28041966" nacionalidade="BRASILEIRA" rua="Av. Sete de Setembro 3728/ ap.107" bairro="CENTRO" cidade="RIO DE JANEIRO" uf="RJ" cep="20000000" telefone="321-1212" naturalidade="RIO DE JANEIRO" tipoSanguineo="O+" grauInstrucao="SUPERIOR COMPLETO" matricula="56708" dtInicioExercicio="22051978" atoNomeacao="000" dtNomeacao="04051978" dtAtoPublicacao="" dtPosse="22051978" cargo="64" padraoReferencia="C-NS-15" situacao="1" lotacao="1400000000000" rg="013456376" rgOrgao="IFP" rgUf="RJ" sigla="SAP" email="[email protected]" funcaoConfianca="" tipo="Servidor">
         <papel id="3130" tipo="Principal" cargo="64" funcaoConfianca="" lotacao="1400000000000" />
      </pessoa>
   </pessoas>
</base>
Clone this wiki locally