Voorbeeld voor het integreren van concepten en verzendingen in de database sample-for-integrating-drafts-submissions-component-with-database
Voorbeeldoverzicht sample-overview
Met concepten en verzendingscomponenten van AEM Forms-portaalsites kunnen gebruikers hun formulieren opslaan als concepten en later verzenden vanaf elk apparaat. Gebruikers kunnen hun ingevulde formulieren ook via een portal bekijken. Om deze functionaliteit in te schakelen, biedt AEM Forms gegevens- en metagegevensservices waarmee de gegevens die een gebruiker heeft ingevuld, worden opgeslagen in het formulier en de metagegevens van het formulier die zijn gekoppeld aan concepten en verzonden formulieren. Deze gegevens worden standaard opgeslagen in de CRX-opslagplaats. Als gebruikers echter via AEM publicatieexemplaar met formulieren werken, wat doorgaans buiten de bedrijfsfirewall valt, willen organisaties wellicht gegevensopslag aanpassen om deze beter te beveiligen en betrouwbaarder te maken.
Het voorbeeld, dat in dit document wordt besproken, is een referentie-implementatie van aangepaste gegevens en metagegevensservices om concepten en verzendingscomponenten te integreren in een database. De database die wordt gebruikt in de voorbeeldimplementatie is MySQL 5.6.24. U kunt echter de concepten en verzendingscomponent integreren met elke database van uw keuze.
- De voorbeelden en configuraties die in dit document worden uitgelegd, zijn in overeenstemming met MySQL 5.6.24 en u moet deze op de juiste wijze vervangen voor uw databasesysteem.
- Controleer of u de nieuwste versie van het AEM Forms-invoegpakket hebt geïnstalleerd. Voor de lijst met beschikbare pakketten raadpleegt u de AEM Forms-releases artikel.
- Het voorbeeldpakket werkt alleen met verzendacties voor Adaptive Forms.
Het voorbeeld instellen en configureren set-up-and-configure-the-sample
Voer de volgende stappen uit, op alle auteur en publiceer instanties, om de steekproef te installeren en te vormen:
-
Download het volgende aem-fp-db-integration-sample-pkg-6.1.2.zip aan uw bestandssysteem te verpakken.
Voorbeeldpakket voor databaseintegratie
-
Ga naar AEM pakketbeheer op https://[host]:[poort]/crx/packmgr/.
-
Klik op Upload Package.
-
Bladeren om de aem-fp-db-integration-sample-pkg-6.1.2.zip verpakken en klikken OK.
-
Klikken Install naast het pakket om het pakket te installeren.
-
Ga naar AEM Web Console Configuration
pagina op https://[host]:[poort]/system/console/configMgr. -
Klik om te openen Forms Portal Draft and Submission Configuration in bewerkingsmodus.
-
Geef de waarden voor de eigenschappen op zoals in de volgende tabel wordt beschreven:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 Eigenschap Beschrijving Waarde Forms Portal Conceptgegevensservice Id voor conceptgegevensservice formsportal.sampledataservice Forms Portal Draft Metadata Service Identificatiecode voor service met metagegevens van concept formsportal.samplemetadataservice Forms Portal verzendt Data Service Id voor verzendgegevensservice formsportal.sampledataservice Forms Portal verzendt metagegevensservice Id voor verzendmetagegevensservice formsportal.samplemetadataservice Forms Portal in afwachting van Sign Data Service Identifier voor de dataservice in afwachting van ondertekening formsportal.sampledataservice Forms Portal in afwachting van Sign Metadata Service Identificatiecode voor de metagegevensservice in afwachting van ondertekening formsportal.samplemetadataservice note note NOTE De diensten worden opgelost door hun namen die als waarde voor aem.formsportal.impl.prop
sleutel als volgt:code language-java @Service(value = {SubmitDataService.class, DraftDataService.class}) @Property(name = "aem.formsportal.impl.prop", value = "formsportal.sampledataservice") @Service(value = { SubmitMetadataService.class, DraftMetadataService.class }) @Property(name = "aem.formsportal.impl.prop", value = "formsportal.samplemetadataservice")
U kunt namen van de gegevens en meta-gegevenslijsten veranderen.
Een andere naam opgeven voor de metagegevenstabel:
- Zoek in de webconsoleconfiguratie naar en klik op Voorbeeldimplementatie van Forms Portal Metadata Service. U kunt de waarden van gegevensbron, meta-gegevens/extra naam van de meta-gegevenslijst veranderen.
Een andere naam voor de gegevenstabel opgeven:
- Zoek en klik in de webconsoleconfiguratie op Voorbeeldimplementatie van Forms Portal Data Service. U kunt de waarden van gegevensbron en naam van de gegevenslijst veranderen.
note note NOTE Als u de tabelnamen wijzigt, geeft u deze op in de configuratie Formulierportal. -
Andere configuraties ongewijzigd laten en klikken Save.
-
De databaseverbinding kan worden uitgevoerd via de gegevensbron van Apache Sling Connection Pooled.
-
Voor Apache Sling-verbinding zoekt en klikt u om te openen Apache Sling Connection Pooled DataSource in geef wijze in de Configuratie van de Console van het Web uit. Geef de waarden voor de eigenschappen op zoals in de volgende tabel wordt beschreven:
- Het JDBC-stuurprogramma voor MySQL wordt niet bij het voorbeeld geleverd. Zorg ervoor dat u daarvoor de provisioned hebt en verstrek de vereiste informatie om de JDBC verbindingspool te vormen.
- Wijs de auteur aan en publiceer instanties om het zelfde gegevensbestand te gebruiken. De waarde van het veld URI van de JDBC-verbinding moet gelijk zijn voor alle auteur- en publicatie-instanties.
-
Andere configuraties ongewijzigd laten en klikken Save.
-
Als u al een lijst in het gegevensbestandschema hebt, sla aan de volgende stap over.
Anders, als u nog geen lijst in het gegevensbestandschema hebt, voer de volgende SQL verklaringen uit om afzonderlijke lijsten voor gegevens, meta-gegevens, en extra meta-gegevens in het gegevensbestandschema tot stand te brengen:
note note NOTE U hebt geen verschillende databases nodig voor auteur- en publicatieinstanties. Gebruik dezelfde database voor alle auteurs en publiceer instanties. SQL-instructie voor gegevenstabel
code language-sql CREATE TABLE `data` ( `owner` varchar(255) DEFAULT NULL, `data` longblob, `metadataId` varchar(45) DEFAULT NULL, `id` varchar(45) NOT NULL, PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
SQL-instructie voor tabel met metagegevens
code language-sql CREATE TABLE `metadata` ( `formPath` varchar(1000) DEFAULT NULL, `formType` varchar(100) DEFAULT NULL, `description` text, `formName` varchar(255) DEFAULT NULL, `owner` varchar(255) DEFAULT NULL, `enableAnonymousSave` varchar(45) DEFAULT NULL, `renderPath` varchar(1000) DEFAULT NULL, `nodeType` varchar(45) DEFAULT NULL, `charset` varchar(45) DEFAULT NULL, `userdataID` varchar(45) DEFAULT NULL, `status` varchar(45) DEFAULT NULL, `formmodel` varchar(45) DEFAULT NULL, `markedForDeletion` varchar(45) DEFAULT NULL, `showDorClass` varchar(255) DEFAULT NULL, `sling:resourceType` varchar(1000) DEFAULT NULL, `attachmentList` longtext, `draftID` varchar(45) DEFAULT NULL, `submitID` varchar(45) DEFAULT NULL, `id` varchar(60) NOT NULL, `profile` varchar(255) DEFAULT NULL, `submitUrl` varchar(1000) DEFAULT NULL, `xdpRef` varchar(1000) DEFAULT NULL, `agreementId` varchar(255) DEFAULT NULL, `nextSigners` varchar(255) DEFAULT NULL, `eSignStatus` varchar(45) DEFAULT NULL, `pendingSignID` varchar(45) DEFAULT NULL, `agreementDataId` varchar(255) DEFAULT NULL, `enablePortalSubmit` varchar(45) DEFAULT NULL, `submitType` varchar(45) DEFAULT NULL, `dataType` varchar(45) DEFAULT NULL, `jcr:lastModified` varchar(45) DEFAULT NULL, PRIMARY KEY (`id`), UNIQUE KEY `ID_UNIQUE` (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
SQL-instructie voor extra metatable
code language-sql CREATE TABLE `additionalmetadatatable` ( `value` text, `key` varchar(255) NOT NULL, `id` varchar(60) NOT NULL, PRIMARY KEY (`id`,`key`), CONSTRAINT ‘additionalmetadatatable_fk’ FOREIGN KEY (`id`) REFERENCES `metadata` (`id`) ON DELETE CASCADE ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
SQL-instructie voor tabel met opmerkingen
code language-sql CREATE TABLE `commenttable` ( `commentId` varchar(255) DEFAULT NULL, `comment` text DEFAULT NULL, `ID` varchar(255) DEFAULT NULL, `commentowner` varchar(255) DEFAULT NULL, `time` varchar(255) DEFAULT NULL);
-
Als u reeds de lijsten (gegevens, meta-gegevens, en extra metatable) in het gegevensbestandschema hebt, voer de volgende veranderlijke lijstvragen uit:
SQL-instructie voor het wijzigen van de gegevenstabel
code language-sql ALTER TABLE `data` CHANGE `owner` `owner` VARCHAR(255) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL;
SQL-instructie voor het wijzigen van de tabel met metagegevens
code language-sql ALTER TABLE metadata add markedForDeletion varchar(45) DEFAULT NULL
note note NOTE De metagegevens van de ALTER-TABEL kunnen niet worden toegevoegd als u deze al hebt uitgevoerd en de kolom MarkedforDeletion in de tabel staat. code language-sql ALTER TABLE metadata add agreementId varchar(255) DEFAULT NULL, add nextSigners varchar(255) DEFAULT NULL, add eSignStatus varchar(45) DEFAULT NULL, add pendingSignID varchar(45) DEFAULT NULL, add agreementDataId varchar(255) DEFAULT NULL, add enablePortalSubmit varchar(45) DEFAULT NULL, add submitType varchar(45) DEFAULT NULL, add dataType varchar(45) DEFAULT NULL;
code language-sql ALTER TABLE `metadata` CHANGE `formPath` `formPath` VARCHAR(1000) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL, CHANGE `formType` `formType` VARCHAR(100) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL, CHANGE `description` `description` TEXT CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL, CHANGE `formName` `formName` VARCHAR(255) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL, CHANGE `owner` `owner` VARCHAR(255) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL, CHANGE `renderPath` `renderPath` VARCHAR(1000) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL, CHANGE `showDorClass` `showDorClass` VARCHAR(255) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL, CHANGE `sling:resourceType` `sling:resourceType` VARCHAR(1000) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL, CHANGE `profile` `profile` VARCHAR(255) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL, CHANGE `submitUrl` `submitUrl` VARCHAR(1000) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL, CHANGE `xdpRef` `xdpRef` VARCHAR(1000) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL;
SQL-instructie voor het wijzigen van de extra metadatable-tabel
code language-sql ALTER TABLE `additionalmetadatatable` CHANGE `value` `value` TEXT CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL, CHANGE `key` `key` VARCHAR(255) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL;
De voorbeeldimplementatie is nu geconfigureerd, waarmee u concepten en verzendingen kunt weergeven terwijl u alle gegevens en metagegevens in een database opslaat. Laten we nu zien hoe de gegevens- en metagegevensservices zijn geconfigureerd in het voorbeeld.
Het bestand mysql-connector-java-5.1.39-bin.jar installeren install-mysql-connector-java-bin-jar-file
Voer de volgende stappen uit op alle auteur- en publicatieinstanties om het bestand mysql-connector-java-5.1.39-bin.jar te installeren:
-
Navigeren naar
https://[server]:[port]/system/console/depfinder
en zoek naar het pakket com.mysql.jdbc. -
Controleer in de kolom Geëxporteerd door of het pakket wordt geëxporteerd door een willekeurige bundel.
Ga door als het pakket niet door enige bundel wordt uitgevoerd.
-
Navigeren naar
https://[server]:[port]/system/console/bundles
en klik op Install/Update. -
Klikken Choose File en bladert u om het bestand mysql-connector-java-5.1.39-bin.jar te selecteren. Selecteer ook Start Bundle en Refresh Packages selectievakjes.
-
Klik op Install or Update. Start de server opnieuw als de bewerking is voltooid.
-
(Alleen Windows) Schakel de systeemfirewall van uw besturingssysteem uit.
Voorbeeldcode voor poortgegevens en metagegevensservice voor formulieren sample-code-for-forms-portal-data-and-metadata-service
De volgende ZIP bevat: FormsPortalSampleDataServiceImpl
en FormsPortalSampleMetadataServiceImpl
(implementatieklassen) voor gegevens en meta-gegevensdienstinterfaces. Bovendien bevat deze klasse alle klassen die vereist zijn voor de compilatie van de bovengenoemde implementatieklassen.
De lengte van de bestandsnaam controleren verify-length-of-the-file-name
De implementatie van de database van Forms Portal maakt gebruik van extra metagegevenstabel. De tabel heeft een samengestelde primaire sleutel die is gebaseerd op de kolommen Key en id van de tabel. MySQL staat primaire sleutels tot de lengte van 255 karakters toe. U kunt het volgende validatiescript aan de clientzijde gebruiken om de lengte te controleren van de bestandsnaam die aan de bestandswidget is gekoppeld. De validatie wordt uitgevoerd wanneer een bestand wordt gekoppeld. Het script dat in de volgende procedure wordt weergegeven, geeft een bericht weer wanneer de bestandsnaam groter is dan 150 (inclusief de extensie). U kunt het script wijzigen om te controleren op een ander aantal tekens.
Voer de volgende stappen uit om te maken een clientbibliotheek en gebruik het script:
-
Meld u aan bij CRXDE en navigeer naar /etc/clientlibs/
-
Een knooppunt van het type maken cq:ClientLibraryFolder en geef de naam van het knooppunt op. Bijvoorbeeld,
validation
.Klik op Save All.
-
Klik met de rechtermuisknop op het knooppunt, klik op create new file en maakt u een bestand met de extensie .txt. Bijvoorbeeld:
js.txt
Voeg de volgende code toe aan het nieuwe .txt-bestand en klik op Save All.code language-none #base=util util.js
In de bovenstaande code:
util
de naam van de map is enutil.js
naam van het bestand in het dialoogvensterutil
map. Deutil
map enutil.js
bestanden worden gemaakt in volgende stappen. -
Klik met de rechtermuisknop op de knop
cq:ClientLibraryFolder
knooppunt dat is gemaakt in stap 2, selecteert u Maken > Map maken. Een map maken met de naamutil
. Klik op Save All. Klik met de rechtermuisknop op de knoputil
Selecteer Maken > Bestand maken. Een bestand met de naamutil.js
. Klik op Save All. -
Voeg de volgende code toe aan het bestand util.js en klik op Save All. De code valideert de lengte van de bestandsnaam.
code language-none /* * ADOBE CONFIDENTIAL * ___________________ * * Copyright 2016 Adobe Systems Incorporated * All Rights Reserved. * * NOTICE: All information contained herein is, and remains * the property of Adobe Systems Incorporated and its suppliers, * if any. The intellectual and technical concepts contained * herein are proprietary to Adobe Systems Incorporated and its * suppliers and may be covered by U.S. and Foreign Patents, * patents in process, and are protected by trade secret or copyright law. * Dissemination of this information or reproduction of this material * is strictly forbidden unless prior written permission is obtained * from Adobe Systems Incorporated. * */ (function () { var connectWithGuideBridge = function (gb) { gb.connect(function () { //For first time load window.guideBridge.on("elementValueChanged" , function(event, payload) { var component = payload.target; // Field whose value has changed if(component.name == 'fileAttachment' && component.parent) { var fileItems = $('#'+payload.target.parent.id).find(".guide-fu-fileItem"); for (i = 0;i<fileItems.length;i++) { var filename = $(fileItems[i]).find(".guide-fu-fileName").text(); //check whether it is previously attached file or a newly attached one if(filename.length > 150 && filename.indexOf("fp.attach.jsp") < 0) { window.alert("filename is larger than 150 : "+filename); $(fileItems[i]).find(".guide-fu-fileClose.close").click(); } } } }); }); }; if (window.guideBridge) { connectWithGuideBridge(window.guideBridge); } else { window.addEventListener("bridgeInitializeStart", function (event) { connectWithGuideBridge(event.detail.guideBridge); }); } })();
note note NOTE Het script is bedoeld voor een component van de box-widget voor bijlagen (OOTB). Als u de OOTB gehechtheidswidget hebt aangepast dan verander het bovengenoemde manuscript om respectieve veranderingen op te nemen. -
Voeg de volgende eigenschap toe aan de map die in stap 2 is gemaakt en klik op Save All.
-
Name: categorieën
-
Type: String
-
Value: fp.validation
-
multi option: Ingeschakeld
-
-
Navigeren naar
/libs/fd/af/runtime/clientlibs/guideRuntime
en voeg defp.validation
aan de insluiten eigenschap. -
Navigeer naar /libs/fd/af/runtime/clientlibs/guideRuntimeWithXFA en voeg de
fp.validation
waarde aan insluiten eigenschap.note note NOTE Als u aangepaste clientbibliotheken gebruikt in plaats van guideRuntime en guideRuntimeWithXfa-clientbibliotheken, gebruikt u de categorienaam om de clientbibliotheek die in deze procedure is gemaakt, in te sluiten in uw aangepaste bibliotheken die tijdens runtime worden geladen. -
Klikken Save All. Wanneer de bestandsnaam groter is dan 150 tekens (inclusief de extensie), wordt nu een bericht weergegeven.