Chamar o AEM Forms usando serviços da Web invoking-aem-forms-using-web-services

A maioria dos serviços da AEM Forms no contêiner de serviço é configurada para expor um serviço da Web, com suporte total para a geração de WSDL (Web Service Definition Language). Ou seja, você pode criar objetos proxy que consomem a pilha SOAP nativa de um serviço AEM Forms. Como resultado, os serviços da AEM Forms podem trocar e processar as seguintes mensagens SOAP:

Com os serviços da Web, é possível executar as mesmas operações dos serviços da AEM Forms que você pode usar a API do Java. Uma vantagem de usar serviços da Web para invocar os serviços da AEM Forms é que você pode criar um aplicativo cliente em um ambiente de desenvolvimento compatível com SOAP. Um aplicativo cliente não está vinculado a um ambiente de desenvolvimento específico ou linguagem de programação. Por exemplo, você pode criar um aplicativo cliente usando o Microsoft Visual Studio .NET e C# como a linguagem de programação.

Os serviços da AEM Forms são expostos através do protocolo SOAP e são compatíveis com o Perfil básico WSI 1.1. A WSI (Web Services Interoperability, interoperabilidade de serviços da Web) é uma organização de padrões abertos que promove a interoperabilidade do serviço da Web em todas as plataformas. Para obter mais informações, consulte https://www.ws-i.org/.

O AEM Forms oferece suporte aos seguintes padrões de serviço da Web:

Para chamar os serviços da AEM Forms usando um serviço da Web, normalmente você cria uma biblioteca de proxy que consome o serviço WSDL. O Chamar o AEM Forms usando serviços da Web A seção usa o JAX-WS para criar classes proxy Java para chamar serviços. (Consulte Criando classes proxy Java usando JAX-WS.)

Você pode recuperar um WDSL de serviço especificando a seguinte definição de URL (os itens entre colchetes são opcionais):

 https://<your_serverhost>:<your_port>/soap/services/<service_name>?wsdl[&version=<version>][&async=true|false][lc_version=<lc_version>]

em que:

A tabela a seguir lista as definições de WSDL de serviço (supondo que o AEM Forms esteja implantado no host local e a publicação seja 8080).

Definições de WSDL do processo AEM Forms

Você deve especificar o nome do Aplicativo e o nome do Processo na definição WSDL para acessar um WSDL que pertence a um processo criado no Workbench. Suponha que o nome do aplicativo seja MyApplication e o nome do processo é EncryptDocument. Nessa situação, especifique a seguinte definição de WSDL:

 http://localhost:8080/soap/services/MyApplication/EncryptDocument?wsdl

 http://localhost:8080/soap/services/MyApplication/[<folderA>/.../<folderZ>/]EncryptDocument?wsdl

Acessar nova funcionalidade usando serviços da Web

A nova funcionalidade do serviço AEM Forms pode ser acessada usando serviços da Web. Por exemplo, no AEM Forms, é introduzida a capacidade de codificar anexos usando MTOM. (Consulte Chamar o AEM Forms usando MTOM.)

Para acessar a nova funcionalidade introduzida no AEM Forms, especifique o lc_version na definição WSDL. Por exemplo, para acessar a nova funcionalidade do serviço (incluindo o suporte a MTOM), especifique a seguinte definição de WSDL:

 http://localhost:8080/soap/services/MyApplication/EncryptDocument?wsdl&lc_version=9.0.1

Tipo de dados BLOB do serviço da Web

As WSDLs do serviço AEM Forms definem muitos tipos de dados. Um dos tipos de dados mais importantes expostos em um serviço da Web é um BLOB tipo . Esse tipo de dados mapeia para a com.adobe.idp.Document ao trabalhar com APIs Java da AEM Forms. (Consulte Passar dados para serviços da AEM Forms usando a API do Java.)

A BLOB O objeto envia e recupera dados binários (por exemplo, arquivos PDF, dados XML e assim por diante) de e para os serviços da AEM Forms. O BLOB O tipo é definido em um WSDL de serviço da seguinte maneira:

 <complexType name="BLOB">
     <sequence>
         <element maxOccurs="1" minOccurs="0" name="contentType"
             type="xsd:string"/>
         <element maxOccurs="1" minOccurs="0" name="binaryData"
             type="xsd:base64Binary"/>
         <element maxOccurs="1" minOccurs="0" name="attachmentID"
             type="xsd:string"/>
         <element maxOccurs="1" minOccurs="0" name="remoteURL"
             type="xsd:string"/>
         <element maxOccurs="1" minOccurs="0" name="MTOM"
             type="xsd:base64Binary"
             xmime:expectedContentTypes="*/*"
             xmlns:xmime="https://www.w3.org/2005/05/xmlmime"/>
         <element maxOccurs="1" minOccurs="0" name="swaRef"
             type="tns1:swaRef"/>
         <element maxOccurs="1" minOccurs="0" name="attributes"
             type="impl:MyMapOf_xsd_string_To_xsd_anyType"/>
     </sequence>
 </complexType>

O MTOM e swaRef são compatíveis somente com o AEM Forms. Você pode usar esses novos campos somente se especificar um URL que inclui a variável lc_version propriedade.

Fornecimento de objetos BLOB em solicitações de serviço

Se uma operação de serviço AEM Forms exigir um BLOB digite como um valor de entrada, crie uma instância do BLOB digite a lógica do aplicativo. (Muitas das inicializações rápidas do serviço da Web estão localizadas em Programação com formulários AEM mostrar como trabalhar com um tipo de dados BLOB.)

Atribua valores a campos que pertencem à variável BLOB instância da seguinte maneira:

Acesso a dados em objetos BLOB retornados de serviços

O protocolo de transmissão para retornado BLOB Os objetos dependem de vários fatores, que são considerados na seguinte ordem, interrompendo quando a condição principal for atendida:

Conforme descrito na primeira condição, é possível garantir o tipo de transmissão para quaisquer documentos retornados estendendo o URL do ponto de extremidade SOAP com um sufixo, da seguinte maneira:

     https://<your_serverhost>:<your_port>/soap/services/<service
     name>?blob=base64|dime|mime|http|mtom|swaref

Esta é a correlação entre os tipos de transmissão e o campo a partir do qual você obtém os dados:

Transmissão MTOM de matrizes de bytes codificadas em base64

