Guia de Configuração e Administração

1. Abra a perspectiva Criação de Projetos: no menu principal, clique em Criação → Criação de Projeto.
2. No Explorador de Projeto, selecione a unidade organizacional e o repositório onde você queira criar o projeto.
3. No menu de perspectiva, vá até Novo Item → Projeto.
4. Na janela de diálogo Criar Novo Projeto, defina os detalhes do projeto:
   1. Na caixa de texto Projeto, insira o nome do projeto.
      
5. O explorador atualiza-se para apresentar uma janela pop-up Novo Assistente de Projeto.
   
6. Defina os detalhes de Configuração Geral do Projeto e Grupo Artefato Versão para esse novo projeto. Esses parâmetros são armazenados dentro do arquivo de configuração do Maven pom.xml.
   • Nome do Projeto: o nome para o projeto, por exemplo MortgageProject
   • Descrição do Projeto: a descrição do projeto, que pode ser útil para a documentação do projeto.
   • ID do Grupo: a identidade do grupo, por exemplo org.mycompany.commons
   • ID do Artefato: a identidade do artefato exlusiva no grupo, por exemplo myframework. Evite usar espaço ou caracteres especiais que possam gerar um nome inválido.
   • ID da Versão: a versão do projeto, por exemplo 2.1.1
   O modo de exibição da Tela do Projeto é atualizado com os novos detalhes do projeto, como definidos no arquivo pom.xml. Observe que você pode trocar os arquivos descritores do projeto na caixa suspensa por Configurações do Projeto e Configurações da Base de Conhecimento e editar seus conteúdos.

1. Abra o Editor de Projetos para o projeto fornecido:
   1. No modo de exibição do Explorador de Projeto da perspectiva Criação de Projeto, abra o diretório do projeto.
   2. Clique no botão para abrir o modo de exibição do projeto.
2. No modo de exibição da Tela do Projeto, selecione o item Dependências na caixa suspensa Configurações do Projeto.
3. Na Tela do Projeto atualizada, clique no botão Adicionar para adicionar uma dependência maven ou clique no botão Adicionar a partir do repositório para adicionar uma dependência do Knowledge Store (repositório de artefatos):
   • Ao adicionar uma dependência maven, o usuário precisa definir a ID do Grupo, a ID do Artefato e a ID da Versão na nova linha que foi criada na tabela de dependências.
   • Ao adicionar uma dependência do Knowledge Store, selecione a dependência na caixa de diálogo exibida: a dependência será adicionada à tabela de dependências.
4. Para aplicar as diversas alterações, as dependências devem ser salvas.

Procedimento 2.1. Configurando os Perfis do Business Central

1. Selecione o web.xml desejado dentro do $BPMS_HOME/standalone/deployments/business-central.war/WEB-INF/. Os seguintes arquivos são fornecidos:
   • web.xml (padrão) para perfil completo
   • web-exec-server.xml para o perfil do servidor de execução
   • web-ui-server.xml para o perfil do servidor da IU
2. Para ativar um perfil que não seja o perfil completo padrão, deve-se renomear o arquivo web-<PROFILE>.xml para web.xml. Os passos a seguir demonstram uma maneira de habilitar o perfil do servidor de execução:
   1. Faça o backup do arquivo web.xml a partir do perfil completo:

      $ mv web.xml web-full.xml

   2. Renomeie o arquivo web-exec-server.xml:

      $ mv web-exec-server.xml web.xml

3. Inicie o servidor do aplicativo com a propriedade adicional do sistema, instruindo o gerenciador do perfil a ativar o perfil especificado:
   • Dorg.kie.active.profile=full - para ativar o perfil completo ou ignorar a propriedade por completo
   • Dorg.kie.active.profile=exec-server - para ativar o perfil do servidor de execução
   • Dorg.kie.active.profile=ui-server - para ativar o perfil do servidor da IU

