Trabalhar com utilitários XMP

ATENÇÃO

AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.

Sobre o Serviço de Utilitários XMP

Os documentos do PDF contêm metadados, que são informações sobre o documento como distinto do conteúdo do documento, como texto e gráficos. A Plataforma de metadados extensível do Adobe (XMP) é um padrão para manipular metadados de documento.

O serviço Utilitários de XMP pode recuperar e salvar metadados XMP de documentos PDF e importar XMP metadados para documentos PDF.

Você pode realizar essas tarefas usando o serviço Utilitários XMP:

OBSERVAÇÃO

Para obter mais informações sobre o serviço Utilitários XMP, consulte Referência de serviços para o AEM Forms.

Importação de metadados para documentos do PDF

Você pode usar o Java Utilitários XMP e as APIs de serviço da Web para importar programaticamente metadados XMP em um documento do PDF. Os metadados fornecem informações sobre um documento PDF, como o autor do documento e palavras-chave relacionadas ao documento. Os metadados podem ser localizados na caixa de diálogo Propriedades do documento, conforme mostrado na ilustração a seguir.

ww_ww_metadatadialog

Para importar metadados programaticamente para um documento PDF, você pode usar um documento XML existente que especifica os valores de metadados ou pode usar um objeto do tipo XMPUtilityMetadata. (Consulte Referência da API do AEM Forms.)

OBSERVAÇÃO

Esta seção discute como usar um documento XML para importar metadados para um documento PDF.

O código XML a seguir contém valores de metadados que correspondem à ilustração anterior. Por exemplo, observe os itens em negrito, que especificam palavras-chave.

 <?xpacket begin="?" id="W5M0MpCehiHzreSzNTczkc9d"?>
 <x:xmpmeta xmlns:x="adobe:ns:meta/" x:xmptk="Adobe XMP Core 4.2-jc015 52.349034, 2008 Jun 20 00:30:39-PDT (debug)">
       <rdf:RDF xmlns:rdf="https://www.w3.org/1999/02/22-rdf-syntax-ns#">
          <rdf:Description rdf:about=""
                xmlns:xmp="https://ns.adobe.com/xap/1.0/">
             <xmp:MetadataDate>2008-10-22T10:52:21-04:00</xmp:MetadataDate>
             <xmp:CreatorTool>AEM Forms</xmp:CreatorTool>
             <xmp:ModifyDate>2008-10-22T10:52:21-04:00</xmp:ModifyDate>
             <xmp:CreateDate>2008-02-13T11:00:18-05:00</xmp:CreateDate>
          </rdf:Description>
          <rdf:Description rdf:about=""
                xmlns:pdf="https://ns.adobe.com/pdf/1.3/">
             <pdf:Producer>AEM Forms</pdf:Producer>
             <pdf:Keywords>keyword1, keyword2, keyword3,keyword4</pdf:Keywords>
          </rdf:Description>
          <rdf:Description rdf:about=""
                xmlns:xmpMM="https://ns.adobe.com/xap/1.0/mm/">
             <xmpMM:DocumentID>uuid:1cce1f84-331e-4d8d-8538-15441c271dd7</xmpMM:DocumentID>
             <xmpMM:InstanceID>uuid:cdda0ca6-7c91-4771-9dc9-796c8fe59350</xmpMM:InstanceID>
          </rdf:Description>
          <rdf:Description rdf:about=""
                >
             <dc:format>application/pdf</dc:format>
             <dc:description>
                <rdf:Alt>
                   <rdf:li xml:lang="x-default">Adobe Designer Sample</rdf:li>
                </rdf:Alt>
             </dc:description>
             <dc:title>
                <rdf:Alt>
                   <rdf:li xml:lang="x-default">Grant Application</rdf:li>
                </rdf:Alt>
             </dc:title>
             <dc:creator>
                <rdf:Seq>
                   <rdf:li>Tony Blue</rdf:li>
                </rdf:Seq>
             </dc:creator>
             <dc:subject>
                <rdf:Bag>
                   <rdf:li>keyword1</rdf:li>
                   <rdf:li>keyword2</rdf:li>
                   <rdf:li>keyword3</rdf:li>
                   <rdf:li>keyword4</rdf:li>
                </rdf:Bag>
             </dc:subject>
          </rdf:Description>
          <rdf:Description rdf:about=""
                xmlns:desc="https://ns.adobe.com/xfa/promoted-desc/">
             <desc:version rdf:parseType="Resource">
                <rdf:value>1.0</rdf:value>
                <desc:ref>/template/subform[1]</desc:ref>
             </desc:version>
             <desc:contact rdf:parseType="Resource">
                <rdf:value>Adobe Systems Incorporated</rdf:value>
                <desc:ref>/template/subform[1]</desc:ref>
             </desc:contact>
          </rdf:Description>
       </rdf:RDF>
 </x:xmpmeta>
