Hoe te met Pakketten te werken

Pakketten maken het importeren en exporteren van inhoud in de opslagplaats mogelijk. U kunt bijvoorbeeld pakketten gebruiken om nieuwe functionaliteit te installeren, inhoud tussen instanties over te brengen, en een back-up van inhoud in de opslagplaats te maken.

Pakketten kunnen op de volgende pagina's worden geopend en/of onderhouden:

• Pakketbeheer, waarmee u de pakketten in uw lokale AEM-instantie kunt beheren.

• Het Aandeel van het pakket, een gecentraliseerde server die zowel openbaar beschikbare pakketten als die privé aan uw bedrijf houdt. De openbare pakketten kunnen hotfixes, nieuwe functionaliteit, documentatie, enz. bevatten.

U kunt pakketten overbrengen tussen de Manager van het Pakket, het Aandeel van het Pakket, en uw dossiersysteem.

Wat zijn pakketten?

Een pakket is een gecomprimeerd bestand met opslagplaats-inhoud in de vorm van een serialisatie van het bestandssysteem (de zogenaamde 'vault'-serienummering). Dit biedt een eenvoudig te gebruiken en te bewerken weergave van bestanden en mappen.

Pakketten bevatten inhoud, zowel pagina-inhoud als projectgerelateerde inhoud, die met filters is geselecteerd.

Een pakket bevat ook vault meta-informatie, met inbegrip van de filterdefinities en de informatie van de de invoerconfiguratie. Extra inhoudseigenschappen (die niet worden gebruikt voor het uitpakken van pakketten) kunnen in het pakket worden opgenomen, zoals een beschrijving, een visuele afbeelding of een pictogram. deze eigenschappen zijn uitsluitend bestemd voor de consument van het inhoudspakket en voor informatieve doeleinden .

U kunt de volgende handelingen uitvoeren op of met pakketten:

• Nieuwe pakketten maken; pakketinstellingen en -filters naar wens definiëren
• Voorvertoning van inhoud van pakket (vóór maken)
• Pakketten maken
• Pakketgegevens weergeven
• Pakketinhoud weergeven (na maken)
• De definitie van bestaande pakketten wijzigen
• Bestaande pakketten opnieuw samenstellen
• Pakketten terugbrengen
• Pakketten downloaden van AEM naar uw bestandssysteem
• Pakketten van uw dossiersysteem in uw lokale AEM instantie uploaden
• Inhoud van pakket valideren vóór installatie
• Een droge runtime installeren
• Pakketten installeren (AEM installeert pakketten niet automatisch na het uploaden)
• Pakketten verwijderen
• Download pakketten, zoals hotfixes, uit de bibliotheek van het Aandeel van het Pakket
• Pakketten uploaden naar het bedrijf-interne gedeelte van de bibliotheek van het Aandeel van het Pakket

Pakketinformatie

Een pakketdefinitie bestaat uit verschillende soorten informatie:

• Pakketinstellingen
• Pakketfilters
• Schermafbeeldingen verpakken
• Pakketpictogrammen

Pakketinstellingen

U kunt een verscheidenheid van de Montages van het Pakket uitgeven om aspecten zoals de pakketbeschrijving, verwante insecten, gebiedsdelen en leveranciersinformatie te bepalen.

Het dialoogvenster Pakketinstellingen is beschikbaar via de knop Bewerken wanneer een pakket maken of bewerken en drie tabbladen voor configuratie bevat. Nadat er wijzigingen zijn aangebracht, klikt u op OK om deze op te slaan.

Pakketfilters

Filters identificeren de knooppunten in de opslagplaats die in het pakket moeten worden opgenomen. A Filter Definition geeft de volgende informatie op:

• Het Basispad van de inhoud die moet worden opgenomen.
• Regels die specifieke knooppunten onder het hoofdpad bevatten of uitsluiten.

Filters kunnen nul of meer regels bevatten. Als er geen regels zijn gedefinieerd, bevat het pakket alle inhoud onder het hoofdpad.

U kunt een of meer filterdefinities definiëren voor een pakket. Gebruik meerdere filters om inhoud van meerdere hoofdpaden op te nemen.

In de volgende tabel worden deze regels beschreven en worden voorbeelden gegeven:

