Se você tiver uma instância do painel configurada e precisar criar outra instância dos terminais de serviço em seu ambiente, é necessário configurar o IBM Business Monitor de forma que os widgets possam exibir dados a partir de diversos terminais de serviço. Você deve editar dois arquivos: o arquivo de terminais, que registra terminais com o componente Business Space e o arquivo de catálogo do widget, que contém definições dos widgets.
Antes de concluir esta etapa, você deve ter concluído as seguintes tarefas: v Instalado o produto.
v Criado um servidor ou cluster e configurado-o para Business Space .
v Configurado as tabelas de banco de dados (se estiver utilizando um banco de dados remoto ou ambiente de implementação).
v Configurado os serviços Representational State Transfer (REST) adicionais para seus widgets adicionais. Em um ambiente de implementação, você pode ter particionamento de trabalho. Por exemplo, você pode ter dois clusters, um que processa dados contábeis e um que processa dados de seguros. Entretanto, um terminal em serviço serve apenas um cluster. Para acessar ambas as partições de trabalho do painel, é necessário registrar dois widgets separados, um para cada partição de trabalho, para que você possa acessá-los a partir do painel. Por exemplo, você poderia ter um widget Lista de Tarefas Humanas da Conta e um widget Lista de Tarefa de Seguros no catálogo (ambos com o mesmo código da lista de tarefas manuais real).
Arquivos de terminal em serviço de widget são fornecidos em um pacote configurável com cada produto e incluídos durante a instalação do produto. Você deve editar um ou mais dos arquivos de terminal em serviço, com base nos produtos instalados e widgets que você está usando com o IBM Business Monitor. A lista a seguir inclui exemplos de gerenciamento de processos de negócios da IBM dos arquivos de terminal em serviço do widget:
v IBM Business Monitor: monitorEndpoints.xml
v IBM Business Monitor com o IBM Cognos Business Intelligence: cognosEndpoints.xml
v WebSphere Enterprise Service Bus: wesbWidgetEndpoints.xml (para widgets do Mediation Policy Administration, Service Browser e Proxy Gateway), bpmAdministrationEndpoints.xml (para widgets de Administration)
v IBM Business Process Manager: wpsEndpoints.xml, bpmAdministrationEndpoints.xml (para widgets de Administration), wesbWidgetEndpoints.xml (para widgets do Mediation Policy Administration, Service Browser e Proxy Gateway), HumanTaskManagementEndpoints.xml (para processos de negócios e tarefas manuais), bspaceWFSEndpoints.xml (para usar o Lotus Webform Server com widgets do Human Task Management)
v Todos os produtos: wsumEndpoint.xml (para associação do usuário)
Os arquivos de catálogo de widgets contêm a definição de widgets para seu produto. Você deve editar um ou mais dos seguintes arquivos de widget, com base nos produtos instalados e widgets que você está usando com o Business Space. A lista a seguir inclui exemplos de gerenciamento de processos de
negócios da IBM dos arquivos de catálogo de widget: v IBM Business Monitor: catalog_WBMonitor.xml
v WebSphere Enterprise Service Bus: catalogProxyGateway.xml e catalog_ServiceAdmin.xml v IBM Business Process Manager: catalog_BPMAdministration.xml, catalog_BusinessRules.xml,
catalog_ServiceAdmin.xmle catalog_HumanTaskManagement.xml
Os arquivos de terminal em serviço e arquivos de catálogo de widget estão localizados em
install_root\BusinessSpace\registryData\product_name\. Os arquivos de terminais estão localizados no subdiretório endpoints e os arquivos de catálogo estão localizados no subdiretório catalogs.
O diretório install_root\BusinessSpace\registryData\product_name\ contém os arquivos de modelo de catálogo de widget e de terminal em serviço para seu produto. É possível copiar os arquivos necessários para usar como um modelo e incluir suas mudanças.
1. De modo a ter múltiplas instâncias de um widget, você deve instalar os aplicativos que fornecem widgets com nome de aplicativo e raiz de contexto exclusivos para cada instância do widget. a. Implemente o aplicativo de widget no destino de implementação do Business Space (o mesmo
servidor ou cluster no qual o aplicativo BSpaceEAR_server_node está sendo executado) para cada instância de widget. A lista a seguir inclui exemplos de gerenciamento de processos de negócios da IBM dos arquivos Archive Corporativo (EAR) do widget:
v BPMAdministrationWidgets_nodename_servername (para WebSphere Enterprise Service Bus e IBM Business Process Manager)
v HumanTaskManagementWidgets_nodename_servername (para IBM Business Process Manager e IBM Business Monitor)
v WBMDashboardWeb_nodename_servername (para IBM Business Monitor) v wesbWidgets_nodename_servername (para WebSphere Enterprise Service Bus)
b. Ao implementar, atualize o nome do aplicativo e os nomes das raízes de conteúdo do módulo da Web para um nome exclusivo. Tome nota dos nomes de raízes de conteúdo usados.
2. Edite os novos terminais em serviço REST para os destinos de implementação de aplicativo adicionais (o servidor ou cluster no qual o aplicativo de serviços REST está implementado). Crie um arquivo de terminais em serviço para incluir terminais em serviço.
a. Localize os arquivos de terminal no diretório install_root\BusinessSpace\registryData\ product_name\endpoints. Copie o arquivo de modelo dos terminais e remova todos os terminais que você não pretende alterar.
b. Edite o arquivo de terminais e inclua um terminal em serviço adicional iniciando com
<tns:Endpoint>, com um ID exclusivo (<tns:id>) e a URL para o novo terminal (<tns:url>), mas com a mesma versão, e opcionalmente com todos os códigos do idioma do terminal original. O tipo (<tns:type>) deve ter o mesmo valor do ID (<tns:id>). É possível alterar nome e descrição, por exemplo Lista de tarefas de seguro da minha equipe.
c. Ao adicionar terminais, atente para as seguintes informações:
v <tns:id>: O ID pode ser qualquer cadeia mas deve ser exclusivo para todos os terminais registrados. Assegure que este ID seja exclusivo quando você estiver incluindo terminais adicionais.
v <tns:type>: O tipo deve ter o mesmo valor de <tns:id>.
v <tns:url>: Para o terminal em serviço, se a URL for relativa, será assumido que o terminal em serviço REST é co-localizado com o servidor Business Space. Se a URL for relativa, certifique-se de que ela seja igual à raiz de contexto que você implementou, mas com indicações de diretório inicial e final, por exemplo, <tns:url>/REST_Endpoint_for_server2/</tns:url>. Se seu terminal estiver em um sistema remoto, atualize esse campo com uma URL absoluta, mas com uma indicação de término de diretório.
v <tns:description>: Digite uma descrição significativa que detalhe ainda mais a natureza do conjunto de dados em que este terminal está trabalhando. Ela poderia ser baseada no cluster que está trabalhando no conjunto de dados ou na natureza do conjunto de dados, por exemplo,
tarefas manuais de reclamação de seguroou tarefas manuais de dados contábeis. d. Salve as alterações.
Exemplo de terminal em serviço, localizado em monitorEndpoints.xml: <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/bpm/monitor/</tns:url>
<tns:description>Location of backing services for Monitor widgets </tns:description>
</tns:Endpoint>
3. No arquivo de terminais em serviço, inclua um terminal de widget para cada instância de widget. a. Edite o arquivo de terminais criado na etapa 2. Inclua um terminal de widget adicional iniciado
por <tns:Endpoint> e com um ID exclusivo (<tns:id>). O tipo (<tns:type>) deve ter o mesmo valor do ID (<tns:id>). A URL para o novo terminal (<tns:url>) deve ser igual à raiz de contexto implementada na etapa 1., mas com indicações de início e término de diretório, por exemplo,
<tns:url>/BSpaceWidgetsWPS2/</tns:url>. O terminal de widget incluído deve conter a mesma versão e pode, opcionalmente, conter todos os códigos do idioma do terminal original. É possível alterar nome e descrição.
b. Ao adicionar terminais, atente para as seguintes informações:
v <tns:id>: O ID pode ser qualquer cadeia mas deve ser exclusivo para todos os terminais registrados. Assegure que este ID seja exclusivo quando você estiver incluindo terminais adicionais.
v <tns:type>: O tipo deve ter o mesmo valor de <tns:id>.
v <tns:url>: Para o terminal de widget, certifique-se de que a URL é igual à raiz de contexto implementada, mas com indicações de início e término de diretório, por exemplo
<tns:url>/BSpaceWidgetsWPS2/</tns:url>.
v <tns:description>: Digite uma descrição significativa que detalhe ainda mais a natureza do conjunto de dados em que este terminal está trabalhando. Ela poderia ser baseada no cluster que está trabalhando no conjunto de dados ou na natureza do conjunto de dados, por exemplo,
c. Salve as alterações.
Exemplo de terminal de widget, localizado em monitorEndpoints.xml: <tns:Endpoint>
<tns:id>{com.ibm.wbimonitor}monitorWidgetRootId2</tns:id>
<tns:type>{com.ibm.wbimonitor}monitorWidgetRootId2</tns:type> <tns:version>1.0.0.0</tns:version>
<tns:url>/BusinessDashboards/</tns:url>
<tns:description>Location for Monitor widgets</tns:description> </tns:Endpoint>
4. Crie um arquivo de catálogo de widget para incluir novas definições de widget.
a. Localize o arquivo de catálogo de widget no diretório install_root\BusinessSpace\registryData\ product_name\catalogs. Copie o arquivo de modelo do catálogo. Para o novo nome de arquivo, use o seguinte padrão: catalog_widget.xml (sem espaços no nome do arquivo), em que widget é igual ao valor do ID do elemento <catalog> no arquivo. Remova todos os elementos <category> que você não deseja alterar. Para a categoria com a qual está trabalhando, remova todos os elementos <entry> que você não deseja alterar.
b. Inclua uma <entry> com um ID exclusivo, por exemplo, id="{com.ibm.bspace.widget}widget_id, e um nome exclusivo, por exemplo, unique-name="{com.ibm.bspace.widget}widget_name. Todas as outras definições podem ser mantidas.
c. Altere o título e a descrição para disponibilizar o novo widget como um widget distinto em Business Space que descreve a natureza do novo terminal. Por exemplo, poderia denominar o widget Lista de tarefas de seguro da minha equipe em <title>. O título poderia ajudar os
usuários de negócios a escolherem o widget certo. A descrição deve ajudar os usuários de negócios a entenderem a natureza dos dados e a funcionalidade de widgets que estão selecionando.
d. Edite o novo arquivo XML do catálogo de widget para fazer referência ao novo terminal de widget: Altere a definição para corresponder com o <tns:id> do novo terminal de widget incluído na etapa 3.a.
Por exemplo, altere-o para: ...
<definition>endpoint://{com.ibm.wbimonitor}monitorWidgetRootId2/com/ibm/wbimonitor/ common/iWidgets/instances_iWidget.xml</definition>
...
e. Em <metadata> do arquivo de catálogo, certifique-se de que endpoint:// corresponda ao tipo e ao ID no arquivo de terminal (<tns:type> e <tns:id>).
f. Em <metadata> do arquivo de catálogo, certifique-se de que "refVersion" : corresponda à versão no arquivo de terminal (<tns:version>).
g. Salve as alterações.
É possível usar a definição de widget no fragmento de código de exemplo abaixo como base para suas mudanças:: <entry id="{com.ibm.wbimonitor}instances" unique-name="{com.ibm.wbimonitor}instances"> <title> <!-- END NON-TRANSLATABLE --> <nls-string xml:lang="en">Instances</nls-string> <!-- START NON-TRANSLATABLE --> </title> <description> <!-- END NON-TRANSLATABLE --> <nls-string xml:lang="en">Instances</nls-string> <!-- START NON-TRANSLATABLE --> </description> <shortDescription> <!-- END NON-TRANSLATABLE -->
<nls-string xml:lang="en">Esse widget exibe um painel com
o contexto de monitoramento disponível em instâncias individuais ou grupos
definidos pelo usuário de instâncias de contexto.</nls-string> <!-- START NON-TRANSLATABLE --> </shortDescription> <definition>endpoint://{com.ibm.wbimonitor}monitorWidgetRootId /com/ibm/wbimonitor/common/iWidgets/instances_iWidget.xml</definition> <content>endpoint://{com.ibm.wbimonitor}monitorWidgetRootId/img/ thumb_instances.gif</content> <preview>endpoint://{com.ibm.wbimonitor}monitorWidgetRootId/img/ prev_instances.gif</preview> <previewThumbnail>endpoint://{com.ibm.wbimonitor}monitorWidgetRootId/ img/prev_instances.gif</previewThumbnail> <help>endpoint://{com.ibm.bspace}bspaceWidgetHelpRootId/topic/ com.ibm.bspace.help.widg.mon.doc/topics/help_instance_whatis.html</help> <icon>endpoint://{com.ibm.wbimonitor}monitorWidgetRootId/img/ icon_instances.gif</icon> <metadata name="com.ibm.mashups.builder.autoWiringEnabled">true </metadata> <metadata name="com.ibm.bspace.version">7.0.0.0</metadata> <metadata name="com.ibm.bspace.owner">International Business Machines Corp.</metadata> <metadata name="com.ibm.bspace.serviceEndpointRefs"> [{"name":"serviceUrlRoot", "required":"true", "refId":"endpoint://{com.ibm.wbimonitor}monitorServiceRootId", "refVersion":"1.0.0.0"}]</metadata> </entry>
5. Coloque o novo arquivo de terminal em serviço e o novo arquivo de catálogo de widget em um arquivo compactado e execute o comando updateBusinessSpaceWidgets usando o parâmetro -widgets para especificar o local do arquivo compactado.
v Após executar o comando updateBusinessSpaceWidgets, é necessário executar etapas manuais para atualizar modelos e espaçosdos painéis. Para obter mais informações, consulte Atualizando Modelos e Espaços após a Instalação ou Atualização de Widgets.
v Se os painéis estiverem em execução em uma célula diferente de onde os serviços REST estão em execução, é necessário editar manualmente os arquivos de 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.