OBSERVAÇÃO

Para obter mais informações sobre o serviço Utilitários XMP, consulte Referência de serviços para o AEM Forms.

Resumo das etapas

Para importar metadados de XMP para um documento PDF, execute as seguintes etapas:

  1. Inclua arquivos de projeto.
  2. Crie um cliente XMPUUtilityService.
  3. Chame a operação de importação de metadados de XMP.

Incluir arquivos de projeto

Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.

Criar um cliente XMPUtilmentService

Antes de poder executar programaticamente uma operação Utilitários de XMP, você deve criar um cliente XMPUUtilityService. Com a API do Java, isso é feito criando uma XMPUtilityServiceClient objeto. Com a API do serviço da Web, isso é feito usando um XMPUtilityServiceService objeto.

Chame a operação de importação de metadados de XMP

Após criar o cliente de serviço, você pode invocar uma das operações de importação de metadados XMP para importar os metadados XMP para o documento PDF especificado.

Consulte também

Importar metadados de XMP usando a API do Java

Importação de metadados de XMP usando a API do serviço da Web

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

Importar metadados de XMP usando a API do Java

Importe XMP metadados usando a API de utilitários XMP (Java):

  1. Incluir arquivos de projeto

    Inclua arquivos JAR do cliente, como adobe-pdfutility-client.jar, no caminho da classe do seu projeto Java.

    OBSERVAÇÃO

    O arquivo adobe-pdfutility-client.jar contém classes que permitem chamar programaticamente o serviço Utilitários de XMP.

  2. Criar um cliente XMPUtilmentService

    Crie um XMPUtilityServiceClient usando seu construtor e transmitindo um ServiceClientFactory objeto que contém propriedades de conexão.

  3. Chame a operação de importação de metadados de XMP

    Para modificar os metadados de XMP, chame o XMPUtilityServiceClient do objeto importMetadata método ou importXMP método .

    Se você usar a variável importMetadata , passe os seguintes valores:

    • A com.adobe.idp.Document que representa o arquivo PDF.
    • Um XMPUtilityMetadata objeto que contém os metadados a serem importados.

    Se você usar a variável importXMP , passe os seguintes valores:

    • A com.adobe.idp.Document que representa o arquivo PDF.
    • A com.adobe.idp.Document objeto que representa um arquivo XML que contém os metadados a serem importados.

    Em ambos os casos, o valor retornado é uma com.adobe.idp.Document que representa o arquivo PDF com os metadados recém-importados. Em seguida, você pode salvar esse objeto em disco.

Consulte também

Importação de metadados para documentos do PDF

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

Importação de metadados de XMP usando a API do serviço da Web

Para importar XMP metadados de maneira programática usando a API do serviço da Web XMP Utilitários, execute as seguintes tarefas:

  1. Incluir arquivos de projeto

  2. Criar um cliente XMPUtilmentService

    Crie um XMPUtilityServiceService usando seu construtor de classe proxy.

  3. Chame a operação de importação de metadados de XMP

    Para modificar os metadados de XMP, chame o XMPUtilityServiceService do objeto importMetadata método ou importXMP método .

    Se você usar a variável importMetadata , passe os seguintes valores:

    • A BLOB que representa o arquivo PDF.
    • Um XMPUtilityMetadata objeto que contém os metadados a serem importados.

    Se você usar a variável importXMP , passe os seguintes valores:

    • A BLOB que representa o arquivo PDF.
    • A BLOB objeto que representa um arquivo XML que contém os metadados a serem importados.

    Em ambos os casos, o valor retornado é uma BLOB que representa o arquivo PDF com os metadados recém-importados. Em seguida, você pode salvar esse objeto em disco.