1. Para iniciar a ferramenta kie-config-cli no modo online, navegue até o diretório kie-config-cli-6.MINOR_VERSION-redhat-x-dist onde você instalou a ferramenta e, então, execute o comando a seguir.
2. Em um ambiente Unix, execute:

   ./kie-config-cli.sh

   Em um ambiente Windows, execute:

   ./kie-config-cli.bat

1. Navegue até o diretório kie-config-cli-6.MINOR_VERSION-redhat-x-dist onde você instalou a ferramenta.
2. Em um ambiente Unix, execute:

   ./kie-config-cli.sh offline

   Em um ambiente Windows, execute:

   ./kie-config-cli.bat offline

1. Baixe a ferramenta de migração fazendo o login no Portal do Consumidor Red Hat e, depois, navegue até a seção de Downloads de Software do Red Hat JBoss BPM Suite. Clique em Red Hat JBoss BPM Suite Migration Tool para baixar o arquivo zip.
2. Descomprima o arquivo zip baixado em um diretório de sua escolha e navegue até esse diretório em um prompt de comando. Esse diretório contém quatro pastas:

   • bin - contém os scripts de inicialização
   • jcr-exporter-libs - contém as bibliotecas específicas à parte export-from-JCR da migração.
   • vfs-importer-libs - contém as bibliotecas específicas à parte import-into-Git da migração.
   • conf - contém a configuração global da ferramenta de migração.
3. Para os bancos de dados de produção, copie o driver JDBC no banco de dados utilizado pelo repositório JCR no diretório jcr-exporter-libs da ferramenta de migração.
4. Execute os seguintes comandos:

   ./bin/runMigration.sh -i <source-path> -o <destination-path> -r <repository-name>

1. Inicie o JBoss Developer Studio.
2. Inicie o Red Hat JBoss BPM Suite Server (caso não esteja em execução ainda) selecionando o servidor através da guia servidor e clique no ícone iniciar.
3. Selecione Arquivo → Importar... e navegue até a pasta Git. Abra a pasta Git para selecionar os Projetos do Git e clique em avançar.
4. Selecione a origem do repositório como Repositório local existente e clique em avançar.
5. Selecione o repositório a ser configurado a partir da lista dos repositórios disponíveis.
6. Importe o projeto como um projeto geral na próxima janela e clique em avançar. Nomeie este projeto e clique em Concluir.

1. Defina a propriedade do sistema jbpm.v5.id.strategy como verdadeira no arquivo standalone.xml do JBoss BPM Suite:

   <property name="jbpm.v5.id.strategy" value="true"/>

2. Carregue KieSession como demonstrado aqui:

   KieSession ksession = JPAKnowledgeService.loadStatefulKnowledgeSession(sessionID, kbase, sessionConf, env);

3. Continue a execução normal do processo usando métodos KieSession:

   ksession.signalEvent("SomeEvent", null);

Procedimento 5.1. Alterando o Banco de Dados

1. Instale o driver do banco de dados no JBoss (consulte a documentação do driver JBoss).
2. Crie um banco de dados e uma fonte de dados JBoss que conecta-se ao driver do banco de dados.
3. Modifique o arquivo dashbuilder.war/WEB-INF/jboss-web.xml:

   <jboss-web>
      <context-root>/dashbuilder</context-root>
      <resource-ref>
          <res-ref-name>jdbc/dashbuilder</res-ref-name>
          <res-type>javax.sql.DataSource</res-type>
          <jndi-name>java:jboss/datasources/myDataSource</jndi-name>
      </resource-ref>
      ...
   

4. Substitua o valor do parâmetro jndi-name pelo caminho JNDI da fonte de dados JBoss que você criou.
5. Modifique o arquivo dashbuilder.war/WEB-INF/jboss-deployment-structure.xml
6. Adicione o seguinte trecho de configuração à tag deployment, onde jdbcDriverModuleName é o nome do módulo do driver JBoss JDBC:

     <dependencies>
         <module name="jdbcDriverModuleName" />
     </dependencies>
   

Procedimento 6.1. Criando um novo repositório

