Trabalhando com XMP Utilities

Exemplos e exemplos neste documento são apenas para AEM Forms no ambiente JEE.

Sobre o XMP Utilities Service

Os documentos PDF contêm metadados, que são informações sobre o documento como distinguido do conteúdo do documento, como texto e gráficos. Adobe Extensible Metadata Platform (XMP) é um padrão para lidar com metadados de documentos.

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

É possível realizar essas tarefas usando o serviço Utilitários XMP:

OBSERVAÇÃO

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

Importação de metadados para Documentos PDF

Você pode usar o Java Utilities XMP e as APIs de serviço da Web para importar XMP metadados de forma programática em um documento PDF. Os metadados fornecem informações sobre um documento PDF, como o autor do documento e as 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, é possível usar um documento XML existente que especifica os valores de metadados ou usar um objeto do tipo XMPUtilityMetadata. (Consulte Referência de 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 Utilities de XMP, consulte Referência de serviços para AEM Forms.

Resumo das etapas

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

  1. Incluir arquivos de projeto.
  2. Crie um cliente XMPUUtilityService.
  3. Chame a operação de importação de metadados 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.

Criação de um cliente XMPUutilityService

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

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

Depois de 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 XMP usando a API Java

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

Incluindo arquivos da biblioteca Java AEM Forms

Configuração das propriedades de conexão

Importar metadados XMP usando a API Java

Importe metadados XMP 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 XMP.

  2. Criação de um cliente XMPUutilityService

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

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

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

    Se você usar o método importMetadata, passe os seguintes valores:

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

    Se você usar o método importXMP, passe os seguintes valores:

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

    Em ambos os casos, o valor retornado é um objeto com.adobe.idp.Document que representa o arquivo PDF com os metadados recém-importados. Em seguida, é possível salvar esse objeto em disco.

Consulte também:

Importação de metadados para Documentos PDF

Incluindo arquivos da biblioteca Java AEM Forms

Configuração das propriedades de conexão

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

Para importar XMP metadados de forma programática usando a API de serviço da Web XMP Utilities, execute as seguintes tarefas:

  1. Incluir arquivos de projeto

  2. Criação de um cliente XMPUutilityService

    Crie um objeto XMPUtilityServiceService usando seu construtor de classe proxy.

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

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

    Se você usar o método importMetadata, passe os seguintes valores:

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

    Se você usar o método importXMP, passe os seguintes valores:

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

    Em ambos os casos, o valor retornado é um objeto BLOB que representa o arquivo PDF com os metadados recém-importados. Em seguida, é possível salvar esse objeto em disco.

Consulte também:

Importação de metadados para Documentos PDF

Invocar o AEM Forms usando a codificação Base64

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

Exportar metadados de Documentos PDF

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

OBSERVAÇÃO

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

Resumo das etapas

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

  1. Incluir arquivos de projeto.
  2. Crie um cliente XMPUUtilityService.
  3. Chame a operação de exportação de metadados 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.

Criação de um cliente XMPUutilityService

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

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

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

Consulte também:

Importar metadados XMP usando a API Java

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

Incluindo arquivos da biblioteca Java AEM Forms

Configuração das propriedades de conexão

Exportar metadados XMP usando a API Java

Exporte os metadados XMP 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. Criação de um cliente XMPUutilityService

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

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

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

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

Consulte também:

Exportação de metadados de Documentos PDF

Incluindo arquivos da biblioteca Java AEM Forms

Configuração das propriedades de conexão

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

Exporte os metadados XMP 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 de Utilitários XMP.
    • Faça referência ao assembly do cliente Microsoft .NET.
  2. Criação de um cliente XMPUutilityService

    Crie um objeto XMPUtilityServiceService usando seu construtor de classe proxy.

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

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

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

Consulte também:

Exportação de metadados de Documentos PDF

Invocar o AEM Forms usando a codificação Base64

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

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free