É necessário editar manualmente arquivos de terminais se os painéis estiverem em execução em uma célula diferente de onde os serviços Representational State Transfer (REST) estão em execução ou se os widgets estiverem em células diferentes de IBM Business Monitor.
Antes de concluir esta etapa, você deve ter concluído as seguintes tarefas: v Instalado o IBM Business Monitor.
v Criado perfis e configurado o componente Business Space em um destino de implementação (servidor ou cluster).
v Configurado as tabelas de banco de dados (se estiver utilizando um banco de dados remoto ou ambiente de implementação).
Todos os widgets necessários para o seu produto são instalados com o IBM Business Monitor, mas é necessário configurar e registrar os terminais necessários pelos widgets antes da sua equipe poder usá-los nos painéis. É possível configurar e registrar os terminais usando as páginas do console administrativo. Porém, se o seu produto e os serviços REST estiverem instalados em uma célula diferente do componente Business Space, você deve editar os arquivos de terminais de serviço REST para que eles acessem os serviços REST e os seus widgets funcionam adequadamente no IBM Business Monitor.
Edite um ou mais dos arquivos de terminal de serviço e arquivos de terminal de widget, com base nos widgets que estiver usando com o IBM Business Monitor. Os arquivos de terminal em serviço
normalmente contêm Endpoint ou Endpoints no nome do arquivo XML, e os arquivos de terminal de widget normalmente contêm Widget ou Widgets no nome do arquivo XML. A lista a seguir inclui exemplos de gerenciamento de processos de negócios da IBM dos arquivos de terminal em serviço e arquivos de terminal de widget:
v IBM Business Monitor: monitorEndpoints.xml e monitorWidget.xml
v IBM Business Monitor com IBM Cognos Business Intelligence: cognosEndpoints.xml e cognosWidget.xml
v wsumEndpoint.xmle wsumWidget.xml (para participação do usuário)
Se você for um administrador, pode registrar terminais e ativar widgets executando as seguintes etapas. 1. Copie o arquivo compactado do widget remoto localizado em install_root\BusinessSpace\
registryData\product_name\product_name_widget_set_name_crosscell.zipna célula em que o
Business Space é configurado durante a instalação do produto. Os widgets podem estar localizados no diretório e ser copiados em uma pasta temporária.
2. Extraia crosscell.zip em um diretório temporário.
3. Localize os arquivos de terminal em serviço e os arquivos de terminais de widget.
No diretório em que extraiu o arquivo, consulte o diretório endpoints para visualizar todos os arquivos de terminal de widget e arquivos de terminal em serviço. Normalmente, os nomes de arquivos terminam com Endpoints.xml ou Endpoint.xml.
4. Configure os terminais conforme necessário editando os arquivos de terminal em serviço e os arquivos de terminal de widget.
a. Edite os arquivos de terminal em serviço para apontarem para o serviço.
Cada terminal no arquivo de terminal em serviço é designado por um bloco <tns:Endpoint>. Identifique o bloco que deseja alterar. Procure comentários que identifiquem onde fazer as edições, por exemplo:
<!-- Quando o seu serviço REST estiver remoto do seu servidor Business Space, atualize o seguinte valor de URL com a URL completamente qualificada para o serviço.
Por exemplo, https://host.domain.com:9443/rest/bpm/monitor/ --> <tns:url>/rest/bpm/monitor/</tns:url>
Dica: Se você não desejar ativar alguns terminais, é possível removê-los do arquivo para evitar confusão.
O local identificado por um terminal é especificado em <tns:url>. Esse valor é um caminho em um módulo da Web, especificado como uma HTTP URL integral ou relativa. Por padrão, a URL é relativa. Altere-o para um caminho de URL integral, por exemplo, https://
virtualhost.com:virtualport/rest/bpm/htmou http://host1:9445/WBPublishingDRAFT/, onde o protocolo, host e porta identificam como o módulo da web do produto podem ser acessados. Para localizar o número da porta para o servidor, desempenhe as seguintes etapas:
v Efetue login no console administrativo.
v Clique em Servidores > Tipos de Servidor > WebSphere Application Servers.
v Clique no servidor para o qual você deseja localizar o número da porta e, em seguida, expanda a seção Portas.
Todos os aplicativos usam a mesma porta, conforme exibido no parâmetrowc_defaulthost (host inseguro) ou no wc_defaulthost_secure (host seguro).
Dica: Se você estiver utilizando um servidor HTTP para acessar seus módulos da Web para balanceamento de carga, utilize o nome do host e as configurações de porta do servidor HTTP. b. Edite os arquivos de terminal de widget para apontarem para o local do Business Space em que os
widgets serão implementados.
Cada terminal no arquivo de terminal em serviço é designado por um bloco <tns:id>. Identifique o bloco que deseja alterar. Procure comentários que identifiquem onde fazer as edições, por exemplo:
<!-- Ao usar widgets em uma configuração remota, atualize o seguinte valor de URL com a URL completamente qualificada do módulo da web do widget. Por exemplo, https://host.domain.com:9443/BusinessDashboard/ -->
<tns:url>/BusinessDashboard/</tns:url>
O local identificado por um terminal é especificado em <tns:url>. Altere-o para um caminho de URL completo que aponte para o local do Business Space em que oswidgets são implementados, por exemplo, https://host.domain.com:port/BusinessDashboard/
5. Na célula na qual o servidor Business Space está configurado, execute o comando
updateBusinessSpaceWidgetspara atualizar as URLs de terminais depois de modificar os arquivos XML de terminais.
a. Para seu perfil, abra uma janela de comando. O comando wsadmin pode ser localizado no diretório profiles\profile_name\bin . Para um ambiente em cluster, execute o comando a partir do diretório deployment_manager_profile_root\bin. Para um ambiente de servidor independente, execute o comando a partir do diretório profile_root\bin.
b. No prompt de comandos, digite o comando wsadmin para iniciar o ambiente wsadmin.
c. Execute o comando updateBusinessSpaceWidgets. Para um ambiente em cluster, especifique o parâmetro -clusterName. Para um ambiente de servidor independente, especifique os parâmetros
-serverName e -nodeName. Especifique o parâmetro -endpoints com o caminho completo para o diretório em que extraiu os arquivos de terminal de widget. Especifique o parâmetro -catalogs para apontar para o diretório em que extraiu o arquivo de catálogo de widget.
6. Reinicie o servidor.
O seguinte arquivo de terminal de exemplo é para os widgets do IBM Business Monitor.
<?xml version="1.0" encoding="UTF-8"?> <!-- START NON-TRANSLATABLE -->
<tns:BusinessSpaceRegistry xmlns:tns="http://com.ibm.bspace/BusinessSpaceRegistry" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://com.ibm.bspace/BusinessSpaceRegistry BusinessSpaceRegistry.xsd "> <tns:Endpoint> <tns:id>{com.ibm.wbimonitor}monitorServiceRootId</tns:id> <tns:type>{com.ibm.wbimonitor}monitorServiceRootId</tns:type> <tns:version>1.0.0.0</tns:version> <tns:url>/rest/</tns:url>
<tns:description>Location of backing services for Monitor widgets </tns:description>
</tns:Endpoint>
</tns:BusinessSpaceRegistry>
<!-- END NON-TRANSLATABLE -->
v Após a execução do comando installBusinessSpaceWidgets ou do comando
updateBusinessSpaceWidgets, é necessário executar etapas manuais para atualizar modelos e espaços dos painéis. Para obter mais informações, consulte Atualizando Modelos e Espaços após a Instalação ou Atualização de Widgets.
v Para várias instâncias dos terminais de serviço, por exemplo para particionamento de trabalho em dois clusters e se você desejar que os widgets mostrem dados de cada cluster, você deve ativar os widgets adicionais manualmente para cada cluster adicional. Você deve editar ambos os arquivos de terminais de widgets e os arquivos de catálogo de widgets. Para obter mais informações, consulte Ativando Widgets para Trabalhar com Diversos Terminais.
v Se você ativou a segurança para seu ambiente, é necessário certificar-se de que ele esteja configurado apropriadamente para trabalhar com painéis.