Pakketfilters worden meestal gedefinieerd wanneer u het pakket maakt, maar kunnen ook op een later tijdstip worden bewerkt (waarna het pakket opnieuw moet worden samengesteld).

Schermafbeeldingen verpakken

U kunt screenshots aan uw pakket vastmaken om een visuele vertegenwoordiging van te verstrekken wat de inhoud kijkt als; bijvoorbeeld door screenshots van nieuwe functionaliteit te geven.

Pakketpictogrammen

U kunt ook een pictogram aan het pakket toevoegen om een snelle visuele weergave van de inhoud van het pakket mogelijk te maken. Dit wordt vervolgens in de pakketlijst weergegeven en u kunt het pakket of de pakketklasse gemakkelijk herkennen.

Aangezien een pakket een pictogram kan bevatten, worden de volgende conventies gebruikt voor officiële pakketten:

Officieel hotfix-pakket:

Officiële AEM installatie of extensiepakket:

Officiële kenmerkpakketten:

Pakketbeheer

De pakketmanager beheert de pakketten op uw lokale AEM installatie. Nadat u de noodzakelijke toestemmingen hebt toegewezen kunt u de Manager van het Pakket voor diverse acties, met inbegrip van het vormen, het bouwen, het downloaden en het installeren van uw pakketten gebruiken. De belangrijkste te vormen elementen zijn:

• Pakketinstellingen
• Pakketfilters

Toestemmingen nodig voor het gebruiken van de Manager van het Pakket

Om gebruikers het recht te verlenen om pakketten tot stand te brengen, te wijzigen, te uploaden en te installeren, moet u hen de aangewezen toestemmingen bij de volgende plaatsen geven:

• /etc/packages (volledige rechten m.u.v. schrapping)
• het knooppunt dat de pakketinhoud bevat

Zie Machtigingen instellen voor instructies over het wijzigen van machtigingen.

Een nieuw pakket maken

Een nieuwe pakketdefinitie maken:

1. Voor het AEM Welkome scherm, klik Pakketten (of van de console Tools tweemaal klikken op Pakketten).

2. Selecteer vervolgens Pakketbeheer.

3. Klik Pakket maken.

   OPMERKING

   Als uw instantie veel pakketten bevat, is er mogelijk een mapstructuur aanwezig, zodat u naar de vereiste doelmap kunt navigeren voordat u het nieuwe pakket maakt.

4. In het dialoogvenster:

   

   Voer het volgende in:

   • Groepsnaam

     De naam van de doelgroep (of map). Groepen zijn bedoeld om u te helpen uw pakketten ordenen.

     Er wordt een map voor de groep gemaakt als deze nog niet bestaat. Als u de groepsnaam leeg laat, wordt het pakket gemaakt in de hoofdpakketlijst (Home > Pakketten).

   • Pakketnaam

     De naam van het nieuwe pakket. Selecteer een beschrijvende naam om (en anderen) de inhoud van het pakket gemakkelijk te identificeren.

   • Versie

     Een tekstveld waarmee u een versie kunt aangeven. Deze wordt aan de pakketnaam toegevoegd met de naam van het ZIP-bestand.
     Klik OK om het pakket te maken.

5. AEM maakt een lijst van het nieuwe pakket in de aangewezen groepsomslag.

   

   Klik op het pictogram of de pakketnaam om te openen.

   

   OPMERKING

   U kunt desgewenst later terugkeren naar deze pagina.

6. Klik Bewerken om de pakketinstellingen te bewerken.

   Hier kunt u informatie toevoegen en/of bepaalde instellingen definiëren. Dit zijn bijvoorbeeld een beschrijving, het pictogram icon, verwante bugs en voeg providerdetails toe.

   Klik OK nadat u klaar bent met het bewerken van de instellingen.

7. Voeg Screenshots aan het pakket toe zoals vereist. Eén instantie is beschikbaar wanneer het pakket wordt gemaakt. Voeg indien nodig meer toe met Package Screenshot van sidekick.

   Voeg de feitelijke afbeelding toe door te dubbelklikken op de afbeeldingscomponent in het gebied Screenshots, een afbeelding toe te voegen en te klikken op OK.

