Configurar Jobs de Transformação XML

Você pode criar um job de transformação XML para transformar um arquivo XML em uma saída desejada, bem como designar valores de campos de Metadados do Capture com base no XML. Isso pode ser feito configurando as combinações suportadas de definições do processador XSLT e fornecendo seu arquivo XSLT personalizado. Além disso, uma expressão XPath pode ser mapeada para campos de Metadados do Capture. O arquivo XML convertido pode então ser usado por aplicativos de terceiros para ajuste com as necessidades de negócios de terceiros.

Nota:

Não é possível criar jobs de transformação XML no Oracle Content Management Starter Edition. Para usar esse recurso, é necessário fazer upgrade para o Oracle Content Management Premium Edition. Para obter mais informações, consulte Starter e Premium Edition.

  1. No painel de procedimentos à esquerda, selecione o procedimento.

    As páginas de configuração do procedimento selecionado são exibidas à direita.

  2. Abra a guia Processamento.

  3. Na tabela Jobs de Transformação XML, clique em Adicionar job de transformação XML ou, para editar um job existente, clique em Editar job de transformação XML.

    Você também pode copiar um job de transformação XML selecionando-o, clicando em Copiar job de transformação e digitando um novo nome quando solicitado. A cópia de um job permite que você rapidamente o duplique e o modifique.

  4. Na página Seleção de Documento:

    1. Na seção Seleção de Documento, faça o seguinte:

      • Informe um nome e uma descrição para o job.

      • Para processar o job de transformação XML para perfis de documentos específicos, selecione um ou mais perfis listados no campo Restringir a Perfis de Documentos ou selecione Todos para processar documentos de todos os perfis definidos.

    2. Na lista drop-down Destino da Saída da Transformação, selecione uma opção adequada:
      • Documento: Substitui o documento original pelos resultados da transformação. Você também poderá alterar o perfil de documento se desejar.
      • Documento, Preservar Cópia: Preserva a cópia original. Você também poderá escolher um perfil de documento se selecionar essa opção. No entanto, selecione um tipo de anexo na lista drop-down Preservar Tipo de Anexo.
      • Anexo: Armazena os resultados da transformação como anexo. Selecione um tipo de anexo na lista drop-down Novo Tipo de Anexo.
      • Campo do Capture: Armazena os resultados da transformação em um campo do Capture. Selecione Campo de Texto na lista drop-down Campo do Capture.
    3. Na seção Seleção de Anexo:
      1. Marque a caixa de seleção Processar Anexos se aplicável às escolhas feitas nas etapas anteriores.
      2. Restrinja aos tipos de anexo obrigatórios marcando as caixas de seleção para os tipos de anexo disponíveis. Você também pode selecionar todos.
      3. Selecione o destino de saída da transformação:
        • Anexo: Você tem a opção de alterar o tipo de anexo.
        • Anexo, Preservar uma Cópia: Você tem a opção de selecionar o tipo de anexo. Mas selecione um tipo de anexo na lista drop-down Preservar Tipo de Anexo.
        • Campo do Capture: Selecione Campo de Texto ou Campo XML.
  5. Na página Transformação - Definição da Transformação:
    1. Se a caixa de seleção Executar Transformação XML não estiver marcada ainda, marque-a para ativar a edição dos valores dos campos nessa página. Ao desmarcar essa caixa de seleção, você desativa a edição mantendo os últimos valores salvos nos campos. Você poderá desmarcar essa caixa de seleção quando a transformação XML não for necessária.
    2. Na seção Mecanismo de Transformação:
      • Selecione a Versão XSLT, o Processador e a Versão do Processador compatíveis. Escolha os padrões do sistema ou escolha entre as versões XSLT disponíveis, compatíveis com os processadores Xalan e Saxon-HE e suas versões.
      • Especifique uma Extensão do Arquivo de Saída como XML, HTML, JSON ou texto.

        Nota:

        Se a extensão do arquivo de saída não for equivalente a XML, a página Mapeamento de Campo será desativada.
    3. Para executar uma transformação, faça upload ou digite o XSLT na seção Folha de Estilo XML.
    4. Os parâmetros incluídos no XSLT devem ser definidos na tabela Parâmetros. Para fazer isso:
      1. Na tabela Parâmetros, clique em Adicionar parâmetros.
      2. Na caixa de diálogo Adicionar Parâmetros XSLT, adicione o nome do parâmetro e designe a ele um valor. Você pode adicionar um valor de texto ou montar um valor de metadados para seus parâmetros.
      3. Repita as etapas i e ii para definir os parâmetros obrigatórios.

        Nota:

        Se você não designar valores aos parâmetros definidos no XSLT, ou se designar valores a parâmetros que não existem no XSLT, não poderá salvar seu job de transformação XML e ser notificado do mesmo quando tentar salvá-lo.
    5. Na seção Teste de Transformação, faça upload e teste o XML transformado para confirmar se ele foi gerado corretamente e, em seguida, clique em Próximo. Você também pode visualizar o conteúdo desta seção clicando em Visualizar no lado superior direito da seção.
  6. Na página Mapeamento de Campo, defina a navegação para elementos ou atributos específicos a fim de que os usuários possam extrair seus valores do documento XML:
    1. Marque a caixa de seleção Executar Mapeamento de Campo XPath para ativar a edição da tabela Mapeamento de Campo XPath. Se você tiver desmarcado essa caixa de seleção, não conseguirá editar a tabela. No entanto, os últimos valores salvos são mantidos.
    2. Marque a caixa de seleção Falhar o Batch em caso de Erros de Parsing se o formato de parsing que você selecionará na próxima precisar ser rigorosamente respeitado.
    3. Na parte superior direita da tabela Mapeamento de Campo XPath, clique em Editar mapeamento de campo XPath
    4. Na caixa de diálogo Editar Mapeamento de Campo XPath:
      1. No campo Expressão XPath, especifique a expressão XPath para o campo de dados de metadados selecionado e escolha o formato de parsing.

        A expressão XPath será avaliada na saída da transformação se houver uma. Se uma transformação não for executada, a expressão XPath será avaliada no documento ou no anexo.

      2. Na lista drop-down Formato de Parsing de Data, selecione o formato de parsing. Se o campo do Capture for um número, você verá uma lista drop-down Formato de Parsing de Número. Se necessário, um formato de parsing personalizado poderá ser selecionado na lista drop-down.
      3. Clique em OK.

        O valor adicionado à coluna Expressão XPath da tabela Mapeamento de Campo XPath é analisado por parsing como data no formato selecionado por você.

    5. Clique em OK.
  7. Na página Pós-processamento, especifique o que acontece depois que um job de transformação XML é concluído com base no seguinte:
    • Nenhuma situação de erro do sistema é um caso no qual todos os critérios da página anterior foram atendidos. Uma transformação bem-sucedida pode fluir para confirmação.
    • Erros do sistema são quaisquer casos em que a transformação falha: nenhum registro encontrado, muitos registros encontrados e assim por diante. Para transformação malsucedidas, o batch retorna ao Content Capture Client para reparo.
    Consulte Configurar Pós-processamento e Monitoramento de um Job de Transformação XML

  8. Confira as definições na página Resumo e clique em Submeter para salvar o job.

  9. Configure como os batches fluem para jobs de transformação XML. Consulte Configurar Fluxo de Batches para um Job de Transformação XML.

  10. Teste o job de transformação XML que você criou.

