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:
- Crie um novo documento de entrada UMF_QUERY.
- No segmento ROOT, digite as tags e valores UMF necessários:
- 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.
- 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.
- 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.
- Na tag ENTITY_ID, digite o ID de entidade para a entidade sobre a qual
você deseja retornar informações.
- Digite outros critérios de consulta utilizando outros segmentos UMF opcionais
de <NAME>, <ADDRESS>, <EMAIL>, <ATTRIBUTE>
e <NUMBER>.
- 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>