Quando um projeto faz referência a outros
projetos na área de trabalho, isso é chamado de referência do projeto.
Quando um projeto se refere a outro, os arquivos no projeto referenciado ficam
disponíveis para uso pelo projeto referido. Por exemplo, para configurar certos nós, criar bibliotecas
de fluxos de mensagem reutilizáveis e para ativar o assistente de conteúdo no editor ESQL.
Os cenários a seguir, no
WebSphere Message Broker
Toolkit, fornecem
exemplos de referências do projeto:
- Ao configurar um nó do Mapeamento
em um fluxo de mensagens, você deve selecionar as mensagens de origem e destino para o
mapa. As mensagens estão contidas dentro de um ou mais conjuntos de mensagens.
Para selecionar mensagens, o Projeto
do Message Broker deve
ter uma referência para os projetos do conjunto de mensagens. Será necessário ter uma referência a um projeto de
de design de dados, se desejar mapear para um banco de dados ou a partir dele.
- Ao configurar um nó, como um nó MQInput, é possível definir um modelo de mensagem para o
tipo de mensagem que o nó processa.
Se você tiver escolhido MRM, SOAP, XMLNSC, DataObject ou IDOC como a propriedade Domínio de mensagem do nó, você também deverá especificar o nome do conjunto de mensagens que contém a definição da mensagem. Para pré-preencher a lista de conjuntos de mensagens
na propriedade Conjunto de mensagens,
o Projeto
do Message Broker deve ter uma referência
para os projetos do conjunto de mensagens.
- Talvez você queira criar uma biblioteca de sub-rotinas ESQL reutilizáveis
em um Projeto
do Message Broker ou criar uma biblioteca
de fluxos de mensagens para reutilizar em outros fluxos. Um fluxo de mensagens no qual você
queira usar essas sub-rotinas ou fluxos de mensagens deve ter uma referência
ao Projeto
do Message Broker a partir de seu Projeto
do Message Broker pai.
- Também é possível usar referências de projeto para ativar o Assistente de Conteúdo no editor ESQL. O "Assistente de Conteúdo" é uma ajuda de contexto que exibe maneiras válidas através das quais uma instrução de código pode ser concluída.
Se você configurar uma referência de projeto a partir de um Projeto
do Message Broker que contenha código ESQL para
um projeto de conjunto de mensagens, o editor ESQL poderá exibir uma lista de
referências de mensagens válidas.
- Se você usar o Explorer de Padrões para gerar uma instância padrão a partir de uma especificação padrão, o projeto de instância padrão gerado conterá referências a todos os outros projetos gerados a partir do padrão. Consulte o Usando Padrões.
Para criar ou remover uma referência de projeto manualmente, clique com o botão direito do mouse no
nome do projeto na visualização Desenvolvimento de Broker e selecione o item do menu Propriedades. Selecione Referências do Projeto a partir da janela Propriedades e será exibida uma lista de todos os projetos regulares na área de trabalho, a partir da qual você poderá selecionar ou limpar referências do projeto. O fluxo de mensagens, o conjunto de mensagens e os projetos de instância padrão possuem um item de menu adicional Incluir ou Remover Referências de Projeto que ativa a janela Incluir ou Remover Referências de Projeto na qual é possível selecionar ou limpar as referências do projeto.
Se, posteriormente, você fechar ou excluir um projeto referenciado, ou excluir um objeto dentro dele, ele não estará mais disponível para o projeto referenciado e será gerado um erro. Você
pode corrigir o erro abrindo o projeto fechado ou incluindo o objeto
ausente, com o nome correto e salvando.