Mudanças entre as edições de "Desenvolvedor"
(→Dependências do Maven) |
(→Dependências do Maven) |
||
Linha 239: | Linha 239: | ||
<id>artifactory</id> | <id>artifactory</id> | ||
</profile> | </profile> | ||
− | + | ||
<profile> | <profile> | ||
<id>pje-descanso</id> | <id>pje-descanso</id> | ||
Linha 248: | Linha 248: | ||
</properties> | </properties> | ||
</profile> | </profile> | ||
− | + | ||
</profiles> | </profiles> | ||
<activeProfiles> | <activeProfiles> | ||
<activeProfile>artifactory</activeProfile> | <activeProfile>artifactory</activeProfile> | ||
</activeProfiles> | </activeProfiles> | ||
− | </settings> | + | </settings> |
Edição das 15h53min de 7 de abril de 2014
O documento de arquitetura orienta o desenvolvimento no padrão do PJe: Acessar
O documento de gerenciamento de configuração traz orientações para a produção e guarda de artefatos e liberação de versões: Acessar
Alguns procedimentos necessários para o desenvolvimento no PJe:
Pré-requisitos para ser desenvolvedor no PJe
Os pré-requisitos exigidos são:
- Conhecimento da linguagem de programação Java (nível de conhecimento mínimo: de intermediário a avançado).
- Conhecimento de persistência com JPA e Hibernate (nível de conhecimento mínimo: básico).
- Conhecimento da linguagem SQL do banco de dados PostgreSQL (nível de conhecimento mínimo: básico).
- Conhecimento de JSF (nível de conhecimento mínimo: básico).
- Conhecimento de JBoss Seam 2.2 (nível de conhecimento mínimo: básico).
- Habilidade de uso com a ferramenta Eclipse (nível de conhecimento mínimo: nível básico).
Os pré-requisitos desejáveis são:
- Habilidade de uso com a ferramenta Maven (nível de conhecimento mínimo: nível básico).
- Habilidade de uso com as ferramentas Git e GitLab (nível de conhecimento mínimo: noções gerais).
- Conhecimento do servidor de aplicação JBoss 5.1 (nível de conhecimento mínimo: básico).
- Conhecimento de padrões de projeto (design patterns) (nível de conhecimento mínimo: básico).
- Conhecimento de jBPM (nível de conhecimento mínimo: noções gerais).
- Habilidade de uso com a ferramenta de controle de demandas JIRA (nível de conhecimento mínimo: noções gerais).
- Ter tido algum contato de uso com o sistema PJe.
Configuração do ambiente de desenvolvimento
Em atualização!
A seguir, algumas instruções para instalação do ambiente de desenvolvimento.
Roteiro para Instalação e Configuração do Sistema Operacional
Baixar e instalar (descompactar) o JBoss 5.1.0.GA (download em http://www.jboss.org/jbossas/downloads/).
Instalação do JBoss 5.1
Baixar e instalar (descompactar) o JBoss 5.1.0.GA (download em http://www.jboss.org/jbossas/downloads/).
Roteiro para Instalação do Eclipse e de seus plugins
- Baixar (http://www.eclipse.org/downloads/) e descompactar o Eclipse Kepler (Eclipse IDE for Java EE Developers)
Atenção! Ao instalar plugins ou gerar/configurar a chave para acesso ao GIT, sempre reinicialize a IDE, mesmo que não seja solicitado
- Ajustar as preferências do Eclipse conforme instruções em Preferências do Eclipse
- Aumentar o tamanho máximo do heap space para 1024 MB. Essa configuração pode ser feita no arquivo eclipse.ini com a alteração do valor -Xmx de 512m (padrão) para 1024m, conforme exemplo a seguir:
- Gerar um par de chaves SSH para acessar o repositório Git do PJe, conforme instruções em Geração do Par de Chaves
- Configurar no GitLab a chave pública gerada no passa anterior, conforme instruções em Configuração da Chave Pública no Servidor Git
- Gerar uma cópia Git local do repositório do PJe conforme descrito em Obtendo a cópia do repositório do PJe
- Criar um projeto a partir do repositório clonado no item anterior, conforme instruções em Criando o projeto a partir do repositório clonado
- Configurar o acesso ao artfactory do CNJ no arquivo setting.xml, conforme instruções em Dependências do Maven
Preferências do Eclipse
- Ir ao menu “Window > Preferences” e configurar as seguintes preferências do Eclipse:
- Adicionar o JDK e remover as JREs existentes (A JDK pode ser obtida através do site da Oracle]. Antes de clicar no botão "Add" da imagem acima, faça o download e instale a JDK. Depois, adicione através do botão "Add", apontando para a pasta raiz onde o JDK foi instalado.
Ir para início do Roteiro para Instalação do Eclipse e de seus plugins
Obtendo a cópia do repositório do PJe
Atenção! Para obter uma cópia do PJe é necessário que um par de chaves SSH tenha sido gerado e configurado no servidor Git
- Clonar o repositório por meio da funcionalidade “Clone Git Repository”, na aba Git Repositories na perspectiva Git do Eclipse. Na primeira clonagem é possível, dependendo da instalação do Eclipse, que sejam apresentadas duas janelas de diálogo seguidas solicitando confirmações. Confirme ambas
- Deixar todos os branchs selecionados e clicar em “Next”
- Escolher a pasta onde o repositório será clonado e clicar em “Next” (por exemplo: C:\TreinamentoPJE\Ambiente\projetos\pje)
Ir para início do Roteiro para Instalação do Eclipse e de seus plugins
Criando o projeto a partir do repositório clonado
Atenção! Antes de criar o projeto, deve ter sido realizada a clonagem do repositório do PJe
- Ir para a perspectiva Java EE e clicar com o botão direito no Project Explorer
- Selecionar o caminho onde foi clonado o repositório do GIT, no passo anterior (por exemplo: C:\TreinamentoPJE\Ambiente\projetos\pje)
- Selecionar todos os pom’s listados e clicar em “Next”
- Clicar em "Finish"
Atenção! A partir desse momento o download das dependências gerenciadas pelo Maven será iniciado.
Na primeira criação de projeto, em função da grande quantidade de dependências, o processo levará aproximadamente 30 minutos
Ir para início do Roteiro para Instalação do Eclipse e de seus plugins
Dependências do Maven
Atenção! O arquivo settings.xml possui as configurações de acesso ao artfactory do CNJ.
- Adicionar settings.xml ao diretório .m2
<?xml version="1.0" encoding="UTF-8"?> <settings xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"
xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <servers> <server> <username>seu login</username> <password>sua senha</password> <id>central</id> </server> <server> <username>seu login</username> <password>sua senha</password> <id>snapshots</id> </server> <server> <id>pje-descanso</id> <username>postgres</username> <password>P123456.</password> </server> </servers> <profiles> <profile> <repositories> <repository> <snapshots> <enabled>false</enabled> </snapshots> <id>central</id> <name>repo</name> <url>http://www.cnj.jus.br/artifactory/repo</url> </repository> <repository> <snapshots /> <id>snapshots</id> <name>repo</name> <url>http://www.cnj.jus.br/artifactory/repo</url> </repository> </repositories> <pluginRepositories> <pluginRepository> <snapshots> <enabled>false</enabled> </snapshots> <id>central</id> <name>repo</name> <url>http://www.cnj.jus.br/artifactory/repo</url> </pluginRepository> <pluginRepository> <snapshots /> <id>snapshots</id> <name>repo</name> <url>http://www.cnj.jus.br/artifactory/repo</url> </pluginRepository> </pluginRepositories> <id>artifactory</id> </profile> <profile> <id>pje-descanso</id> <properties> <flyway.serverId>pje-descanso</flyway.serverId> <flyway.driver>org.postgresql.Driver</flyway.driver> <flyway.url>jdbc:postgresql://localhost:5432/pje_homologacao_1g</flyway.url> </properties> </profile> </profiles> <activeProfiles> <activeProfile>artifactory</activeProfile> </activeProfiles> </settings>
- Clicar em UPDATE SETTINGS do "Window > Preferences > Maven" (caminho para plataforma Windows):
- Sempre que precisar atualizar as dependências do Maven, vá em:
- Se ainda forem detectados problemas de dependência, executar procedimento de limpeza:
Removendo as validações desnecessárias
- Clicar com o botão direito em cada um dos projetos e configurar as seguintes propriedades:
Criando um branch para iniciar a resolução de uma pendência (issue)
- Verificar instruções do EGit;
- Solicitar alteração do branch de trabalho para um novo branch, conforme abaixo:
- Criar o branch novo, referenciando o nome da pendência a ser resolvida. Adicionalmente, para contemplar necessidade de diversos pedidos de integração devido às várias versões em uso do PJe, sugere-se acrescentar ao nome do branch novo o nome do branch base que se está usando para criar o branch. Por exemplo, PJEII-7249-master, ou PJEII-7249-stable, ou ainda PJEII-7249-1.4.6.x
Após finalizado o procedimento, terá sido criado o branch em seu repositório local.
Publicando a aplicação com Jboss
- Na aba Servers, adicione um novo servidor;
- Aponte o ambiente de execução (runtime environment) para o diretório da instalação do JBoss;
- Copie e cole o arquivo de datasources “PJE-ds.xml” para o diretório “/server/default/deploy” contido na instalação do JBoss (Lembre-se de editar o arquivo XML conforme a necessidade).
Alterando parâmetros de performance do Jboss
Pode ser que o Eclipse fique com sua execução prejudicada devido a problemas de performance do Jboss. Se for esse o caso, para alterar os parâmetros de performance, realize um clique duplo no servidor Jboss e depois clique em "Open launch configuration":
- Verifique os VM Arguments. Tente melhorar a performance do JBoss aumentando o Xms, Xmx e MaxPermSize. (atentar para orientações disponíveis no manual de instalação - Xms = 1024m, Xmx = 1024 e MaxPermSize=256 )
Usuários para acessar sua instância do PJE
Para “zerar” as senhas dos usuários no banco de dados, executar o método main da classe RegistraSenha (após configurar acesso ao banco):
Instalando e configurando o FileSync
O FileSync é um plugin que executa no Eclipse, permitindo a 13.1. sincronização de arquivos mantidos por ele (leia http://marketplace.eclipse.org/content/filesync). Instale o plugin a partir do Eclipse em “Help > Eclipse Marketplace”:
- Após a instalação, clicar com o botão direito no projeto que contém o ponto de início de execução (pje-web), selecionar "Properties" e localizar o item “File synchronization”. Clicar em “Add Folder” e adicionar a pasta /src/main/webapp:
- Abrir a pasta incluída, selecionar “Excluded” e clicar em “Edit”:
- Clicar no botão “Add Multiple” do “Exclusion patterns”, selecionar todos os arquivos do WEB-INF exceto a pasta XHTML e clicar em “OK”:
- Informar em "Default target folder" o caminho do .war:
Comandos GIT
- Para começar, leia a documentação existente em http://www.atlassian.com/git. Estude primeiro o tutorial para iniciantes (http://www.atlassian.com/git/tutorial).
Exemplos de comandos:
- FETCH ( atualizar um branch local com o código do servidor remoto):
- COMMIT
- RESET (apagar as modificações feitas em um branch local):
Lembre-se: Quando você desfaz suas modificações com reset git, não existe maneira alguma de recuperá-las. Leia: http://www.atlassian.com/git/tutorial/undoing-changes#!reset .
Depois, deve ser realizado um PULL a fim de recuperar a versão mais atualizada do branch.
Observações
O vídeo que descreve a configuração do projeto no Eclipse está um pouco desatualizado, mas é importante dar uma olhada:
- Teclas de atalho do Eclipse:
- CTRL + SHIT + F = Identar
- CTRL + SHIT + R = Localizar arquivo ou classe
- CTRL + SHIT + T = Localizar tipo (classe)
- CTRL + SHIT + O = Imports
- CTRL + D = Apagar linha
- CTRL + F = Localizar
- CTRL + O = Localizar métodos e atributos dentro de um arquivo
A seguir, alguns vídeos que auxiliam na configuração do ambiente.
Download das ferramentas
Para iniciar o desenvolvimento do sistema PJE, faça o download das ferramentas necessárias através do endereço: https://wwwh.cnj.jus.br/svn/projeto_pje/trunk/ambiente (atualizar - svn não mais necessário)
Veja como fazer o download: Vídeo
Instalando o Postgres
Para instalar o Postgres, execute o instalador que foi baixado anteriormente deixando as opções sugeridas. Na etapa de definição de senha de administrador, informe "P123456."
Criando base de dados
Crie duas bases de dados: PJE_1_4 e PJE_1_4_BIN, sendo a primeira necessária para armazemanento dos dados do PJE e a segunda para armazenamento dos documentos dos processos gerados pelo PJE.
Veja como fazer a criação da base de dados: Vídeo
Restaurando base de dados
Após criar as bases, vamos copiar os dados e a estrutura do banco de desenvolvimento e restaurá-lo em nosso banco local.
Veja como: Vídeo
Configurando o Eclipse
Tutorial que ensina as principais configurações para desenvolvimento no eclipse, tais como: configuração do MAVEN, download de códigos-fonte no SVN, configuração do JBoss, configuração de HotDeploy (atualizar - svn não mais necessário) Vídeo
Gerando certificados CACERTS
O PJE faz uso de alguns webServices para consulta de dados, como receita federal e OAB. Para que ele consiga executar as pesquisas, é necessário gerar alguns certificados. Veja no vídeo como fazê-lo: Vídeo
Desenvolvimento
Criando entidades
Neste vídeo, demonstraremos como criar entidades para armazenamento de dados no padrão exigido pelo PJE.
Script de criação das tabelas usadas no exemplo: Arquivo:Script criacao tabelas.txt
Vídeo
Criando DAO
Neste vídeo, demonstraremos como criar classes do tipo DAO para acesso aos dados de uma entidade. Uma DAO acessa dados de somente uma entidade.
Vídeo
Criando manager
Neste vídeo, demonstraremos como criar classes do tipo "manager" para adicionarmos regras de negócio e validações antes de persistir os dados de uma entidade. Managers controlam regras de negócio de apenas uma entidade.
Vídeo
Criando action
Neste vídeo, demonstraremos como criar classes do tipo "action" que farão o controle de uma determinada tela.
Vídeo
Criando páginas
Neste vídeo, demonstraremos como criar páginas "xhtml" de pesquisa e edição de registros.
Vídeo
Gerando Deploy
Vídeos que orientam o desenvolvedor sobre como gerar corretamente o deploy do PJE:
Interfaces para extensão do sistema
O sistema PJe evidentemente não é capaz de contemplar toda a variedade de implementações existentes dadas pelos tribunais para os diversos serviços auxiliares ou acessórios que orbitam a atividade jurisdicional. Alguns desses serviços são intensamente próximos da atividade judicial, outros são um pouco mais distantes. O traço mais comum é, no entanto, a grande possibilidade de variação de implementação dada por cada um dos tribunais.
Em razão dessa apreensão, é imprescindível permitir que algumas atividades sejam implementadas pelo tribunal interessado e conectadas ao PJe. Essa conexão pode ser feita de várias maneiras, desde serviços web até implementações mais internas. Uma alternativa de implementação mais rápida é a construção de componentes Seam que possam ser instalados no PJe para sua posterior utilização em nós de fluxos.
A presente página apresenta as interfaces inicialmente disponibilizadas para algumas das atividades mais críticas do sistema e disponibiliza um projeto de exemplo contendo uma implementação vazia para uma dessas interfaces.
Interfaces disponibilizadas
Na versão 1.0 do projeto de interfaces do PJe, serão disponibilizadas interfaces para as seguintes atividades:
- verificação de prevenção em relação a outros sistemas - br.jus.cnj.pje.extensao.VerificadorPrevencaoExterna
- envio e recebimento de informações para sistema de diário eletrônico - br.jus.cnj.pje.extensao.PublicadorDJE
- envio e recebimento de comunicações postais - br.jus.cnj.pje.extensao.ConectorECT
- verificação de recolhimento de custas processuais - br.jus.cnj.pje.extensao.VerificadorCustasProcessuais
Essas interfaces estão definidas no projeto pje-interfaces-1.0.0, empacotadas em um arquivo JAR que deve ser utilizado na implementação da interface. A documentação relativa a cada uma das interfaces pode ser consultada diretamente na WIKI e nos arquivos de documentação do desenvolvedor.
Desenvolvimento de ponto de extensão
O desenvolvimento do ponto de extensão do PJe passa pelas seguintes etapas:
- implementação da interface como componente Seam
- definição de arquivo components.xml em que o componente da interface seja inicializado pela classe que a implementa
- empacotamento do ponto de extensão, devendo ser identificadas as bibliotecas de dependência para instalação junto ao PJe
- instalação do ponto de extensão e concretização de seus testes
Implementação da interface
O JBoss Seam 2.2.X permite que sejam criados componentes em pacotes autônomos, que podem ser posteriormente instalados em sistemas Seam. Uma vez instalados, esses componentes são inicializados juntamente com os demais componentes da aplicação e ficarão disponíveis para injeção e utilização pela aplicação. Para tanto, basta implementar a interface e, no arquivo components.xml, definir o componente e a classe que o implementa. O exemplo que será apresentado versará sobre a implementação da interface de verificação de prevenção. Essa interface tem uma só função definida:
String[] verificaPrevencao(String processoOrigem, int codClasse, int codAssuntoPrincipal, int[] codAssuntos, String[] nomesAutores, String[]
documentosAutores, String[] nomesReus, String[] documentosReus)
A implementação pode adotar o mecanismo que o tribunal implementador entender mais adequado, desde arquivo de sistemas até serviços Web. Neste exemplo, vamos adotar um mecanismo de verificação em banco de dados.
<code class="java"> @Name("verificadorPrevencaoExterna") @Scope(ScopeType.APPLICATION) @Install(precedence=Install.APPLICATION) @Startup public class VerificadorPrevencaoExemplo implements VerificadorPrevencaoExterna { @In(create=true) private DataSource prevencaoDS; @Override public String[] verificaPrevencao(String processoOrigem, int codClasse, int codAssuntoPrincipal, int[] codAssuntos, String[] nomesAutores, String[] documentosAutores, String[] nomesReus, String[] documentosReus){ List<String> nomesPartes = new ArrayList<String>(); nomesPartes.addAll(Arrays.asList(nomesAutores)); nomesPartes.addAll(Arrays.asList(nomesReus)); List<String> documentosPartes = new ArrayList<String>(); documentosPartes.addAll(Arrays.asList(documentosAutores)); documentosPartes.addAll(Arrays.asList(documentosReus)); int numeroNomes = nomesPartes.size(); int numeroDocumentos = documentosPartes.size(); String qStr = buildQuery(numeroDocumentos, numeroNomes); Connection con = ds.getConnection(); PreparedStatement pstmt = con.prepareStatement(qStr); pstmt.setInt(1, codClasse); pstmt.setInt(2, codAssuntoPrincipal); for(int i = 3; i < 3 + numeroNomes; i++){ pstmt.setString(i, nomesPartes.get(i - 3)); } for(int i = 3 + numeroNomes; i < 3 + numeroNomes + numeroDocumentos; i++){ pstmt.setString(i, documentosPartes.get(i - numeroNomes - 3)); } ResultSet rs = pstmt.executeQuery(); List<String> ret = new ArrayList<String>(); while(rs.next()){ ret.add(new String(rs.getString(1))); } return ret.toArray(new String[]{}); } private String buildQuery(int numeroNomes, int numeroDocumentos){ StringBuilder sb = new StringBuilder("SELECT DISTINCT p.numero FROM tb_processo AS p " + "JOIN tb_partes AS par ON par.processo = p.numero " + "JOIN tb_pessoa AS pes ON par.cod_pessoa = pes.cod_pessoa WHERE p.classe = ?1 AND p.assunto = ?2 AND "); sb.append("(pes.nome IN ("); for(int i = 3; i < 3 + numeroNomes; i++){ sb.append("?" + i); if(i != (2 + numeroNomes)){ sb.append(", "); } } sb.append(") OR pes.documento IN ("); for(int i = 3 + numeroNomes; i < (3 + numeroNomes+ numeroDocumentos); i++){ sb.append("?" + i); if(i != (2 + numeroNomes + numeroDocumentos)){ sb.append(", "); } } sb.append("))"); return sb.toString(); } } </code>
Atentem que essa implementação é *apenas um exemplo*, não se tendo buscado assegurar características mais profundas de segurança ou de performance. No exemplo, não são considerados os assuntos que não o principal e é adotada estratégia única de verificação de prevenção em que é imprescindível a coincidência de classe e assunto, ainda que a posição das partes não seja relevante.
Definição do arquivo components.xml
No exemplo acima, vimos que a implementação reclama a existência de uma fonte de dados. Essa fonte deve ser definida no arquivo components.xml
.
<code class="xml"> <?xml version="1.0" encoding="UTF-8"?> <components xmlns="http://jboss.com/products/seam/components" xmlns:core="http://jboss.com/products/seam/core" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://jboss.com/products/seam/core http://jboss.com/products/seam/core-2.2.xsd http://jboss.com/products/seam/components http://jboss.com/products/seam/components-2.2.xsd"> <factory name="prevencaoDS" value="DATASOURCE_CONFIGURADO_NO_SERVIDOR_DE_APLICACAO" scope="application"/> </components> </code>
Empacotamento do ponto de extensão
O ponto de extensão deve ser empacotado em um arquivo JAR contendo a(s) classe(s) necessárias à implementação e, aindaa seguinte estrutura mínima:
- arquivo
seam.properties
vazio na raiz do arquivo JAR - pasta META-INF contendo o arquivo
components.xml
A par desse arquivo JAR, é imprescindível que o desenvolvedor do ponto de extensão identifique as bibliotecas de que depende, devendo, especialmente, verificar:
- se a biblioteca já faz parte do servidor de aplicação JBoss em que o PJe será instalado
- se a biblioteca já faz parte das bibliotecas de que o próprio PJe depende (WEB-INF/lib)
- se há alguma incompatibilidade entre as bibliotecas dependentes e aquelas já utilizadas no PJe
Cumpridos os passos acima, o desenvolvedor deverá elaborar um pacote ZIP contendo o JAR do ponto de extensão e os JARs das bibliotecas extras necessárias.
Instalação do ponto de extensão
A instalação do ponto de extensão é feita inserindo nos JARs contidos no pacote ZIP acima referido na pasta WEB-INF/lib do PJe. Sua utilização será feita por meio de injeção em componentes Seam do PJe ou indiretamente, em chamadas EL contidas em arquivos xhtml. Tanto a injeção quanto o uso em XHTMLs será feita por meio do nome padronizado de cada interface, que é o nome CamelCase da interface, sendo a primeira letra minúscula.
- pje-interfaces-1.0.0.jar
- pje-interfaces-1.0.0-javadoc.jar
- pje-interfaces-1.0.1.jar
- pje-interfaces-1.0.1-javadoc.jar
- pje-interfaces-1.0.2.jar
- pje-interfaces-1.0.2-javadoc.jar
- pje-interfaces-1.0.3.jar
- pje-interfaces-1.0.3-javadoc.jar
- pje-interfaces-1.0.4.jar
- pje-interfaces-1.0.4-javadoc.jar
Interoperabilidade
Sistemas externos podem ser integrados ao PJe através de serviços disponíveis no padrão MNI. Pode-se acessar a lista de serviços através da instalação do PJe no tribunal, complementendo o endereço de acesso inicial do PJe com o trecho "intercomunicacao?wsdl". Esse é um acesso disponível em toda instalação do PJe, ou seja, se o seu tribunal tem o PJe instalado, essa verificação teste pode ser realizada no seu próprio ambiente.
Para auxiliar na integração com outros sistemas, o PJe dispõe de outros serviços web. Pode-se acessar a lista de serviços através da instalação do PJe no tribunal, complementendo o endereço de acesso inicial do PJe com o trecho "ConsultaPJe?wsdl". Esse é um acesso disponível em toda instalação do PJe, ou seja, se o seu tribunal tem o PJe instalado, essa verificação teste pode ser realizada no seu próprio ambiente.
Modelo Nacional de Interoperabilidade - MNI
O MNI estabelece as bases para o intercâmbio de informações de processos judiciais e assemelhados entre os diversos órgãos de administração da Justiça, e como base para a implementação das funcionalidades pertinentes no âmbito do sistema processual de que trata o TCOT n.º 073/2009 e o acordo TAC n.º 58/2009.
Serviços disponíveis pelo Web Service do MNI (MNI Versão 2.1)
Em construção
PJe versão 1.4.6.4
Das cinco operações previstas, quatro estão implementadas (ver detalhes em http://www.cnj.jus.br/intercomunicacao-2.1):
- consultarAvisosPendentes - consulta a existência de avisos de comunicação processual pendentes. Pode ser específica em relação a uma parte representada ou relativa aos processos em que o consultante opera como órgão de representação processual (MP, defensoria pública, advocacia pública, escritório de advocacia e advogado). Seu retorno contém os dados básicos, uma lista dos avisos pendentes de conhecimento pelo consultante. Caso não haja aviso pendente o retorno será uma lista vazia.
- consultarTeorComunicacao - consulta o teor específico de uma comunicação processual pendente
- consultarProcesso - consulta um processo judicial se o nível de sigilo interno permitir a consulta pelo requerente. Os documentos do processo poderão encerrar apenas binários encriptados cuja chave será fornecida na consultaTeorComunicacao, caso haja intimação pendente para o documento transferido.
- entregarManifestacaoProcessual - permite a entrega de manifestação processual, por órgão de representação processual ou por advogado, e a entrega de petição inicial. Retorna o os dados básicos, o número do protocolo, a data da operação e, se bem sucedida, documento PDF contendo o recibo.
Autenticação
Como pré-requisito para usá-las, deve ser feita a autenticação dos clientes por meio da inscrição na Receita Federal (CNPJ ou CPF) extraída de certificados digitais ICP-Brasil. O protocolo de comunicação deve ser https.
Os órgãos de representação processual (MP, Defensoria Pública, Advocacia Pública e escritório de advocacia) são tratados no PJe como procuradorias. O cliente pode utilizar o certificado institucional ou pessoal. No primeiro caso, o CPF do responsável deve ser o mesmo que está associado à procuradoria cadastrada no PJe.
Referências:
- Modelo Nacional Interoperabilidade (versão 2.1.1) - Interoperabilidade
- Modelo Nacional Interoperabilidade (versão 2.1.1) - Intercomunicação
Em construção
Comunicação entre instâncias do PJe
Utilização por órgãos externos
Órgãos externos ao tribunal objeto da instalação do PJe
Migração
Uso temporário
Flyway
O Flyway é um sistema de versionamento de banco de dados. Funciona como um plugin no maven. Anteriormente, no PJe, vinha se usando o Flyway através do projeto pje-dbmanager, mas, devido às dificuldades de integração de código e integração de banco em projetos separados, optou-se, na versão 1.5.0, por reintegrar os scripts do dbmanager ao PJe e utilizar o flyway direto no maven desse momento em diante. Para configurá-lo no projeto PJe, deve-se modificar o arquivo .m2/settings.xml e acrescentar os seguintes parâmetros:
<servers> ... <server> <id>pje-descanso</id> <username>postgres</username> <password>123456.</password> </server> ... </servers> <profiles> ... <profile> <id>pje-descanso</id> <properties> <flyway.serverId>pje-descanso</flyway.serverId> <flyway.driver>org.postgresql.Driver</flyway.driver> <flyway.url>jdbc:postgresql://localhost:5432/pje_1_4</flyway.url> </properties> </profile> ... </profiles>
No início do trecho de arquivo, a configuração do <server> é a autenticação que deve ser utilizada para o <profile> de nome "pje-descanso", configurado mais abaixo. A configuração do <profile> contém o servidor (<flyway.serverId>) onde será executada a atualização, estabelecendo o driver para acesso ao banco (<flyway.driver>) e o endereço onde o banco se encontra (<flyway.url>).
Para atualizar a base, execute o comando "mvn flyway:migrate -P pje-descanso" através do eclipse, conforme imagem abaixo:
onde "pje-descanso" é o <flyway.serverId> definido no arquivo de configuração acima descrito.
A atualização de banco em versões anteriores é feita através do projeto dbmanager (que não mais existe a partir da 1.5.0), utilizando a classe atualizarBase.java. Ela deve ser executada diretamente pelo eclipse.
Catálogo de serviços
O PJe faz uso de comunicação com diversos serviços externos, como consulta à Receita Federal, consulta a instituições financeiras, consulta à OAB. Os endereços desses serviços ficam centralizados no Catálogo de serviços. Para ter acesso ao catálogo, os tribunais devem solicitar ao CNJ através do email G-lideres.PJE@cnj.jus.br.