ESPECIFICAÇÃO TÉCNICA DE SERVIÇO

(PERFIL DO SERVIÇO)

Magistrado

MagistradoService
Entidade

Versão 0.1
10/09/2015

Projeto: Implantação SOA TJSC Emissão: 10/09/2015 Arquivo: 527530946.docx 1/12

Contrato 048/2015 - OS 06/2015
Projeto: Implantação SOA TJSC Emissão: 10/09/2015 Arquivo: 527530946.docx 2/12
Contrato 048/2015 - OS 06/2015
 HISTÓRICO DE REVISÃO
Data Versão Descrição Autores
10/09/2015 0.1 Versão de análise do Perfil de Ricardo S. Puttini
Serviço Valéria Guimarães
SUMÁRIO

1 INTRODUÇÃO..............................................................................................................................................4
1.1 OBJETIVO...............................................................................................................................................4
1.2 ESCOPO DO DOCUMENTO.....................................................................................................................4
1.3 REFERÊNCIAS........................................................................................................................................4
2 MAGISTRADOSERVICE V1R0.................................................................................................................5
2.1 IDENTIFICAÇÃO DO SERVIÇO.................................................................................................................5
2.2 ESPECIFICAÇÃO TÉCNICA.....................................................................................................................5
2.2.1 Contexto Funcional........................................................................................................................5
2.2.2 Capacidades do Serviço...............................................................................................................5
2.2.3 Tipologia..........................................................................................................................................6
2.2.4 Contrato...........................................................................................................................................6
2.2.5 Descrição da Lógica (opcional)...................................................................................................6
2.2.6 Estruturas de Dados......................................................................................................................6
2.2.7 Regras de Negócio (opcional).....................................................................................................6
2.2.8 Segurança.......................................................................................................................................6
2.2.9 Políticas de Uso.............................................................................................................................6
2.2.10 SLA..............................................................................................................................................6
2.2.11 Especificações Adicionais (Não Funcionais) (opcional).....................................................6
2.2.12 Arquitetura do Serviço..............................................................................................................7
2.2.13 Configuração do Serviço (Implantação)................................................................................7
2.2.14 Dependências............................................................................................................................7
2.2.15 Tecnologias de Implementação..............................................................................................7
2.3 GOVERNANÇA........................................................................................................................................7
2.3.1 Guardião..........................................................................................................................................7
2.3.2 Desenvolvedores...........................................................................................................................7
2.3.3 Contratos Concorrentes................................................................................................................7
2.3.4 Histórico de Versões.....................................................................................................................7
2.3.5 Consumidores Conhecidos..........................................................................................................7
3 CAPACIDADES............................................................................................................................................8
3.1 CONSULTAR............................................................................................................................................8
3.1.1 Identificação.....................................................................................................................................8
3.1.2 Entrada.............................................................................................................................................8
3.1.3 Tipo de Retorno................................................................................................................................8
3.1.4 Saída.................................................................................................................................................8
3.1.5 Descrição da Lógica (opcional).......................................................................................................8
3.1.6 Versão (opcional).............................................................................................................................8
3.2 PESQUISAR.............................................................................................................................................9
3.2.1 Identificação.....................................................................................................................................9
3.2.2 Entrada.............................................................................................................................................9
3.2.3 Tipo de Retorno................................................................................................................................9
3.2.4 Saída.................................................................................................................................................9
3.2.5 Descrição da Lógica (opcional).......................................................................................................9
3.2.6 Versão (opcional).............................................................................................................................9
4 ANEXOS......................................................................................................................................................10
1 Introdução

1.1 Objetivo
Descrever o serviço de entidade MagistradoService. Este serviço controla as
informações acerca de magistrados (cadastro de).

1.2 Escopo do Documento

Nesta versão, a especificação contém os resultados da Análise Orientada a Serviço
e do Projeto Orientado a Serviço (contrato), para uso no projeto de arquitetura e
implementação do serviço. O escopo atual do serviço inclui apenas capacidades de
consulta e pesquisa, para a estrutura de dados resumida de Magistrados de Primeiro
Grau. Capacidades de inserção e alteração não estão contempladas neste
momento.

1.3 Referências
- Modelo de Processo de Negócio e Modelo de Informação, Projeto COMAGIS, v2.0
de 19/08/2015.

- Modelo de Candidatos a Serviços (modelo BPMN2.0), Projeto COMAGIS, de

10/09/2015.

- Candidatos a Serviços, Projeto COMAGIS, v1.1 de 14/09/2015.

2 MagistradoService v1r0

2.1 Identificação do Serviço

Nome MagistradoService
Inventário / Domínio TJSC / COMAGIS
Modelo do Serviço Entidade
Descrição Serviço de Entidade Magistrado.
Propósito Controlar informações acerca de magistrados (cadastro de).
Palavras-chaves Magistrado, Cargo de Magistrado, Função de Magistrado
Versão v1r0
Status do Serviço Projeto
Data de Entrega 31/10/2015

2.2 Especificação Técnica

2.2.1 Contexto Funcional
Um magistrado representa um Juiz de Direito ou Juiz Substituto. Trata-se de
entidade base para diversos processos de negócio no TJSC. Inicialmente, este
serviço disponibiliza informações básicas de identificação e da vida funcional de um
magistrado, tais como lotação (cargo e função), bem como informações para
verificação de antiguidade utilizadas em regras de negócio para estabelecimento de
prioridades em diversos processos.