Além do BLOB , o protocolo MTOM suporta qualquer parâmetro de matriz de bytes ou campo de matriz de bytes de um tipo complexo. Isso significa que as estruturas SOAP do cliente compatíveis com MTOM podem enviar qualquer xsd:base64Binary elemento como um anexo MTOM (em vez de um texto codificado em base64). Os pontos de extremidade SOAP AEM Forms podem ler esse tipo de codificação de matriz de bytes. No entanto, o serviço AEM Forms sempre retorna um tipo de matriz de bytes como um texto codificado em base64. Os parâmetros da matriz de bytes de saída não são compatíveis com MTOM.

Os serviços da AEM Forms que retornam uma grande quantidade de dados binários usam o tipo Documento/BLOB em vez do tipo de matriz de bytes. O tipo de documento é muito mais eficiente para transmitir grandes quantidades de dados.

Tipos de dados do serviço da Web web-service-data-types

A tabela a seguir lista os tipos de dados Java e mostra o tipo de dados do serviço da Web correspondente.

Criando classes proxy Java usando JAX-WS creating-java-proxy-classes-using-jax-ws

Você pode usar o JAX-WS para converter um WSDL de serviço da Forms em classes proxy Java. Essas classes permitem que você chame as operações dos serviços da AEM Forms. O Apache Ant permite criar um script de criação que gera classes proxy Java referenciando um WSDL do serviço AEM Forms. Você pode gerar arquivos proxy JAX-WS executando as seguintes etapas:

Consulte também

Criação de classes proxy Java usando o Apache Axis

Chamada de AEM Forms usando codificação Base64

Chamada de AEM Forms usando dados BLOB sobre HTTP

Chamar o AEM Forms usando SwaRef

Criação de classes proxy Java usando o Apache Axis creating-java-proxy-classes-using-apache-axis

Você pode usar a ferramenta Apache Axis WSDL2Java para converter um serviço Forms em classes proxy Java. Essas classes permitem que você chame as operações do serviço Forms. Usando o Apache Ant, você pode gerar arquivos de biblioteca do Axis a partir de um WSDL de serviço. Você pode baixar o Apache Axis no URL https://ws.apache.org/axis/.

Você pode gerar arquivos de biblioteca Java do Axis executando as seguintes etapas:

Consulte também

Criando classes proxy Java usando JAX-WS

Chamada de AEM Forms usando codificação Base64

Chamada de AEM Forms usando dados BLOB sobre HTTP

Chamada de AEM Forms usando codificação Base64 invoking-aem-forms-using-base64-encoding

Você pode chamar um serviço AEM Forms usando a codificação Base64. Codificação Base64 codifica anexos que são enviados com uma solicitação de invocação de serviço da Web. Ou seja, BLOB Os dados são codificados em Base64, não na mensagem SOAP inteira.

"Chamar o AEM Forms usando a codificação Base64" discute chamar o seguinte processo de curta duração do AEM Forms chamado MyApplication/EncryptDocument usando a codificação Base64.

Quando esse processo é chamado, ele executa as seguintes ações:

Criando um assembly de cliente .NET que usa codificação Base64 creating-a-net-client-assembly-that-uses-base64-encoding

Você pode criar um assembly de cliente .NET para chamar um serviço Forms de um projeto Microsoft Visual Studio .NET. Para criar um assembly de cliente .NET que use codificação base64, execute as seguintes etapas:

Criação de uma classe proxy

Você pode criar uma classe proxy usada para criar o assembly do cliente .NET usando uma ferramenta que acompanha o Microsoft Visual Studio. O nome da ferramenta é wsdl.exe e está localizado na pasta de instalação do Microsoft Visual Studio. Para criar uma classe proxy, abra o prompt de comando e navegue até a pasta que contém o arquivo wsdl.exe. Para obter mais informações sobre a ferramenta wsdl.exe, consulte o Ajuda do MSDN.

Digite o seguinte comando no prompt de comando:

 wsdl https://hiro-xp:8080/soap/services/MyApplication/EncryptDocument?WSDL&lc_version=9.0.1

Por padrão, essa ferramenta cria um arquivo CS na mesma pasta que se baseia no nome do WSDL. Nessa situação, ele cria um arquivo CS chamado EncryptDocumentService.cs. Use esse arquivo CS para criar um objeto proxy que permita chamar o serviço especificado no URL de invocação.

Alterar o URL na classe de proxy para incluir ?blob=base64 para assegurar que BLOB retorna dados binários. Na classe proxy, localize a seguinte linha de código:

 "https://hiro-xp:8080/soap/services/MyApplication/EncryptDocument";

e alterá-lo para:

 "https://hiro-xp:8080/soap/services/MyApplication/EncryptDocument?blob=base64";

O Chamada de AEM Forms usando codificação Base64 usos da seção MyApplication/EncryptDocument como exemplo. Se estiver criando um assembly de cliente .NET para outro serviço Forms, certifique-se de substituir MyApplication/EncryptDocument com o nome do serviço.

Desenvolvendo o assembly do cliente .NET

Crie um projeto do Visual Studio Class Library que produz um assembly de cliente .NET. O arquivo CS criado usando wsdl.exe pode ser importado para este projeto. Este projeto produz um arquivo DLL (o assembly do cliente .NET) que você pode usar em outros projetos do Visual Studio .NET para invocar um serviço.

Fazendo referência ao assembly do cliente .NET

Coloque o conjunto de clientes .NET recém-criado no computador onde está desenvolvendo o aplicativo cliente. Depois de colocar o assembly do cliente .NET em um diretório, você pode referenciá-lo a partir de um projeto. Consulte também a System.Web.Services biblioteca do seu projeto. Se não fizer referência a esta biblioteca, não poderá utilizar a assemblagem de cliente .NET para invocar um serviço.

Chamando um serviço usando um assembly de cliente .NET que usa codificação Base64

Você pode invocar o MyApplication/EncryptDocument serviço (que foi criado no Workbench) usando um assembly de cliente .NET que usa codificação Base64. Para invocar o MyApplication/EncryptDocument execute as seguintes etapas:

Chamada de serviço usando classes proxy Java e codificação Base64 invoking-a-service-using-java-proxy-classes-and-base64-encoding

Você pode chamar um serviço da AEM Forms usando classes proxy Java e Base64. Para invocar o MyApplication/EncryptDocument serviço usando classes proxy Java, execute as seguintes etapas:

Consulte também

Início rápido: Chamada de serviço usando arquivos proxy Java e codificação Base64

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

Chamar o AEM Forms usando MTOM invoking-aem-forms-using-mtom

