Guia de Introdução

Red Hat JBoss BPM Suite 6.3

Guia de Introdução para o Red Hat JBoss BPM Suite

Serviços de Conteúdo da Red Hat

Klara Kufova

Marek Czernek

Tomas Radej

Vidya Iyengar

Resumo

This guide provides information for getting started with Red Hat JBoss BPM Suite.

Capítulo 1. Início Rápido do Red Hat JBoss BPM Suite

Nessa seção, baixamos, instalamos e executamos o Red Hat JBoss BPM Suite com o menor número de instruções. Para uma descrição mais detalhada e métodos de instalação alternativos, ignore essa seção e leia o restante deste guia.
Essas instruções pressupõem que você tenha a versão mínima suportada do Java instalada no seu sistema. Um servidor Red Hat JBoss EAP existente (versão 6.4 ou superior) também é necessário, já que o instalador não o instala.
Nota
Pode ser necessário atualizar o servidor do seu JBoss EAP. Se o instalador informar tal necessidade, baixe o patch mais recente do access.redhat.com e siga as instruções para atualização do Guia de Instalação do Red Hat JBoss EAP.

Procedimento 1.1. Início Rápido do Red Hat JBoss BPM Suite

  1. Baixe o instalador do JBoss BPM Suite a partir do link access.redhat.com.
  2. Execute o instalador usando o seguinte comando:
    java -jar jboss-bpmsuite-6.3.0.GA-installer.jar
  3. Complete os passos do instalador da GUI anotando o nome de usuário e a senha para acessar o aplicativo JBoss BPM Suite depois da instalação.
  4. Depois de concluir a instalação, navegue até a pasta inicial do EAP, em um prompt de comando, onde você instalou o JBoss BPM Suite.
  5. Inicie o servidor do JBoss BPM Suite emitindo o seguinte comando:
    bin/standalone.sh
  6. Abra um navegador da web e faça o login no Business Central navegando até o http://localhost:8080/business-central/. Faça o login usando a combinação de nome de usuário/ senha para o acesso ao aplicativo JBoss BPM Suite que você criou durante a instalação.
Você terá instalado e executado com êxito o Red Hat JBoss BPM Suite. Agora, você pode fazer o seguinte:
Aprender mais sobre as funções: Seção 2.1.3, “Definindo Funções”
Criar usuários adicionais: Seção 2.1.4, “Criando Usuários”
Criar um Projeto Hello World: Capítulo 4, Projeto Hello World
Consultar instruções mais detalhadas de instalação para uso do instalador no Guia de Instalação

Capítulo 2. Opções de Instalação

O Red Hat JBoss BPM Suite possui duas versões.
  • Instalador jar executável para instalação no Red Hat JBoss Enterprise Application Platform (EAP) 6.4.
  • Instalação do arquivo zip que, por sua vez, possui duas versões:
    • jboss-bpmsuite-6.3.0.GA-deployable-eap6.x.zip: versão adaptada para implantação no Red Hat JBoss Enterprise Application Platform.
    • jboss-bpmsuite-6.3.0.GA-deployable-generic.zip: versão implantável com bibliotecas adicionais adaptadas para implantação no Red Hat JBoss Web Server (EWS), Apache Tomcat 6 e Apache Tomcat 7.
Dependendo do seu ambiente, você pode escolher a opção de instalação que melhor atenda às necessidades do seu projeto.
Nota
O Red Hat JBoss BPM Suite foi desenvolvido para operar em codificação UTF-8. Caso um sistema de codificação diferente seja utilizado pela JVM subjacente, erros inesperados podem ocorrer. Para assegurar que a codificação UTF-8 seja utilizada pela JVM, use a seguinte propriedade de sistema: "-Dfile.encoding=UTF-8".
Importante
Do JBoss BPM Suite 6.1 em diante, você deve ter o JBoss EAP 6.4, ou superior, já instalado antes de tentar instalar o Red Hat JBoss BPM Suite.

2.1. Instalação do Pacote EAP 6

Esta seção descreve a instalação do pacote implantável Red Hat JBoss BPM Suite no Red Hat JBoss Enterprise Application Platform (EAP).
Nota
A versão mínima com suporte do Red Hat JBoss EAP para a instalação do Red Hat JBoss BPM Suite é 6.4.

2.1.1. Baixando o Pacote Red Hat JBoss EAP 6

Para baixar o pacote implantável Red Hat JBoss BPM Suite no JBoss Enterprise Application Platform, siga as instruções a seguir:
  1. Acesse o Portal do Cliente Red Hat e faça o login.
  2. Clique em DOWNLOADS na parte superior da página.
  3. Quando a página Downloads de Produtos abrir, clique em Red Hat JBoss BPM Suite.
  4. A partir do menu suspenso Version, selecione 6.3.0.
  5. Na página Downloads de Software que abrir, navegue pela linha do Red Hat JBoss BPM Suite 6.3 Implantável para EAP 6 e clique em Download.

2.1.2. Instalando o Pacote Red Hat JBoss EAP 6

Instalação em uma Instância Nova do JBoss EAP

Para instalar o pacote implantável em um JBoss EAP que ainda precisa ser configurado, sigas as intruções a seguir:
  1. Extraia o pacote zip implantável para o JBoss EAP que você baixou do Portal do Cliente Red Hat.
  2. Mescle o pacote zip implantável extraído para o JBoss EAP no diretório SERVER_HOME do JBoss EAP.
    Atenção
    Esta etapa deve ser realizada pela mesma conta de usuário que foi usada para instalar o JBoss EAP. Esta não deve ser uma conta de super usuário.
  3. Neste processo, múltiplos arquivos no diretório SERVER_HOME do JBoss EAP serão sobrescritos e você deve permitir que o processo de descompactação sobrescreve esses arquivos.
  4. Certifique-se de que o arquivo SERVER_HOME/bin/product.conf contenha a cadeia de caracteres slot=bpms.
No Red Hat Enterprise Linux, você pode usar o comando a seguir para extrair o arquivo zip do Red Hat JBoss Suite e mesclá-lo ao diretório do seu servidor corretamente, em um único passo, caso você execute esse comando no diretório onde você baixou o arquivo zip: 
unzip -u jboss-bpmsuite-VERSION-TYPE.zip -d SERVER_HOME_PARENT_DIR

Exemplo 2.1. Comando unzip 

unzip -u jboss-bpmsuite-6.3.0.GA-deployable-eap6.x.zip -d /home/john/myServers/
Na inicialização do servidor, o Red Hat JBoss BPM Suite será implantado.

Instalação em uma Configuração do JBoss EAP Existente

