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
ServiceClientFactory
object dat verbindingseigenschappen bevat. - Een
AssemblerServiceClient
object door de constructor ervan te gebruiken en door te gevenServiceClientFactory
object.
- Een
-
Verwijs naar een bestaand DDX-document.
- Een
java.io.FileInputStream
een 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.Document
object door de constructor ervan te gebruiken en door te gevenjava.io.FileInputStream
object.
- Een
-
Stel uitvoeringsopties in om het DDX-document te valideren.
- Een
AssemblerOptionSpec
object 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
AssemblerOptionSpec
methode setValidateOnly van object en doorgeventrue
. - Plaats de hoeveelheid informatie die de dienst van de Assembler aan het logboekdossier schrijft door te roepen
AssemblerOptionSpec
objectgetLogLevel
en 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 doorgevenFINE
ofFINER
.
- Een
-
Voer de validatie uit.
De
AssemblerServiceClient
objectinvokeDDX
en geeft de volgende waarden door:- A
com.adobe.idp.Document
object dat het DDX-document vertegenwoordigt. - De waarde
null
voor 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
invokeDDX
methode retourneert eenAssemblerResult
object 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
AssemblerResult
objectgetJobLog
methode. Deze methode retourneert eencom.adobe.idp.Document
instantie die validatiegegevens bevat. - De
com.adobe.idp.Document
objectcopyToFile
methode om de inhoud van decom.adobe.idp.Document
naar het bestand.
note note NOTE Als het DDX-document ongeldig is, OperationException
wordt gegenereerd. Binnen de catch-instructie kunt u de instructieOperationException
objectgetJobLog
methode. - 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
AssemblerServiceClient
object met de standaardconstructor. -
Een
AssemblerServiceClient.Endpoint.Address
object gebruikenSystem.ServiceModel.EndpointAddress
constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeldhttp://localhost:8080/soap/services/AssemblerService?blob=mtom
). U hoeft delc_version
kenmerk. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt. -
Een
System.ServiceModel.BasicHttpBinding
object door de waarde van het object op te halenAssemblerServiceClient.Endpoint.Binding
veld. De geretourneerde waarde omzetten inBasicHttpBinding
. -
Stel de
System.ServiceModel.BasicHttpBinding
objectMessageEncoding
veld 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.Basic
naar het veldBasicHttpBindingSecurity.Transport.ClientCredentialType
. - De constante waarde toewijzen
BasicHttpSecurityMode.TransportCredentialOnly
naar het veldBasicHttpBindingSecurity.Security.Mode
.
- Wijs de gebruikersnaam van het AEM aan het veld toe
-
-
Verwijs naar een bestaand DDX-document.
- Een
BLOB
object met behulp van de constructor. DeBLOB
wordt 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.FileStream
object. U kunt de grootte van de bytearray bepalen door deSystem.IO.FileStream
objectLength
eigenschap. - De bytearray vullen met streamgegevens door de
System.IO.FileStream
objectRead
en geeft u de bytearray, de startpositie en de streamlengte door die u wilt lezen. - Vul de
BLOB
object door het toe te wijzenMTOM
eigenschap met de inhoud van de bytearray.
- Een
-
Stel uitvoeringsopties in om het DDX-document te valideren.
- Een
AssemblerOptionSpec
object 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
AssemblerOptionSpec
objectvalidateOnly
lid. - Stel de hoeveelheid informatie in die de Assembler-service naar het logbestand schrijft door een tekenreekswaarde toe te wijzen aan de
AssemblerOptionSpec
objectlogLevel
lid. 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 opgevenFINE
ofFINER
. Voor informatie over de runtime opties die u kunt plaatsen, zieAssemblerOptionSpec
klasseverwijzing in AEM Forms API-naslag.
- Een
-
Voer de validatie uit.
De
AssemblerServiceClient
objectinvokeDDX
en geeft de volgende waarden door:- A
BLOB
object dat het DDX-document vertegenwoordigt. - De waarde
null
voor deMap
object waarin gewoonlijk PDF-documenten worden opgeslagen. - An
AssemblerOptionSpec
-object dat uitvoeringsopties opgeeft.
De
invokeDDX
methode retourneert eenAssemblerResult
object 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
BLOB
object dat logboekgegevens opslaat door de waarde van deAssemblerResult
objectjobLog
lid. - Maak een bytearray waarin de inhoud van de
BLOB
object. Vul de bytearray met de waarde van deBLOB
objectMTOM
veld. - Een
System.IO.BinaryWriter
object door de constructor aan te roepen en deSystem.IO.FileStream
object. - Schrijf de inhoud van de bytearray naar een PDF-bestand door het
System.IO.BinaryWriter
objectWrite
en geeft u de bytearray door.
note note NOTE Als het DDX-document ongeldig is, OperationException
wordt gegenereerd. Binnen de catch-instructie kunt u de waarde van de instructieOperationException
objectjobLog
lid. - Een
Zie ook