8. Definieer de Pakketfilters door instanties van de Definitie van filter van het hulpstuk te slepen, en dan te dubbelklikken om voor het uitgeven te openen:

   

   Geef het volgende op:

   • basispadDe
     inhoud die moet worden verpakt; dit kan de basis van een substructuur zijn.

   • ​
     Regels zijn facultatief; voor eenvoudige pakketdefinities is het niet nodig regels op te nemen of uit te sluiten .

     Indien nodig kunt u Include of Exclude regels bepalen om de pakketinhoud precies te bepalen.

     Voeg regels toe met het symbool +, of verwijder regels met het symbool -. Regels worden toegepast op basis van hun volgorde, zodat ze op de gewenste positie worden geplaatst met de knoppen Omhoog en Omlaag.
     Klik vervolgens op OK om het filter op te slaan.

   OPMERKING

   U kunt zoveel filterdefinities gebruiken als u nodig hebt, maar zorg ervoor dat deze geen conflict veroorzaken. Gebruik Voorvertoning om te bevestigen wat de inhoud van het pakket zal zijn.

9. Om te bevestigen wat het pakket zal houden kunt u Voorproef gebruiken. Dit voert een droge looppas van het bouwstijlproces uit en maakt een lijst van alles die aan het pakket zal worden toegevoegd wanneer het eigenlijk wordt gebouwd.

10. U kunt nu Build uw pakket.

    OPMERKING

    Het is niet verplicht om het pakket op dit moment te bouwen, het kan op een later tijdstip gebeuren.

Een pakket maken

Een pakket wordt vaak gebouwd tezelfdertijd aangezien u de pakketdefinitie creeert, maar u kunt op een later punt in tijd terugkeren om of het pakket te bouwen, of te herbouwen. Dit kan handig zijn als de inhoud in de opslagplaats is gewijzigd.

1. Open de pakketdefinitie van Package Manager (klik op het pakketpictogram of de naam).

2. Klik Bouwstijl. Er wordt een dialoogvenster weergegeven waarin u moet bevestigen dat u het pakket wilt maken.

   OPMERKING

   Dit is met name van belang wanneer u een pakket opnieuw opstelt omdat de inhoud van het pakket wordt overschreven.

3. Klik OK. AEM bouwt het pakket en geeft alle inhoud weer die aan het pakket is toegevoegd. Na voltooiing AEM wordt bevestigd dat het pakket is gemaakt en (wanneer u het dialoogvenster sluit) worden de gegevens in de pakketlijst bijgewerkt.

Een pakket opnieuw inpakken

Nadat een pakket is gemaakt, kan het indien nodig opnieuw worden verpakt.

Als u de pakketgegevens opnieuw inpakt, worden deze gewijzigd - zonder de pakketinhoud te wijzigen. Pakketgegevens zijn de miniatuur, beschrijving, enzovoort, met andere woorden alles wat u kunt bewerken met het dialoogvenster Pakketinstellingen (om deze klik te openen Bewerken).

Een belangrijk gebruiksgeval voor omloop is wanneer het voorbereiden van een pakket voor het pakketaandeel. U hebt bijvoorbeeld een bestaand pakket en u wilt dit delen met anderen. Hiervoor wilt u een miniatuur toevoegen en een beschrijving toevoegen. In plaats van het hele pakket opnieuw te maken met al zijn functionaliteit (wat enige tijd kan duren en het risico inhoudt dat het pakket niet meer identiek is aan het origineel), kunt u het pakket terugzetten en alleen de miniatuur en beschrijving toevoegen.

1. Open de pakketdefinitie van Package Manager (klik op het pakketpictogram of de naam).

2. Klik Bewerken en werk de Pakketinstellingen naar wens bij. Klik OK om op te slaan.

3. Klik Omloop, zal een dialoog om bevestiging vragen.

Pakketgegevens weergeven en bewerken

Informatie over een pakketdefinitie weergeven of bewerken:

1. Navigeer in Pakketbeheer naar het pakket dat u wilt weergeven.

2. Klik op het pakketpictogram van het pakket dat u wilt weergeven. Hiermee wordt de pakketpagina geopend met informatie over de pakketdefinitie:

   

   OPMERKING

   U kunt ook bepaalde handelingen op het pakket bewerken en uitvoeren vanaf deze pagina.

   Welke knoppen beschikbaar zijn, is afhankelijk van het feit of het pakket al dan niet is gemaakt.