Você pode chamar os serviços da AEM Forms usando o MTOM padrão do serviço da Web. Esse padrão define como os dados binários, como um documento PDF, são transmitidos pela Internet ou pela intranet. Um recurso do MTOM é o uso do XOP:Include elemento. Esse elemento é definido na especificação XML Binary Otimized Packaging (XOP) para fazer referência aos anexos binários de uma mensagem SOAP.

A discussão aqui é sobre o uso do MTOM para invocar o seguinte processo de curta duração do AEM Forms chamado MyApplication/EncryptDocument.

Quando esse processo é chamado, ele executa as seguintes ações:

A discussão aqui é sobre o uso do MTOM em um projeto do Microsoft .NET para chamar os serviços do AEM Forms. O .NET Framework usado é 3.5, e o ambiente de desenvolvimento é Visual Studio 2008. Se você tiver o WSE (Web Service Enhancements, Melhorias de serviço da Web) instalado no computador de desenvolvimento, remova-o. O .NET 3.5 Framework suporta uma estrutura SOAP chamada Windows Communication Foundation (WCF). Ao invocar o AEM Forms usando o MTOM, somente o WCF (não WSE) é compatível.

Criando um projeto .NET que chame um serviço usando MTOM creating-a-net-project-that-invokes-a-service-using-mtom

Você pode criar um projeto do Microsoft .NET que possa chamar um serviço do AEM Forms usando serviços da Web. Primeiro, crie um projeto Microsoft .NET usando o Visual Studio 2008. Para chamar um serviço do AEM Forms, crie uma Referência de serviço para o serviço do AEM Forms que você deseja chamar em seu projeto. Ao criar uma Referência de serviço, especifique um URL para o serviço AEM Forms:

 http://localhost:8080/soap/services/MyApplication/EncryptDocument?WSDL&lc_version=9.0.1

Substituir localhost com o endereço IP do servidor de aplicativos J2EE que hospeda o AEM Forms. Substituir MyApplication/EncryptDocument com o nome do serviço AEM Forms a ser chamado. Por exemplo, para invocar uma operação de Rights Management, especifique:

http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1

O lc_version garante que a funcionalidade do AEM Forms, como MTOM, esteja disponível. Sem especificar o lc_version não é possível chamar o AEM Forms usando o MTOM.

Após criar uma Referência de serviço, os tipos de dados associados ao serviço do AEM Forms estarão disponíveis para uso em seu projeto .NET. Para criar um projeto .NET que chame um serviço AEM Forms, execute as seguintes etapas:

Chamar um serviço usando MTOM em um projeto .NET invoking-a-service-using-mtom-in-a-net-project

Considere a MyApplication/EncryptDocument processo que aceita um documento PDF não seguro e retorna um documento PDF criptografado por senha. Para invocar o MyApplication/EncryptDocument processo (que foi criado no Workbench) usando o MTOM, execute as seguintes etapas:

Consulte também

Início rápido: Chamar um serviço usando MTOM em um projeto .NET

Acesso a vários serviços usando serviços da Web

Criação de um aplicativo Web ASP.NET que invoque um processo de vida longa centrado em humanos

Chamar o AEM Forms usando SwaRef invoking-aem-forms-using-swaref

Você pode chamar os serviços da AEM Forms usando SwaRef. O conteúdo da wsi:swaRef O elemento XML é enviado como um anexo dentro de um corpo SOAP que armazena a referência ao anexo. Ao chamar um serviço Forms usando SwaRef, crie classes proxy Java usando a API Java para XML Web Services (JAX-WS). (Consulte API Java para serviços XML da Web.)

A discussão aqui é sobre invocar o seguinte processo de curta duração do Forms chamado MyApplication/EncryptDocument ao utilizar SwaRef.

Quando esse processo é chamado, ele executa as seguintes ações:

A discussão abaixo é sobre como invocar os serviços da Forms usando SwaRef em um aplicativo cliente Java. O aplicativo Java usa classes proxy criadas usando JAX-WS.

Chamar um serviço usando arquivos da biblioteca JAX-WS que usam SwaRef invoke-a-service-using-jax-ws-library-files-that-use-swaref

Para invocar o MyApplication/EncryptDocument processar usando arquivos proxy Java criados com JAX-WS e SwaRef, execute as seguintes etapas:

Consulte também

Início rápido: Chamar um serviço usando SwaRef em um projeto Java

Chamada de AEM Forms usando dados BLOB sobre HTTP invoking-aem-forms-using-blob-data-over-http

Você pode chamar os serviços da AEM Forms usando serviços da Web e transmitir dados BLOB via HTTP. Passar dados BLOB por HTTP é uma técnica alternativa em vez de usar codificação base64, DIME ou MIME. Por exemplo, você pode passar dados via HTTP em um projeto do Microsoft .NET que usa o Aprimoramento do serviço da Web 3.0, que não é compatível com DIME ou MIME. Ao usar dados BLOB em HTTP, os dados de entrada são carregados antes que o serviço AEM Forms seja chamado.

"Chamar o AEM Forms usando dados BLOB sobre HTTP" discute chamar o seguinte processo de curta duração do AEM Forms chamado MyApplication/EncryptDocument transmitindo dados BLOB por HTTP.

Quando esse processo é chamado, ele executa as seguintes ações:

Criando um assembly de cliente .NET que usa dados em HTTP creating-a-net-client-assembly-that-uses-data-over-http

Para criar um assembly de cliente que use dados via HTTP, siga o processo especificado em Chamada de AEM Forms usando codificação Base64. No entanto, altere o URL na classe de proxy para incluir ?blob=http em vez de ?blob=base64. Essa ação garante que os dados sejam transmitidos por HTTP. Na classe proxy, localize a seguinte linha de código:

 "http://localhost:8080/soap/services/MyApplication/EncryptDocument";

e alterá-lo para:

 "http://localhost:8080/soap/services/MyApplication/EncryptDocument?blob=http";

Fazendo referência ao assembly .NET clienMyApplication/EncryptDocumentt

Coloque o novo assembly do cliente .NET no computador em que você está desenvolvendo seu aplicativo cliente. Depois de colocar o assembly do cliente .NET em um diretório, você pode referenciá-lo a partir de um projeto. Faça referência ao System.Web.Services biblioteca do seu projeto. Se não fizer referência a esta biblioteca, não poderá utilizar a assemblagem de cliente .NET para invocar um serviço.

Chamando um serviço usando um assembly de cliente .NET que usa dados BLOB via HTTP