Atenção
Essas instruções são para a instalação e NÃO para a atualização de uma instância do JBoss BPM Suite existente. Certifique-se de que não haja uma instalação do JBoss BPM Suite existente no JBoss EAP de destino.
Para instalar o pacote implantável em um JBoss EAP configurado anteriormente, sigas as intruções a seguir:
  1. Extraia o pacote zip implantável para o JBoss EAP que você baixou do Portal do Cliente Red Hat.
  2. Descompacte o arquivo zip baixado; no entanto, não sobrescreva todos os arquivos. Mescle manualmente os seguintes arquivos no diretório SERVER_HOME:
    • jboss-eap-6.4/domain/configuration/* - (por favor, esteja ciente de que o JBoss BPM Suite necessita do JMS, portanto o JMS é adicionado por padrão a todos os perfis no domain.xml fornecidos pela distribuição do JBoss BPM Suite).
    • jboss-eap-6.4/standalone/configuration/* - (por favor, esteja ciente de que o JBoss BPM Suite necessita do JMS, portanto o JMS é adicionado por padrão a todos os arquivos de configuração dos perfis (principalmente aos arquivos standalone.xml e standalone-ha.xml) fornecidos pela distribuição do JBoss BPM Suite.
    • jboss-eap-6.4/modules/layers.conf
    • jboss-eap-6.4/bin/product.conf
  3. Certifique-se de que o JBoss EAP de destino não inclua uma implantação com um nome em conflito. Copie a pasta jboss-eap-6.4/standalone/deployments no diretório EAP_HOME da distribuição do JBoss BPM Suite.
  4. Certifique-se de que nenhuma camada de módulos do JBoss EAP já esteja nomeada como JBoss BPM Suite e copie a pasta jboss-eap-6.4/modules/system/layers/bpms na pasta do EAP 6.4.

2.1.3. Definindo Funções

Antes de iniciar o servidor e fazer o login no Business Central, você precisará criar algumas contas de usuários. Esta seção descreve as diferentes funções de usuários que são usadas no Red Hat JBoss BPM Suite :
  • admin: os usuários com funções admin são os administradores do aplicativo. Os administradores podem gerenciar os usuários e os repositórios (criar e clonar) e ter acesso completo para efetuar as alterações solicitadas no aplicativo. Os administradores têm acesso a todas as áreas do sistema.
  • desenvolvedor: um desenvolvedor tem acesso a quase todos os recursos e pode gerenciar as regras, os modelos, os fluxos de processos, os formulários e os painéis. Eles podem gerenciar o repositório de ativos, criar, construir e implantar projetos e podem até mesmo usar o RedHat JBossDeveloperStudio para visualizar os processos. Apenas certas funções administrativas, como criar e clonar um novo repositório, estão ocultas para a função de desenvolvedor.
  • analista: um analista tem acesso a todos os recursos de alto nível para modelar e executar seus projetos. No entanto, o acesso à Criação → Administração está indisponível para os usuários com a função de analista. Alguns recursos de nível mais baixo voltados para os desenvolvedores, como a visualização de Implantação → Repositório de Artefatos, não estão acessíveis para essa função. Já o botão Compilar & Implantar está disponível para a função de analista durante o uso do Editor de Projeto.
  • usuário: o usuário ou usuário de negócios trabalha com as listas de tarefas de negócios que são usadas para operar um certo processo. Um usuário com essa função pode acessar o painel e gerenciar processos.
  • gerenciador: um gerenciador é um visualizador do sistema que está interessado nas estatísticas referentes aos processos de negócios e seus desempenhos, indicadores de negócios e outros tipos de notificação do sistema. Um usuário com essa função tem acesso somente ao BAM.
Nota
Insira as funções mencionadas acima durante o processo de criação do usuário. Para mais informações sobre as funções, consulte Capítulo 2. Configuração do Business Central. Para informações adicionais sobre funções e interações de tarefas, consulte Apêndice 11.5 Tarefa de Usuário.

2.1.4. Criando Usuários

Para começar a adicionar novos usuários, você precisará executar o script add-user.sh em um sistema Unix ou o arquivo add-user.bat em um sistema Windows a partir do diretório bin.
  1. Execute 
    ./add-user.sh
    em um ambiente Unix ou 
    add-user.bat
    em um sistema Windows do diretório bin.
  2. Insira b para selecionar um Usuário do Aplicativo no prompt do usuário e pressione Enter.
  3. Aceite o Realm padrão (ApplicationRealm) pressionando Enter.
  4. No prompt de nome de usuário, insira um nome de usuário e confirme. Por exemplo: helloworlduser.
    Nota
    Certifique-se de que os nomes de usuário não entrem em conflito com grupos conhecidos. Por exemplo, caso haja um grupo chamado admin, você não deve criar um usuário com o nome de usuário admin.
  5. Crie a senha do usuário no prompt de senha e insira-a novamente. Por exemplo: Helloworld@123.
    Nota
    A senha deve ter, no mínimo, 8 caracteres e deve conter caracteres alfabéticos com letras maiúsculas e minúsculas (ex.: A-Z, a-z), ao menos um caractere numérico (ex.: 0-9) e ao menos um caractere especial (ex.: ~ ! @ # $ % ^ * ( ) - _ + =).
  6. Insira uma lista separada por vírgulas das funções que o usuário precisará no prompt de funções (consulte Seção 2.1.3, “Definindo Funções”).
  7. Confirme caso queira adicionar o usuário.
  8. Insira yes (sim) no próximo prompt para habilitar a clusterização no futuro, se necessário.

2.2. Instalação do Pacote Implantável Genérico

Para instalar o Red Hat JBoss BPM Suite no Red Hat JBoss Web Server (EWS), você precisa usar o pacote implantável genérico do produto.
Para a instalação no EWS, o pacote implantável genérico contém o gerenciador de transação adicional e as bibliotecas de segurança que não fazem parte do Red Hat JBoss EWS.
Observe que, para instalar o pacote implantável genérico, você precisará dos seguintes arquivos ZIP:
  • jboss-bpmsuite-6.3.0.GA-deployable-generic.zip: contém os aplicativos web business-central.war, dashbuilder.war e kie-server.war.
  • jboss-bpmsuite-6.3.0.GA-engine.zip: bibliotecas de mecanismo de execução com suporte para incorporar o mecanismo no seu aplicativo e outras bibliotecas necessárias para implantação genérica.

2.2.1. Baixando o Pacote Implantável Genérico

Para baixar o pacote implantável genérico Red Hat JBoss BPM Suite no JBoss Web Server, siga as instruções a seguir:
  1. Acesse o Portal do Cliente Red Hat e faça o login.
  2. Clique em Downloads.
  3. A partir da lista de produtos, clique em Red Hat JBoss BPM Suite.
  4. A partir do menu suspenso Versão, selecione a versão 6.3.0 (caso ainda não esteja selecionada).
  5. Na seção Downloads de Software que surgir, navegue pela linha do Red Hat JBoss BPM Suite 6.3 Implantável para odos os contêineres com suporte e clique em Download.
  6. Navegue também pela linha dos arquivos Red Hat JBoss BPM Suite 6.3.0 Core Engine e clique em Download para baixar os arquivos do JBoss BPM Suite Core Engine.

2.2.2. Instalando o Pacote Implantável Genérico

Para instalar o pacote implantável genérico, você precisará configurar o seguinte depois de ter instalado a plataforma subjacente (Red Hat JBoss WS):

2.2.2.1. Configurando o Gerenciador de Transação para o Red Hat JBoss Web Server 2.1 (Tomcat 7)

  1. Extraia o pacote zip implantável genérico baixado do Portal do Cliente Red Hat para um local temporário. Esse pacote zip contém os três arquivos do aplicativo web a seguir: business-central.war, dashbuilder.war e kie-server.war em um formato expandido. Renomeie essas pastas para remover a extensão .war.
  2. Copie essas pastas diretamente sob a pasta $TOMCAT_DIR/webapps.
    Você deve obter três pastas em um formato expandido: $TOMCAT_DIR/webapps/business-central, $TOMCAT_DIR/webapps/dashbuilder e $TOMCAT_DIR/webapps/kie-server.
    Observação
    $TOMCAT_DIR refere-se ao diretório home onde seu servidor web está localizado. Substitua-o pelo próprio caminho do diretório home do seu servidor web, por exemplo: /home/john/jboss-ews-2.1/tomcat7/
  3. Extraia os conteúdos dos arquivos do JBoss BPM Suite Engine para um local temporário de onde você pode copiar as bibliotecas necessárias. Essa pasta contém, agora, todas as bibliotecas principais do JBoss BPM Suite sob a pasta extraída e uma pasta lib.
  4. Instale o Gerenciador de Transação.
    Atenção
    Por favor, observe que a seção a seguir descreve a instalação de um gerenciador de transação, Bitronix, que não possui suporte da Red Hat.
    Copie as seguintes bibliotecas jar do gerenciador de transação da pasta lib no diretório $TOMCAT_DIR/lib/:
    • btm-VERSION.jar
    • btm-tomcat55-lifecycle-VERSION.jar
    • jta-VERSION.jar
    • slf4j-api-VERSION.jar
    • slf4j-jdk14-VERSION.jar
    Além disso, baixe a biblioteca a seguir e copie-a na pasta $TOMCAT_DIR/lib/ também:
  5. Instale o Driver no seu Banco de Dados
    Copie o arquivo jar com o driver do banco de dados relevante no $TOMCAT_DIR/lib/.
    Driver para o banco de dados H2 incoporado
    Caso utilize o banco de dados H2 incorporado, o driver estará disponível em business-central/WEB-INF/lib/.
  6. Crie os arquivos de configuração do gerenciador de transação em $TOMCAT_DIR/conf/:
    • btm-config.properties 
      bitronix.tm.serverId=tomcat-btm-node0
bitronix.tm.journal.disk.logPart1Filename=${btm.root}/work/btm1.tlog
bitronix.tm.journal.disk.logPart2Filename=${btm.root}/work/btm2.tlog
bitronix.tm.resource.configuration=${btm.root}/conf/resources.properties
    • resources.properties (resource.ds1.uniqueName define, depois, o nome da fonte de dados usado na definição do recurso tomcat - anote esse valor).
      Certifique-se de mudar os valores nas definições a seguir para corresponderem ao seu ambiente.

      Exemplo 2.2. Definição da fonte de dados H2

      resource.ds1.className=bitronix.tm.resource.jdbc.lrc.LrcXADataSource
resource.ds1.uniqueName=jdbc/jbpm
resource.ds1.minPoolSize=10
resource.ds1.maxPoolSize=20
resource.ds1.driverProperties.driverClassName=org.h2.Driver
resource.ds1.driverProperties.url=jdbc:h2:file:~/jbpm
resource.ds1.driverProperties.user=sa
resource.ds1.driverProperties.password=
resource.ds1.allowLocalTransactions=true

      Exemplo 2.3. Definição da fonte de dados MySQL 5.5

      resource.ds1.className=com.mysql.jdbc.jdbc2.optional.MysqlXADataSource
resource.ds1.uniqueName=jdbc/jbpm
resource.ds1.minPoolSize=0
resource.ds1.maxPoolSize=10
resource.ds1.driverProperties.URL=jdbc:mysql://localhost:3306/sampledb
resource.ds1.driverProperties.user=dbuser
resource.ds1.driverProperties.password=dbpassword
resource.ds1.allowLocalTransactions=true

      Exemplo 2.4. Definição da fonte de dados DB2 Tipo 4 

      resource.ds1.className=com.ibm.db2.jcc.DB2Driver
resource.ds1.uniqueName=jdbc/jbpm
resource.ds1.minPoolSize=0
resource.ds1.maxPoolSize=10
resource.ds1.driverProperties.URL=jdbc:db2://localhost:50000/sampledb
resource.ds1.driverProperties.user=dbuser
resource.ds1.driverProperties.password=dbpassword
resource.ds1.allowLocalTransactions=true

      Exemplo 2.5. Definição da fonte de dados Oracle 

      resource.ds1.className=oracle.jdbc.xa.client.OracleXADataSource
resource.ds1.uniqueName=jdbc/jbpm
resource.ds1.minPoolSize=0
resource.ds1.maxPoolSize=10
resource.ds1.driverProperties.URL=jdbc:oracle:thin:@//localhost:1521/bpms
resource.ds1.driverProperties.user=dbuser
resource.ds1.driverProperties.password=dbpassword
resource.ds1.allowLocalTransactions=true

      Exemplo 2.6. Definição da fonte de dados Microsoft SQL Server

      resource.ds1.className=com.microsoft.sqlserver.jdbc.SQLServerDriver
resource.ds1.uniqueName=jdbc/jbpm
resource.ds1.minPoolSize=0
resource.ds1.maxPoolSize=10
resource.ds1.driverProperties.URL=jdbc:sqlserver://localhost:1433;databaseName=bpms;
resource.ds1.driverProperties.user=dbuser
resource.ds1.driverProperties.password=dbpassword
resource.ds1.allowLocalTransactions=true
  7. Configure o ouvinte do gerenciador de transação no $TOMCAT_DIR/conf/server.xml para iniciar e encerrar Bitronix na inicialização e no desligamento do contêiner:
    Adicione o elemento a seguir como o último elemento <Listener> no elemento <Server>: 
    <Listener className="bitronix.tm.integration.tomcat55.BTMLifecycleListener" />
  8. Defina a propriedade de sistema btm.root e o local onde o arquivo de configuração bitronix será colocado:
    Em $TOMCAT_DIR/bin/, crie um arquivo legível setenv.sh com o seguinte conteúdo: 
    CATALINA_OPTS="-Xmx512M -XX:MaxPermSize=512m -Djava.security.auth.login.config=$CATALINA_HOME/webapps/business-central/WEB-INF/classes/login.config -Dbtm.root=$CATALINA_HOME -Dbitronix.tm.configuration=$CATALINA_HOME/conf/btm-config.properties -Dorg.jbpm.designer.perspective=RuleFlow -Djbpm.tsr.jndi.lookup=java:comp/env/TransactionSynchronizationRegistry"
    A propriedade org.jbpm.designer.perspective é definida como RuleFlow permitindo que a perspectiva padrão para o designer seja RuleFlow ao invés de Full. Conceda as permissões de execução do arquivo, se necessário.
    A propriedade java.security.auth.login.config deve ser definida para que o clone ssh do repositório git funcione.
    Tomcat nos sistemas do Microsoft Windows
    Nos sistemas do Microsoft Windows, substitua o valor $CATALINA_HOME no conteúdo do arquivo pelo nome da variável do ambiente equivalente ou use o caminho absoluto e adicione os valores no arquivo setenv.bat, como apresentado aqui, no exemplo a seguir: 
    set "CATALINA_OPTS=-Xmx512M -XX:MaxPermSize=512m -Dbtm.root=C:/Tomcat -Dbitronix.tm.configuration=C:/Tomcat/conf/btm-config.properties -Dorg.jbpm.designer.perspective=RuleFlow"

2.2.2.2. Configurando o Business Central para Red Hat JBoss Web Server 2.1 (Tomcat 7)

Para configurar o Business Central, siga as instruções a seguir:
  1. Defina um Valve para que o aplicativo web do Business Central possa carregar os usuários definidos no Tomcat:
    1. Defina os usuários e as funções em $TOMCAT_DIR/conf/tomcat-users.xml. Observe que o Business Central exige que os usuários tenham as funções especificadas como admin e/ou analista (para mais informações sobre as definições de usuário e função, consulte a documentação sobre Tomcat 7).
      Segue abaixo um exemplo de como essas duas funções seriam adicionadas e como elas seriam atribuídas a um usuário nomeado bpmsadmin.
      Nota
      Certifique-se de que os nomes de usuário não entrem em conflito com as funções conhecidas. Por exemplo, você não deve criar um usuário com o nome de usuário admin. 
        <role rolename="admin"/>
  <role rolename="analyst" />
  <user username="bpmsadmin" password="P@ssw0rd" roles="admin,analyst"/>
    2. Mova (não copie) kie-tomcat-integration-VERSION.jar de $TOMCAT_DIR/webapps/business-central/WEB-INF/lib/ para $TOMCAT_DIR/lib/.
    3. Copie jboss-jaxb-api-VERSION.jar de $TOMCAT_DIR/webapps/business-central/WEB-INF/lib/ para $TOMCAT_DIR/lib/.
    4. Em $TOMCAT_DIR/conf/server.xml, adicione a declaração Tomcat Valve no elemento <host> relevante: 
      <Valve className="org.kie.integration.tomcat.JACCValve" />
  2. Caso esteja utilizando uma fonte de dados que não seja a fonte de dados padrão fornecida pelo banco de dados H2 subjacente, você precisará definir as persistências. Se estiver usando o banco de dados H2 padrão, você pode ignorar as outras etapas deste procedimento.
    Nesse procedimento, você configura uma fonte de dados com o nome JNDI jdbc/myDatasource, como definido antes em uniqueName=jdbc/jbpm no arquivo resources.properties bitronix (para a opção MySQL).
    1. Em business-central/META-INF/context.xml, substitua o nome JNDI da fonte de dados no elemento <Resource>. O atributo uniqueName refere-se à propriedade resource.ds1.uniqueName definida em resources.properties: 
      <Resource name="jdbc/myDatasource" uniqueName="jdbc/jbpm" auth="Container" removeAbandoned="true" factory="bitronix.tm.resource.ResourceObjectFactory" type="javax.sql.DataSource"/>
    2. Em business-central/WEB-INF/web.xml, substitua o nome JNDI da fonte de dados no elemento <res-ref-name> pelo nome da sua fonte de dados: 
      <resource-ref>
        <description>Console DS</description>
        <res-ref-name>jdbc/myDatasource</res-ref-name>
        <res-type>javax.sql.DataSource</res-type>
        <res-auth>Container</res-auth>
</resource-ref>
    3. Altere business-central/WEB-INF/classes/META-INF/persistence.xml.
      Nesse arquivo, altere o nome do dialeto do hibernate usado para a sua fonte de dados, se estiver usando uma fonte de dados diferente da H2. O código abaixo demonstra as informações originais da fonte de dados para persistence.xml: 
      <property name="hibernate.dialect" value="org.hibernate.dialect.H2Dialect"/>
      Essas informações podem ser atualizadas da seguinte maneira (como demonstrado com o banco de dados MySQL abaixo): 
      <property name="hibernate.dialect" value="org.hibernate.dialect.MySQLDialect"/>
      Nota
      O dialeto para DB2 é org.hibernate.dialect.DB2Dialect, para DB2 em AS/400 é org.hibernate.dialect.DB2400Dialect, para Oracle é org.hibernate.dialect.Oracle10gDialect e para Microsoft SQL Server é org.hibernate.dialect.SQLServerDialect
    4. Altere o arquivo business-central/WEB-INF/classes/META-INF/persistence.xml para que o mecanismo do processo JBoss BPM Suite possa usar o novo banco de dados.
      O código abaixo demonstra as informações originais da fonte de dados para persistence.xml: 
      <jta-data-source>java:comp/env/jdbc/jbpm</jta-data-source>
      Altere esse valor para a fonte de dados definida antes: 
      <jta-data-source>java:comp/env/jdbc/myDatasource</jta-data-source>
  3. Você pode, agora, iniciar o JBoss Web Server para fazer o login no Business Central.
    1. Execute startup.sh no diretório $TOMCAT_HOME/bin. 
      ./startup.sh
    2. Navegue pelo http://localhost:8080/business-central em um navegador da web.
    3. Faça o login com o nome de usuário e a senha definidos antes no arquivo tomcat-users.xml.

2.2.2.3. Configurando o Dashbuilder para o Red Hat JBoss Web Server 2.0 (Tomcat 7)

Nota
Antes de configurar o Dashbuilder no Red Hat JBoss Web Server, você deve certificar-se de que o Business Central foi instalado e iniciado corretamente, como descrito na Seção 2.2.2.2, “Configurando o Business Central para Red Hat JBoss Web Server 2.1 (Tomcat 7)”. O Dashbuilder necessita que as tabelas da fonte de dados do log do histórico estejam presentes, as quais são fornecidas pelo Business Central. Se essas tabelas não existirem na fonte de dados antes de você tentar realizar as etapas abaixo, erros de inicialização podem ocorrer.
Para configurar o Dashbuilder no Red Hat JBoss Web server, siga as instruções a seguir:
  1. Defina os usuários e as funções em $TOMCAT_DIR/conf/tomcat-users.xml. Observe que, o Dashbuilder exige que os usuários tenham as funções especificadas como admin e/ou analista. Se você já definiu esses usuários antes para o Business Central, você não precisa definí-los novamente.
  2. Habilite o logon único entre o Dashbuilder e o Business Central removendo os comentários das seguintes linhas no arquivo $TOMCAT_DIR/conf/server.xml: 
    <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
  3. Quanto à configuração do Business Central, se você estiver usando um banco de dados que não seja o padrão e o banco de dados H2 integrado, você precisará definir as persistências.
    Nesse procedimento, você configura uma fonte de dados com o nome JNDI jdbc/dashbuilderDS, como definido em uniqueName=jdbc/jbpm no arquivo resources.properties bitronix:
    1. Em dashbuilder/META-INF/context.xml, substitua o nome JNDI da fonte de dados no elemento <Resource>. O atributo uniqueName refere-se à propriedade resource.ds1.uniqueName definida em resources.properties: 
      <Resource name="jdbc/dashbuilderDS" uniqueName="jdbc/jbpm" auth="Container" removeAbandoned="true" factory="bitronix.tm.resource.ResourceObjectFactory" type="javax.sql.DataSource"/>
      Nota
      Dependendo do seu banco de dados, pode ser preciso definir algumas outras propriedades também. Por exemplo, em um ambiente Oracle, essa entrada pode parecer-se com o seguinte: 
      <Resource name="jdbc/jbpm" uniqueName="jdbc/jbpm" auth="Container"  removeAbandoned="true" factory="bitronix.tm.resource.ResourceObjectFactory" type="javax.sql.DataSource" username="username" password="password"  driverClassName="oracle.jdbc.xa.client.OracleXADataSource" url="jdbc:oracle:thin:YOUR-URL:1521:YOUR-DB" maxActive="8" />
    2. Em dashbuilder/WEB-INF/web.xml, substitua o nome JNDI da fonte de dados no elemento <res-ref-name> pelo nome da sua fonte de dados: 
      <resource-ref>
    <description>Dashboard Builder Datasource</description>
    <res-ref-name>jdbc/dashbuilderDS</res-ref-name>
    <res-type>javax.sql.DataSource</res-type>
    <res-auth>Container</res-auth>
</resource-ref>
    3. Em dashbuilder/META-INF/context.xml, defina a fábrica de transação: 
       <Transaction factory="bitronix.tm.BitronixUserTransactionObjectFactory"/>
    4. Atualize o nome JNDI da fonte de dados em dashbuilder/WEB-INF/etc/hibernate.cfg.xml no elemento <session-factory>: 
      <property name="connection.datasource">java:/comp/env/jdbc/dashbuilderDS</property>
  4. Reinicie o servidor Web Java para que essas alterações sejam efetivadas. Depois de reiniciado, você pode navegar pelo Dashbuilder de dentro do Business Central ou diretamente via: http://localhost:8080/dashbuilder.

2.3. Iniciando o Servidor

Se você instalou o Red Hat JBoss BPM Suite usando a instalação do pacote JBoss EAP 6, você pode agora iniciar o seu servidor em um dos dois modos.
Nota
Se você instalou o JBoss BPM Suite usando a versão implantável genérica no Red Hat Java Web Server, as instruções para download e instalação também contêm informações sobre como iniciar o servidor. Nesse caso, você pode ignorar a discussão a seguir.
O script de inicialização padrão standalone.sh com que o Red Hat JBoss BPM Suite é enviado é otimizado para desempenho. Para executar o seu servidor no modo desempenho, siga as instruções a seguir:
  1. Na linha de comando, mova para o diretório $SERVER_HOME/bin/.
  2. Em um ambiente Unix, execute: 
    ./standalone.sh
    Em um ambiente Windows, execute: 
    ./standalone.bat
O Red Hat JBoss BPM Suite também é enviado com um script separado, standalone-secure.sh, que é otimizado para segurança. Esse script utiliza uma política de segurança por padrão que evita vulnerabilidades de segurança conhecidas.
Nota
É recomendável que os ambientes de produção usem o script standalone-secure.sh.
Atenção
É importante estar ciente de que o uso de um gerenciador de segurança afeta consideravelmente o desempenho. O equilíbrio entre segurança e desempenho deve ser mantido levando em consideração as circunstâncias individuais. Consulte Seção 2.4, “Gerenciamento de Desempenho e Gerenciador de Segurança do Java”.
Para executar o seu servidor no modo de segurança com esse script, siga as instruções a seguir:
  1. Na linha de comando, mova para o diretório $SERVER_HOME/bin/.
  2. Em um ambiente Unix, execute: 
    ./standalone-secure.sh
    Em um ambiente Windows, execute: 
    ./standalone-secure.bat
Nota
Se você instalou o JBoss BPM Suite usando o instalador, você terá a opção de aplicar a política de segurança no momento da instalação. O instalador não fornece um script standalone-secure.sh separado.
Nota
Se você estiver iniciando o servidor no modo de domínio, os scripts correspondentes serão domain.sh e domain-secure.sh respectivamente.

2.4. Gerenciamento de Desempenho e Gerenciador de Segurança do Java

Como observado anteriormente, a habilitação do Gerenciador de Segurança do Java (JSM) para desempenhar a avaliação em área restrita dos scripts MVEL no Red Hat JBoss BPM Suite introduz uma queda de desempenho em ambientes de alta carga. Os ambientes e marcadores de desempenho devem ser levados em consideração durante a implantação de um aplicativo JBoss BPM Suite. Use as diretrizes a seguir para a implantação de aplicativos seguros e de alto desempenho JBoss BPM Suite.
  • Em ambientes de alta carga, onde o desempenho é crítico, recomenda-se implantar somente os aplicativos que foram desenvolvidos em outros sistemas e que foram revisados adequadamente. Recomenda-se também não criar usuários com a função de analista em tais sistemas. Se essas salvaguardas forem seguidas, é seguro deixar o JSM desabilitado nesses sistemas para que ele não introduza degradação alguma ao desempenho.
  • Nos ambientes de desenvolvimento e de testes sem altas cargas, ou em ambientes onde a criação de processos e regras está exposta às redes externas, recomenda-se ter o JSM habilitado para atingir os benefícios de segurança das avaliações em área restrita do MVEL.
Não é seguro e nem recomendável permitir que os usuários com a função de analista façam o log in no console do Business Central com o JSM desabilitado.

Capítulo 3. Fazendo o log in no Business Central

Faça o log in no Business Central após o servidor ser iniciado com êxito.
  1. Navegue até o http://localhost:8080/business-central em um navegador da web. Caso a interface do usuário tenha sido configurada para execução a partir de um modo de domínio, substitua localhost pelo nome do domínio. Por exemplo, http://www.example.com:8080/business-central.
  2. Faça o login usando as credenciais do usuário que foram criadas durante a instalação. Por exemplo: Usuário = helloworlduser e senha = Helloworld@123.

Capítulo 4. Projeto Hello World

Para demonstrar os recursos básicos do Red Hat BPM Suite, este capítulo fornecerá instruções sobre como configurar o projeto Hello World com um processo de negócios Hello World. Esse processo de negócios exibirá a messagem Hello World! e concluirá a execução. Para exemplos adicionais que fazem uso da funcionalidade completa da regra 'quando-então', consulte Getting Started with Rules and Facts no Red Hat JBoss BPM Suite Development Guide.
Você será instruído a fazer o seguinte:
  1. Criar um repositório Hello World no repositório de artefatos.
  2. Criar o projeto Hello World com a definição do processo de negócios HelloWorld.
  3. Modelar a lógica do processo Hello World no processo de negócios usando a ferramenta gráfica do Designer de Processos.
  4. Compilar e implantar o projeto no Mecanismo de Execução local.
  5. Executar o processo Hello World.
  6. Monitorar a execução do processo.

4.1. Criando Estruturas de Repositório

Todos os ativos de negócios encontram-se nos repositórios que estão nas Unidades Organizacionais, que são diretórios no repositório de artefatos. Por padrão, o repositório de artefatos não contém nenhuma unidade organizacional. Portanto, para criar os seus próprios ativos de negócios, tais como, um processo de negócios, você precisa criar uma unidade organizacional no repositório de artefatos e um repositório (Git) nela. O repositório poderá, então, conter o seu Projeto. Um projeto pode conter uma estrutura de pacote arbitrária, o que permite a estruturação do seu conteúdo na estrutura lógica do "diretório". Qualquer pacote pode conter os seus ativos de negócios (para mais informações sobre o repositório de artefatos, consulte Red Hat JBoss BPM Suite User Guide).
Para criar uma estrutura de repositórios, siga as instruções a seguir:
  1. Abra o Business Central no seu navegador da web e faça o login como um usuário com a função admin (por exemplo helloworlduser).
  2. Crie uma unidade organizacional no repositório de artefatos:
    1. Vá até Criação → Administração.
    2. No menu de perspectiva, clique em Unidades Organizacionais → Gerenciar Unidades Organizacionais.
    3. No modo de exibição Gerenciar Unidade Organizacional, clique em Adicionar.
      Na caixa de diálogo exibida Adicionar Nova Unidade Organizacional, defina as propriedades da unidade e clique em OK:
      • Nome: helloworld
      • Proprietário: helloworlduser
  3. Crie um novo repositório na unidade organizacional helloworld:
    1. Vá até Criação → Administração.
    2. No menu de perspectiva, clique em Repositórios → Novo repositório.
    3. Na caixa de diálogo exibida Criar Repositório, defina as propriedades do repositório:
      • Nome do Repositório: helloworldrepo
      • Unidade Organizacional: helloworld
    4. Clique em Concluir.
  4. Vá até Criação → Criação de Projeto.
  5. No Explorador de Projeto, na caixa de diálogo suspensa da unidade organizacional, selecione helloworld e na caixa de diálogo suspensa do repositório, selecione helloworldrepo.

    Figura 4.1. Seleção do Repositório helloworldrepo no Grupo Organizacional helloworld no Explorador de Projeto

    Seleção do Repositório helloworldrepo no Grupo Organizacional helloworld no Explorador de Projeto
  6. Crie um projeto no repositório helloworld:
    1. No menu de perspectiva, vá até Novo Item → Projeto.
    2. No assistente exibido Novo Projeto, defina as propriedades do seu Projeto:
      • Nome do Projeto: HelloWorld
      • ID do Grupo: org.bpms
      • ID do Artefato: HelloWorld
      • ID da Versão: 1.0
    3. Clique em Concluir.

Capítulo 5. Processo Hello World

Neste capítulo, daremos continuidade ao exemplo Hello World e criaremos um processo de negócios de ponta a ponta, demonstrando a criação de um Processo Hello World básico.

5.1. Criando o Processo de Negócios

Para criar uma nova definição do Processo de Negócios, siga as instruções a seguir:
  1. Exiba a perspectiva Criação de Projeto (Criação → Criação de Projeto).
  2. No modo de exibição do Explorador de Projeto à esquerda, selecione a unidade organizacional helloworld, o repositório helloworldrepo e o projeto HelloWorld.
  3. No menu de perspectiva, clique em Novo Item → Processo de Negócios e defina os detalhes do Processo:
    • Insira o nome do Processo de Negócios como HelloWorld.
    • Selecione o pacote org.bpms.helloworld. Isto determina o local no repositório de artefatos, onde você criará a sua definição do Processo de Negócios.
      Seleção de Pacotes
      Certifique-se de selecionar o pacote org.bpms.helloworld. A seleção de um pacote incorreto gera falhas na implantação.
  4. Clique em OK.
O Designer de Processos com o canvas da definição do Processo criada abrirá.

5.2. Modelando o Processo de Negócios

Depois de ter criado a definição do Processo de Negócios, você pode elaborar o Processo de Negócios: O designer do Processo de Negócios deve estar aberto em uma guia à direita. Se você tiver fechado a guia, no Explorador de Projeto, clique em HelloWorld abaixo de Processos de Negócios para reabrir o designer do Processo de Negócios. Certifique-se de selecionar o pacote correto (org.bpms.helloworld). Para elaborar o conteúdo do Processo, siga as instruções a seguir:
  1. Expanda a paleta Biblioteca de Objetos com os Elementos do Processo: clique no botão de seta dupla ( ) no canto superior esquerdo da guia do designer do Processo de Negócios.
  2. Um elemento Evento Inicial aparece no canvas.
  3. Clique no elemento Evento Inicial: os itens de acesso rápido aparecem perto do nó. Clique no ícone de Tarefa ( ) para criar um Fluxo de Sequência de saída e um elemento de Tarefa conectado ao Evento Inicial.
  4. Crie um Evento Timer: a partir da paleta, arraste e solte o Timer (sob Capturando Eventos Intermediários) e conecte a Tarefa ao Elemento do Timer usando o menu de acesso rápido.
  5. Crie o elemento do Evento Final conectado ao elemento do Evento Timer (seja usando o recurso de acesso rápido ou arrastando-o a partir da paleta).

Figura 5.1. Rascunho do Processo HelloWorld

Rascunho do Processo HelloWorld

5.3. Definindo as Propriedades do Elemento

Agora, você precisa definir as propriedades do elemento:
  1. Clique na seta dupla ( ) no canto superior direito para expandir a guia Propriedades.
  2. Clique em qualquer lugar no canvas. A guia Propriedades exibe as propriedades do Processo HelloWorld. As propriedades necessárias são predefinidas, no entanto, você pode mudar os seus valores, caso necessário.
  3. O Elemeto Inicial e o Elemento Final possuem proriedades opcionais apenas. No entanto, os Elementos de Tarefa precisam dos seus tipos e, depois, das propriedades de tipo específico definidas. Clique no elemento de tarefa e defina as propriedades necessárias:
    • Nome: ScriptTask
    • Tipo de Tarefa: Script
    • Linguagem do Script: java
    • Script: System.out.println("Hello World!");
      Clique em OK.
    Você definiu uma Tarefa que desempenhará um script mediante execução. O script é definido em Java e executa o método System.out.println("Hello World!"), o que significa que ele gravará Hello World! à saída padrão do servidor. Por padrão, a saída padrão do servidor é o console em que o servidor foi iniciado.
  4. Você ainda precisa definir as propriedades do Evento Timer para fazer com que o processo aguarde durante o tempo de execução, assim você pode inspecionar a sua execução. Clique no Elemento Timer e defina o tempo que ele deve aguardar para a execução:
    • Defina a Duração de Tempo para 1m e clique em Ok.
      O processo aguardará, assim, por 1 minuto no Evento Timer, após executar a Tarefa de Script.
  5. Forneça um nome ao Evento Timer usando a mesma guia e, então, salve seu processo: clique em Salvar na parte superior do Editor do Processo de Negócios.
  6. Um prompt Salve este item é exibido. Insira o Comentário de check-in.
    Nota
    O comentário de check-in seria uma descrição breve do tipo de alteração que você realizou. Ele precisa ser inserido todas as vezes que um ativo é salvo.
  7. Clique na barra de ferramentas do Designer de Processos com o processo, certificando-se de que o processo definido esteja válido. O contorno de qualquer elemento com um ou vários erros de validação fica laranja. Consulte Red Hat JBoss BPM Suite User Guide para informações sobre o recurso de validação.
Mais informações sobre Elementos de Processos e suas propriedades estão disponíveis em Red Hat JBoss BPM Suite User Guide.

5.4. Compilando e Implantando

Antes de você poder instanciar o seu Processo Hello World, você precisa compilar todo o projeto e implantá-lo no Servidor de Execução:
  1. No menu principal do Business Central, vá até Criação → Criação de Projeto.
  2. No Explorador de Projeto, localize o projeto Hello World.
  3. Abra o projeto no Editor de Projeto: no Explorador de Projeto, clique em Abrir Editor de Projeto.
  4. Verifique se os detalhes corretos do projeto são exibidos na Tela do Projeto e clique em Compilar → Compilar & Implantar no canto superior direito do modo de exibição da Tela do Projeto.

    Figura 5.2. Editor de Projeto com as Propriedades do Projeto HelloWorld

    Project Editor with the HelloWorld Project Properties.
Uma notificação verde aparece na parte superior da tela informando que o projeto foi compilado e implantado no Servidor de Execução e está disponível para instalação.

5.5. Criando Instâncias no Processo de Negócios

Para criar uma instância do processo Hello World, ou seja, para executar o processo de negócios, siga as instruções a seguir:
  1. Clique em Gerenciamento de Processos → Definições de Processos no menu principal.
  2. Na guia Definições de Processos exibida, localize o processo Hello World. Pode ser que você precise clicar no botão Atualizar para obter a implantação exibida na lista.
  3. Clique no botão Iniciar( ) próximo à entrada da definição do Processo e na caixa de diálogo Enviar para confirmar que você deseja instanciar o processo.
    O Processo é instanciado com o atual usuário conectado, já que o proprietário do processo e o formulário do processo são exibidos. O formulário pode servir para solicitar entradas de um usuário na instanciação do processo, se definido; consulte Red Hat JBoss BPM Suite User Guide para mais informações.
O modo de exibição Detalhes da Instância do Processo apresenta os detalhes da instância do processo iniciado. A mensagem Hello World! aparece na saída padrão, geralmente no emulador do terminal no qual o servidor foi iniciado. Depois, a instância do processo aguarda pelo Evento Timer. Clique em Opções → Modelo do Processo para ver o status da execução atual.

Figura 5.3. Diagrama de Execução em Tempo Real do HelloWorld: Evento Timer Sendo Executado

Diagrama de Execução em Tempo Real do HelloWorld: Evento Timer Sendo Executado

5.6. Abortando o Processo de Negócios

No momento, uma instância do Processo HelloWorld está em execução no Servidor de Execução. Isto pode ser verificado no modo de exibição Instâncias do Processo: para exibí-lo, vá até Gerenciamento de Processos → Instâncias do Processo.
A partir deste ponto, você pode visualizar os Detalhes da Instância clicando na linha de um processo selecionado. Além disto, você pode desempenhar ações administrativas básicas, como enviar um sinal a uma instância do processo ( ) ou abortá-la ( ).
Depois que um processo de negócios é instanciado, uma instância do processo aguardará pelo Evento Timer. Para abortar a instância, clique na linha com as informações da instância. A instância desaparecerá da lista de instâncias do processo Ativas e aparecerá na lista Abortadas.

Figura 5.4. Lista de Instâncias do Processo Abortadas

List of Aborted Process Instances

Capítulo 6. Regra de Negócios Hello World

Já que o Red Hat JBoss BPM Suite é enviado junto com o Red Hat JBoss BRMS integrado, esse capítulo fornece uma introdução sobre como as regras de negócios funcionam e são integradas ao JBoss BPM Suite.
Você adicionará uma nova Tarefa de Regra de Negócios ao processo HelloWorld, o qual acionará (verificará) uma regra de negócios de um grupo de regra de negócios em particular.
Observe que este é um caso de integração muito simples e, em produção, você pode precisar usar técnicas e um conceito mais avançado, tais como tabelas de decisão. Para mais informações sobre regras de negócios e BRMS, consulte Red Hat JBoss BRMS User Guide.

6.1. Criando a Regra de Negócios

As regras de negócios são definidas como lógicas 'quando-então': quando algo é verdadeiro, então ele acontece (por exemplo, quando a pessoa tem mais de 18 anos, ela pode acessar um conteúdo em particular). As regras de negócios são armazenadas em arquivos DRL.
Para definir a regra de negócios helloworldrule no projeto HelloWorld, siga as instruções a seguir:
  1. No Explorador de Projeto, selecione a unidade organizacional helloworld, o repositório helloworldrepo, o projeto HelloWorld e o pacote default.
    Seleção do Pacote
    Certifique-se de selecionar o pacote default. A seleção de um pacote incorreto gera falhas na implantação.
  2. Crie o arquivo DRL:
    1. No menu de perspectiva, clique em Novo Item → arquivo DRL.
    2. Na caixa de diálogo, Criar novo arquivo DRL, defina o nome do recurso como helloworldrule e verifique se o pacote está definido como org.bpms.helloworld.
    3. Clique em OK.
  3. No editor DRL exibido com o arquivo helloworldrule.drl, defina a regra: 
    rule "helloworldrule"
ruleflow-group "helloworldgroup"
when
then
	System.out.println("Hello World!");
end
    Essa regra nao define nenhuma condição de 'quando', ou seja, ela sempre será verdadeira, quando acionada (chamada para executar), e a expressão Hello World! será impressa.
  4. Clique em Salvar.
  5. Um prompt Salve este item é exibido. Insira o Comentário de check-in e clique em Save.

6.2. Adicionando a Tarefa de Regra de Negócios

Uma Tarefa de Regra de Negócios é uma tarefa que aciona regras que pertencem a um certo grupo de fluxo de regra.
Para adicionar uma Tarefa de Regra de Negócios ao seu processo, siga as instruções a seguir:
  1. Abra o seu Processo de Negócios no Designer de Processos: no Explorador de Projeto, selecione o projeto HelloWorld, o pacote org.bpms.helloworld, clique em PROCESSOS DE NEGÓCIOS e selecione o processo HelloWorld.
    Seleção de Pacotes
    Certifique-se de selecionar o pacote org.bpms.helloworld. A seleção de um pacote incorreto gera falhas na implantação.
  2. No designer do Processo de Negócios com o processo helloWorld, expanda a paleta Biblioteca de Objetos com os Elementos do Processo: clique no botão de seta dupla ( ) no canto superior esquerdo da guia do designer do Processo de Negócios.
  3. Expanda o menu Tarefas e arraste e solte a tarefa de Regra de Negócios ao canvas à direita.
    Ajuste as conexões de fluxo para que a tarefa seja integrada ao fluxo de trabalho.
  4. Selecione a Tarefa de Regra de Negócios e defina as suas propriedades no painel Propriedades:
    • Nome: BusinessRule
    • Grupo do Fluxo de Regra: helloworldgroup
      A propriedade Grupo do Fluxo de Regra (em inglês, Ruleflow Group) define o grupo de regras que deve ser acionado quando a tarefa está sendo executada. Neste exemplo, apenas uma regra, a regra helloworldrule definida no arquivo helloworldrule.drl, está presente no grupo helloworldgroup.

    Figura 6.1. Processo HelloWorld com a Tarefa de Regra de Negócios e suas Propriedades

    Processo HelloWorld com a Tarefa de Regra de Negócios e suas Propriedades
  5. Clique no botão Salvar para salvar as suas alterações.

6.3. Compilando e Implantando

Compile o Projeto inteiro e implante-o no Servidor de Execução:
  1. No menu principal do Business Central, vá até Criação → Criação de Projeto.
  2. No Explorador de Projeto, localize o projeto HelloWorld.
  3. Abra o projeto no Editor de Projeto: no Explorador de Projeto, clique em Abrir Editor de Projeto.
  4. Verifique se os detalhes corretos do projeto são exibidos na Tela do Projeto e clique em Compilar → Compilar & Implantar no canto superior direito do modo de exibição da Tela do Projeto.

    Figura 6.2. Editor de Projeto com as Propriedades do Projeto HelloWorld

    Project Editor with the HelloWorld Project Properties
Uma notificação verde aparece na parte superior da tela informando que o projeto foi compilado e implantado no Servidor de Execução e está disponível para instalação.
Nota
A versão prévia da implantação HelloWorld é substituída pela nova contendo a Tarefa de Regra de Negócios. Para manter ambas implantações, altere o número da versão do projeto no Editor de Projeto.

6.4. Criando Instâncias no Processo de Negócios

Para criar uma instância do processo HelloWorld, ou seja, para executar o processo de negócios, siga as instruções a seguir:
  1. Clique em Gerenciamento de Processos → Definições de Processos no menu principal.
  2. Na guia Definições de Processos exibida, localize HelloWorld. Pode ser que você precise clicar em Atualizar para obter a implantação exibida na lista.
  3. Clique no botão Iniciar( ) próximo à entrada da definição do processo e na caixa de diálogo Enviar para confirmar que você deseja instanciar o processo.
    O Processo é instanciado com o atual usuário conectado, já que o proprietário do processo e o formulário do processo são exibidos (o formulário pode servir para solicitar a entrada de um usuário na instanciação do processo, se definido; consulte Red Hat JBoss BPM Suite User Guide).
O modo de exibição Detalhes da Instância do Processo apresenta os detalhes da instância do processo iniciado. A mensagem Hello World! aparece na saída padrão duas vezes, geralmente no emulador do terminal no qual o servidor foi iniciado. Depois, a instância do processo aguarda pelo Evento Timer. Clique em Opções → Modelo do Processo para ver o status da execução atual.

Figura 6.3. Diagrama de Execução em Tempo Real do HelloWorld: Evento Timer Sendo Executado

Diagrama de Execução em Tempo Real do HelloWorld: Evento Timer Sendo Executado

Capítulo 7. BAM

7.1. Acessando o Dashbuilder do Red Hat BPM Suite

O Dashbuilder é a interface do usuário baseada na web do Red Hat JBoss BPM Suite para o Monitoramento de Atividades de Negócios. Para acessar o Dashbuilder do Business Central, vá até Painéis → Painéis de Tarefas & Processos.
O painel exibido fornece, à esquerda, as estatísticas sobre os dados do tempo de execução selecionados. Você pode criar o seu próprio painel no Dashbuilder. Para fazê-lo, abra o Dashbuilder clicando em Painéis → Painéis de Negócios.

7.2. Monitorando Instâncias

O Dashbuilder fornece um painel especial que permite o monitoramento do status dos dados do tempo de execução (instâncias do processo e tarefas) no seu Mecanismo de Execução.
Para visualizar esses dados, vá até Painéis → Painel de Tarefas & Processos.

Figura 7.1. Painel de Tarefas e Processos

Painel de Tarefas e Processos
No painel esquerdo, você pode selecionar uma entidade para exibir as estatísticas. Os gráficos e dados à direita são, então, atualizados de forma correspondente.

Capítulo 8. Red Hat JBoss Developer Studio

O RedHat JBossDeveloperStudio é o ambiente de desenvolvimento integrado (IDE) do JBoss baseado no Eclipse. Para obter as informações mais atualizadas sobre o JBoss Developer Studio, acesse o Portal do Cliente Red Hat https://access.redhat.com. O JBossDeveloperStudio fornece plug-ins com ferramentas e interfaces para o RedHat JBossBRMS e o RedHat JBossBPM Suite. Esses plug-ins são baseados nas versões da comunidade desses produtos. Portanto, o plug-in do JBoss BRMS é chamado de plug-in Drools e o plug-in do JBoss BPM Suite é chamado de plug-in jBPM.
Consulte a documentação RedHat JBossDeveloperStudio para instruções de instalação e configuração.
Atenção
Certifique-se de que a instância do JBoss Developer Studio seja iniciada com a codificação do arquivo definida como UTF-8, devido a um problema na forma como os nomes de regra com múltiplos bytes são tratados. Você pode fazer isto editando o arquivo $JBDS_HOME/studio/jbdevstudio.ini e adicionando a seguinte propriedade: "-Dfile.encoding=UTF-8"

8.1. JBoss Central

Quando o JBoss Developer Studio 8.0 é iniciado pela primeira vez, o JBoss Central é exibido na janela principal do workbench. A partir do JBoss Central, é possível criar novos projetos selecionando as opções de menu sob Começar do zero. Os projetos de exemplo podem ser iniciados selecionando os links sob Iniciar a partir de uma amostra.
Nota
Devido a problemas no GWT3, o JBDS deve ser configurado para não usá-lo. Você pode fazer isto definindo a propriedade do sistema como 0: 
# Don't use GTK 3
export SWT_GTK3=0

Figura 8.1. JBoss Central

JBoss Central

[D]

8.2. Instalando os Plug-ins do JBoss Developer Studio

Os plug-ins Drools e jBPM para o JBoss Developer Studio estão disponíveis através do site de atualização.

Procedimento 8.1. Instale os Plug-ins Drools e jBPM do JBoss Developer Studio

  1. Inicie o JBoss Developer Studio.
  2. Selecione Ajuda → Instale Novo Software.
  3. Clique em Adicionar para inserir o menu Adicionar Repositório.
  4. Forneça um nome ao site do software próximo ao campo Nome e adicione o seguinte url ao campo Local: https://devstudio.jboss.com/updates/8.0/integration-stack/
  5. Clique em OK.
  6. Selecione o recurso JBoss Business Process and Rule Development a partir das opções disponíveis e clique em Próximo e, depois, em Próximo novamente.
  7. Leia o contrato de licença e aceite seus termos selecionando o botão de opção apropriado e clique em Concluir.
  8. Após concluir a instalação dos plug-ins, reinicie o JBoss Developer Studio.

8.3. Definindo o Tempo de Execução do Plug-in Drools

Para usar o plug-in do Red Hat JBoss BRMS com o RedHat JBossDeveloperStudio, é necessário configurar o tempo de execução.
O tempo de execução é uma coleção de arquivos jar que representa um lançamento específico do software e fornece as bibliotecas necessárias para a compilação e execução dos seus ativos de negócios.

Procedimento 8.2. Configure o Tempo de Execução do JBoss BRMS

  1. Extraia os arquivos jar do tempo de execução localizados no arquivo jboss-brms-VERSION-engine.zip, que pode ser baixado através do Portal do Cliente Red Hat.
  2. A partir do menu JBossDeveloperStudio, selecione a Janela e clique em Preferências.
  3. Selecione Drools → Tempos de Execução dos Drools Instalados.
  4. Clique em Adicionar...; forneça um nome para o novo tempo de execução e clique em Navegar para navegar até o diretório onde você extraiu os arquivos do tempo de execução na etapa 1. Clique em OK para registrar o tempo de execução selecionado no JBDS.
  5. Marque o tempo de execução que você criou como o tempo de execução padrão do Drools clicando na caixa de seleção próxima a ele.
  6. Clique em OK. Caso tenha projetos existentes, uma caixa de diálogo indicará que você deve reiniciar o JBossDeveloperStudio para atualizar o tempo de execução.

8.4. Definindo o Tempo de Execução do JBoss BPM Suite

Para usar o plug-in do Red Hat JBoss BPM Suite com o RedHat JBossDeveloperStudio, é necessário configurar o tempo de execução.
O tempo de execução é uma coleção de arquivos jar que representa um lançamento específico do software.
Se você baixou anteriormente o arquivo zip implantável genérico do JBoss BPM Suite a partir do Portal do Cliente Red Hat, os arquivos jar que compõem o tempo de execução ficarão localizados no arquivo jboss-bpms-engine.zip.

Procedimento 8.3. Configure o Tempo de Execução do jBPM

  1. A partir do menu JBossDeveloperStudio, selecione a Janela e clique em Preferências.
  2. Selecione jBPM → Tempos de Execução do jBPM Instalados.
  3. Clique em Adicionar...; forneça um nome para o novo tempo de execução e clique em Navegar para navegar até o diretório onde o tempo de execução está localizado.
  4. Clique em OK, selecione o novo tempo de execução e clique em OK de novo. Se você tiver projetos existentes, uma caixa de diálogo indicará que você deve reiniciar o JBossDeveloperStudio para atualizar o tempo de execução.

8.5. Configurando o JBoss BPM Suite Server

O JBoss Developer Studio pode ser configurado para executar o Red Hat JBoss BPM Suite Server.

Procedimento 8.4. Configure o Servidor

  1. Abra o modo de exibição do jBPM jBPM selecionando Janela → Abrir Perspectiva → Outros e selecione jBPMjBPM. Depois, clique em OK.
  2. Adicione o modo de visualização do servidor selecionando Janela → Mostrar Modo de Exibição → Outros... e selecione Servidor → Servidores.
  3. Abra o menu do servidor clicando com o botão direito do mouse no painel Servidores e selecione Novo → Servidor.
  4. Defina o servidor selecionando JBoss Enterprise Middleware → JBoss Enterprise Application Platform 6.4+ e clique em Próximo.
  5. Defina o diretório home clicando no botão Navegar. Navegue e selecione o diretório de instalação para o JBoss EAP 6.4, o qual possui o JBoss BPM Suite JBoss BPM Suite instalado.
  6. Forneça um nome para o servidor no campo Nome, certifique-se de que o arquivo de configuração esteja definido e clique em Concluir.

8.6. Importando os Projetos de um Repositório Git no JBoss Developer Studio

Nota
Este é um recurso adicional e não é necessário para trabalhar com o JBoss Developer Studio.
Você pode configurar o JBoss Developer Studio para conectar-se a um repositório central de ativos Git. O repositório armazena regras, modelos, funções e processos.
Você pode clonar um repositório remoto Git ou importar um repositório local Git.

Procedimento 8.5. Clonando um Repositório Remoto Git

  1. Inicie o Red Hat JBoss BRMS/BPM Suite Server (conforme aplicável) selecionando o servidor através da guia servidor e clique no ícone iniciar.
  2. Simultaneamente, inicie o servidor Secure Shell, se ainda não estiver em execução, usando o comando a seguir. O comando é específico ao Linux e Mac apenas. Caso o sshd já tenha sido iniciado nessas plataformas, esse comando não funcionará. Nesse caso, é mais seguro ignorar essa etapa. 
    /sbin/service sshd start
  3. No JBoss Developer Studio, selecione Arquivo → Importar... e navegue até a pasta Git. Abra a pasta Git e selecione Projetos do Git e clique em Próximo.
  4. Selecione a fonte do repositório como Clonar URI e clique em Próximo.
  5. Insira os detalhes do repositório Git na próxima janela e clique em Próximo.

    Figura 8.2. Detalhes do Repositório Git

    Detalhes do Repositório Git
  6. Selecione a ramificação que você deseja importar na janela seguinte e clique em Próximo.
  7. Para definir o armazenamento local deste projeto, insira (ou selecione) um diretório não vazio, aplique quaisquer alterações de configuração e clique em Próximo.
  8. Importe o projeto como um projeto geral na janela seguinte e clique em Próximo. Nomeie o projeto e clique em Concluir.

Procedimento 8.6. Importando um Repositório Local Git

  1. Inicie o Red Hat JBoss BRMS/BPM Suite Server (conforme aplicável) selecionando o servidor através da guia servidor e clique no ícone iniciar.
  2. No JBoss Developer Studio, selecione Arquivo → Importar... e navegue até a pasta Git. Abra a pasta Git e selecione Projetos do Git e clique em Próximo.
  3. Selecione a fonte do repositório como Repositório local existente e clique em Próximo.

    Figura 8.3. Detalhes do Repositório Git

    Detalhes do Repositório Git
  4. Selecione o repositório a ser configurado a partir da lista de repositórios disponíveis e clique em Próximo.
  5. Na caixa de diálogo que abrir, selecione o botão de opção Importar como projeto geral do Assistente para o grupo de importação de projetos e clique em Próximo. Nomeie o projeto e clique em Concluir.

    Figura 8.4. Assistente para a Importação de Projetos

    Assistente para a Importação de Projetos

8.7. Criando um Projeto Drools

Procedimento 8.7. Criando um Novo Projeto RedHat JBossDeveloperStudio

  1. A partir do menu principal, selecione Arquivo → Novo → Projeto.
    Selecione Drools → Projeto Drools e clique em Próximo.
  2. Insira um nome para o projeto na caixa de texto Nome do projeto: e clique em Próximo.
    OBSERVAÇÃO
    O JBossDeveloperStudio fornece a opção de adicionar uma amostra do arquivo da regra HelloWorld ao projeto. Para aceitar este padrão clique em Próximo e teste o projeto de exemplo nas etapas a seguir.
  3. Selecione o tempo de execução do plug-in Drools (ou use o padrão).
  4. Selecione o código compatível com o Drools 6.0.x. Insira um GroupID, ArtifactID, Version e clique em Concluir.
  5. Para testar o projeto, clique com o botão direito do mouse no arquivo Java que contém o método principal e selecione Executar → executar como → Aplicativo Java.
    O resultado será exibido na guia do console.

8.8. Criando um Projeto JBoss BPM Suite

Procedimento 8.8. Criando um novo Projeto JBoss BPM Suite no RedHat JBossDeveloperStudio

  1. A partir do menu principal, selecione Arquivo → Novo → Projeto.
    Selecione jBPM → Projeto jBPM e clique em Próximo.
  2. Insira um nome para o projeto na caixa de texto Nome do projeto: e clique em Próximo.
    Arquivo HelloWorld de Exemplo
    O JBossDeveloperStudio fornece a opção de adicionar uma amostra do arquivo da regra HelloWorld ao projeto. Para aceitar este padrão clique em Próximo e teste o projeto de exemplo nas etapas a seguir.
  3. Selecione o tempo de execução do jBPM (ou use o padrão).
  4. Selecione gerenciar código compatível com jBPM 6 ou superior e clique em Concluir.
  5. Para testar o projeto, clique com o botão direito do mouse no arquivo Java que contém o método principal e selecione Executar → executar como → Aplicativo Java.
    O resultado será exibido na guia do console.

Capítulo 9. Business Resource Planner

O Business Resource Planner é um mecanismo de planejamento leve e incorporável que otimiza a resolução de problemas. Ele ajuda os programadores de Java TM a resolver problemas de planejamento de maneira eficiente e combina métodos heurísticos e meta heurísticos de otimização com cáculos de pontuação bastante eficientes.
O Planner ajuda a resolver vários casos de uso, como os seguintes:
  • Escalas de Funcionários/Pacientes. O Planner ajuda a criar escalas de trabalho para enfermeiros e monitora a gestão de pacientes.
  • Calendário Escolar. O Planner ajuda a agendar aulas, cursos, provas e apresentações de palestras.
  • Escalonamento de Produção: O Planner controla as linhas de montagem de carros, o planejamento das filas de máquinas e o planejamento da alocação de pessoal.
  • Redução de Estoque: O Planner minimiza o desperdício reduzindo o consumo de recursos, tais como papel e aço.

9.1. Instalando o Business Resource Planner

  1. Navegue pelo Portal do Cliente Red Hat e faça o login com as suas credenciais de usuário.
  2. Selecione Downloads → Downloads de Produtos.
  3. Quando a página Downloads de Produtos abrir, clique em Red Hat JBoss BPM Suite.
  4. A partir do menu suspenso Versão, selecione 6.3.
  5. Selecione Red Hat JBoss BPM Suite 6.3 Business Resource Planner e depois clique em Download.

9.2. Executando os Exemplos do Business Resource Planner

  1. Na linha de comando, mova para o diretório examples/.
  2. Em um ambiente Unix, execute o seguinte comando: 
    ./runExamples.sh
    Em um ambiente Windows, execute o seguinte comando: 
    ./runExamples.bat
  3. Selecione um exemplo que abra através do aplicativo GUI e execute-o no seu IDE de preferência.

Apêndice A. Histórico de Revisões

Histórico de Revisões
Revisão 6.3.0-5.1Fri May 27 2016Red Hat Localization Services
Tradução de arquivos sincronizados com a versão 6.3.0-5 de fontes do XML
Revisão 6.3.0-5Thu May 5 2016Tomas Radej
Criado com links ativos.
Revisão 6.3.0-4Thu May 5 2016Tomas Radej
Links de inicialização.
Revisão 6.3.0-3Thu Apr 28 2016Tomas Radej
Recriação de todos os guias.
Revisão 6.3.0-2Thu Apr 28 2016Tomas Radej
Recriação de todos os guias.
Revisão 6.3.0-1Thu Apr 28 2016Tomas Radej
Criação inicial para o lançamento 6.3.0 do JBoss BPM Suite.

Nota Legal

Copyright © 2016 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.