Conversão de Postscript em documentos PDF converting-postscript-to-pdf-documents
Exemplos e exemplos neste documento são somente para AEM Forms no ambiente JEE.
Sobre o serviço Distiller about-the-distiller-service
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.
Conversão de PostScript em documentos PDF converting-postscript-to-pdf-documents-inner
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.
Resumo das etapas summary-of-steps
Para converter qualquer um dos tipos suportados em um documento PDF, execute as seguintes etapas:
- Incluir arquivos de projeto.
- Crie um cliente de serviço Distiller.
- Recupere o arquivo a ser convertido.
- Chame a operação de criação de PDF.
- Salve o documento PDF.
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 você estiver usando a API Java, crie um objeto DistillerServiceClient
. Se você estiver usando a API de serviço Web, crie um objeto DistillerServiceService
.
Recuperar o arquivo para converter
Recupere o arquivo que deseja converter. Por exemplo, para converter um arquivo PS em um documento PDF, você deve recuperar o arquivo PS.
Invocar 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.
Salvar o documento do 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 Web
Inclusão de arquivos da biblioteca Java do AEM Forms
Converter um arquivo PostScript em PDF usando a API Java convert-a-postscript-file-to-pdf-using-the-java-api
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.
- Crie um objeto
ServiceClientFactory
que contenha propriedades de conexão. - Crie um objeto
DistillerServiceClient
usando seu construtor e transmitindo o objetoServiceClientFactory
.
- Crie um objeto
-
Recupere o arquivo a ser convertido.
- Crie um objeto
java.io.FileInputStream
que represente o arquivo a ser convertido usando seu construtor e transmitindo um valor de cadeia de caracteres que especifique o local do arquivo. - Crie um objeto
com.adobe.idp.Document
usando seu construtor e transmitindo o objetojava.io.FileInputStream
.
- Crie um objeto
-
Chame a operação de criação de PDF.
Chame o método
createPDF
do objetoDistillerServiceClient
e passe os seguintes valores:- O objeto
com.adobe.idp.Document
que representa o arquivo PS, EPS ou PRN a ser convertido - Um objeto
java.lang.String
que contém o nome do arquivo a ser convertido - Um objeto
java.lang.String
que contém o nome das configurações do Adobe PDF a serem usadas - Um objeto
java.lang.String
que contém o nome das configurações de segurança a serem usadas - Um objeto
com.adobe.idp.Document
opcional que contém configurações a serem aplicadas durante a geração do documento PDF - Um objeto
com.adobe.idp.Document
opcional que contém informações de metadados a serem aplicadas ao documento PDF
O método
createPDF
retorna um objetoCreatePDFResult
que contém o novo documento PDF e um arquivo de log que pode ser gerado. O arquivo de log geralmente contém mensagens de erro ou aviso que são geradas pela solicitação de conversão. - O objeto
-
Salve o documento PDF.
Para obter o documento PDF recém-criado, execute as seguintes ações:
- Invoque o método
getCreatedDocument
do objetoCreatePDFResult
. Isso retorna um objetocom.adobe.idp.Document
. - Invoque o método
copyToFile
do objetocom.adobe.idp.Document
para extrair o documento PDF.
Da mesma forma, para obter o documento de log, execute as ações a seguir.
- Invoque o método
getLogDocument
do objetoCreatePDFResult
. Isso retorna um objetocom.adobe.idp.Document
. - Invoque o método
copyToFile
do objetocom.adobe.idp.Document
para extrair o documento de log.
- Invoque o método
Consulte também
Início rápido (modo SOAP): conversão de um arquivo PostScript em um documento PDF usando a API Java
Conversão de um arquivo PostScript em PDF usando a API do serviço Web converting-a-postscript-file-to-pdf-using-the-web-service-api
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
.note note NOTE 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 construtorSystem.ServiceModel.EndpointAddress
. Transmita um valor de cadeia de caracteres que especifique o WSDL para o serviço AEM Forms (por exemplo,http://localhost:8080/soap/services/DistillerService?blob=mtom
.) Você não precisa usar o atributolc_version
. Esse atributo é usado quando você cria uma referência de serviço. No entanto, especifique?blob=mtom
para usar MTOM. -
Crie um objeto
System.ServiceModel.BasicHttpBinding
obtendo o valor do campoDistillerServiceClient.Endpoint.Binding
. Converter o valor de retorno emBasicHttpBinding
. -
Defina o campo
MessageEncoding
do objetoSystem.ServiceModel.BasicHttpBinding
comoWSMessageEncoding.Mtom
. Esse valor garante que a MTOM seja usada. -
Ative a autenticação HTTP básica executando as seguintes tarefas:
- Atribua o nome de usuário dos formulários AEM ao campo
DistillerServiceClient.ClientCredentials.UserName.UserName
. - Atribua o valor de senha correspondente ao campo
DistillerServiceClient.ClientCredentials.UserName.Password
. - Atribua o valor constante
HttpClientCredentialType.Basic
ao campoBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Atribua o valor constante
BasicHttpSecurityMode.TransportCredentialOnly
ao campoBasicHttpBindingSecurity.Security.Mode
.
- Atribua o nome de usuário dos formulários AEM ao campo
-
-
Recupere o arquivo a ser convertido.
- Crie um objeto
BLOB
usando seu construtor. Este objetoBLOB
é usado para armazenar o arquivo a ser convertido em um documento PDF. - Crie um objeto
System.IO.FileStream
chamando seu construtor e transmitindo um valor de cadeia de caracteres que representa o local do arquivo e o modo em que o arquivo será aberto. - Crie uma matriz de bytes que armazene o conteúdo do objeto
System.IO.FileStream
. Você pode determinar o tamanho da matriz de bytes obtendo a propriedadeLength
do objetoSystem.IO.FileStream
. - Preencha a matriz de bytes com os dados de fluxo invocando o método
Read
do objetoSystem.IO.FileStream
e transmitindo a matriz de bytes, a posição inicial e o comprimento do fluxo para leitura. - Preencha o objeto
BLOB
atribuindo sua propriedadeMTOM
com o conteúdo da matriz de bytes.
- Crie um objeto
-
Chame a operação de criação de PDF.
Chame o método
CreatePDF2
do objetoDistillerServiceService
e passe os seguintes valores obrigatórios:- O objeto
BLOB
que representa o arquivo PS a ser convertido - Uma string que contém o nome do caminho do arquivo a ser convertido
- Um objeto de cadeia de caracteres que contém as configurações de Adobe PDF a serem usadas (por exemplo,
Standard
) - Um objeto de cadeia de caracteres que contém as configurações de segurança a serem usadas (por exemplo,
No Securit
a) - Um objeto
BLOB
opcional que contém configurações a serem aplicadas durante a geração do documento PDF - Um objeto
BLOB
opcional que contém informações de metadados a serem aplicadas ao documento PDF - Um parâmetro de saída
BLOB
usado para armazenar o documento PDF - Um parâmetro de saída
BLOB
usado para armazenar o log
- O objeto
-
Salve o documento PDF.
- Crie um objeto
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. - Crie uma matriz de bytes que armazene o conteúdo do objeto
BLOB
retornado pelo métodoCreatePDF2
(o parâmetro de saída). Popular a matriz de bytes obtendo o valor do membro de dadosMTOM
do objetoBLOB
. - Crie um objeto
System.IO.BinaryWriter
invocando seu construtor e transmitindo o objetoSystem.IO.FileStream
. - Grave o conteúdo da matriz de bytes em um arquivo PDF, chamando o método
Write
do objetoSystem.IO.BinaryWriter
e transmitindo a matriz de bytes.
- Crie um objeto
Consulte também
Chamar o AEM Forms usando MTOM
Chamar o AEM Forms usando SwaRef