Criando ou transformando uma mensagem de saída JSON usando a função Definido pelo usuário para modelar os dados JSON

Você pode usar a função Add User Defined no Editor de Mapeamento de Dados Gráficos para criar ou transformar uma mensagem de objeto JSON ou uma mensagem de matriz JSON.

Sobre esta tarefa

Ao criar um mapa de mensagem, você pode optar por fornecer o modelo dos dados JSON a partir de um esquema JSON, ou você pode definir seus dados JSON usando a função Add User Defined no mapa. Este tópico explica como usar a função Incluir definido pelo usuário. Para obter informações sobre como usar um esquema JSON, consulte Criando ou transformando uma mensagem JSON usando um esquema JSON.

Os modelos predefinidos estão disponíveis sob a categoria de modelos de mensagens fornecidas do IBM® na árvore de entrada e seleção de saída do mapa.
  • Selecione JSON (modelo de mensagem de objeto JSON fornecido pela IBM) para criar uma mensagem de objeto JSON.
  • Selecione JSON (modelo de mensagem de matriz JSON fornecido pela IBM) para criar uma mensagem de matriz JSON.

Se você selecionar qualquer um dos modelos de mensagem JSON como a saída do mapa, o domínio de saída no conjunto de mensagens de saída será configurado automaticamente como JSON.

A mensagem JSON predefinida contém um valor de elemento único do tipo JSONMsg_type. Este elemento contém os seguintes elementos filhos:
  1. Um elemento Preenchimento: Esse elemento é opcional. Você define seu valor para passar uma chamada de função JavaScript definida pelo usuário usada por serviços JSONP.
  2. Dois elementos Dados: Defina apenas um dos elementos Dados para modelar sua mensagem JSON.
    • Defina o elemento Dados do tipo anyType usando a função Cast. Defina esse elemento quando tiver um modelo de esquema que define sua mensagem JSON. Se você criar um mapa programaticamente, será possível efetuar cast dos Dados para algum tipo em um arquivo de esquema externo, que pode definir uma mensagem de objeto JSON ou de matriz JSON.
    • Você define o elemento Data, do tipo JSONObject, ao usar a função Add User-Defined . Defina esse elemento quando desejar transformar alguns elementos de sua mensagem de objeto JSON. Também é possível usar a função Cast para definir a mensagem JSON, ou uma parte dela, com um modelo de esquema.

      Figura que mostra o tipo de mensagem de objeto JSON que está predefinida no editor de Mapeamento de Dados Gráficos.

    • Você define o elemento Data, do tipo JSONArray_1, ao usar a função Add User-Defined . Defina esse elemento quando desejar transformar alguns elementos de sua mensagem de objeto JSON. Também é possível usar a função Cast para definir a mensagem JSON, ou uma parte dela, com um modelo de esquema.

      Figura que mostra o tipo de mensagem da matriz JSON que está predefinida no editor de Mapeamento de Dados Gráficos.

Procedimento

Você pode concluir qualquer uma das seguintes ações em mensagens JSON no editor Graphical Data Mapping:

  1. É possível definir um objeto JSON graficamente sem um modelo de esquema. Use a função Add User-Defined para adicionar um elemento, e selecione um dos tipos simples suportados. Para obter mais informações, consulte Modelando graficamente um objeto JSON em um mapa de mensagem.
  2. É possível definir uma matriz JSON graficamente sem um modelo de esquema. Todos os elementos na matriz são do mesmo tipo. Use a função Add User-Defined para adicionar um elemento, e selecione JSONArray_Default como seu tipo. Para obter mais informações, consulte Modelando graficamente uma matriz JSON em um mapa de mensagem..
  3. É possível definir uma matriz JSON multidimensional graficamente sem um modelo de esquema. Use a função Add User-Defined para adicionar vários elementos, e selecione JSONArray_Default como seus tipos. Para obter mais informações, consulte Modelando graficamente uma matriz JSON multidimensional em um mapa de mensagens.
  4. É possível criar uma mensagem JSONP ou transformar uma mensagem modelada em um domínio de mensagem diferente em uma mensagem JSONP. Para obter mais informações, consulte Modelando e transformando graficamente uma mensagem JSONP em um mapa de mensagens..
  5. É possível definir uma mensagem JSON usando seu próprio modelo de esquema. Use a função Cast para incluir uma mensagem JSON. Para obter mais informações, consulte Modelando uma mensagem JSON para uso em um mapa de mensagens usando um modelo de esquema XML equivalente
  6. Você pode usar o editor de Mapeamento de Dados Gráficos para implementar uma operação REST API. Para obter mais informações, consulte Implementando uma operação da API REST usando um mapa de mensagem.