3. Als het pakket al is samengesteld, klikt u op Inhoud, wordt een venster geopend met daarin de volledige inhoud van het pakket:

Inhoud van pakket weergeven en installatie testen

Nadat een pakket is gemaakt, kunt u de inhoud weergeven:

1. Navigeer in Pakketbeheer naar het pakket dat u wilt weergeven.

2. Klik op het pakketpictogram van het pakket dat u wilt weergeven. Hiermee wordt de pakketpagina geopend met informatie over de pakketdefinitie.

3. Als u de inhoud wilt weergeven en op Inhoud wilt klikken, wordt een venster geopend waarin de volledige inhoud van het pakket wordt weergegeven:

   

4. Klik Installatie testen om de installatie op een droge manier uit te voeren. Nadat u de actie hebt bevestigd, wordt een venster geopend en worden de resultaten weergegeven alsof de installatie is uitgevoerd:

   

Pakketten downloaden naar uw bestandssysteem

In deze sectie wordt beschreven hoe u een pakket van AEM naar uw bestandssysteem kunt downloaden met Package Manager.

1. Voor het AEM Welkome scherm, klik Pakketten, dan selecteer de Manager van het Pakket.

2. Navigeer naar het pakket dat u wilt downloaden.

   

3. Klik op de koppeling die wordt gevormd door de naam van het ZIP-bestand (onderstreept) voor het pakket dat u wilt downloaden; bijvoorbeeld export-for-offline.zip.

   AEM downloadt het pakket naar de computer (via een standaarddialoogvenster voor het downloaden van browsers).

Pakketten uploaden vanuit uw bestandssysteem

Met een pakketupload kunt u een pakket van uw bestandssysteem uploaden naar AEM Package Manager.

Een pakket uploaden:

1. Navigeer aan de Manager van het Pakket. Vervolgens naar de groepsmap waarin u het pakket wilt uploaden.

   

2. Klik Pakket uploaden.

   

   • Bestand

     U kunt de bestandsnaam rechtstreeks typen of Bladeren gebruiken… om het vereiste pakket in uw lokale bestandssysteem te selecteren (klik na de selectie op OK).

   • Uploaden forceren

     Als er al een pakket met deze naam bestaat, kunt u hierop klikken om het uploaden te forceren (en het bestaande pakket te overschrijven).
     Klik OK zodat het nieuwe pakket wordt geüpload en in de lijst van de Manager van het Pakket wordt vermeld.

   OPMERKING

   Als u de inhoud beschikbaar wilt maken voor AEM, moet u het pakket installeren.

Pakketten valideren

Voordat u een pakket installeert, dient u de inhoud ervan te controleren. Omdat de pakketten overlay dossiers onder /apps kunnen wijzigen en/of ACLs toevoegen wijzigen en verwijderen, is het vaak nuttig om deze veranderingen te bevestigen alvorens te installeren.

Validatieopties

Het validatiemechanisme kan de volgende kenmerken van het pakket controleren:

• OSGi-pakket importeren
• Bedekkingen
• ACLs

Deze opties worden hieronder beschreven.

• OSGi-pakketinvoer valideren

  Wat wordt gecontroleerd

  Deze bevestiging inspecteert het pakket voor alle JAR dossiers (bundels OSGi), haalt hun manifest.xml (die de versioned gebiedsdelen bevat waarop genoemde OSGi bundel baseert) en verifieert de AEM instantie uitvoert genoemde gebiedsdelen met de correcte versies.

  Hoe het is gemeld

  Om het even welke versioned gebiedsdelen die niet door de AEM instantie kunnen worden tevredengesteld zijn vermeld in Activiteitenlogboek van de Manager van het Pakket.

  Foutstatussen

  Als de gebiedsdelen ontevreden zijn, dan zullen de bundels OSGi in het pakket met die gebiedsdelen niet beginnen. Dit resulteert in een gebroken toepassingsplaatsing aangezien om het even wat die op de niet-begonnen bundel OSGi baseert zal beurtelings niet behoorlijk functioneren.

  Foutresolutie

  Om fouten als gevolg van ontevreden OSGi-bundels op te lossen, moet de afhankelijkheidsversie in de bundel met ontevreden invoer worden aangepast.