Configurar Pós-processamento e Monitoramento de um Job de Transformação XML

Use as opções de pós-processamento de um job de transformação XML para especificar o que acontece após a conclusão do processamento.

Para configurar o pós-processamento e o monitoramento de um job de transformação XML:
  1. No painel de procedimentos à esquerda, selecione o procedimento.
    As páginas de configuração do procedimento selecionado são exibidas à direita.
  2. Abra a guia Processador.
  3. Na tabela Jobs de Transformação XML, adicione ou edite um job de transformação XML.
  4. Clique na página Pós-processamento para exibir as opções de processamento bem-sucedido (nenhum erro do sistema) e malsucedido (um ou mais erros do sistema). As próximas etapas se aplicam às duas seções: Quando não houver erro do sistema e Quando houver erros do sistema.
  5. Nos campos Processador de Batch e Job do Processador de Batch, especifique qual etapa do processamento, se houver, ocorre após a conclusão do job de transformação XML. Você pode escolher entre as opções Nenhum, Processador de Confirmação, Processador de Reconhecimento, Conversão em TIFF , Conversões em PDF, Processador de Pesquisa de Ativos ou Processador de Transformação XML.
  6. No campo de endereço de e-mail, digite opcionalmente um endereço para o qual um e-mail será enviado após o processamento ser concluído com sucesso ou falhar. Enquanto estiver configurando e testando um job de transformação XML, você mesmo poderá definir o recebimento de notificações por e-mail quando houver erros do sistema e depois alertar automaticamente um administrador sobre os erros de processamento.
  7. Nos campos restantes, especifique como alterar os batches processados.

    • Renomeie os batches adicionando um prefixo. Por exemplo, renomeie os batches que não tiverem êxito com o prefixo ERR para acompanhamento.

    • Altere o status ou a prioridade do batch. Por exemplo, você poderá alterar o status dos batches com erros do sistema; em seguida, criar um perfil do cliente com a filtragem de batches definida com esse status para permitir que usuários qualificados editem e preencham manualmente os batches que encontraram erros.

  8. Clique em Submeter para salvar o job.

Configurar Fluxo de Batches para um Job de Transformação XML

Para executar um job de transformação XML, configure o fluxo de batches até o job para processamento. Faça isso definindo o job de transformação XML como etapa de pós-processamento em um perfil de cliente.

Você pode configurar fluxos de batch com base no seguinte:

Desativar ou Excluir um Job de Transformação XML

Quando você exclui um job de transformação XML, ele não permanece mais disponível para os batches nos quais ele está definido como etapa de pós-processamento. Se um job especificado para pós-processamento não estiver disponível, ocorrerá um erro para o batch. É conveniente alterar um job para off-line durante um período, antes de excluí-lo, permitindo que você resolva problemas inesperados com sua exclusão. Os jobs de transformação XML on-line são executados quando são selecionados em um perfil do cliente ou na página Pós-processamento de um job do processador. Você pode interromper temporariamente um job (colocá-lo off-line) ou alterar um job desativado para ser executado novamente.

Para desativar ou excluir um job de transformação XML:
  1. No painel de procedimentos à esquerda, selecione o procedimento.
    As páginas de configuração do procedimento selecionado são exibidas à direita.
  2. Abra a guia Processamento.
  3. Para desativar um job, selecione-o na tabela Jobs de Transformação XML e clique em Desativar ou ativar um job de transformação XML.

    Você também pode desativar ou ativar um job de transformação XML marcando ou desmarcando o campo On-line na página Seleção de Documento.

  4. Selecione o job desativado na tabela Jobs de Transformação XML e clique em Excluir um job de transformação XML.
  5. Quando solicitado, clique em Sim para confirmar que você deseja excluir esse job.