Você pode invocar o MyApplication/EncryptDocument serviço (que foi criado no Workbench) usando um assembly de cliente .NET que usa dados via HTTP. Para invocar o MyApplication/EncryptDocument execute as seguintes etapas:

Chamada de serviço usando classes proxy Java e dados BLOB por HTTP invoking-a-service-using-java-proxy-classes-and-blob-data-over-http

Você pode chamar um serviço da AEM Forms usando classes proxy Java e dados BLOB via HTTP. Para invocar o MyApplication/EncryptDocument serviço usando classes proxy Java, execute as seguintes etapas:

Chamar o AEM Forms usando DIME invoking-aem-forms-using-dime

Você pode chamar os serviços da AEM Forms usando SOAP com anexos. O AEM Forms oferece suporte aos padrões de serviço da Web MIME e DIME. O DIME permite enviar anexos binários, como documentos PDF, juntamente com solicitações de invocação em vez de codificar o anexo. O Chamar o AEM Forms usando DIME seção discute invocar o seguinte processo de curta duração do AEM Forms chamado MyApplication/EncryptDocument utilizando DIME.

Quando esse processo é chamado, ele executa as seguintes ações:

Esse processo não se baseia em um processo AEM Forms existente. Para seguir junto com os exemplos de código, crie um processo chamado MyApplication/EncryptDocument**usando o Workbench. (Consulte Uso do Workbench.)

Criando um projeto .NET que usa DIME creating-a-net-project-that-uses-dime

Para criar um projeto .NET que possa invocar um serviço Forms usando DIME, execute as seguintes tarefas:

Instalação dos aprimoramentos de serviços da Web 2.0

Instale os Aprimoramentos de Serviços Web 2.0 em seu computador de desenvolvimento e integre-o ao Microsoft Visual Studio .NET. Você pode baixar os Aprimoramentos de serviços da Web 2.0 da seção Centro de download da Microsoft.

Nesta página da Web, procure por Aprimoramentos de serviços da Web 2.0 e baixe-os no computador de desenvolvimento. Este download coloca um arquivo chamado Microsoft WSE 2.0 SPI.msi em seu computador. Execute o programa de instalação e siga as instruções online.

Criação de uma referência da Web para um serviço AEM Forms

Depois de instalar os Aprimoramentos de Serviços Web 2.0 no computador de desenvolvimento e criar um projeto Microsoft .NET, crie uma referência Web para o serviço Forms. Por exemplo, para criar uma referência da Web para a variável MyApplication/EncryptDocument e supondo que o Forms esteja instalado no computador local, especifique o seguinte URL:

     http://localhost:8080/soap/services/MyApplication/EncryptDocument?WSDL

Após criar uma referência da Web, os dois tipos de dados proxy a seguir estão disponíveis para você usar em seu projeto .NET: EncryptDocumentService e EncryptDocumentServiceWse. Para invocar o MyApplication/EncryptDocument processar usando o DIME, use o EncryptDocumentServiceWse tipo .

Referência à biblioteca WSE

Criar uma referência da Web para um serviço Forms

Chamando um serviço usando DIME em um projeto .NET

Você pode chamar um serviço Forms usando DIME. Considere a MyApplication/EncryptDocument processo que aceita um documento PDF não seguro e retorna um documento PDF criptografado por senha. Para invocar o MyApplication/EncryptDocument para processar usando o DIME, execute as seguintes etapas:

Criando classes proxy Java do Apache Axis que usam DIME creating-apache-axis-java-proxy-classes-that-use-dime

Você pode usar a ferramenta Apache Axis WSDL2Java para converter um WSDL de serviço em classes proxy Java para que possa chamar operações de serviço. Usando o Apache Ant, você pode gerar arquivos de biblioteca do Axis a partir de um WSDL de serviço da AEM Forms que permite chamar o serviço. (Consulte Criação de classes proxy Java usando o Apache Axis.)

A ferramenta Apache Axis WSDL2Java gera arquivos JAVA que contêm métodos usados para enviar solicitações SOAP a um serviço. As solicitações SOAP recebidas por um serviço são decodificadas pelas bibliotecas geradas pelo Axis e transformadas em métodos e argumentos.

Para invocar o MyApplication/EncryptDocument serviço (que foi criado no Workbench) usando arquivos de biblioteca gerados pelo Axis e DIME, execute as seguintes etapas:

Consulte também

Início rápido: Chamar um serviço usando DIME em um projeto Java

Usar autenticação baseada em SAML using-saml-based-authentication

O AEM Forms oferece suporte a vários modos de autenticação de serviço da Web ao chamar serviços. Um modo de autenticação está especificando um nome de usuário e um valor de senha usando um cabeçalho de autorização básico na chamada de serviço da Web. O AEM Forms também oferece suporte à autenticação baseada em asserção SAML. Quando um aplicativo cliente chama um serviço da AEM Forms usando um serviço da Web, o aplicativo cliente pode fornecer informações de autenticação de uma das seguintes maneiras:

A AEM Forms não oferece suporte à autenticação baseada em certificado padrão, mas oferece suporte à autenticação baseada em certificado em um formulário diferente.

A identidade dos usuários dos formulários de AEM pode ser representada por meio de uma asserção SAML assinada usando uma chave secreta. O código XML a seguir mostra um exemplo de uma asserção SAML.

 <Assertion xmlns="urn:oasis:names:tc:SAML:1.0:assertion"
     xmlns:saml="urn:oasis:names:tc:SAML:1.0:assertion"
     xmlns:samlp="urn:oasis:names:tc:SAML:1.0:protocol"
     AssertionID="fd4bd0c87302780e0d9bbfa8726d5bc0" IssueInstant="2008-04-17T13:47:00.720Z" Issuer="LiveCycle"
     MajorVersion="1" MinorVersion="1">
     <Conditions NotBefore="2008-04-17T13:47:00.720Z" NotOnOrAfter="2008-04-17T15:47:00.720Z">
     </Conditions>
     <AuthenticationStatement
         AuthenticationInstant="2008-04-17T13:47:00.720Z"
         AuthenticationMethod="urn:oasis:names:tc:SAML:1.0:am:unspecified">
         <Subject>
             <NameIdentifier NameQualifier="DefaultDom">administrator</NameIdentifier>
             <SubjectConfirmation>
                 <ConfirmationMethod>urn:oasis:names:tc:SAML:1.0:cm:sender-vouches</ConfirmationMethod>
             </SubjectConfirmation>
         </Subject>
     </AuthenticationStatement>
     <ds:Signature >
         <ds:SignedInfo>
             <ds:CanonicalizationMethod Algorithm="https://www.w3.org/2001/10/xml-exc-c14n#"></ds:CanonicalizationMethod>
             <ds:SignatureMethod    Algorithm="https://www.w3.org/2000/09/xmldsig#hmac-sha1"></ds:SignatureMethod>
             <ds:Reference URI="#fd4bd0c87302780e0d9bbfa8726d5bc0">
                 <ds:Transforms>
                     <ds:Transform Algorithm="https://www.w3.org/2000/09/xmldsig#enveloped-signature"></ds:Transform>
                     <ds:Transform Algorithm="https://www.w3.org/2001/10/xml-exc-c14n#">
                         <ec:InclusiveNamespaces
                             PrefixList="code ds kind rw saml samlp typens #default">
                         </ec:InclusiveNamespaces>
                     </ds:Transform>
                 </ds:Transforms>
                 <ds:DigestMethod Algorithm="https://www.w3.org/2000/09/xmldsig#sha1"></ds:DigestMethod>
                 <ds:DigestValue>hVrtqjWr+VzaVUIpQx0YI9lIjaY=</ds:DigestValue>
             </ds:Reference>
         </ds:SignedInfo>
         <ds:SignatureValue>UMbBb+cUcPtcWDCIhXes4n4FxfU=</ds:SignatureValue>
     </ds:Signature>
 </Assertion>

