Documenten doorgeven aan de Forms-service passing-documents-to-the-formsservice

Projectbestanden opnemen

Neem JAR-bestanden voor clients, zoals adobe-forms-client.jar en adobe-contentservices-client.jar, op in het klassenpad van uw Java-project.

Een Forms en een Document Management Client API-object maken

• Maak een ServiceClientFactory -object dat verbindingseigenschappen bevat. (Zie Plaatsende verbindingseigenschappen.)
• Maak een FormsServiceClient -object door de constructor ervan te gebruiken en het ServiceClientFactory -object door te geven.
• Maak een DocumentManagementServiceClientImpl -object door de constructor ervan te gebruiken en het ServiceClientFactory -object door te geven.

Het formulierontwerp ophalen van Content Services (afgekeurd)

Roep de methode retrieveContent van het object DocumentManagementServiceClientImpl aan en geef de volgende waarden door:

• Een tekenreekswaarde die de opslaglocatie opgeeft waar de inhoud wordt toegevoegd. De standaardopslag is SpacesStore. Deze waarde is een verplichte parameter.
• Een tekenreekswaarde die het volledig gekwalificeerde pad opgeeft van de inhoud die moet worden opgehaald (bijvoorbeeld /Company Home/Form Designs/Loan.xdp ). Deze waarde is een verplichte parameter.
• Een tekenreekswaarde die de versie opgeeft. Deze waarde is een optionele parameter en u kunt een lege tekenreeks doorgeven. In dit geval wordt de laatste versie opgehaald.

De methode retrieveContent retourneert een CRCResult -object dat het XDP-bestand bevat. Haal een com.adobe.idp.Document -instantie op door de methode CRCResult object getDocument aan te roepen.

Een interactief PDF-formulier renderen

Roep de methode renderPDFForm2 van het object FormsServiceClient aan en geef de volgende waarden door:

• Een com.adobe.idp.Document -object dat het formulierontwerp bevat dat is opgehaald uit Content Services (afgekeurd).
• Een com.adobe.idp.Document -object dat gegevens bevat die met het formulier moeten worden samengevoegd. Wanneer u geen gegevens wilt samenvoegen, geeft u een leeg com.adobe.idp.Document -object door.
• Een PDFFormRenderSpec -object dat uitvoeringsopties opslaat. Deze waarde is een optionele parameter en u kunt null opgeven als u geen runtime-opties wilt opgeven.
• Een URLSpec -object dat URI-waarden bevat. Deze waarde is een optionele parameter en u kunt null opgeven.
• Een java.util.HashMap -object dat bestandsbijlagen opslaat. Deze waarde is een optionele parameter en u kunt null opgeven als u geen bestanden aan het formulier wilt koppelen.

De methode renderPDFForm retourneert een FormsResult -object dat een formuliergegevensstroom bevat die naar de webbrowser van de client moet worden geschreven.

Een handeling uitvoeren met de gegevensstroom van het formulier

• Maak een com.adobe.idp.Document -object door de methode FormsResult object 's getOutputContent aan te roepen.
• Haal het inhoudstype van het object com.adobe.idp.Document op door de methode getContentType ervan aan te roepen.
• Stel het inhoudstype van het javax.servlet.http.HttpServletResponse -object in door de methode setContentType ervan aan te roepen en het inhoudstype van het com.adobe.idp.Document -object door te geven.
• Maak een javax.servlet.ServletOutputStream -object dat wordt gebruikt om de formuliergegevensstroom naar de webbrowser van de client te schrijven door de methode javax.servlet.http.HttpServletResponse object getOutputStream aan te roepen.
• Maak een java.io.InputStream -object door de methode com.adobe.idp.Document object getInputStream aan te roepen.
• Maak een bytearray en vul deze met de formuliergegevensstroom door de methode read van het object InputStream aan te roepen. Geef de bytearray door als een argument.
• Roep de methode write van het object javax.servlet.ServletOutputStream aan om de gegevensstroom van het formulier naar de webbrowser van de client te verzenden. Geef de bytearray door aan de methode write .

Projectbestanden opnemen

Creeer een Microsoft .NET project dat MTOM gebruikt. Omdat deze cliënttoepassing de twee diensten van AEM Forms aanhaalt, creeer twee de dienstverwijzingen. Gebruik de volgende WSDL-definitie voor de serviceverwijzing die aan de Forms-service is gekoppeld: http://localhost:8080/soap/services/FormsService?WSDL&lc_version=9.0.1 .

Gebruik de volgende WSDL-definitie voor de serviceverwijzing die is gekoppeld aan de Document Management-service: http://localhost:8080/soap/services/DocumentManagementService?WSDL&lc_version=9.0.1 .

Omdat het gegevenstype BLOB veel wordt gebruikt voor beide serviceverwijzingen, kunt u het gegevenstype van BLOB volledig kwalificeren wanneer u het gebruikt. In de bijbehorende webservice quick start zijn alle BLOB -instanties volledig gekwalificeerd.

