AEM Forms-elementen en -documenten migreren migrate-aem-forms-assets-and-documents
Het migratiehulpprogramma converteert het Aangepaste Forms-middelen, cloudconfiguraties, en Correspondentenbeheermiddelen van de indeling die in de eerdere versies werd gebruikt naar de indeling die in AEM 6.4 Forms werd gebruikt. Wanneer u migratiehulpprogramma uitvoert, worden de volgende onderdelen gemigreerd:
- Aangepaste componenten voor aangepaste formulieren
- Aangepaste formulieren en correspondentiebeheersjablonen
- Cloud-configuraties
- Correspondentenbeheer en aangepaste formulieren
Migratieaanpak approach-to-migration
U kunt upgrade naar de recentste versie van AEM Forms 6.4 van AEM Forms 6.3 of 6.2 of voer een nieuwe installatie uit. Afhankelijk van of u uw vorige installatie upgradet of een nieuwe installatie hebt uitgevoerd, moet u een van de volgende handelingen uitvoeren:
In het geval van een upgrade ter plekke
Als u een upgrade op locatie hebt uitgevoerd, beschikt de geüpgrade instantie al over de elementen en documenten. Voordat u de elementen en documenten kunt gebruiken, moet u echter eerst de installatie uitvoeren AEMFD-compatibiliteitspakket (inclusief het compatibiliteitspakket voor Correspondentenbeheer)
Vervolgens moet u de elementen en documenten vóór Het migratiehulpprogramma uitvoeren.
In geval van installatie buiten de plaats
Als de installatie op een verkeerde plaats staat (vers) voordat u de middelen en documenten kunt gebruiken, moet u de installatie AEMFD-compatibiliteitspakket (inclusief het pakket Correspondence Management Compatibility).
Vervolgens moet u uw elementenpakket (zip of cmp) importeren in de nieuwe configuratie en de elementen en documenten vervolgens bijwerken vóór Het migratiehulpprogramma uitvoeren. Door achterwaartse compatibiliteit verandert, worden de plaatsen van een paar omslagen in crx-bewaarplaats veranderd. Exporteer en importeer handmatig afhankelijkheden (aangepaste bibliotheken en elementen) van vorige installatie naar een nieuwe omgeving.
Lees deze voordat u verdergaat met de migratie prerequisites
Voor Correspondentenbeheermiddelen:
- Voor de elementen die zijn geïmporteerd vanaf het vorige platform, wordt een eigenschap toegevoegd: fd:versie=1.0.
- Sinds AEM 6.1 Forms zijn opmerkingen niet beschikbaar in het tekstvak. De opmerkingen die eerder zijn toegevoegd, zijn beschikbaar in de elementen, maar niet automatisch in de interface. U moet de eigenschap extendedProperties aanpassen in de gebruikersinterface van AEM Forms om de opmerkingen zichtbaar te maken.
- In sommige van de vorige versies zoals LiveCycle ES4, werd de tekst uitgegeven gebruikend Flex RichTextEditor, maar sinds AEM 6.1 Forms, wordt de redacteur van HTML gebruikt. Door deze weergave en weergave van de lettertypen kunnen de tekengrootten en lettertypemarges afwijken van de vorige versies in de gebruikersinterface van de auteur. De letters zien er echter hetzelfde uit wanneer ze worden gerenderd.
- Lijsten in tekstmodules zijn verbeterd en worden nu anders weergegeven. Er kunnen visuele verschillen zijn. Wij adviseren dat u teruggeeft en de brieven ziet waar u lijsten in tekstmodules gebruikt.
- Aangezien de modules met afbeeldingsinhoud worden omgezet in DAM-elementen en tijdens de migratie lay-outs en fragmenten worden toegevoegd aan formulieren, verandert de eigenschap Bijgewerkt op voor deze modules in beheer.
- De versiegeschiedenis van de elementen wordt niet gemigreerd en is niet beschikbaar na de migratie. De volgende versiegeschiedenis na migratie wordt gehandhaafd.
- De staat Klaar om te publiceren is afgekeurd sinds AEM 6.1 Forms, zodat worden alle activa in Klaar om staat te publiceren veranderd in Gewijzigde staat.
- Aangezien de gebruikersinterface in AEM Forms 6.3 wordt bijgewerkt, zijn de stappen voor het uitvoeren van de aanpassingen ook verschillend. U moet de aanpassing opnieuw uitvoeren als u van een versie voorafgaand aan 6.3 migreert.
- Layoutfragmenten worden verplaatst van /content/apps/cm/layouts/fragmentlayouts/1001 naar /content/apps/cm/modules/fragmentlayouts. De verwijzing van het Woordenboek van gegevens in activa toont weg van het Woordenboek van Gegevens in plaats van zijn naam.
- Alle tabruimten die worden gebruikt voor uitlijning in tekstmodules moeten worden aangepast. Zie voor meer informatie Correspondentenbeheer - Tabspatiëring gebruiken voor het rangschikken van tekst.
- Configuraties van de middelencomposer veranderen in Correspondence Management-configuraties.
- Elementen worden onder mappen met namen als Bestaande tekst en Bestaande lijst geplaatst.
Het migratiehulpprogramma gebruiken using-the-migration-utility
Het migratiehulpprogramma uitvoeren runningmigrationutility
Voer het migratiehulpprogramma uit voordat u wijzigingen aanbrengt in de elementen of elementen maakt. We raden u aan het hulpprogramma niet uit te voeren nadat u wijzigingen hebt aangebracht of elementen hebt gemaakt. Zorg ervoor dat de gebruikersinterface Correspondence Management of Adaptive Forms Assets niet is geopend tijdens het migratieproces.
Wanneer u het Hulpprogramma van de Migratie voor het eerst in werking stelt, wordt een logboek gecreeerd met de volgende weg en de naam: \[aem-installation-directory]\cq-quickstart\logs\aem-forms-migration.log. Dit logboek wordt voortdurend bijgewerkt met Correspondence Management en Adaptive Forms-migratiegegevens, zoals het verplaatsen van middelen.
-
Meld u in een browsersessie aan bij AEM auteurinstantie als Admin.
-
Open de volgende URL in de browser:
https://[hostnaam]:[poort]/[context_path]/libs/fd/foundation/gui/content/migration.html
In de browser worden vier opties weergegeven:
- Migratie van AEM Forms-middelen
- Migratie van aangepaste Forms-componenten
- Migratie van adaptieve Forms-sjablonen
- Migratie van AEM Forms Cloud Configurations
-
Voer de volgende handelingen uit om de migratie uit te voeren:
-
Migreren elementen tikken op AEM Forms Assets Migration en tikken in het volgende scherm op Migratie starten. De volgende code wordt gemigreerd:
- Aangepaste formulieren
- Documentfragmenten
- Thema's
- Letters
- Gegevenswoordenboeken
note note NOTE Tijdens de migratie van middelen vindt u mogelijk waarschuwingsberichten zoals "Conflict gevonden voor…". Dergelijke berichten geven aan dat de regels voor sommige componenten in adaptieve formulieren niet kunnen worden gemigreerd. Als de component bijvoorbeeld een gebeurtenis met zowel regels als scripts had, als regels optreden nadat een script is uitgevoerd, worden de regels voor de component niet gemigreerd. Dergelijke regels kunnen echter worden gemigreerd door de regeleditor te openen in aangepaste formulierontwerpen. Deze componenten kunnen worden gemigreerd door ze te openen in de Rule Editor in de Adaptive Forms Editor. -
Tik op Adaptive Forms Custom Components Migration en tik in het volgende scherm op Start Migration om regels en scripts te migreren (niet vereist als u vanaf 6.3 een upgrade uitvoert) in aangepaste componenten. De volgende code wordt gemigreerd:
- Regels en Scripts die zijn gemaakt met een regeleditor (6.1 FP1 en hoger)
- Scripts die zijn gemaakt met het tabblad Script in de gebruikersinterface van 6.1 en eerder
-
Tik op Adaptive Forms Template Migration en tik in het volgende scherm op Start Migration om sjablonen te migreren (niet vereist als u een upgrade uitvoert vanaf 6.3). De volgende code wordt gemigreerd:
- Oude sjablonen - de aangepaste formuliersjablonen die zijn gemaakt onder /apps met AEM 6.1 Forms of eerder. Dit geldt ook voor de scripts die zijn gedefinieerd in de sjablooncomponenten.
- Nieuwe sjablonen - Aangepaste formuliersjablonen die zijn gemaakt met de sjablooneditor onder /conf. Dit omvat migratie van regels en manuscripten die gebruikend de regelredacteur worden gecreeerd.
-
Tik op Aangepaste componenten om aangepaste formulieren te migreren Migratie van aangepaste Forms-componenten en tikt u op de pagina Custom Components Migration op Migratie starten. De volgende code wordt gemigreerd:
- Aangepaste componenten geschreven voor Adaptive Forms
- Eventuele componentbedekkingen.
-
Tik op Aangepaste formuliersjablonen om deze te migreren Adaptieve Forms-sjabloonmigratie en tikt u op de pagina Custom Components Migration op Migratie starten. De volgende code wordt gemigreerd:
- Aangepaste formuliersjablonen die zijn gemaakt onder /apps of /conf met AEM Sjablooneditor.
-
Migreer AEM Forms Cloud Configuration-services om gebruik te maken van het nieuwe contextbewuste cloudservicepparadigma, dat de interface voor aanraakbediening bevat (onder /conf). Wanneer u AEM Forms Cloud Configuration Services migreert, worden de cloudservices in /etc. verplaatst naar /conf. Als u geen aanpassingen van de cloudservices hebt die afhankelijk zijn van de oude paden (https://experienceleague.adobe.com/etc?lang=nl), wordt u aangeraden het migratiehulpprogramma direct uit te voeren na de upgrade naar 6.4 en de aanraakinterface voor cloudconfiguratie te gebruiken voor verdere werkzaamheden. Als u een bestaande aanpassing van de cloudservices hebt, blijft u de klassieke interface gebruiken bij de geüpgrade installatie totdat de aanpassingen zijn bijgewerkt en worden uitgelijnd op de gemigreerde paden (https://experienceleague.adobe.com/conf?lang=nl). Voer vervolgens het migratiehulpprogramma uit.
Migreren AEM Forms-cloudservices tikt u op AEM Forms Cloud Configuration Migration (migratie van cloudconfiguratie is onafhankelijk van het compatibiliteitspakket AEMFD), tikt u op Migratie van AEM Forms Cloud Configurations en vervolgens op de pagina Configuration Migration Migratie starten:
-
Cloudservices formuliergegevensmodel
- Bronpad: /etc/cloudservices/fdm
- Doelpad: /conf/global/settings/cloudconfigs/fdm
-
Recaptcha
- Bronpad: /etc/cloudservices/recaptcha
- Doelpad: /conf/global/settings/cloudconfigs/recaptcha
-
Acrobat Sign
- Bronpad: /etc/cloudservices/echosign
- Doelpad: /conf/global/settings/cloudconfigs/echosign
-
Typekit-cloudservices
- Bronpad: /etc/cloudservices/typekit
- Doelpad: /conf/global/settings/cloudconfigs/typekit
Het browservenster geeft het volgende weer terwijl het migratieproces plaatsvindt:
- Wanneer de elementen worden bijgewerkt: Elementen zijn bijgewerkt.
- Zodra de migratie is voltooid: Migratie van middelen is voltooid.
Wanneer uitgevoerd, doet het nut van de Migratie het volgende:
- Hiermee voegt u de codes toe aan de elementen: Hiermee voegt u het label Correspondentiebeheer toe: Gemigreerde activa" / "Aangepaste Forms: Gemigreerde activa". naar de gemigreerde elementen, zodat de gebruikers de gemigreerde elementen kunnen identificeren. Wanneer u het migratiehulpprogramma uitvoert, worden alle bestaande elementen in het systeem gemarkeerd als Gemigreerd.
- Hiermee genereert u tags: Categorieën en subcategorieën die zich in het vorige systeem bevinden, worden gemaakt als codes. Deze codes worden vervolgens gekoppeld aan de relevante Correspondence Management-elementen in AEM. Een categorie (claims) en een subcategorie (claims) van een lettertypesjabloon worden bijvoorbeeld gegenereerd als tags.
- Hiermee verplaatst u lay-outs en lay-outfragmenten naar AEM 6.4 Forms-gebruikersinterface: Als u een upgrade uitvoert van 6.2 naar 6.4, worden de lay-outsjablonen en lay-outfragmenten toegevoegd als formulieren in de sectie voor de AEM Forms 6.4-gebruikersinterface.
note note NOTE Als u een upgrade uitvoert van 6.2 naar 6.4, worden voor Correspondentiebeheer mogelijk nieuwe mappen weergegeven in de gebruikersinterface die uw elementen bevatten. Mogelijk moet u deze mappen controleren om uw elementen te vinden. -
-
Nadat het migratiehulpprogramma is uitgevoerd, gaat u verder naar huishoudelijke taken.
Bewaringstaken na het uitvoeren van het migratiehulpprogramma housekeepingtasks
Nadat u het migratiehulpprogramma hebt uitgevoerd, moet u de volgende huishoudelijke taken uitvoeren:
-
Zorg ervoor dat de XFA-versie van lay-outs en fragmentlay-outs 3.3 of hoger is. Als u lay-outs en fragmentlay-outs van een oudere versie gebruikt, kunnen er problemen optreden bij het renderen van de letter. Voer de volgende stappen uit om de versie van een oudere XFA bij te werken naar de meest recente versie:
- XFA downloaden als ZIP-bestand in de Forms-gebruikersinterface.
- Extraheer het bestand.
- Open het XFA-bestand in de nieuwste Designer en sla het op. De versie van XFA wordt bijgewerkt naar de nieuwste versie.
- Upload de XFA in de Forms-gebruikersinterface.
-
Publiceer alle elementen die vóór de migratie in het vorige systeem zijn gepubliceerd. Het migratiehulpprogramma werkt de elementen alleen bij op de instantie van de auteur en om de elementen in de instantie(s) voor publicatie bij te werken, moet u de elementen publiceren.
-
In AEM Forms 6.4 worden sommige rechten van de gebruikersgroepen voor formulieren gewijzigd. Als u wilt dat een van uw gebruikers XDP's en Adaptive Forms met scripts of code-editor kan uploaden, moet u ze toevoegen aan een gebruikersgroep voor formulieren. Op dezelfde manier kunnen de malplaatje-auteurs niet meer de coderedacteur in de Redacteur van de Regel gebruiken. Gebruikers kunnen alleen code-editor gebruiken als ze deze aan de af-template-script-writers-groep toevoegen. Voor instructies over het toevoegen van gebruikers aan groepen raadpleegt u Gebruikers en gebruikersgroepen beheren.