Os exemplos e amostras neste documento são somente para AEM Forms no ambiente JEE.
O serviço Distiller® converte arquivos PostScript®, Encapsulated PostScript (EPS) e PRN para arquivos PDF compactos, confiáveis e mais seguros em uma rede. O serviço Distiller é frequentemente usado para converter grandes volumes de documentos impressos em documentos eletrônicos, como faturas e demonstrativos. A conversão de documentos em PDF também permite que as empresas enviem aos seus clientes uma versão em papel e uma versão eletrônica de um documento.
Para obter mais informações sobre o serviço Distiller, consulte Referência de serviços para o AEM Forms.
Este tópico descreve como você pode usar a API de serviço do Distiller (Java e serviço da Web) para converter programaticamente arquivos PostScript (PS), Encapsulated PostScript (EPS) e PRN em documentos PDF.
Para obter mais informações sobre o serviço Distiller, consulte Referência de serviços para o AEM Forms.
Para converter arquivos PostScript em documentos PDF, um dos itens a seguir precisa ser instalado no servidor que hospeda o AEM Forms: Acrobat 9 ou Microsoft Visual C++ 2005 pacote redistribuível.
Para converter qualquer um dos tipos suportados em um documento PDF, execute as seguintes etapas:
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando uma aplicação 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 de serviço Distiller
Antes de executar programaticamente uma operação de serviço Distiller, você deve criar um cliente de serviço Distiller. Se estiver usando a API Java, crie uma DistillerServiceClient
objeto. Se estiver usando a API do serviço Web, crie uma DistillerServiceService
objeto.
Recuperar o arquivo para converter
Você deve recuperar o arquivo que deseja converter. Por exemplo, para converter um arquivo PS em um documento PDF, você deve recuperar o arquivo PS.
Chame a operação de criação de PDF
Depois de criar o cliente de serviço, você pode chamar a operação de criação de PDF. Esta operação precisará de informações sobre o documento a ser convertido, incluindo o caminho para o documento de destino.
Salve o documento PDF
Você pode salvar o documento PDF como um arquivo PDF.
Consulte também
Converter um arquivo PostScript em PDF usando a API Java
Conversão de um arquivo PostScript em PDF usando a API do serviço da Web
Inclusão de arquivos da biblioteca Java do AEM Forms
Definindo propriedades de conexão
Início Rápido da API de Serviço de Saída
Converta um arquivo PostScript em um documento PDF usando a API de serviço do Distiller (Java):
Incluir arquivos de projeto.
Inclua arquivos JAR do cliente, como adobe-destiller-client.jar, no caminho de classe do projeto Java.
Crie um cliente de serviço Distiller.
ServiceClientFactory
objeto que contém propriedades de conexão.DistillerServiceClient
usando seu construtor e transmitindo o ServiceClientFactory
objeto.Recupere o arquivo a ser convertido.
java.io.FileInputStream
objeto que representa o arquivo a ser convertido usando seu construtor e transmitindo um valor de string que especifica o local do arquivo.com.adobe.idp.Document
usando seu construtor e transmitindo o java.io.FileInputStream
objeto.Chame a operação de criação de PDF.
Chame o DistillerServiceClient
do objeto createPDF
e passe os seguintes valores:
com.adobe.idp.Document
objeto que representa o arquivo PS, EPS ou PRN a ser convertidojava.lang.String
objeto que contém o nome do arquivo a ser convertidojava.lang.String
objeto que contém o nome das configurações do Adobe PDF a serem usadasjava.lang.String
objeto que contém o nome das configurações de segurança a serem usadascom.adobe.idp.Document
objeto que contém configurações a serem aplicadas durante a geração do documento PDFcom.adobe.idp.Document
objeto que contém informações de metadados a serem aplicadas ao documento PDFA variável createPDF
o método retorna um CreatePDFResult
objeto que contém o novo documento PDF e um arquivo de log que pode ser gerado. O arquivo de log normalmente contém mensagens de erro ou aviso geradas pela solicitação de conversão.
Salve o documento PDF.
Para obter o documento PDF recém-criado, execute as seguintes ações:
CreatePDFResult
do objeto getCreatedDocument
método. Isso retorna um com.adobe.idp.Document
objeto.com.adobe.idp.Document
do objeto copyToFile
método para extrair o documento PDF.Da mesma forma, para obter o documento de log, execute as ações a seguir.
CreatePDFResult
do objeto getLogDocument
método. Isso retorna um com.adobe.idp.Document
objeto.com.adobe.idp.Document
do objeto copyToFile
método para extrair o documento de log.Consulte também
Inclusão de arquivos da biblioteca Java do AEM Forms
Definindo propriedades de conexão
Converta um arquivo PostScript em um documento PDF usando a API de serviço do Distiller (serviço da Web):
Incluir arquivos de projeto.
Crie um projeto Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição WSDL: http://localhost:8080/soap/services/DistillerService?WSDL&lc_version=9.0.1
.
Substituir localhost
com o endereço IP do servidor que hospeda o AEM Forms.
Crie um cliente de serviço Distiller.
Criar um DistillerServiceClient
usando seu construtor padrão.
Criar um DistillerServiceClient.Endpoint.Address
usando o System.ServiceModel.EndpointAddress
construtor. Transmita um valor de string que especifique o WSDL para o serviço AEM Forms (por exemplo, http://localhost:8080/soap/services/DistillerService?blob=mtom
.) Não é necessário usar a variável lc_version
atributo. Esse atributo é usado quando você cria uma referência de serviço. No entanto, especifique ?blob=mtom
para usar MTOM.
Criar um System.ServiceModel.BasicHttpBinding
obtendo o valor do DistillerServiceClient.Endpoint.Binding
campo. Converter o valor de retorno em BasicHttpBinding
.
Defina o System.ServiceModel.BasicHttpBinding
do objeto MessageEncoding
campo para WSMessageEncoding.Mtom
. Esse valor garante que a MTOM seja usada.
Ative a autenticação HTTP básica executando as seguintes tarefas:
DistillerServiceClient.ClientCredentials.UserName.UserName
.DistillerServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
ao campo BasicHttpBindingSecurity.Security.Mode
.Recupere o arquivo a ser convertido.
BLOB
usando seu construtor. Este BLOB
objeto é usado para armazenar o arquivo a ser convertido em um documento PDF.System.IO.FileStream
chamando seu construtor e transmitindo um valor de string que representa o local do arquivo e o modo em que o arquivo será aberto.System.IO.FileStream
objeto. Você pode determinar o tamanho da matriz de bytes obtendo o System.IO.FileStream
do objeto Length
propriedade.System.IO.FileStream
do objeto Read
e transmitindo a matriz de bytes, a posição inicial e o comprimento do fluxo para leitura.BLOB
atribuindo seu MTOM
com o conteúdo da matriz de bytes.Chame a operação de criação de PDF.
Chame o DistillerServiceService
do objeto CreatePDF2
e passe os seguintes valores obrigatórios:
BLOB
objeto que representa o arquivo PS a ser convertidoStandard
)No Securit
y)BLOB
objeto que contém configurações a serem aplicadas durante a geração do documento PDFBLOB
objeto que contém informações de metadados a serem aplicadas ao documento PDFBLOB
parâmetro de saída usado para armazenar o documento PDFBLOB
parâmetro de saída usado para armazenar o logSalve o documento PDF.
System.IO.FileStream
invocando seu construtor. Transmita um valor de string que represente o local do arquivo do documento de PDF assinado e o modo no qual o arquivo será aberto.BLOB
objeto que foi retornado pelo CreatePDF2
(o parâmetro de saída). Preencha a matriz de bytes obtendo o valor de BLOB
do objeto MTOM
membro de dados.System.IO.BinaryWriter
objeto chamando seu construtor e transmitindo o System.IO.FileStream
objeto.System.IO.BinaryWriter
do objeto Write
e transmitindo a matriz de bytes.Consulte também
Chamar o AEM Forms usando MTOM
Chamar o AEM Forms usando SwaRef