1. Abra a perspectiva Administração: no menu principal, clique em Criação → Administração.
2. No menu de perspectiva, clique em Repositórios → Novo Repositório.
3. A janela pop-up Criar Repositório é exibida.
   

   Figura 6.1. Janela Pop-up Criar Repositório

4. Insira os detalhes mandatórios:
   • Nome do repositório.

     Nota

     Observe que o nome do repositório deve ser um nome de arquivo válido. Evite usar espaço ou caracteres especiais que possam gerar um nome de pasta inválido.
   • Selecione a unidade organizacional na qual o repositório será criado a partir da opção suspensa Unidade Organizacional.
5. Clique em Concluir

Procedimento 6.2. Clonando um Repositório

1. Abra a perspectiva Administração.
2. No menu Repositórios, selecione Clonar repositório.
3. A janela pop-up Clonar Repositório é exibida.
   

   Figura 6.2. Janela Pop-up Clonar Repositório

4. Na janela de diálogo Clonar Repositório, insira os detalhes do repositório:
   1. Insira o Nome do Repositório a ser usado como o identificador do repositório no Repositório de Ativos e selecione a Unidade Organizacional onde ele deve ser adicionado.
   2. Insira o URL do repositório GIT:
      • Para um Repositório Local: file:///path-to-repository/reponame
      • Para um Repositório remoto ou preexistente: git://hostname/reponame

      Nota

      O protocolo do arquivo possui suporte somente para as operações de 'LEITURA'. As operações de 'GRAVAÇÃO' não possuem suporte.
   3. Se necessário, insira o Nome do Usuário e a Senha usados para autenticação, quando clonando o repositório.
5. Clique em Clonar.
6. Um prompt de confirmação com o botão OK será exibido, notificando o usuário de que o repositório foi criado com êxito. Clique em OK. O repositório será indexado. Alguns recursos do workbench estarão indisponíveis até que a indexação esteja completa.

Procedimento 6.3. Usando o Business Central para Remover um Repositório

1. Acesse o RepositoryEditor no Business Central Criação → Administração.
2. Selecione Repositórios do menu de árvore à esquerda.
3. No RepositoryEditor à direita, localize o repositório a ser excluído da lista dos repositórios disponíveis.
4. Selecione mestre do menu suspenso e clique no botão Excluir.
5. A seguinte mensagem aparecerá:

   Você tem certeza que deseja remover o Repositório "<$RepositoryName>"? Alguns editores podem tornar-se inoperáveis caso seus conteúdos estejam inacessíveis.

   Pressione Ok para excluir.

Procedimento 6.4. Alterando as Propriedades do Sistema

1. Edite o arquivo $JBOSS_HOME/domain/configuration/host.xml
2. Localize o servidor dos elementos XML que pertencem a main-server-group e adicione as propriedades do sistema. Por exemplo:

   <system-properties>
    <property name="org.uberfire.nio.git.dir" value="..." boot-time="false"/>
    ...
   </system-properties>
   

1. Abra a perspectiva Criação de Projeto (Criação → Criação de Projeto).
2. No Explorador de Projeto (Criação de Projeto → Explorador de Projeto), navegue até o projeto onde você deseja criar a definição do processo (no modo de exibição do Projeto, selecione o respectivo repositório e projeto nas listas suspensas; no modo de exibição do Repositório, navegue até o diretório REPOSITORY/PROJECT/src/main/resources/).

   Nota

   É recomendável criar os seus recursos, incluindo as suas definições de processos, em um pacote de um projeto para permitir a importação dos recursos e de suas referências. Para criar um pacote, siga as instruções a seguir:

   • No modo de exibição do Repositório do Explorador de Projeto, navegue até o diretório REPOSITORY/PROJECT/src/main/resources/.
   • Vá até Novo Item → Pacote.
   • Na caixa de diálogo Novo recurso, defina o nome do pacote e verifique o local do pacote no repositório.
3. A partir do menu de perspectiva, vá até Novo Item → Processos Empresariais.
4. Na caixa de diálogo Novos Processos, insira o nome do processo e clique em OK. Aguarde até que o Editor do Processo apareça com o diagrama do processo.

