Configurar Tarefas de Transformação XML

Pode criar uma tarefa de transformação XML para transformar um ficheiro XML numa saída de dados pretendida, bem como atribuir valores dos campos de Metadados do Capture a partir do XML. Pode fazer isto configurando as combinações suportadas das definições do processador de XSLT e fornecendo o seu ficheiro XSLT customizado. Adicionalmente, uma expressão do XPath pode ser mapeada para os campos de Metadados do Capture. O ficheiro XML convertido pode então ser utilizado por aplicações de terceiros para se adequar às necessidades empresariais de outras entidades.

Nota:

Não pode criar as tarefas de transformação XML na Edição Starter do Oracle Content Management. Para utilizar esta funcionalidade, é necessário atualizar para a Edição Premium do Oracle Content Management. Para obter mais informações, consulte Edição Starter vs. Premium.

  1. Na secção de procedimentos à esquerda, selecione o seu procedimento.

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

  2. Abra o separador Processamento.
  3. Na tabela Tarefas de Transformação XML, clique em Acrescentar tarefa de transformação XML ou, para editar uma tarefa existente, clique em Editar tarefa de transformação XML.

    Também pode copiar uma tarefa de transformação XML selecionando-a, clicando em Copiar tarefa de transformação e introduzindo um novo nome quando solicitado. A cópia de uma tarefa permite-lhe duplicá-la e modificá-la rapidamente.

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

    1. Na secção Seleção de Documento, efetue o seguinte:
      • Introduza um nome e uma descrição para a tarefa.

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

    2. Na lista pendente Destino da Saída de Dados de Transformação, selecione uma opção adequada:
      • Documento: Substitui o documento original pelos resultados da transformação. Pode também alterar o perfil do documento, se pretender.
      • Documento, Preservar Cópia: Preserva a cópia original. Pode também escolher um perfil do documento se selecionar esta opção. No entanto, deve selecionar um tipo de anexo a partir da lista pendente Preservar Tipo de Anexo.
      • Anexo: Armazena os resultados da transformação como um anexo. Deve selecionar um tipo de anexo a partir da lista pendente Novo Tipo de Anexo.
      • Campo do Capture: Armazena os resultados da transformação num campo do Capture. Deve selecionar o Campo de Texto a partir da lista pendente Campo do Capture.
    3. Na secção Seleção de Anexos:
      1. Selecione a caixa de seleção Processar Anexos, se aplicável às escolhas que efetuou nos passos anteriores.
      2. Restrinja os tipos de anexo obrigatórios selecionando as caixas de seleção para os tipos de anexo disponíveis. Pode também selecionar todos.
      3. Selecione o destino da saída de dados de transformação:
        • Anexo: Tem a opção de alterar o tipo de anexo.
        • Anexo, Preservar uma Cópia: Tem a opção de selecionar o tipo de anexo. Mas, deve selecionar um tipo de anexo a partir da lista pendente Preservar Tipo de Anexo.
        • Campo do Capture: Deve selecionar o Campo de Texto ou Campo XML.
  5. Na página Transformação - Definição da Transformação:
    1. Se a caixa de seleção Efetuar Transformação XML ainda não estiver selecionada, selecione-a para permitir a edição dos valores dos campos nesta página. Ao anular a seleção desta caixa de seleção desativa a edição mantendo os últimos valores gravados nos campos. Pode anular a seleção desta caixa de seleção quando a transformação XML não é obrigatória.
    2. Na secção Mecanismo de Transformação:
      • Selecione a Versão de XSLT, o Processador e a Versão do Processador compatível. Escolha os valores assumidos por omissão do sistema ou escolha a partir das versões de XSLT disponíveis compatíveis com os processadores Xalan e Saxon-HE e as respetivas versões.
      • Especifique uma Extensão do Ficheiro de Saída de Dados tal como XML, HTML, JSON, texto.

        Nota:

        Se a extensão do ficheiro de saída de dados não equivaler a XML, a página Correspondência de Campos é desativada.
    3. Para efetuar uma transformação, carregue ou introduza XSLT na secção Folha de Estilos XML.
    4. Os parâmetros que incluiu no seu XSLT devem ser definidos na tabela Parâmetros. Para efetuar este procedimento:
      1. Na tabela Parâmetros, clique em Acrescentar parâmetros.
      2. Na caixa de diálogo Acrescentar Parâmetros XSLT, acrescente o nome do parâmetro e atribua-lhe um valor. Pode acrescentar um valor de texto ou compor um valor de metadados para os seus parâmetros.
      3. Repita os passos i e ii para definir os parâmetros obrigatórios.

        Nota:

        Se não atribuir valores aos parâmetros que estejam definidos no XSLT ou se atribuir valores aos parâmetros que não existam no XSLT, não poderá gravar a sua tarefa de transformação XML e será notificado desta situação quando tentar gravar a tarefa de transformação.
    5. Na secção Teste da Transformação, carregue e teste o XML transformado para confirmar que foi gerado corretamente e, em seguida, clique em Seguinte. Também pode pré-visualizar o conteúdo nesta secção clicando em Pré-visualizar no lado superior direito desta secção.
  6. Na página Correspondência de Campos, defina a navegação para elementos ou atributos específicos de forma a que os utilizadores possam extrair os respetivos valores a partir do documento XML:
    1. Selecione a caixa de seleção Efetuar Correspondência de Campos do XPath para ativar a edição da tabela Correspondência de Campos do XPath. Se anular a seleção desta caixa de seleção, não poderá editar a tabela. No entanto, os últimos valores gravados são mantidos.
    2. Selecione a caixa de seleção Batch de Falhas em Erros de Análise se o formato de análise que irá selecionar no passo seguinte deve ser estritamente cumprido.
    3. Na parte superior direita da rabela Correspondência de Campos do XPath, clique em Editar correspondência de campos do XPath
    4. Na caixa de diálogo Editar Correspondência de Campos do XPath:
      1. No campo Expressão do XPath, especifique a expressão do XPath para o campo de metadados selecionado e selecione o formato de análise.

        A expressão do XPath é avaliada na saída de dados da transformação, caso exista. Se uma transformação não for efetuada, a expressão do XPath é avaliada no documento ou anexo.

      2. Na lista pendente Formato de Análise de Data, selecione o formato de análise. Se o campo do Capture for um número, verá uma lista pendente Formato de Análise de Número como alternativa. Se necessário, um formato de análise customizado poderá ser selecionado na lista pendente.
      3. Clique em OK.

        O valor que é acrescentado à coluna Expressão do XPath da tabela Correspondência de Campos do XPath é analisado para uma data no formato que selecionou.

    5. Clique em OK.
  7. Na página Pós-Processamento, com base no seguinte, especifique o que acontece após a conclusão de uma tarefa de transformação XML:
    • Os casos de erros do sistema são situações em que todos os critérios da página anterior não foram cumpridos. Uma transformação com êxito pode fluir para a confirmação.
    • Os erros de sistema são casos em que a transformação falha: não são encontrados registos, são encontrados demasiados registos, etc. Nas transformações sem êxito, o batch regressa ao Content Capture Client para reparação.
    Consulte Configurar o Pós-Processamento e a Monitorização de uma Tarefa de Transformação XML
  8. Reveja as definições na página Resumo e clique em Submeter para gravar a tarefa.

  9. Configure de que forma os batches fluem para tarefas de transformação XML. Consulte Configurar Fluxo de Batches para uma Tarefa de Transformação XML.

  10. Teste a tarefa de transformação XML que criou.

