O documento de entrada UMF_QUERY contém os critérios de pedido e de procura
para uma procura de pipeline de serviços da Web. Ele contém a coleta de segmentos UMF
que estruturam os dados de entrada para consultar o banco de dados da entidade e, em seguida,
localizar e retornar informações sobre uma entidade específica ao aplicativo de chamada.
As informações em um documento de entrada UMF_QUERY são baseadas em instruções SQL.
Os resultados desta procura de pipeline de serviços da Web são retornados ao aplicativo de
chamada em um documento de saída UMF_QUERY_RESULT.
Estas tags UMF incluem o segmento ROOT para o documento de entrada UMF_QUERY:
- DSRC_CODE
- A tag UMF do código da origem de dados é necessária, porque faz referência e identifica
o aplicativo de chamada. Como parte da criação de log de pipeline normal, este código de origem de dados
é registrado na tabela UMF_LOG para cada UMF_QUERY processado.
- O sistema já está configurado com um código de origem de dados, 1589, que pode ser
utilizado para todas as procuras de pipeline de serviços da Web. Este código de origem de dados desempenha
o processamento de resolução da entidade sem resolver os critérios de procura de entrada
com a entidade no banco de dados da entidade que corresponde à procura. Você pode criar seu próprio
código de origem de dados para um aplicativo de chamada específico, apenas certifique-se de que
o código de origem de dados esteja configurado para não resolver entidades.
- DSRC_REF
- A tag UMF de referência da origem de dados é necessária, porque faz referência à
transação de mensagem solicitante e é retornada ao aplicativo de chamada.
- FORMAT_CODE
- A tag UMF correlacionada a um formato de documento de saída UMF especificado
na tabela UMF_OUTPUT_FORMAT. 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 da entidade solicitado
- WS_RELATION, que retorna uma lista de todas as entidades relacionadas à entidade
de entrada no grau 1
- Consulta WS_ALERT, que retorna todos os alertas no sistema que envolvem o ID da entidade
de entrada
- ENTITY_ID
- Esta tag UMF necessária especifica o ID da entidade para a entidade na procura.
O sistema retorna uma resposta com detalhes de dados conhecidos
sobre esta entidade a partir do banco de dados da entidade, com base nos outros critérios de procura.
Os segmentos UMF opcionais do documento de entrada UMF_QUERY são:
- <NAME>
- <ADDRESS>
- <EMAIL_ADDR>
- <NUMBER>
- <ATTRIBUTE>
Procura UMF_QUERY de Exemplo
Este UMF_QUERY de exemplo
utiliza o código de formato WS_DETAIL para consultar o banco de dados da entidade e retornar
todas as informações conhecidas sobre o ID da 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>