Esta asserção de exemplo é emitida para um usuário administrador. Essa asserção contém os seguintes itens observáveis:

Um aplicativo cliente pode recuperar a asserção de qualquer API do AEM Forms AuthenticationManager que retorne um AuthResult objeto. Você pode obter um AuthResult executando um dos dois métodos a seguir:

um usuário do AEM forms pode ser autenticado usando um token SAML obtido. Essa asserção SAML (fragmento xml) pode ser enviada como parte do cabeçalho WS-Security com a chamada de serviço da Web para autenticação de usuário. Normalmente, um aplicativo cliente autentica um usuário, mas não armazenou as credenciais do usuário. (Ou o usuário fez logon nesse cliente por meio de um mecanismo diferente do uso de um nome de usuário e senha.) Nessa situação, o aplicativo cliente deve chamar o AEM Forms e representar um usuário específico que tenha permissão para invocar o AEM Forms.

Para representar um usuário específico, chame o AuthenticationManager.getAuthResultOnBehalfOfUser usando um serviço da Web. Esse método retorna um AuthResult instância que contém a asserção SAML para esse usuário.

Em seguida, use essa asserção SAML para invocar qualquer serviço que exija autenticação. Essa ação envolve enviar a asserção como parte do cabeçalho SOAP. Quando uma chamada de serviço da Web é feita com essa asserção, o AEM Forms identifica o usuário como aquele representado por essa asserção. Ou seja, o usuário especificado na asserção é o usuário que está chamando o serviço.

Uso de classes do Apache Axis e autenticação baseada em SAML using-apache-axis-classes-and-saml-based-authentication

Você pode chamar um serviço AEM Forms por classes proxy Java que foram criadas usando a biblioteca Eixo. (Consulte Criação de classes proxy Java usando o Apache Axis.)

Ao usar o AXIS que usa a autenticação baseada em SAML, registre o manipulador de solicitação e resposta no Axis. O Apache Axis chama o manipulador antes de enviar uma solicitação de invocação para o AEM Forms. Para registrar um manipulador, crie uma classe Java que se estende org.apache.axis.handlers.BasicHandler.

Criar um AssertionHandler com Eixo

A seguinte classe Java, chamada de AssertionHandler.java, mostra um exemplo de uma classe Java que se estende org.apache.axis.handlers.BasicHandler.

 public class AssertionHandler extends BasicHandler {
        public void invoke(MessageContext ctx) throws AxisFault {
            String assertion = (String) ctx.getProperty(LC_ASSERTION);

            //no assertion hence nothing to insert
            if(assertion == null) return;

            try {
                MessageElement samlElement = new MessageElement(convertToXML(assertion));
                SOAPHeader header = (SOAPHeader) ctx.getRequestMessage().getSOAPHeader();
                //Create the wsse:Security element which would contain the SAML element
                SOAPElement wsseHeader = header.addChildElement("Security", "wsse", WSSE_NS);
                wsseHeader.appendChild(samlElement);
                //remove the actor attribute as in LC we do not specify any actor. This would not remove the actor attribute though
                //it would only remove it from the soapenv namespace
                wsseHeader.getAttributes().removeNamedItem("actor");
            } catch (SOAPException e) {
                throw new AxisFault("Error occured while adding the assertion to the SOAP Header",e);
            }
        }
 }

Registre o manipulador

Para registrar um manipulador no Axis, crie um arquivo client-config.wsdd . Por padrão, o Axis procura um arquivo com esse nome. O código XML a seguir é um exemplo de um arquivo client-config.wsdd . Consulte a documentação do Eixo para obter mais informações.

 <deployment xmlns="https://xml.apache.org/axis/wsdd/" xmlns:java="https://xml.apache.org/axis/wsdd/providers/java">
     <transport name="http" pivot="java:org.apache.axis.transport.http.HTTPSender"/>
      <globalConfiguration >
       <requestFlow >
        <handler type="java:com.adobe.idp.um.example.AssertionHandler" />
       </requestFlow >
      </globalConfiguration >
 </deployment>

Chamar um serviço AEM Forms

O exemplo de código a seguir chama um serviço AEM Forms usando a autenticação baseada em SAML.

 public class ImpersonationExample {
        . . .
        public void  authenticateOnBehalf(String superUsername,String password,
                String canonicalName,String domainName) throws UMException, RemoteException{
            ((org.apache.axis.client.Stub) authenticationManager).setUsername(superUsername);
            ((org.apache.axis.client.Stub) authenticationManager).setPassword(password);

            //Step 1 - Invoke the Auth manager api to get an assertion for the user to be impersonated
            AuthResult ar = authenticationManager.getAuthResultOnBehalfOfUser(canonicalName, domainName, null);
            String assertion = ar.getAssertion();
            //Step 2 - Setting the assertion here to be picked later by the AssertionHandler. Note that stubs are not threadSafe
            //hence should not be reused. For this simple example we have made them instance variable but care should be taken
            //regarding the thread safety
            ((javax.xml.rpc.Stub) authorizationManager)._setProperty(AssertionHandler.LC_ASSERTION, assertion);
        }

        public Role findRole(String roleId) throws UMException, RemoteException{
            //This api would be invoked under bob's user rights
            return authorizationManager.findRole(roleId);
        }

        public static void main(String[] args) throws Exception {
            ImpersonationExample ie = new ImpersonationExample("http://localhost:5555");
            //Get the SAML assertion for the user to impersonate and store it in stub
            ie.authenticateOnBehalf(
                    "administrator", //The Super user which has the required impersonation permission
                    "password", // Password of the super user as referred above
                    "bob", //Cannonical name of the user to impersonate
                    "testdomain" //Domain of the user to impersonate
                    );

            Role r = ie.findRole("BASIC_ROLE_ADMINISTRATOR");
            System.out.println("Role "+r.getName());
        }
 }