1. No Explorador de Projeto, selecione um projeto e o respectivo pacote para o qual você deseja importar a definição do processo.
2. Crie um novo Processo Empresarial para trabalhar indo até Novo Item → Processo Empresarial.
3. Na barra de ferramentas do Designer de Processos, clique no ícone Importar na barra de ferramentas do editor e selecione o formato da definição do processo importado. Observe que você deve optar por sobrescrever a definição do processo existente para poder importar.
4. A partir da janela Importar, localize o arquivo do processo e clique em Importar.
   

   Figura 7.1. Importar Janela

Procedimento 7.1. Exportando um processo empresarial

1. Abra a perspectiva Criação de Projetos: no menu principal, clique em Criação → Criação de Projeto.
2. Selecione o processo empresarial a ser exportado para visualizá-lo no Designer de Processos.
3. Clique no botão ( ) da barra de ferramentas do designer de processos e selecione Exibir as Fontes do Processo a partir das opções suspensas.
4. A janela Fontes do Processo é exibida.
5. Clique no botão Baixar BPMN2 e salve o processo empresarial no local desejado.

1. Clone o repositório git onde você salvou o projeto BPM Suite executando o seguinte comando:

   git clone http://localhost:8001/REPOSITORY_NAME

2. Na linha de comando, mova para a pasta que contém o projeto.
3. Siga as instruções em Red Hat JBoss Fuse Service Works 6 Development Guide, Volume 3: Governance, na seção Implantando no S-RAMP (Deploying to S-RAM). Use o URL do exemplo abaixo:

   <distributionManagement>
     <repository>
       <id>local-sramp-repo</id>
       <name>S-RAMP Releases Repository</name>
       <url>sramp://S-RAMP_SERVER_URL/s-ramp-server/</url>
     </repository>
     <snapshotRepository>
       <id>local-sramp-repo-snapshots</id>
       <name>S-RAMP Snapshots Repository</name>
       <url>sramp://S-RAMP_SERVER_URL/s-ramp-server/</url>
     </snapshotRepository>
   </distributionManagement>

   Com esses parâmetros de configuração, as implantações do Maven são enviadas diretamente para o repositório S-RAM, usando o API S-RAMP. Observe que os artefatos são adicionados ao repositório S-RAM com um tipo de artefato baseado no tipo Maven do projeto. Você pode substituir esse comportamente ao adicionar um parâmtero de consulta ao repositório URL no arquivo pom.xml. Por exemplo:

   <distributionManagement>
     <repository>
       <id>local-sramp-repo</id>
       <name>S-RAMP Releases Repository</name>
       <url>sramp://S-RAMP_SERVER_URL/s-ramp-server/?artifactType=KieJarArchive</url>
     </repository>
   </distributionManagement>
   

   O exemplo acima faz com que o artefato do Maven seja carregado com um tipo de artefato S-RAMP de KieJarArchive.
4. Corrija o plug-in do maven no arquivo pom.xml e adicione a ele uma dependência como a seguir, no caso do projeto não conter as tabelas de decisão:

   <plugins>
       <plugin>
         <groupId>org.kie</groupId>
         <artifactId>kie-maven-plugin</artifactId>
         <version>6.0.2-redhat-6</version>
         <extensions>true</extensions>
         <dependencies>
             <dependency>
                 <groupId>org.jbpm</groupId>
                 <artifactId>jbpm-bpmn2</artifactId>
                 <version>6.0.2-redhat-6</version>
             </dependency>
         </dependencies>  
        </plugin>
       </plugins>
   

   Caso o projeto contenha tabelas de decisão, use essa dependência para o kie-maven-plugin:

   <plugins>
       <plugin>
         <groupId>org.kie</groupId>
         <artifactId>kie-maven-plugin</artifactId>
         <version>6.0.2-redhat-6</version>
         <extensions>true</extensions>
         <dependencies>
             <dependency>
                  <groupId>org.drools</groupId>
                  <artifactId>drools-decisiontables</artifactId>
                  <version>6.0.2-redhat-6</version>
              </dependency>
         </dependencies>  
        </plugin>
       </plugins>
   

