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 em um ou mais arquivos de esquemas de modelos de mensagens. Para selecionar
mensagens, o Projeto do Message Broker deve
ter uma referência para os arquivos de esquemas de modelos de mensagens.
Será necessário ter uma referência a um projeto 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ó,
também deverá especificar o nome dos arquivos de esquemas de modelos de mensagens que contêm o modelo de
mensagem. Para preencher previamente a lista de arquivos de esquemas de modelos de mensagens na propriedade Mensagem,
o Projeto do Message Broker deve ter uma referência
aos arquivos de esquemas de modelos 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
arquivos de esquemas de modelos 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 no Visualização Desenvolvimento
do Broker e selecione o item de 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, os arquivos de esquemas de modelos 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 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.