Configurar o Pós-Processamento e a Monitorização de uma Tarefa de Transformação XML

Utilize as opções de pós-processamento de uma tarefa de transformação XML para especificar o que acontece após o processamento ser concluído.

Para configurar o pós-processamento e a monitorização de uma tarefa de transformação XML:
  1. Na secção de procedimentos à esquerda, selecione o seu procedimento.
    As páginas de configuração do procedimento selecionado são apresentadas à direita.
  2. Abra o separador Processador.
  3. Na tabela Tarefas de Transformação XML, acrescente ou edite uma tarefa de transformação XML.
  4. Clique na página Pós-Processamento para apresentar as opções de processamento para um processamento com êxito (sem erros do sistema) e um processamento sem êxito (um ou mais erros do sistema). Os passos seguintes aplicam-se a ambas as secções: Quando não existir nenhum erro do sistema e Quando existirem erros do sistema.
  5. Nos campos Processador de Batches e Tarefa do Processador de Batches, especifique que passo de processamento ocorre, se aplicável, após a conclusão da tarefa de transformação XML. Pode escolher entre Nenhum, Processador de Confirmações, Processador de Reconhecimentos, Conversão em TIFF, Conversões em PDF, Processador de Lookups de Ativos ou Processador de Transformação XML.
  6. No campo de endereço de correio eletrónico, introduza um endereço para o qual enviar uma mensagem de correio eletrónico após a conclusão com êxito ou sem êxito do processamento. Quando configurar e testar uma tarefa de transformação XML, poderá definir para si próprio a receção de notificações por correio eletrónico em caso de erros de sistema e, posteriormente, alertar automaticamente um administrador dos erros de processamento.
  7. Nos restantes campos, especifique como alterar os batches processados.
    • Renomeie os batches acrescentando um prefixo. Por exemplo, renomeie batches que não tiveram êxito com o prefixo ERR para seguimento.

    • Altere o estado ou a prioridade do batch. Por exemplo, pode alterar o estado dos batches com erros de sistema, em seguida, criar um perfil de cliente com a filtragem de batches definida para este estado para permitir que os utilizadores qualificados editem manualmente e completem os batches com erros.

  8. Clique em Submeter para gravar a tarefa.