5. Execute uma implantação limpa do maven usando o seguinte comando:

   mvn -s sramp-settings.xml deploy

   .

1. Em um navegador da web, navegue até http://localhost:8080/s-ramp-ui/. Se a interface do usuário tiver sido configurada para executar a partir de um nome de domíno, substitua localhost pelo nome de domínio. Por exemplo, http://www.example.com:8080/s-ramp-ui/.
2. Clique em Artefatos.
3. Na seção Gerenciar Artefatos, selecione Importar.
4. Localize o arquivo kie que você queira implantar. Na caixa de diálogo que abrir, preencha KieJarArchive como o tipo e selecione Importar.
5. A implantação, então, cria estas entradas no repositório S-RAMP:
   KieJarArchive, da qual derivam-se:
   • KieXmlDocument (caso o arquivo contenha kmodule.xml)
   • BpmnDocument (caso o arquivo contenha definições bpmn)
   • DroolsDocument (caso o arquivo contenha definições drl)

Procedimento 9.1. Removendo uma Instalação drools-karaf-features Existente

1. Inicie o console Fuse usando:

   $ ./installDir/bin/fuse

2. Desinstale recursos/ aplicativos antigos que usavam o arquivo features.xml anterior. Por exemplo:

   JBossFuse:karaf@root> features:uninstall drools-module
   JBossFuse:karaf@root> features:uninstall jbpm
   JBossFuse:karaf@root> features:uninstall kie-ci
   

3. Pesquise por referências de pacotes usando drools/kie/jbpm e remova-as:

   list -t 0 -s | grep drools
   list -t 0 -s | grep kie
   list -t 0 -s | grep jbpm

   Para remover os pacotes:

   karaf@root> osgi:uninstall <BUNDLE_ID>

4. Remova o url drools-karaf-features antigo:

   karaf@root> features:removeurl mvn:org.drools/drools-karaf-features/6.2.0.Final-redhat-<VERSION>/xml/features

5. Reinicie Fuse
6. Adicione o novo arquivo de recursos:

   karaf@root> features:addurl mvn:org.drools/drools-karaf-features/6.2.0.Final-redhat-6-BZ1232486/xml/features

7. Instale os recursos:

   karaf@root> features:install ...

Procedimento 9.2. Instale os recursos principais do JBoss BPM Suite e JBoss BRMS

1. Baixe e instale a correção.
   1. Baixe jboss-brms-6.1.1-BZ-1232486.zip.
   2. Descompacte-o.
   3. Navegue até o diretório BZ-1232486 descompactado.
   4. Execute o seguinte comando de console:

      $ mvn org.apache.maven.plugins:maven-install-plugin:2.5.2:install-file -Dfile=drools-karaf-features-6.2.0.Final-redhat-6-BZ1232486-features.xml -DgroupId=org.drools -DartifactId=drools-karaf-features -Dversion=6.2.0.Final-redhat-6-BZ1232486 -Dpackaging=xml -Dclassifier=features

2. Configure os repositórios necessários:
   1. Edite o arquivo installDir/etc/org.ops4j.pax.url.mvn.cfg na sua instalação do JBoss Fuse e adicione a seguinte entrada à variável org.ops4j.pax.url.mvn.repositories, observe que as entradas são separadas por ‘, \’:
      • http://maven.repository.redhat.com/techpreview/all/@id=bxms-product-repo
3. Inicie o JBoss Fuse:

   $ ./installDir/bin/fuse

4. Adicione uma referência ao arquivo dos recursos principais executando o seguinte comando de console:

   JBossFuse:karaf@root> features:addurl mvn:org.drools/drools-karaf-features/6.2.0.Final-redhat-6-BZ1232486/xml/features

5. Você pode instalar, agora, os recursos fornecidos por este arquivo executando, por exemplo, o seguinte comando de console:

   JBossFuse:karaf@root> features:install drools-module