Usando um assembly de cliente .NET e autenticação baseada em SAML using-a-net-client-assembly-and-saml-based-authentication

Você pode invocar um serviço Forms usando um assembly de cliente .NET e autenticação baseada em SAML. Para fazer isso, você deve usar o WSE (Web Service Aprimorments 3.0). Para obter informações sobre como criar um assembly de cliente .NET que usa WSE, consulte Criando um projeto .NET que usa DIME.

A arquitetura WSE usa tipos de dados Políticas, Asserções e SecurityToken. Resumidamente, para uma chamada de serviço da Web, especifique uma política. Uma política pode ter várias asserções. Cada asserção pode conter filtros. Um filtro é chamado em determinados estágios em uma chamada de serviço da Web e, nesse momento, pode modificar a solicitação SOAP. Para obter detalhes completos, consulte a documentação Melhorias do serviço da Web 3.0 .

Criar a asserção e o filtro

O exemplo de código C# a seguir cria classes de filtro e asserção. Este exemplo de código cria um SamlAssertionOutputFilter. Esse filtro é chamado pela estrutura WSE antes da solicitação SOAP ser enviada para o AEM Forms.

 class LCSamlPolicyAssertion : Microsoft.Web.ServicES4.Design.PolicyAssertion
 {
        public override Microsoft.Web.ServicES4.SoapFilter CreateClientOutputFilter(FilterCreationContext context)
        {
           return new SamlAssertionOutputFilter();
        }
        . . .
 }


 class SamlAssertionOutputFilter : SendSecurityFilter
 {
        public override void SecureMessage(SoapEnvelope envelope, Security security)
        {
           // Get the SamlToken from the SessionState
           SamlToken samlToken = envelope.Context.Credentials.UltimateReceiver.GetClientToken<SamlToken>();
           security.Tokens.Add(samlToken);
        }
 }

Criar o token SAML

Crie uma classe para representar a asserção SAML. A principal tarefa executada por essa classe é converter valores de dados da string em xml e preservar o espaço em branco. Esse xml de asserção é importado posteriormente para a solicitação SOAP.

 class SamlToken : SecurityToken
 {
        public const string SAMLAssertion = "https://docs.oasis-open.org/wss/oasis-wss-saml-token-profile-1.1#SAMLV1.1";
        private XmlElement _assertionElement;

        public SamlToken(string assertion)
             : base(SAMLAssertion)
        {
           XmlDocument xmlDoc = new XmlDocument();
           //The white space has to be preserved else the digital signature would get broken
           xmlDoc.PreserveWhitespace = true;
           xmlDoc.LoadXml(assertion);
           _assertionElement = xmlDoc.DocumentElement;
         }

         public override XmlElement GetXml(XmlDocument document)
         {
            return (XmlElement)document.ImportNode(_assertionElement, true);
         }
        . . .
 }

Chamar um serviço AEM Forms

O exemplo de código C# a seguir chama um serviço Forms usando a autenticação baseada em SAML.

 public class ImpersonationExample
 {
        . . .
        public void AuthenticateOnBehalf(string superUsername, string password, string canonicalName, string domainName)
        {
            //Create a policy for UsernamePassword Token
            Policy usernamePasswordPolicy = new Policy();
            usernamePasswordPolicy.Assertions.Add(new UsernameOverTransportAssertion());

            UsernameToken token = new UsernameToken(superUsername, password, PasswordOption.SendPlainText);
            authenticationManager.SetClientCredential(token);
            authenticationManager.SetPolicy(usernamePasswordPolicy);

            //Get the SAML assertion for impersonated user
            AuthClient.AuthenticationManagerService.AuthResult ar
                = authenticationManager.getAuthResultOnBehalfOfUser(canonicalName, domainName, null);
            System.Console.WriteLine("Received assertion " + ar.assertion);

            //Create a policy for inserting SAML assertion
            Policy samlPolicy = new Policy();
            samlPolicy.Assertions.Add(new LCSamlPolicyAssertion());
            authorizationManager.SetPolicy(samlPolicy);
            //Set the SAML assertion obtained previously as the token
            authorizationManager.SetClientCredential(new SamlToken(ar.assertion));
        }

        public Role findRole(string roleId)
        {
            return authorizationManager.findRole(roleId);
        }

        static void Main(string[] args)
        {
            ImpersonationExample ie = new ImpersonationExample("http://localhost:5555");
            ie.AuthenticateOnBehalf(
                 "administrator", //The Super user which has the required impersonation permission
                 "password", // Password of the super user as referred above
                 "bob", //Cannonical name of the user to impersonate
                 "testdomain" //Domain of the user to impersonate
                 );

         Role r = ie.findRole("BASIC_ROLE_ADMINISTRATOR");
            System.Console.WriteLine("Role "+r.name);
     }
 }

Considerações relacionadas ao usar serviços da Web related-considerations-when-using-web-services

Às vezes, ocorrem problemas ao invocar determinadas operações dos serviços da AEM Forms usando serviços da Web. O objetivo desta discussão é identificar essas questões e fornecer uma solução, se disponível.

Chamada de operações de serviço de forma assíncrona invoking-service-operations-asynchronously

