Etapa do XML Composer (DataStage)

Use uma estrutura especificada para compor o conteúdo XML.

Destino XML

Gravar em arquivo
Insira o diretório de saída e o prefixo de nome do arquivo para os arquivos que serão editados ou clique em Inserir parâmetro e, em seguida, selecione o nome do parâmetro para o diretório de saída e o prefixo do nome do arquivo. Os parâmetros que estão disponíveis são os parâmetros que você definiu anteriormente no job e as macros embutidas que estão em IBM® InfoSphere® DataStage®.
Passar como sequência
Passe a sequência XML editada para um estágio ou etapa de recebimento de dados para processamento adicional.
Passar como objeto grande
Passe a sequência XML editada como um objeto grande. O estágio de destino final, que é o último estágio na tarefa, deve ser um estágio com reconhecimento de LOB, como o conector DB2, conector Oracle, conector ODBC, conector Teradata ou conector Websphere MQ. Esses estágios usam a sequência de localizador de LOB para obter os dados XML e, em seguida, gravam no banco de dados ou fila de mensagens de destino. A tarefa pode conter estágios não com reconhecimento de LOB, mas esses estágios não devem modificar a sequência de localizador de LOB. Se o último estágio na tarefa não fizer reconhecimento de LOB, o localizador de LOB será gravado como dados, em vez de ser interpretado como um localizador.

Raiz do Documento

Selecione o elemento de nível superior que descreve os documentos que você está editando. Os tipos que são exibidos sob o namespace da biblioteca são definições de elemento de alto nível. Seguindo o padrão de esquema XML, somente elementos de nível superior podem descrever documentos. O nome do elemento que você selecionar deve corresponder ao nome do elemento de nível superior nos documentos da instância. Por exemplo, se você estiver editando documentos de Ordem, selecione o elemento Ordem. Ao selecionar o elemento, é possível visualizar sua estrutura e verificar se a estrutura está correta para os documentos que você deseja editar.
Nota: Os elementos a partir dos quais você seleciona a raiz do documento são dos recursos que antes eram importados para as bibliotecas do esquema. Se você precisar importar o recurso que contém a raiz do documento para a etapa Editor de XML, clique na guia Abrir bibliotecas e importe o recurso necessário. Em seguida, retorne para o editor de montagem e configure a raiz do documento.

Validação

Por padrão, o Editor de XML usa a validação mínima e a tarefa falhará se ocorrer uma violação. Para customizar a validação, especifique a ação a ser tomada quando ocorrer uma violação.

Para obter mais informações sobre regras de validação, consulte Regras de validação do XML Composer (DataStage).

Mapeamentos

Criar um mapeamento para o item document_collection. O modo de mapeamento desse item determina a criação de um ou de vários documentos. Para produzir somente um documento, mapeie a raiz da Entrada (superior) para document_collection. Para produzir vários documentos, mapeie um item de lista para o item document_collection. Em seguida, um arquivo é criado para cada item na lista. Para obter mais informações sobre mapeamento, consulte Trabalhando com a tabela de mapeamento (DataStage).

Cabeçalho

Especifique mais informações opcionais para incluir no início da saída XML.

Gerar fragmento XML
Não inclua a declaração XML, comentários e instruções de processamento.
Incluir declaração XML
Inclua a declaração XML, por exemplo, <?xml version="1.0" encoding="UTF-8">.
Incluir comentários
Inclua os comentários inseridos no campo Comentários.
Incluir instruções de processamento
Inclua as instruções de processamento inseridas no campo Instruções de processamento. Coloque cada instrução de processamento entre as tags <? e ?>.
Incluir schemaLocation
Inclua o atributo schemaLocation no arquivo xml com o valor inserido no campo Local do esquema.
Incluir noNamespaceSchemaLocation
Inclua o atributo noNamespaceSchemaLocation no arquivo xml com o valor inserido no campo Nenhum local do esquema de namespace.

Formato

Tipo de codificação
Selecione a codificação a ser usada para o documento. A codificação padrão é UTF-8.
Estilo de formato
Marque a caixa para aplicar as opções de formato a seguir à saída XML:
  • Espaços por nível de indentação – Selecione o número de caracteres a serem usados para cada nível de indentação na saída XML.
  • Novo estilo de linha – Selecione o tipo de nova linha. As escolhas são UNIX (LF), DOS (CRLF) ou MAC (CR).
  • Fuso horário – Especifique o valor de fuso horário de +14:00 a -14:00. Se os dados de saída do editor tiverem elementos de tipo de dados de data (time, dateTime ou gMonth), a etapa do editor converterá o tipo de dados de data de acordo com o fuso horário especificado e anexará os dados convertidos aos dados de saída do editor. Se os dados de saída do editor não contiverem informações de fuso horário, o fuso horário especificado no campo de texto será anexado aos dados de saída do editor.

    É possível selecionar a opção Inserir parâmetro para inserir parâmetros que contenham o fuso horário no tempo de execução em vez de especificá-los no tempo de design.

  • Omitir atributos com valor padrão – Para atributos que têm valores padrão e estão nos dados ou para atributos que têm valores fixos, omita os valores da saída XML.
  • Omitir elementos nulos – Para elementos nulos que não estão nos dados, omita os elementos da saída XML.
  • Omitir elementos vazios opcionais – Se um nó XML tiver um valor vazio, omita os elementos da saída XML.