Een Forms en een Document Management Client API-object maken

• Maak een FormsServiceClient -object met de standaardconstructor.

• Maak een FormsServiceClient.Endpoint.Address -object met de System.ServiceModel.EndpointAddress -constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/FormsService?WSDL ). U hoeft het attribuut lc_version niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.)

• Maak een System.ServiceModel.BasicHttpBinding -object door de waarde van het FormsServiceClient.Endpoint.Binding -veld op te halen. De geretourneerde waarde wordt gecast naar BasicHttpBinding .

• Stel het veld MessageEncoding van het System.ServiceModel.BasicHttpBinding -object in op WSMessageEncoding.Mtom . Deze waarde zorgt ervoor dat MTOM wordt gebruikt.

• Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:

  • Wijs de gebruikersnaam van het AEM aan het veld FormsServiceClient.ClientCredentials.UserName.UserName toe.
  • Wijs de bijbehorende wachtwoordwaarde toe aan het veld FormsServiceClient.ClientCredentials.UserName.Password .
  • Wijs de constante waarde HttpClientCredentialType.Basic toe aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType .

• Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly toe aan het veld BasicHttpBindingSecurity.Security.Mode .

Het formulierontwerp ophalen van Content Services (afgekeurd)

Haal inhoud op door de methode retrieveContent van het object DocumentManagementServiceClient aan te roepen en de volgende waarden door te geven:

• Een tekenreekswaarde die de opslaglocatie opgeeft waar de inhoud wordt toegevoegd. De standaardopslag is SpacesStore. Deze waarde is een verplichte parameter.
• Een tekenreekswaarde die het volledig gekwalificeerde pad opgeeft van de inhoud die moet worden opgehaald (bijvoorbeeld /Company Home/Form Designs/Loan.xdp ). Deze waarde is een verplichte parameter.
• Een tekenreekswaarde die de versie opgeeft. Deze waarde is een optionele parameter en u kunt een lege tekenreeks doorgeven. In dit geval wordt de laatste versie opgehaald.
• Een parameter van de koordoutput die doorbladert verbindingswaarde opslaat.
• Een BLOB uitvoerparameter die de inhoud opslaat. U kunt deze uitvoerparameter gebruiken om de inhoud op te halen.
• Een ServiceReference1.MyMapOf_xsd_string_To_xsd_anyType uitvoerparameter die inhoudskenmerken opslaat.
• Een CRCResult uitvoerparameter. In plaats van dit object te gebruiken, kunt u de uitvoerparameter BLOB gebruiken om de inhoud op te halen.

Een interactief PDF-formulier renderen

Roep de methode renderPDFForm2 van het object FormsServiceClient aan en geef de volgende waarden door:

• Een BLOB -object dat het formulierontwerp bevat dat is opgehaald uit Content Services (afgekeurd).
• Een BLOB -object dat gegevens bevat die met het formulier moeten worden samengevoegd. Wanneer u geen gegevens wilt samenvoegen, geeft u een leeg BLOB -object door.
• Een PDFFormRenderSpec -object dat uitvoeringsopties opslaat. Deze waarde is een optionele parameter en u kunt null opgeven als u geen runtime-opties wilt opgeven.
• Een URLSpec -object dat URI-waarden bevat. Deze waarde is een optionele parameter en u kunt null opgeven.
• Een Map -object dat bestandsbijlagen opslaat. Deze waarde is een optionele parameter en u kunt null opgeven als u geen bestanden aan het formulier wilt koppelen.
• Een lange uitvoerparameter die wordt gebruikt om het aantal pagina's op te slaan.
• Een tekenreeks-uitvoerparameter die wordt gebruikt om de waarde van de landinstelling op te slaan.
• Een FormsResult -uitvoerparameter die wordt gebruikt om het interactieve PDF-formulier op te slaan .

De methode renderPDFForm2 retourneert een FormsResult -object dat het interactieve PDF-formulier bevat.

Een handeling uitvoeren met de gegevensstroom van het formulier

• Maak een BLOB -object dat formuliergegevens bevat door de waarde van het veld FormsResult object outputContent op te halen.
• Maak een System.IO.FileStream -object door de constructor ervan aan te roepen. Geef een tekenreekswaarde door die staat voor de bestandslocatie van het interactieve PDF-document en de modus waarin het bestand moet worden geopend.
• Maak een bytearray waarin de inhoud wordt opgeslagen van het BLOB -object dat is opgehaald van het FormsResult -object. Vul de bytearray met de waarde van het gegevenslid MTOM van het object BLOB .
• Maak een System.IO.BinaryWriter -object door de constructor ervan aan te roepen en het System.IO.FileStream -object door te geven.
• Schrijf de inhoud van de bytearray naar een PDF-bestand door de methode Write van het object System.IO.BinaryWriter aan te roepen en de bytearray door te geven.