Se você tentar invocar de forma assíncrona uma operação de serviço do AEM Forms, como a variável Gerar PDF htmlToPDF operação, uma SoapFaultException ocorre. Para resolver esse problema, crie um arquivo XML de vínculo personalizado que mapeie a variável ExportPDF_Result elemento e outros elementos em classes diferentes. O XML a seguir representa um arquivo de vínculo personalizado.

 <bindings
        xmlns:xsd="https://www.w3.org/2001/XMLSchema"
        xmlns:jxb="https://java.sun.com/xml/ns/jaxb" jxb:version="1.0"
        xmlns:wsdl="https://schemas.xmlsoap.org/wsdl/"
      wsdlLocation="http://localhost:8080/soap/services/GeneratePDFService?wsdl&async=true&lc_version=9.0.0"
        xmlns="https://java.sun.com/xml/ns/jaxws">
        <enableAsyncMapping>false</enableAsyncMapping>
        <package name="external_customize.client"/>
        <enableWrapperStyle>true</enableWrapperStyle>
        <bindings node="/wsdl:definitions/wsdl:types/xsd:schema[@targetNamespace='https://adobe.com/idp/services']/xsd:element[@name='ExportPDF_Result']">
            <jxb:class name="ExportPDFAsyncResult">
            </jxb:class>
        </bindings>
        <bindings node="/wsdl:definitions/wsdl:types/xsd:schema[@targetNamespace='https://adobe.com/idp/services']/xsd:element[@name='CreatePDF_Result']">
            <jxb:class name="CreatePDFAsyncResult">
            </jxb:class>
        </bindings>
        <bindings node="/wsdl:definitions/wsdl:types/xsd:schema[@targetNamespace='https://adobe.com/idp/services']/xsd:element[@name='HtmlToPDF_Result']">
            <jxb:class name="HtmlToPDFAsyncResult">
            </jxb:class>
        </bindings>
        <bindings node="/wsdl:definitions/wsdl:types/xsd:schema[@targetNamespace='https://adobe.com/idp/services']/xsd:element[@name='OptimizePDF_Result']">
            <jxb:class name="OptimizePDFAsyncResult">
            </jxb:class>
        </bindings>
        <!--bindings node="//wsdl:portType[@name='GeneratePDFService']/wsdl:operation[@name='HtmlToPDF_Result']">
            <jxb:class name="HtmlToPDFAsyncResult"/>
        </bindings-->
 </bindings>

Use esse arquivo XML ao criar arquivos proxy Java usando JAX-WS. (Consulte Criando classes proxy Java usando JAX-WS.)

Faça referência a esse arquivo XML ao executar a ferramenta JAX-WS (wsimport.exe) usando o - b opção de linha de comando. Atualize o wsdlLocation no arquivo XML de vínculo para especificar o URL do AEM Forms.

Para garantir que a invocação assíncrona funcione, modifique o valor do URL do ponto final e especifique async=true. Por exemplo, para arquivos proxy Java criados com JAX-WS, especifique o seguinte para o BindingProvider.ENDPOINT_ADDRESS_PROPERTY.

https://server:port/soap/services/ServiceName?wsdl&async=true&lc_version=9.0.0

A lista a seguir especifica outros serviços que precisam de um arquivo de vínculo personalizado quando invocados de forma assíncrona:

Diferenças nos servidores de aplicativos J2EE differences-in-j2ee-application-servers

Às vezes, uma biblioteca de proxy criada usando um servidor de aplicativos J2EE específico não chama com êxito o AEM Forms que está hospedado em um servidor de aplicativos J2EE diferente. Considere uma biblioteca de proxy que é gerada usando o AEM Forms que é implantada no WebSphere. Esta biblioteca de proxy não pode invocar com êxito os serviços da AEM Forms implantados no Servidor de Aplicativos JBoss.

Alguns tipos de dados complexos do AEM Forms, como PrincipalReference, são definidas de forma diferente quando o AEM Forms é implantado no WebSphere, em comparação com o JBoss Application Server. As diferenças nos JDKs usados pelos diferentes serviços de aplicativos do J2EE são o motivo das diferenças nas definições de WSDL. Como resultado, use bibliotecas de proxy geradas no mesmo servidor de aplicativos J2EE.

Acesso a vários serviços usando serviços da Web accessing-multiple-services-using-web-services

Devido a conflitos de namespace, objetos de dados não podem ser compartilhados entre vários WSDLs de serviço. Diferentes serviços podem compartilhar tipos de dados e, portanto, os serviços compartilham a definição desses tipos nas WSDLs. Por exemplo, não é possível adicionar dois assemblies cliente .NET que contêm um BLOB tipo de dados para o mesmo projeto de cliente .NET. Se você tentar fazer isso, ocorrerá um erro de compilação.

A lista a seguir especifica os tipos de dados que não podem ser compartilhados entre vários WSDLs de serviço:

Para evitar esse problema, é recomendável qualificar totalmente os tipos de dados. Por exemplo, considere um aplicativo .NET que faça referência ao serviço Forms e ao serviço de assinatura usando uma referência de serviço. Ambas as referências de serviço conterão um BLOB classe . Para usar um BLOB , qualifique totalmente a variável BLOB ao declará-lo. Essa abordagem é mostrada no seguinte exemplo de código. Para obter informações sobre este exemplo de código, consulte Assinatura digital - Forms interativo.