Procedimento 9.3. Integração do SwitchYard e Camel

1. Adicione uma referência ao arquivo dos recursos para uma integração adicional com o SwitchYard e Camel executando o seguinte comando de console:

   JBossFuse:karaf@root> features:addurl mvn:org.jboss.integration.fuse/karaf-features/1.0.0.redhat-620137/xml/features

2. Você pode instalar, agora, os recursos fornecidos pela integração do SwitchYard e Camel executando, por exemplo, o seguinte comando de console:

   JBossFuse:karaf@root> features:install fuse-bxms-switchyard-rules

Procedimento 9.4. Instalando o Aplicativo de Início Rápido

1. Adicione uma referência ao arquivo dos recursos executando o seguinte comando de console:

   JBossFuse:karaf@root> features:addurl mvn:org.jboss.integration.fuse.quickstarts/karaf-features/1.0.0.redhat-620137/xml/features

2. Você pode instalar, agora, os aplicativos de início rápido fornecidos por este arquivo de recursos executando, por exemplo, o seguinte comando de console:

   JBossFuse:karaf@root> features:install fuse-bxms-switchyard-quickstart-bpm-service

Procedimento 9.5. Baixando e Instalando os Arquivos ZIP de Início Rápido

1. Baixe o arquivo ZIP do aplicativo de início rápido.
2. Desempacote os conteúdos do diretório de início rápido no seu diretório existente installDir/quickstarts.
3. Desempacote os conteúdos do diretório do sistema no seu diretório existente installDir/system.

1. Registre um gerenciador de transação no seu ambiente.

   Exemplo 13.1. Codifique com o registro do gerenciador de transação

   // create the entity manager factory
   EntityManagerFactory emf = EntityManagerFactoryManager.get().getOrCreate("org.jbpm.persistence.jpa");
   TransactionManager tm = TransactionManagerServices.getTransactionManager();
   Environment env = EnvironmentFactory.newEnvironment();
   env.set(EnvironmentName.ENTITY_MANAGER_FACTORY, emf);
   env.set(EnvironmentName.TRANSACTION_MANAGER, tm);
   	
   // setup the runtime environment
   RuntimeEnvironment environment = RuntimeEnvironmentBuilder.Factory.get()
   .newDefaultBuilder()
   .addAsset(ResourceFactory.newClassPathResource("MyProcessDefinition.bpmn2"), ResourceType.BPMN2)
       .addEnvironmentEntry(EnvironmentName.TRANSACTION_MANAGER, tm)
       .addEnvironmentEntry(EnvironmentName.PERSISTENCE_CONTEXT_MANAGER, new JpaProcessPersistenceContextManager(env))
       .addEnvironmentEntry(EnvironmentName.TASK_PERSISTENCE_CONTEXT_MANAGER, new JPATaskPersistenceContextManager(env))
       .get();

2. Inicialize a KieSession:

   // get the KieSession
   RuntimeManager manager = RuntimeManagerFactory.Factory.get().newPerProcessInstanceRuntimeManager(environment);
   RuntimeEngine runtime = manager.getRuntimeEngine(ProcessInstanceIdContext.get());
   KieSession ksession = runtime.getKieSession();

3. Defina o gerenciador de transação em jndi.properties.

   Exemplo 13.2. Definição do gerenciador de transação Bitronix em jndi.properties

   java.naming.factory.initial=bitronix.tm.jndi.BitronixInitialContextFactory

   Nota

   Para usar um gerenciador de transação JTA, edite hibernate.transaction.manager_lookup_class, a propriedade do gerenciador de transação, no arquivo persistence.xml para carregar o seu gerenciador de transação.

   Exemplo 13.3. Gerenciador de Transação JBoss definido como gerenciador de transações

   <property name="hibernate.transaction.manager_lookup_class" value="org.hibernate.transaction.JBossTransactionManagerLookup"/>