Um magistrado é unicamente identificado por seu número de matrícula.

2.2.2 Capacidades do Serviço

Capacidade Descrição Status

consultar Consultar um magistrado existente. Projeto
Pesquisar magistrados existentes, por Projeto
pesquisar lotação e tipo de cargo e/ou função.
inserir Inserir (registrar) um novo magistrado. Candidata
Alterar qualquer elemento do Candidata
alterar magistrado.
Tornar inativo um magistrado (registro Candidata
não pode ser vinculado a novas
tornarInativo transações).
2.2.3 Tipologia
Web Service (SOAP)

2.2.4 Contrato
wsdl/MagistradoService_v1r0.wsdl

2.2.5 Descrição da Lógica (opcional)

2.2.6 Estruturas de Dados

Magistrado:
MagistradoType, xsd/comagis/Magistrado_v1r0.xsd
MatriculaType, xsd/comagis/Magistrado_v1r0.xsd

Vaga de Magistrado:
VagaMagistradoType, xsd/comagis/VagaMagsitrado_v1r0.xsd

Cargo:
CargoType, xsd/corporativo/Cargo_v1r0.xsd

Funcao:
FuncaoType, xsd/corporativo/Funcao_v1r0.xsd

Status do Processamento:
StatusProcessamentoType, xsd/messages/StatusProcessamento_v1r0

2.2.7 Regras de Negócio (opcional)

Um magistrado deve ter sempre um “cargo” e estar lotado em uma “vaga de
magistrado”.

Um magistrado pode ter adicionalmente uma “função”.

2.2.8 Segurança
TBD

2.2.9 Políticas de Uso

TBD

2.2.10 SLA
TBD

2.2.11 Especificações Adicionais (Não Funcionais) (opcional)

TBD
2.2.12 Arquitetura do Serviço
Padrão de Projeto: Serviço de Entidade com Persistência em Schema Dedicado
Arquitetura de aplicação composta (SCA) implementada em Oracle SOA Suite.
Operação SQL em BD, através de componente DB Adapter. Transformação XLST
(modelo BD <-> modelo canônico) em componente Mediator.

Atualmente, o serviço está implementado usando persistência direta em banco de

dados (Oracle) através de uma “view” que materializa os elementos da entidade,
para persistência. A atualização das tabelas associadas com esta “view” é realizada
por rotina “batch” que executa periodicamente, sincronizando as informações
mantidas nos sistemas legados, em especial SHF. Desse modo, trata-se de serviço
apenas para operações de “leitura”, pois os dados relativos à entidade são geridos e
atualizados nestes sistemas legados.

2.2.13 Configuração do Serviço (Implantação)

TBD

2.2.14 Dependências
Legado: SHF e Serviços (rotinas) de replicação SHF/Caché <-> Oracle (Schemas
core e srh).

2.2.15 Tecnologias de Implementação

Arquitetura SCA, com SOA Suite 12c.

2.3 Governança
2.3.1 Guardião
Rafael Guimarães (proprietário).

2.3.2 Desenvolvedores
[Detalha como contatar desenvolvedores do serviço, assim como outros que
contribuíram com essa documentação].

2.3.3 Contratos Concorrentes

N/A

2.3.4 Histórico de Versões

N/A

2.3.5 Consumidores Conhecidos

Processo de Substituição de Magistrados (Projeto COMAGIS)
3 Capacidades

3.1 consultar
3.1.1 Identificação

Nome da Capacidade consultar

Situação de Terminação Membro de Composição (F)
Descrição Consultar um magistrado existente.
Propósito Consultar magistrado através de seu número de
matricula.
Palavras-Chave Magistrado
Status da Capacidade Projeto
Data de Entrega 31/10/2015

3.1.2 Entrada
MatriculaType

3.1.3 Tipo de Retorno

Síncrono

3.1.4 Saída
MagistradoType

3.1.5 Descrição da Lógica (opcional)

Retorna um elemento único ou gera exceção (Código: 404, Descrição: Não Encontrado) caso a opção
informada não seja encontrada.

3.1.6 Versão (opcional)

v1r0
3.2 pesquisar
3.2.1 Identificação

Nome da Capacidade pesquisar

Situação de Terminação Membro de Composição (F)
Descrição Pesquisar magistrados existentes, por lotação e
tipo de cargo e/ou função.
Propósito Pesquisar magistrados existentes, por lotação
(unidade organizacional), tipo de cargo e/ou
função.
Palavras-Chave Afastamento de Magistrado
Status da Capacidade Projeto
Data de Entrega 31/10/2015

3.2.2 Entrada
“Unidade” CodigoType (UnidadeOriganizacional),
“Cargo” CargoType,
“Funcao” FuncaoType

3.2.3 Tipo de Retorno

Síncrono

3.2.4 Saída
Lista de VagaMagistradoType

3.2.5 Descrição da Lógica (opcional)

Pode retornar a lista vazia, caso nenhuma instância seja encontrada satisfazendo os
parâmetros da pesquisa (não gera exceção neste caso).

3.2.6 Versão (opcional)

v1r0
4 Anexos