• Bedekkingen valideren

  Wat wordt gecontroleerd

  Deze validatie bepaalt of het pakket dat wordt geïnstalleerd een bestand bevat dat al wordt bedekt in de AEM.

  Als u bijvoorbeeld een bestaande overlay op /apps/sling/servlet/errorhandler/404.jsp hebt, een pakket dat /libs/sling/servlet/errorhandler/404.jsp bevat, zodat het bestaande bestand op /libs/sling/servlet/errorhandler/404.jsp wordt gewijzigd.

  Hoe het is gemeld

  Dergelijke overlays worden beschreven in het Activiteitenlogboek van het Pakketbeheer.

  Foutstatussen

  Een foutstatus houdt in dat het pakket probeert een bestand te implementeren dat al is bedekt. De wijzigingen in het pakket worden dus overschreven (en dus "verborgen") door de bedekking en worden niet van kracht.

  Foutresolutie

  Om dit probleem op te lossen, moet de beheerder van het overlaybestand in /apps de wijzigingen in het overlay-bestand in /libs controleren en de wijzigingen naar wens opnemen in de overlay ( /apps) en het overlay-bestand opnieuw implementeren.

  OPMERKING

  Het validatiemechanisme biedt geen enkele manier om te combineren als de overlay-inhoud correct is opgenomen in het overlaybestand. Daarom zal deze validatie ook na de nodige wijzigingen over conflicten blijven rapporteren.

• ACLs bevestigen

  Wat wordt gecontroleerd

  Deze bevestiging controleert welke toestemmingen worden toegevoegd, hoe zij zullen worden behandeld (samenvoegen/vervangen), en als de huidige toestemmingen zullen worden beïnvloed.

  Hoe het is gemeld

  De toestemmingen worden beschreven in Activiteitenlogboek van de Manager van het Pakket.

  Foutstatussen

  Er kunnen geen expliciete fouten worden opgegeven. De bevestiging wijst eenvoudig erop of om het even welke nieuwe ACL toestemmingen zullen worden toegevoegd of beïnvloed door het pakket te installeren.

  Foutresolutie

  Gebruikend de informatie die door de bevestiging wordt verstrekt, kunnen de beïnvloede knopen in CRXDE worden herzien en ACLs kan in het pakket aanpassen zoals nodig.

  LET OP

  Als beste praktijken wordt het geadviseerd dat de pakketten geen AEM-Verstrekte ACLs zouden moeten beïnvloeden aangezien dit in onverwacht productgedrag kan resulteren.

Validatie uitvoeren

De validatie van pakketten kan op twee verschillende manieren worden uitgevoerd:

• Via de interface van Package Manager
• Via HTTP-POST request zoals with cURL

Pakketvalidatie via pakketbeheer

1. Open de Manager van het Pakket bij https://<server>:<port>/crx/packmgr

2. Selecteer het pakket in de lijst en selecteer Meer dropdown van de rubriek en dan Valideren van het drop-down menu.

   OPMERKING

   Dit moet gebeuren nadat u het inhoudspakket hebt geüpload, maar voordat u het pakket installeert.

3. In het modale dialoogvenster dat dan wordt weergegeven, gebruikt u de selectievakjes om het type of de typen validatie te selecteren en de validatie te starten door op Valideren te klikken. U kunt ook op Annuleren klikken.

4. De gekozen validatie(s) worden dan uitgevoerd. De resultaten worden getoond in het activiteitenlogboek van de Manager van het Pakket.

Pakketvalidatie via HTTP-POST-aanvraag

Het verzoek van de POST heeft de volgende vorm.

https://<host>:<port>/crx/packmgr/service.jsp?cmd=validate&type=osgiPackageImports,overlays,acls

Hieronder ziet u een voorbeeld van het gebruik van cURL voor het uitvoeren van een pakketvalidatie.

1. Als u cURL gebruikt, voert u een instructie uit die vergelijkbaar is met het volgende:

   curl -v -X POST --user admin:admin -F file=@/Users/SomeGuy/Desktop/core.wcm.components.all-1.1.0.zip 'http://localhost:4502/crx/packmgr/service.jsp?cmd=validate&type=osgiPackageImports,overlays,acls'
   