Configurar Fluxo de Batches para uma Tarefa de Transformação XML

Para executar uma tarefa de transformação XML, deve configurar batches para fluírem até à tarefa para processamento. Para tal, defina a tarefa de transformação XML como um passo de pós-processamento num perfil de cliente.

Pode configurar fluxos de batches a partir do seguinte:

Desativar ou Apagar uma Tarefa de Transformação XML

Quando apagar uma tarefa de transformação XML, esta deixa de ficar disponível para batches para os quais foi definida como um passo de pós-processamento. Se uma tarefa especificada para pós-processamento não estiver disponível, ocorre um erro no batch. Poderá optar por passar uma tarefa para offline durante algum tempo antes de a apagar, permitindo-lhe resolver questões imprevistas com o respetivo apagamento. As tarefas de transformação XML online são executadas quando são selecionadas num perfil de cliente ou na página de Pós-Processamento de uma tarefa do processador. Pode suspender uma tarefa temporariamente (colocá-la offline) ou colocar uma tarefa desativada novamente em execução.

Para desativar ou apagar uma tarefa de transformação XML:
  1. Na secção de procedimentos à esquerda, selecione o seu procedimento.
    As páginas de configuração do procedimento selecionado são apresentadas à direita.
  2. Abra o separador Processamento.
  3. Para desativar uma tarefa, selecione-a na tabela de Tarefas de Transformação XML e clique em Desativar ou ativar uma tarefa de transformação XML.

    Também pode desativar ou ativar uma tarefa de transformação XML selecionando ou anulando a seleção do campo Online na página Seleção de Documento.

  4. Selecione a tarefa desativada na tabela Tarefas de Transformação XML e clique em Apagar uma tarefa de transformação XML.
  5. Quando solicitado, clique em Sim para confirmar que pretende apagar esta tarefa.