O serviço Distiller® converte arquivos PostScript®, Encapsulated PostScript (EPS) e PRN em 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 declarações. 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 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 AEM Forms.
Para converter arquivos PostScript em documentos PDF, um dos itens a seguir precisa ser instalado no servidor que hospeda o AEM Forms: Pacote redistribuível Acrobat 9 ou Microsoft Visual C++ 2005.
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 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 de serviço Distiller
Antes de executar programaticamente uma operação de serviço do Distiller, você deve criar um cliente de serviço do Distiller. Se estiver usando a API do Java, crie um objeto DistillerServiceClient
. Se estiver usando a API do serviço da Web, crie um objeto DistillerServiceService
.
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.
Chamar a operação de criação de PDF
Depois de criar o cliente de serviço, você pode invocar a operação de criação de PDF. Essa operação precisará de informações sobre o documento a ser convertido, incluindo o caminho para o documento de destino.
Salvar 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 para PDF usando a API de serviço da Web
Inclusão de arquivos da biblioteca Java do AEM Forms
Configuração das propriedades de conexão
Início rápido da API do Serviço de Saída
Converta um arquivo PostScript em documento PDF usando a API do serviço de Distiller (Java):
Inclua arquivos de projeto.
Inclua arquivos JAR do cliente, como adobe-destiller-client.jar, no caminho da classe do seu projeto Java.
Crie um cliente de serviço Distiller.
ServiceClientFactory
que contenha propriedades de conexão.DistillerServiceClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Recupere o arquivo para converter.
java.io.FileInputStream
que represente o arquivo a ser convertido usando seu construtor e transmitindo um valor de string que especifique o local do arquivo.com.adobe.idp.Document
usando seu construtor e transmitindo o objeto java.io.FileInputStream
.Chame a operação de criação de PDF.
Chame o método DistillerServiceClient
do objeto createPDF
e passe os seguintes valores:
com.adobe.idp.Document
que representa o arquivo PS, EPS ou PRN a ser convertidojava.lang.String
que contém o nome do arquivo a ser convertidojava.lang.String
que contém o nome das configurações do Adobe PDF a serem usadasjava.lang.String
que contém o nome das configurações de segurança a serem usadascom.adobe.idp.Document
opcional que contém configurações a serem aplicadas durante a geração do documento PDFcom.adobe.idp.Document
opcional que contém informações de metadados a serem aplicadas ao documento PDFO método createPDF
retorna um objeto CreatePDFResult
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
. Isso retorna um objeto com.adobe.idp.Document
.com.adobe.idp.Document
do objeto copyToFile
para extrair o documento PDF.Da mesma forma, para obter o documento de log, execute as seguintes ações.
CreatePDFResult
do objeto getLogDocument
. Isso retorna um objeto com.adobe.idp.Document
.com.adobe.idp.Document
do objeto copyToFile
para extrair o documento de log.Consulte também:
Início rápido (modo SOAP): Conversão de um arquivo PostScript em um documento PDF usando a API Java
Inclusão de arquivos da biblioteca Java do AEM Forms
Configuração das propriedades de conexão
Converta um arquivo PostScript em um documento PDF usando a API do serviço da Distiller (serviço da Web):
Inclua arquivos de projeto.
Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/DistillerService?WSDL&lc_version=9.0.1
.
Substitua localhost
pelo endereço IP do servidor que hospeda o AEM Forms.
Crie um cliente de serviço Distiller.
Crie um objeto DistillerServiceClient
usando seu construtor padrão.
Crie um objeto DistillerServiceClient.Endpoint.Address
usando o construtor System.ServiceModel.EndpointAddress
. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo, http://localhost:8080/soap/services/DistillerService?blob=mtom
.) Você não precisa usar o atributo lc_version
. Esse atributo é usado ao criar uma referência de serviço. No entanto, especifique ?blob=mtom
para usar MTOM.
Crie um objeto System.ServiceModel.BasicHttpBinding
obtendo o valor do campo DistillerServiceClient.Endpoint.Binding
. Converta o valor de retorno em BasicHttpBinding
.
Defina o campo System.ServiceModel.BasicHttpBinding
MessageEncoding
do objeto para WSMessageEncoding.Mtom
. Esse valor garante que o MTOM seja usado.
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 para converter.
BLOB
usando seu construtor. Esse objeto BLOB
é usado para armazenar o arquivo para conversão em um documento PDF.System.IO.FileStream
chamando seu construtor e passando um valor de string que representa o local do arquivo e o modo para abrir o arquivo no.System.IO.FileStream
. Você pode determinar o tamanho da matriz de bytes obtendo a propriedade System.IO.FileStream
do objeto Length
.System.IO.FileStream
do objeto Read
e passando a matriz de bytes, a posição inicial e o comprimento do fluxo a ser lido.BLOB
atribuindo sua propriedade MTOM
ao conteúdo da matriz de bytes.Chame a operação de criação de PDF.
Chame o método DistillerServiceService
do objeto CreatePDF2
e passe os seguintes valores obrigatórios:
BLOB
que representa o arquivo PS a ser convertidoStandard
)No Securit
y)BLOB
opcional que contém configurações a serem aplicadas durante a geração do documento PDFBLOB
opcional que contém informações de metadados a serem aplicadas ao documento PDFBLOB
usado para armazenar o documento PDFBLOB
usado para armazenar o logSalve o documento PDF.
System.IO.FileStream
chamando seu construtor. Passe um valor de string que representa o local do arquivo do documento PDF assinado e o modo no qual o arquivo deve ser aberto.BLOB
retornado pelo método CreatePDF2
(o parâmetro de saída). Preencha a matriz de bytes obtendo o valor do membro de dados BLOB
do objeto MTOM
.System.IO.BinaryWriter
chamando seu construtor e passando o objeto System.IO.FileStream
.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