O exemplo de código C# a seguir assina um formulário interativo renderizado pelo serviço Forms. O aplicativo cliente tem duas referências de serviço. O BLOB A instância associada ao serviço do Forms pertence ao SignInteractiveForm.ServiceReference2 namespace. Da mesma forma, a variável BLOB A instância associada ao serviço de assinatura pertence ao SignInteractiveForm.ServiceReference1 namespace. O formulário interativo assinado é salvo como um arquivo PDF chamado LoanXFASigned.pdf.

 ???/**
     * Ensure that you create a .NET project that uses
     * MS Visual Studio 2008 and version 3.5 of the .NET
     * framework. This is required to invoke a
     * AEM Forms service using MTOM.
     *
     * For information, see "Invoking AEM Forms using MTOM" in Programming with AEM forms
     */
 using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Text;
 using System.ServiceModel;
 using System.IO;

 //A reference to the Signature service
 using SignInteractiveForm.ServiceReference1;

 //A reference to the Forms service
 using SignInteractiveForm.ServiceReference2;

 namespace SignInteractiveForm
 {
        class Program
        {
            static void Main(string[] args)
            {
                try
                {
                    //Because BLOB objects are used in both service references
                    //it is necessary to fully-qualify the BLOB objects

                    //Retrieve the form -- invoke the Forms service
                    SignInteractiveForm.ServiceReference2.BLOB formData = GetForm();

                    //Create a BLOB object associated with the Signature service
                    SignInteractiveForm.ServiceReference1.BLOB sigData = new SignInteractiveForm.ServiceReference1.BLOB();

                    //Transfer the byte stream from one Forms BLOB object to the
                    //Signature BLOB object
                    sigData.MTOM = formData.MTOM;

                    //Sign the Form -- invoke the Signature service
                    SignForm(sigData);
                }
                catch (Exception ee)
                {
                    Console.WriteLine(ee.Message);
                }
            }

            //Creates an interactive PDF form based on a XFA form - invoke the Forms service
            private static SignInteractiveForm.ServiceReference2.BLOB GetForm()
            {

                try
                {
                    //Create a FormsServiceClient object
                    FormsServiceClient formsClient = new FormsServiceClient();
                    formsClient.Endpoint.Address = new System.ServiceModel.EndpointAddress("https://hiro-xp:8080/soap/services/FormsService?blob=mtom");

                    //Enable BASIC HTTP authentication
                    BasicHttpBinding b = (BasicHttpBinding)formsClient.Endpoint.Binding;
                    b.MessageEncoding = WSMessageEncoding.Mtom;
                    formsClient.ClientCredentials.UserName.UserName = "administrator";
                    formsClient.ClientCredentials.UserName.Password = "password";
                    b.Security.Transport.ClientCredentialType = HttpClientCredentialType.Basic;
                    b.Security.Mode = BasicHttpSecurityMode.TransportCredentialOnly;
                    b.MaxReceivedMessageSize = 2000000;
                    b.MaxBufferSize = 2000000;
                    b.ReaderQuotas.MaxArrayLength = 2000000;

                    //Create a BLOB to store form data
                    SignInteractiveForm.ServiceReference2.BLOB formData = new SignInteractiveForm.ServiceReference2.BLOB();
                    SignInteractiveForm.ServiceReference2.BLOB pdfForm = new SignInteractiveForm.ServiceReference2.BLOB();

                    //Specify a XML form data
                    string path = "C:\\Adobe\Loan.xml";
                    FileStream fs = new FileStream(path, FileMode.Open);

                    //Get the length of the file stream
                    int len = (int)fs.Length;
                    byte[] ByteArray = new byte[len];

                    fs.Read(ByteArray, 0, len);
                    formData.MTOM = ByteArray;

                    //Specify a XML form data
                    string path2 = "C:\\Adobe\LoanSigXFA.pdf";
                    FileStream fs2 = new FileStream(path2, FileMode.Open);

                    //Get the length of the file stream
                    int len2 = (int)fs2.Length;
                    byte[] ByteArray2 = new byte[len2];

                    fs2.Read(ByteArray2, 0, len2);
                    pdfForm.MTOM = ByteArray2;

                    PDFFormRenderSpec renderSpec = new PDFFormRenderSpec();
                    renderSpec.generateServerAppearance = true;

                    //Set out parameter values
                    long pageCount = 1;
                    String localValue = "en_US";
                    FormsResult result = new FormsResult();

                    //Render an interactive PDF form
                    formsClient.renderPDFForm2(
                        pdfForm,
                        formData,
                        renderSpec,
                        null,
                        null,
                        out pageCount,
                        out localValue,
                        out result);

                    //Write the data stream to the BLOB object
                    SignInteractiveForm.ServiceReference2.BLOB outForm = result.outputContent;
                    return outForm;
                }
                catch (Exception ee)
                {
                    Console.WriteLine(ee.Message);
                }
                return null;
            }

            //Sign the form -- invoke the Signature service
            private static void SignForm(SignInteractiveForm.ServiceReference1.BLOB inDoc)
            {

                try
                {
                    //Create a SignatureServiceClient object
                    SignatureServiceClient signatureClient = new SignatureServiceClient();
                    signatureClient.Endpoint.Address = new System.ServiceModel.EndpointAddress("https://hiro-xp:8080/soap/services/SignatureService?blob=mtom");

                    //Enable BASIC HTTP authentication
                    BasicHttpBinding b = (BasicHttpBinding)signatureClient.Endpoint.Binding;
                    b.MessageEncoding = WSMessageEncoding.Mtom;
                    signatureClient.ClientCredentials.UserName.UserName = "administrator";
                    signatureClient.ClientCredentials.UserName.Password = "password";
                    b.Security.Transport.ClientCredentialType = HttpClientCredentialType.Basic;
                    b.Security.Mode = BasicHttpSecurityMode.TransportCredentialOnly;
                    b.MaxReceivedMessageSize = 2000000;
                    b.MaxBufferSize = 2000000;
                    b.ReaderQuotas.MaxArrayLength = 2000000;

                    //Specify the name of the signature field
                    string fieldName = "form1[0].grantApplication[0].page1[0].SignatureField1[0]";

                    //Create a Credential object
                    Credential myCred = new Credential();
                    myCred.alias = "secure";

                    //Specify the reason to sign the document
                    string reason = "The document was reviewed";

                    //Specify the location of the signer
                    string location = "New York HQ";

                    //Specify contact information
                    string contactInfo = "Tony Blue";

                    //Create a PDFSignatureAppearanceOptions object
                    //and show date information
                    PDFSignatureAppearanceOptionSpec appear = new PDFSignatureAppearanceOptionSpec();
                    appear.showDate = true;

                    //Sign the PDF document
                    SignInteractiveForm.ServiceReference1.BLOB signedDoc = signatureClient.sign(
                        inDoc,
                        fieldName,
                        myCred,
                        HashAlgorithm.SHA1,
                        reason,
                        location,
                        contactInfo,
                        appear,
                        true,
                        null,
                        null,
                        null);

                    //Populate a byte array with BLOB data that represents the signed form
                    byte[] outByteArray = signedDoc.MTOM;

                    //Save the signed PDF document
                    string fileName = "C:\\Adobe\LoanXFASigned.pdf";
                    FileStream fs2 = new FileStream(fileName, FileMode.OpenOrCreate);

                    //Create a BinaryWriter object
                    BinaryWriter w = new BinaryWriter(fs2);
                    w.Write(outByteArray);
                    w.Close();
                    fs2.Close();
                }

                catch (Exception ee)
                {
                    Console.WriteLine(ee.Message);
                }
            }
        }
 }

Os serviços que começam com a letra I produzem arquivos proxy inválidos services-starting-with-the-letter-i-produce-invalid-proxy-files

O nome de algumas classes proxy geradas pelo AEM Forms está incorreto ao usar o Microsoft .Net 3.5 e o WCF. Esse problema ocorre quando classes proxy são criadas para IBMFilenetContentRepositoryConnector, IDPSchedulerService ou qualquer outro serviço cujo nome começa com a letra I. Por exemplo, o nome do cliente gerado no caso de IBMFileNetContentRepositoryConnector é BMFileNetContentRepositoryConnectorClient. A letra I está ausente na classe de proxy gerada.