4. Defina o início e o fim da transação.

    // start the transaction
   UserTransaction ut = InitialContext.doLookup("java:comp/UserTransaction");
   ut.begin();
   
   // perform multiple commands inside one transaction
   ksession.insert( new Person( "John Doe" ) );
   ksession.startProcess("MyProcess");
   
   // commit the transaction
   ut.commit();

1. Mapeie as classes de log na fonte de dados para que a fonte de dados fornecida aceite as entradas de log. No Red Hat JBoss EAP, edite as propriedades da fonte de dados no arquivo persistence.xml.

   Exemplo 14.1. Classes ProcessInstanceLog, NodeInstanceLog e VariableInstanceLog habilitadas por processInstanceDS

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <persistence  version="1.0"  xsi:schemaLocation=
       "http://java.sun.com/xml/ns/persistence
        http://java.sun.com/xml/ns/persistence/persistence_1_0.xsd
        http://java.sun.com/xml/ns/persistence/orm
        http://java.sun.com/xml/ns/persistence/orm_1_0.xsd"
     xmlns:orm="http://java.sun.com/xml/ns/persistence/orm"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xmlns="http://java.sun.com/xml/ns/persistence">
   
     <persistence-unit name="org.jbpm.persistence.jpa">
       <provider>org.hibernate.ejb.HibernatePersistence</provider>
       <jta-data-source>jdbc/processInstanceDS</jta-data-source>
       <class>org.drools.persistence.info.SessionInfo</class>
       <class>org.jbpm.persistence.processinstance.ProcessInstanceInfo</class>
       <class>org.drools.persistence.info.WorkItemInfo</class>
       <class>org.jbpm.process.audit.ProcessInstanceLog</class>
       <class>org.jbpm.process.audit.NodeInstanceLog</class>
       <class>org.jbpm.process.audit.VariableInstanceLog</class>
   
       <properties>
         <property name="hibernate.dialect" value="org.hibernate.dialect.H2Dialect"/>
         <property name="hibernate.max_fetch_depth" value="3"/>
         <property name="hibernate.hbm2ddl.auto" value="update"/>
         <property name="hibernate.show_sql" value="true"/>
         <property name="hibernate.transaction.manager_lookup_class"
                   value="org.hibernate.transaction.BTMTransactionManagerLookup"/>
       </properties>
     </persistence-unit>
   </persistence>
   

2. Registre um agente na sua Sessão Kie.

   Exemplo 14.2. Importando os Agentes

   import org.jbpm.process.audit.AuditLogService;
   import org.jbpm.process.audit.AuditLoggerFactory;
   import org.jbpm.process.audit.AuditLoggerFactory.Type;
   import org.jbpm.process.audit.JPAAuditLogService;
   ...
   

   Exemplo 14.3. Registrando um Agente a uma Sessão Kie

   @PersistenceUnit(unitName = PERSISTENCE_UNIT_NAME)
     private EntityManagerFactory emf;
   
     private AuditLogService auditLogService;
   @PostConstruct
     public void configure() {
     
     auditLogService = new JPAAuditLogService(emf);
     ((JPAAuditLogService) auditLogService).setPersistenceUnitName(PERSISTENCE_UNIT_NAME);
     
     if( emf == null ) { 
     ((JPAAuditLogService) auditLogService).setPersistenceUnitName(PERSISTENCE_UNIT_NAME);
     }
     
     RuntimeEngine runtime = singletonManager.getRuntimeEngine(EmptyContext.get());
     KieSession ksession = runtime.getKieSession();
     AuditLoggerFactory.newInstance(Type.JPA, ksession, null);
   
     }
   

3. Facultativamente, chame o método addFilter no agente para remover as informações irrelevantes. Apenas as informações aceitas por todos os filtros aparecem no banco de dados.
4. As classes do agente podem ser exibidas no Modo de Exibição de Auditoria:

   <dependency>
   	<groupId>org.jbpm</groupId>
   	<artifactId>jbpm-audit</artifactId>
   	<version>6.0.1.Final</version>
   </dependency>
   

