Documenten doorgeven aan de Forms-service

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.

OPMERKING

Vervang localhost met het IP adres van de server die AEM Forms ontvangt.

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 .

OPMERKING

Herhaal deze stappen voor de DocumentManagementServiceClient de dienstcliënt.

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.