DDX-documenten valideren validating-ddx-documents
U kunt een DX- document programmatically bevestigen dat door de dienst van de Assembler wordt gebruikt. Met andere woorden, met de API van de Assembler-service kunt u bepalen of een DDX-document geldig is of niet. Als u bijvoorbeeld een upgrade hebt uitgevoerd van een eerdere AEM Forms-versie en u wilt controleren of uw DDX-document geldig is, kunt u dit valideren met de API voor de Assembler-service.
Overzicht van de stappen summary-of-steps
Voer de volgende taken uit om een DDX-document te valideren:
- Inclusief projectbestanden.
- Maak een Assembler-client.
- Verwijs naar een bestaand DDX-document.
- Stel uitvoeringsopties in om het DDX-document te valideren.
- Voer de validatie uit.
- Sla de validatieresultaten op in een logbestand.
Projectbestanden opnemen
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, dient u de proxybestanden op te nemen.
De volgende JAR-bestanden moeten worden toegevoegd aan het klassepad van uw project:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-assembler-client.jar
- adobe-utilities.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss)
- jbossall-client.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss)
als AEM Forms wordt geïmplementeerd op een andere ondersteunde J2EE-toepassingsserver dan JBoss, moet u de bestanden adobe-utilities.jar en jbossall-client.jar vervangen door JAR-bestanden die specifiek zijn voor de J2EE-toepassingsserver waarop AEM Forms is geïmplementeerd.
Een PDF Assembler-client maken
Alvorens u programmatically een verrichting van de Assembler kunt uitvoeren, moet u een de dienstcliënt van de Assembler tot stand brengen.
Verwijzen naar een bestaand DDX-document
Als u een DDX-document wilt valideren, moet u naar een bestaand DDX-document verwijzen.
Stel runtime-opties in om het DDX-document te valideren
Wanneer het bevestigen van een Dx- document, moet u specifieke runtime opties plaatsen die de dienst van de Assembler opdragen om het Dx- document in plaats van het uit te voeren te bevestigen. Ook, kunt u de hoeveelheid informatie verhogen die de dienst van de Assembler aan het logboekdossier schrijft.
De validatie uitvoeren
Nadat u de de dienstcliënt van de Assembler creeert, van verwijzingen het DX- document, en vastgestelde runtime opties, kunt u aanhalen invokeDDX bewerking om het DDX-document te valideren. Wanneer u het DDX-document valideert, kunt u null als de kaartparameter (deze parameter slaat gewoonlijk PDF documenten op die de Assembler vereist om de verrichting(en) uit te voeren die in het DX- document wordt gespecificeerd).
Als de validatie mislukt, wordt een uitzondering gegenereerd en bevat het logbestand details die verklaren waarom het DDX-document ongeldig is, kunnen worden verkregen uit het dialoogvenster OperationException -instantie. Zodra voorbij het basisontleden van XML en schema het controleren, dan wordt de bevestiging tegen de specificatie DDX uitgevoerd. Alle fouten die zich in het DDX-document bevinden, worden opgegeven in het logbestand.
De validatieresultaten opslaan in een logbestand
De dienst van de Assembler keert de bevestigingsresultaten terug die u aan een het logboekdossier van XML kunt schrijven. De hoeveelheid detail die de dienst van de Assembler aan het logboekdossier schrijft hangt van de runtime optie af die u plaatst.
Zie ook
Een DDX-document valideren met de Java API
Een DDX-document valideren met de webservice-API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
PDF-documenten programmatisch samenstellen
Een DDX-document valideren met de Java API validate-a-ddx-document-using-the-java-api
Valideer een DDX-document met behulp van de API voor vergaderingsservice (Java):
-
Inclusief projectbestanden.
Neem client-JAR-bestanden, zoals adobe-assembler-client.jar, op in het klassenpad van uw Java-project.
-
Maak een PDF Assembler-client.
- Een
ServiceClientFactoryobject dat verbindingseigenschappen bevat. - Een
AssemblerServiceClientobject door de constructor ervan te gebruiken en door te gevenServiceClientFactoryobject.
- Een
-
Verwijs naar een bestaand DDX-document.
- Een
java.io.FileInputStreameen object dat het DDX-document vertegenwoordigt door de constructor ervan te gebruiken en een tekenreekswaarde door te geven die de locatie van het DDX-bestand aangeeft. - Een
com.adobe.idp.Documentobject door de constructor ervan te gebruiken en door te gevenjava.io.FileInputStreamobject.
- Een
-
Stel uitvoeringsopties in om het DDX-document te valideren.
- Een
AssemblerOptionSpecobject dat uitvoeringsopties opslaat met de constructor ervan. - Plaats de runtime optie die de dienst van de Assembler opdraagt om het DX- document te bevestigen door het te roepen
AssemblerOptionSpecmethode setValidateOnly van object en doorgeventrue. - Plaats de hoeveelheid informatie die de dienst van de Assembler aan het logboekdossier schrijft door te roepen
AssemblerOptionSpecobjectgetLogLevelen het doorgeven van een tekenreekswaarde voldoet aan uw vereisten. Wanneer u een DDX-document valideert, wilt u meer informatie naar het logbestand dat u helpt bij het validatieproces. Hierdoor kunt u de waarde doorgevenFINEofFINER.
- Een
-
Voer de validatie uit.
De
AssemblerServiceClientobjectinvokeDDXen geeft de volgende waarden door:- A
com.adobe.idp.Documentobject dat het DDX-document vertegenwoordigt. - De waarde
nullvoor het java.io.Map-object waarin gewoonlijk PDF-documenten worden opgeslagen. - A
com.adobe.livecycle.assembler.client.AssemblerOptionSpec-object dat de runtime-opties opgeeft.
De
invokeDDXmethode retourneert eenAssemblerResultobject dat informatie bevat die aangeeft of het DDX-document geldig is. - A
-
Sla de validatieresultaten op in een logbestand.
- Een
java.io.File-object en zorg ervoor dat de bestandsnaamextensie .xml is. - De
AssemblerResultobjectgetJobLogmethode. Deze methode retourneert eencom.adobe.idp.Documentinstantie die validatiegegevens bevat. - De
com.adobe.idp.DocumentobjectcopyToFilemethode om de inhoud van decom.adobe.idp.Documentnaar het bestand.
note note NOTE Als het DDX-document ongeldig is, OperationExceptionwordt gegenereerd. Binnen de catch-instructie kunt u de instructieOperationExceptionobjectgetJobLogmethode. - Een
Zie ook
Snel starten (SOAP-modus): DDX-documenten valideren met de Java API (SOAP-modus)
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Een DDX-document valideren met de webservice-API validate-a-ddx-document-using-the-web-service-api
Valideer een DDX-document met behulp van de API (webservice) voor vergaderingsservice:
-
Inclusief projectbestanden.
Creeer een Microsoft .NET project dat MTOM gebruikt. Zorg ervoor dat u de volgende definitie van WSDL gebruikt:
http://localhost:8080/soap/services/AssemblerService?WSDL&lc_version=9.0.1.note note NOTE Vervang localhost door het IP-adres van de formulierserver. -
Maak een PDF Assembler-client.
-
Een
AssemblerServiceClientobject met de standaardconstructor. -
Een
AssemblerServiceClient.Endpoint.Addressobject gebruikenSystem.ServiceModel.EndpointAddressconstructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeldhttp://localhost:8080/soap/services/AssemblerService?blob=mtom). U hoeft delc_versionkenmerk. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt. -
Een
System.ServiceModel.BasicHttpBindingobject door de waarde van het object op te halenAssemblerServiceClient.Endpoint.Bindingveld. De geretourneerde waarde omzetten inBasicHttpBinding. -
Stel de
System.ServiceModel.BasicHttpBindingobjectMessageEncodingveld naarWSMessageEncoding.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 toe
AssemblerServiceClient.ClientCredentials.UserName.UserName. - De bijbehorende wachtwoordwaarde aan het veld toewijzen
AssemblerServiceClient.ClientCredentials.UserName.Password. - De constante waarde toewijzen
HttpClientCredentialType.Basicnaar het veldBasicHttpBindingSecurity.Transport.ClientCredentialType. - De constante waarde toewijzen
BasicHttpSecurityMode.TransportCredentialOnlynaar het veldBasicHttpBindingSecurity.Security.Mode.
- Wijs de gebruikersnaam van het AEM aan het veld toe
-
-
Verwijs naar een bestaand DDX-document.
- Een
BLOBobject met behulp van de constructor. DeBLOBwordt gebruikt om het DDX-document op te slaan. - Een
System.IO.FileStream-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het DDX-document en de modus voor het openen van het bestand in vertegenwoordigt. - Maak een bytearray waarin de inhoud van de
System.IO.FileStreamobject. U kunt de grootte van de bytearray bepalen door deSystem.IO.FileStreamobjectLengtheigenschap. - De bytearray vullen met streamgegevens door de
System.IO.FileStreamobjectReaden geeft u de bytearray, de startpositie en de streamlengte door die u wilt lezen. - Vul de
BLOBobject door het toe te wijzenMTOMeigenschap met de inhoud van de bytearray.
- Een
-
Stel uitvoeringsopties in om het DDX-document te valideren.
- Een
AssemblerOptionSpecobject dat uitvoeringsopties opslaat met de constructor ervan. - Plaats de runtime optie die de dienst van de Assembler opdraagt om het Dx- document te bevestigen door de waarde waar aan toe te wijzen
AssemblerOptionSpecobjectvalidateOnlylid. - Stel de hoeveelheid informatie in die de Assembler-service naar het logbestand schrijft door een tekenreekswaarde toe te wijzen aan de
AssemblerOptionSpecobjectlogLevellid. methode Bij het valideren van een DDX-document wilt u meer informatie naar het logbestand schrijven dat u helpt bij het validatieproces. Hierdoor kunt u de waarde opgevenFINEofFINER. Voor informatie over de runtime opties die u kunt plaatsen, zieAssemblerOptionSpecklasseverwijzing in AEM Forms API-naslag.
- Een
-
Voer de validatie uit.
De
AssemblerServiceClientobjectinvokeDDXen geeft de volgende waarden door:- A
BLOBobject dat het DDX-document vertegenwoordigt. - De waarde
nullvoor deMapobject waarin gewoonlijk PDF-documenten worden opgeslagen. - An
AssemblerOptionSpec-object dat uitvoeringsopties opgeeft.
De
invokeDDXmethode retourneert eenAssemblerResultobject dat informatie bevat die aangeeft of het DDX-document geldig is. - A
-
Sla de validatieresultaten op in een logbestand.
- Een
System.IO.FileStream-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het logbestand en de modus voor het openen van het bestand vertegenwoordigt. Controleer of de bestandsnaamextensie .xml is. - Een
BLOBobject dat logboekgegevens opslaat door de waarde van deAssemblerResultobjectjobLoglid. - Maak een bytearray waarin de inhoud van de
BLOBobject. Vul de bytearray met de waarde van deBLOBobjectMTOMveld. - Een
System.IO.BinaryWriterobject door de constructor aan te roepen en deSystem.IO.FileStreamobject. - Schrijf de inhoud van de bytearray naar een PDF-bestand door het
System.IO.BinaryWriterobjectWriteen geeft u de bytearray door.
note note NOTE Als het DDX-document ongeldig is, OperationExceptionwordt gegenereerd. Binnen de catch-instructie kunt u de waarde van de instructieOperationExceptionobjectjobLoglid. - Een
Zie ook