1. Faça o login no Dashbuilder, depois que o servidor foi iniciado com êxito, e navegue até http://localhost:8080/dashbuilder em um navegador da web.
2. Selecione o idioma de sua escolha clicando nas localidades disponíveis na parte superior central da interface do usuário do Dashbuilder para alterar o idioma.

Procedimento 15.1. Configurando o idioma padrão como francês

1. Navegue até jboss-eap-6.1/standalone/configuration e defina o seguinte no arquivo standalone.xml.

   <system-properties>
       <property name="org.jboss.dashboard.LocaleManager.installedLocaleIds" value="en,es,de,fr,ja,pt,zh"/>
       <property name="org.jboss.dashboard.LocaleManager.defaultLocaleId" value="fr"/>
   </system-properties>
   

2. O idioma padrão da interface do usuário do Dashbuilder está definido agora como francês.

Procedimento 15.2. Definindo as localidades instaladas

• Navegue até jboss-eap-6.1/standalone/configuration e defina o seguinte no arquivo standalone.xml.

  <system-properties>
      <property name="org.jboss.dashboard.LocaleManager.installedLocaleIds" value="en,es,de,fr,ja,pt"/>
      <property name="org.jboss.dashboard.LocaleManager.defaultLocaleId" value="fr"/>
  </system-properties>
  

Procedimento 18.1. Copiando os arquivos JAR do plug-in do JBoss BRMS

1. Extraia o pacote de plug-ins do JBoss BRMS colocando-o em um local temporário. Essa ação cria um subdiretório com o nome de jon-plugin-pack-brms-bpms-3.3.0.GA. Por exemplo:

   [root@server rhq-agent]# unzip jon-plugin-pack-brms-bpms-3.3.0.GA.zip -d /tmp

2. Copie os arquivos JAR do plug-in do JBoss BRMS a partir do diretório jon-plugin-pack-brms-bpms-3.2.0.GA/ no diretório do plug-in do servidor JBoss ON. Por exemplo:

   [root@server rhq-agent]# cp /tmp/jon-plugin-pack-brms-bpms-3.3.0.GA/*.jar /opt/jon/jon-server-3.3.0.GA1/plugins

3. Inicie o servidor do JBoss Operations Network para atualizar o plug-in do JBoss BRMS.

Procedimento 18.2. Carregando o plug-in do JBoss BRMS através da GUI

1. Inicie o servidor do JBoss Operations Network e Faça o Login para acessar a GUI.
2. Na navegação superior da GUI, abra o menu Administração.
3. Na área de Configuração à esquerda, selecione o link Plug-ins do Servidor.
4. No fim da lista dos plug-ins carregados do servidor, clique no botão Carregar um plug-in e selecione o plug-in do BRMS.
5. O plug-in do JBoss BRMS para o JBoss Operations Network está agora carregado.

Procedimento 19.1. Acessando as Permissões do Espaço de Trabalho

1. Faça o login nos Painéis de Negócios a partir do Business Central (como descrito no tópico Acessando o Dashbuilder do Red Hat BPM Suite)
2. Selecione o Painel apropriado a partir do menu suspenso do espaço de trabalho.
   

   Figura 19.1. Espaço de Trabalho do Dashbuilder

3. Clique no botão Editar propriedades do espaço de trabalho selecionado para acessar o Painel do Espaço de Trabalho.
4. Clique no rótulo Permissões para exibir a tela de gerenciamento das permissões.
   

   Figura 19.2. Tela de Permissões

1. Para acessar as Permissões de Páginas, localize o menu suspenso Páginas sob o Painel jBPM (ou sob qualquer outro Painel que desejar).
2. Após expandir Páginas, expanda a opção Painel de processos.
3. Selecione a opção Permissões de Páginas.

1. Para acessar a página Permissões de Painel, expanda a opção Instâncias de painel sob o Painel jBPM (ou sob qualquer outro Painel que estiver usando).
2. Expanda a opção Painel e, então, expanda o Painel de processos.
3. Expanda a opção Panéis e selecione o processo adequado.
4. Abra a página Permissões de Painel.