Consulte também

Importação de metadados para documentos do PDF

Chamada de AEM Forms usando codificação Base64

Criando um assembly de cliente .NET que usa codificação Base64

Exportação de metadados de documentos do PDF

Você pode usar o Java Utilitários XMP e as APIs de serviço da Web para recuperar e salvar programaticamente XMP metadados de um documento do PDF.

OBSERVAÇÃO

Para obter mais informações sobre o serviço Utilitários XMP, consulte Referência de serviços para o AEM Forms.

Resumo das etapas

Para exportar XMP metadados de um documento PDF, execute as seguintes etapas:

  1. Inclua arquivos de projeto.
  2. Crie um cliente XMPUUtilityService.
  3. Chame a operação de exportação de metadados de XMP.

Incluir arquivos de projeto

Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.

Criar um cliente XMPUtilmentService

Antes de poder executar programaticamente uma operação Utilitários de XMP, você deve criar um cliente XMPUUtilityService. Com a API do Java, se isso for feito com a criação de um XMPUtilityServiceClient objeto. Com a API do serviço da Web, isso é feito usando um XMPUtilityServiceService objeto.

Chame a operação de exportação de metadados de XMP

Após criar o cliente de serviço, você pode invocar uma das operações de exportação de metadados de XMP, que pode ser usada para inspecionar os metadados de XMP ou salvá-los em disco.

Consulte também

Importar metadados de XMP usando a API do Java

Importação de metadados de XMP usando a API do serviço da Web

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

Exportar metadados de XMP usando a API Java

Exporte XMP metadados usando a API de utilitários XMP (Java):

  1. Incluir arquivos de projeto

    Inclua arquivos JAR do cliente, como adobe-pdfutility-client.jar, no caminho da classe do seu projeto Java.

    OBSERVAÇÃO

    O arquivo adobe-pdfutility-client.jar contém classes que permitem chamar programaticamente o serviço Utilitário de XMP.

  2. Criar um cliente XMPUtilmentService

    Crie um XMPUtilityServiceClient usando seu construtor e transmitindo um ServiceClientFactory objeto que contém propriedades de conexão.

  3. Chame a operação de importação de metadados de XMP

    Para inspecionar os metadados de XMP, chame o XMPUtilityServiceClient do objeto exportMetadata e passar em um com.adobe.idp.Document que representa o arquivo PDF. O método retorna um XMPUtilityMetadata objeto que contém os metadados recuperados.

    Para recuperar e salvar os metadados do XMP, chame o XMPUtilityServiceClient do objeto exportXMP e passar em um com.adobe.idp.Document que representa o arquivo PDF. O método retorna um com.adobe.idp.Document objeto que contém os metadados recuperados, que podem ser salvos posteriormente em disco como um arquivo XML.

Consulte também

Exportação de metadados de documentos do PDF

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

Exportar metadados XMP usando a API de serviço da Web

Exporte XMP metadados usando a API de Utilitários XMP (serviço da Web):

  1. Incluir arquivos de projeto

    • Crie um assembly de cliente Microsoft .NET que consuma o arquivo WSDL do serviço Utilitários XMP.
    • Faça referência ao assembly do cliente Microsoft .NET.

  2. Criar um cliente XMPUtilmentService

    Crie um XMPUtilityServiceService usando seu construtor de classe proxy.

  3. Chame a operação de importação de metadados de XMP

    Para inspecionar os metadados de XMP, chame o XMPUtilityServiceClient do objeto exportMetadata e passar em um BLOB que representa o arquivo PDF. O método retorna um XMPUtilityMetadata objeto que contém os metadados recuperados.

    Para recuperar e salvar os metadados do XMP, chame o XMPUtilityServiceClient do objeto exportXMP e passar em um BLOB que representa o arquivo PDF. O método retorna um BLOB objeto que contém os metadados recuperados, que podem ser salvos posteriormente em disco como um arquivo XML.

Consulte também

Exportação de metadados de documentos do PDF

Chamada de AEM Forms usando codificação Base64

Criando um assembly de cliente .NET que usa codificação Base64

Nesta página