IM Centro de Informações do Relationship Resolution, Versão 4.2

Construindo Consultas de Serviços da Web para Localizar uma Entidade Específica

Utilize estas instruções para construir um documento de entrada UMF_QUERY para localizar uma entidade específica no banco de dados da entidade. Você envia o documento de entrada UMF_QUERY por meio de serviços da Web para um pipeline de serviços da Web para processamento. Quando o pipeline processar a consulta, os serviços da Web retornarão um documento de saída UMF_QUERY_RESULT que contém os detalhes sobre a entidade de entrada solicitada.

Antes de iniciar :
O WebSphere Application Server deve estar em execução e pelo menos um pipeline de serviços da Web deve estar iniciado e em execução para receber e processar o documento de entrada UMF_QUERY.
Sobre Esta Tarefa:
Como o pedido de consulta é um documento de entrada UMF, os critérios devem ser formatados utilizando tags UMF válidas. Você pode utilizar qualquer editor de texto ou utilitário que cria UMF.
Procedimento:
  1. Crie um novo documento de entrada UMF_QUERY.
  2. No segmento ROOT, digite as tags e valores UMF necessários:
    1. Digite o código da origem de dados na tag DSRC_CODE. O código da origem de dados padrão para procuras de pipeline de serviços da Web é 1589. Se você utilizar um código da origem de dados diferente do código da origem de dados de procura de pipeline de serviços da Web padrão, certifique-se de que ele esteja configurado para não resolver entidades.
    2. Digite o código de referência da origem de dados que faz referência à transação da mensagem solicitante na tag DSRC_REF. O código de referência da origem de dados deve ser significativo, porque ele é retornado ao aplicativo de chamada.
    3. Digite o código de formato para indicar o formato de saída dos resultados utilizando a tag FORMAT_CODE. O IBM Relationship Resolution é fornecido com três códigos de formato integrado para uma procura de pipeline de serviços da Web utilizando UMF_QUERY:
      • WS_DETAIL, que retorna todos os dados da entidade disponíveis para o ID de entidade de entrada
      • WS_RELATION, que retorna uma lista de todas as entidades relacionadas ao ID de entidade de entrada em um relacionamento de grau 1
      • Consulta WS_ALERT, que retorna todos os alertas de função no sistema que envolvem o ID de entidade de entrada
      Se você utilizar um código de formato diferente, ele deverá ser configurado na tabela UMF_OUTPUT_FORMAT.
    4. Na tag ENTITY_ID, digite o ID de entidade para a entidade sobre a qual você deseja retornar informações.
  3. Digite outros critérios de consulta utilizando outros segmentos UMF opcionais de <NAME>, <ADDRESS>, <EMAIL>, <ATTRIBUTE> e <NUMBER>.
  4. Envie o documento de entrada UMF_QUERY para um pipeline de serviços da Web.
Um pipeline de serviços da Web alimenta o documento UMF_QUERY utilizando os critérios especificados para localizar entidades no banco de dados que correspondem à consulta. O pipeline então processa a consulta, cria arquivos de criação de log normais e retorna os resultados em um documento de saída UMF_QUERY_RESULT por meio de serviços da Web para o aplicativo de chamada.

Procura UMF_QUERY de Exemplo

Este UMF_QUERY de exemplo procura todas as informações sobre o ID de entidade 1223:
Nota: Este exemplo é formatado para capacidade de leitura e não segue a linha única necessária por formato de registro UMF.
<UMF_QUERY>
	<DSRC_CODE>1589</DSRC_CODE> 	
	<DSRC_REF>546</DSRC_REF>
	<FORMAT_CODE>WS_DETAIL</FORMAT_CODE>
	<ENTITY_ID>1223</ENTITY_ID>
</UMF_QUERY>
Tarefas relacionadas
Construindo Consultas de Serviços da Web para Localizar Entidades com Atributos Semelhantes
Ativando o Mecanismo de Contagem Dinâmico


Feedback

Última atualização: 2007