2. De gevraagde validatie wordt uitgevoerd en het antwoord wordt teruggestuurd als een JSON-object.

Pakketten installeren

Nadat u een pakket hebt geüpload, moet u de inhoud installeren. Om de pakketinhoud geïnstalleerd en functioneel te hebben, moet het allebei zijn:

• geladen in AEM (of geüpload van uw bestandssysteem of gedownload van pakketshare)

• geïnstalleerd

1. Navigeer in Pakketbeheer naar het pakket dat u wilt installeren.

   Een Install knoop wordt getoond aan de kant van Pakketten die nog niet geïnstalleerd zijn.

   OPMERKING

   U kunt het pakket ook openen door op het bijbehorende pictogram te klikken om de knop Installeren daar te openen.

2. Klik Installeren om de installatie te starten. In een dialoogvenster wordt bevestiging gevraagd en worden alle aangebrachte wijzigingen vermeld. Wanneer gebeëindigd klik Close op de dialoog.

   Het woord Installed verschijnt naast het pakket nadat het is geïnstalleerd.

Uploaden en installeren op basis van bestandssysteem

U kunt pakketten op een andere manier naar uw exemplaar uploaden en installeren. In uw dossiersysteem, hebt u een crx-quicksart omslag naast uw jar en license.properties dossier. U moet een map maken met de naam install onder crx-quickstart. Dan heb je iets als dit: <aem_home>/crx-quickstart/install

In deze installatiemap kunt u uw pakketten rechtstreeks toevoegen. Deze worden automatisch geüpload en geïnstalleerd op uw exemplaar. Wanneer het wordt gedaan, kunt u de pakketten in de Manager van het Pakket zien.

Als uw instantie wordt uitgevoerd en u een pakket aan de map install toevoegt, wordt het uploaden en de installatie op de instantie direct gestart. Als de instantie niet wordt uitgevoerd, worden de pakketten die u in de map install plaatst, bij het opstarten in alfabetische volgorde geïnstalleerd.

Pakketten verwijderen

Met AEM kunt u pakketten verwijderen. Deze actie keert de inhoud van de bewaarplaats terug die aan de momentopname wordt beïnvloed die onmiddellijk voorafgaand aan de pakketinstallatie wordt gemaakt.

1. Navigeer in Pakketbeheer naar het pakket dat u wilt verwijderen.
2. Klik op het pakketpictogram van het pakket dat u wilt verwijderen.
3. Klik op Verwijderen om de inhoud van dit pakket uit de opslagplaats te verwijderen. In een dialoogvenster wordt bevestiging gevraagd en worden alle aangebrachte wijzigingen vermeld. Wanneer gebeëindigd klik Close op de dialoog.

Pakketten verwijderen

Een pakket verwijderen uit de lijst(en) in Package Manager:

1. Vouw in de Tools-console de map Packages uit om het pakket weer te geven in het rechterdeelvenster.

2. Klik op het pakket dat u wilt verwijderen, zodat het wordt gemarkeerd en vervolgens op een van de volgende manieren:

   • Klik Delete in het toolbarmenu.
   • Klik met de rechtermuisknop en selecteer Delete.

   

3. AEM vraagt om bevestiging dat u het pakket wilt schrappen. Klik OK om de verwijdering te bevestigen.

Pakketten dupliceren

Kopieer de inhoud van een pakket en installeer het naar de publicatie-instantie:

1. Navigeer in Pakketbeheer naar het pakket dat u wilt repliceren.

2. Klik op het pictogram of de naam van het pakket dat u wilt repliceren om het uit te vouwen.

3. Selecteer Repliceren in het vervolgkeuzemenu Meer op de werkbalk.

Package Share

Het aandeel van het Pakket was een gecentraliseerde server die openbaar ter beschikking werd gesteld om inhoud-Pakketten te delen.

Het is vervangen door Softwaredistributie.

Softwaredistributie

Software Distributionis de nieuwe gebruikersinterface die is ontworpen om het zoeken en downloaden van AEM pakketten te vereenvoudigen.

Voor meer informatie, heb een blik bij de documentatie van de Distributie van de Software.

Business.Adobe.com-bronnen

Automated Onboarding Auto Form Fill Targeted Content Asset Collections Embedded Charts Version History