Sumário

Search

  1. Prefácio
  2. Introdução
  3. Configurando o aplicativo Data Director
  4. Estabelecendo um nó raiz
  5. Definindo o modelo de entidade comercial
  6. Configurando propriedades da entidade comercial
  7. Configurando as propriedades da entidade de referência
  8. Transformando entidades comerciais e exibições
  9. Configurando relacionamentos de hierarquia e de rede
  10. Criando conjuntos de regras de correspondência
  11. Configurando a pesquisa
  12. Configurando tarefas
  13. Configurando segurança e filtros de dados para entidades comerciais
  14. Integrando Dados como um Serviço
  15. Configurando chamadas externas
  16. Projetando a interface do usuário do Data Director
  17. Traduzindo o Data Director
  18. Perguntas frequentes sobre a ferramenta de provisionamento

Transformando dados XML em uma entidade comercial

Transformando dados XML em uma entidade comercial

Para usar os serviços DaaS, você deve definir os mapeamentos para a resposta retornada pelo serviço. Mapeie os campos na resposta para os aos campos da entidade comercial. Especifique quais campos da saída XML do serviço você deseja armazenar na sua entidade comercial.
  1. Clique em
    Entidade Comercial
    Transformações
    e selecione
    XML para Entidade Comercial
    .
  2. Clique em
    Criar
    .
  3. No painel de propriedades, especifique as seguintes propriedades:
    Propriedade
    Descrição
    Nome
    O nome da transformação.
    URL
    Identifica o espaço de nome no qual a operação SOAP está definida.
    Tipo
    Selecione o espaço de nomes.
    Entidade Comercial
    A entidade comercial que você deseja transformar.
    Expor como Serviço
    Se definido como "true", a transformação será exposta como dois serviços de entidade comercial, Importação e Atualização. Esses serviços aceitam dados XML, transformam-nos em dados de entidade comercial e os salvam como um registro de entidade comercial.
    Fonte
    O elemento no objeto de resposta. Clique no botão
    Procurar
    para pesquisar o elemento.
  4. Clique em
    Aplicar
    .
    A seguinte imagem mostra dados XML de exemplo para uma transformação de entidade comercial: Uma captura de tela mostrando dados XML de exemplo para uma transformação de entidade comercial.
  5. Para configurar a transformação para o nó raiz, selecione
    Transformações
    no painel de exibição em árvore e clique em
    Criar
    .
  6. No painel de propriedades, especifique as seguintes propriedades:
    Propriedade
    Descrição
    Nome
    O nome da transformação. Por exemplo, transformação para raiz.
    Saída do Status
    Nome do parâmetro de saída de limpeza. Usado em transformações de limpeza. Não se aplica a transformações para DaaS.
    Êxito do Status
    Uma expressão regular. Quando a operação de limpeza for concluída com êxito, ele retornará um valor no parâmetro de saída de limpeza que corresponde à expressão regular. Não se aplica a transformações para DaaS.
    Tipo
    O tipo de transformação para mapear diretamente os dados de um campo de entidade comercial para XML. Transformações diretas mantêm os dados inalterados.
  7. Mapeie os elementos XML na resposta do serviço para os campos da entidade comercial:
    1. Na coluna
      Campos de Entrada
      , clique no botão
      Procurar
      .
    2. Escolha o campo e clique em
      Selecionar
      .
    3. Na coluna
      Campos de Saída
      , clique no botão
      Procurar
      .
    4. Selecione o campo da entidade comercial para a qual você deseja mapear e clique em
      Selecionar
      .
    5. Para mapear informações adicionais, clique no ícone
      Adicionar
      e depois siga as etapas de
      a
      até
      d
      .
    6. Clique em
      Aplicar
      .
    A seguinte imagem mostra um mapeamento de amostra dos campos do nó raiz:
    Uma captura de tela mostrando o mapeamento do XML e dos campos da entidade comercial.
  8. Para configurar a transformação para os nós filho da entidade comercial, adicione o nó a um grupo e configure as transformações:
    1. Selecione a pasta
      Grupos
      e clique em
      Criar
      .
    2. No painel de propriedades, insira um nome para o nó conforme você deseja que ele apareça na pasta do grupo.
    3. No campo
      Origem
      , selecione um campo e, no campo
      Destino
      , selecione o nó filho na entidade comercial. Repita para cada nó filho.
    4. Clique em
      Aplicar
      .
    5. Expanda um
      nó filho
      , selecione
      Transformações
      e clique em
      Criar
      .
    6. No painel de propriedades, insira um nome para a transformação.
    7. Na lista
      Tipo
      , selecione
      Direto
      .
    8. Na coluna
      Campos de Entrada
      , clique no botão
      Procurar
      .
    9. Escolha o campo e clique em
      Selecionar
      .
    10. Na coluna
      Campos de Saída
      , clique no botão
      Procurar
      .
    11. Selecione o campo da entidade comercial para a qual você deseja mapear e clique em
      Selecionar
      .
      É possível especificar o caminho do XML SDO (Service Data Object) diretamente em um atributo
      field
      . Quando um campo contém
      /
      , ele indica o XPath o SDO. Se você usar uma transformação de limpeza antes de preencher a entidade comercial com os dados XML, talvez precise de alguns elementos XML pai nos mapeamentos de nós filho. No entanto, elementos XML pai não estão disponíveis para seleção na transformação de nós filho. Você deve digitar manualmente o caminho para o elemento XML pai necessário no campo
      Nome do Campo
      . Use a expressão XPath SDO (Service Data Objects) para acessar um elemento pai, em que
      /
      representa o elemento raiz. Por exemplo, ao configurar a transformação do nó de endereço filho, você pode concatenar o elemento
      dunsNumber
      com o elemento
      city
      . Como o elemento
      dunsNumber
      é um elemento pai, ele não está disponível para seleção. Para acessar o elemento
      dunsNumber
      , use o caminho
      /OrderCompanyProfileResult[1]/ServiceResult[1]/OrderProductResponseDetail[1]/InquiryDetail[1]/DUNSNumber[1]
    12. Repita as etapas
      h
      a
      k
      para outros campos.
    13. Clique em
      Aplicar
      .
  9. Repita a Etapa
    9
    para cada nó filho.
    A seguinte imagem mostra um exemplo de transformação e mapeamento de campos para um nó filho:
    Uma captura de tela mostrando o mapeamento dos campos XML para os campos da entidade comercial para o addr filho.