Catalogi

Gebruik een catalogus wanneer templates en herbruikbare content samen moeten verplaatsen, releasen of upgraden. Een catalogus kan templates, attributen, codelijsten, stencils, themes, fonts en afbeeldingen bevatten.

Begrijp catalogustypen

Authored catalogi zijn eigendom van en bewerkbaar door de huidige tenant. Maak er een voor gedeelde templates, een gezamenlijk designsysteem of een gecontroleerde release.
Subscribed catalogi zijn geïnstalleerde kopieën uit een andere bron. De resources zijn beschikbaar voor gebruik, maar alleen-lezen in de ontvangende tenant.
System catalogi leveren gebundelde resources zoals codelijsten voor locale, taal en land. Ook deze zijn alleen-lezen.

Wanneer een team subscribed content wil wijzigen, doe je dat in de authored broncatalogus en release je een nieuwe versie. Kopieer een resource niet naar de ontvangende tenant, tenzij die daar zelfstandig onderhouden moet worden.

Maak en release een catalogus

Open Catalogi en kies Nieuwe catalogus.
Voeg de templates en herbruikbare resources toe die bij elkaar horen.
Controleer previews, voorbeelden en afhankelijkheden tussen resources.
Kies Nieuwe versie releasen en vul de volgende semantische versie in.
Deel de gereleasete catalogus met een andere tenant of exporteer deze als ZIP.

Een release is een onveranderlijke grens voor de huidige inhoud van de catalogus. Een Authored catalogus kan daarna verder als werkversie; release bewust opnieuw wanneer de volgende set wijzigingen klaar is.

Abonneer op een externe catalogus

Open Catalogi en kies Abonneren.
Vul de URL van het catalogusmanifest in, plus de authenticatiegegevens wanneer nodig.
Bekijk de beschikbare resources en kies Installeren voor geselecteerde resources of Alles installeren.
Gebruik Controleren op updates wanneer de bron een nieuwe release publiceert.
Bekijk de upgrade-preview voordat je deze toepast.

De subscribed catalogus en de geïnstalleerde resources zijn alleen-lezen. Een URL-gebonden abonnement kan de bron op updates controleren; een ZIP-beheerde subscribed catalogus upgrade je door een nieuwere ZIP te importeren.

Import en export

Een catalogus exporteren

Open Catalogi in de brontenant.
Open de catalogus die je wilt verplaatsen.
Kies Exporteren en download het ZIP-bestand.
Bewaar de ZIP bij de release notes of het deploymentartefact.

De export bevat de actuele resources en het manifest van de catalogus. Als een authored catalogus wijzigingen bevat sinds de laatste release, wordt de export als ontwikkelversie gemarkeerd zodat deze niet voor een release wordt aangezien.

Een catalogus importeren

Open Catalogi in de doeltenant en kies Importeren.
Upload de catalogus-ZIP.
Kies het catalogustype:
- Authored maakt een bewerkbare catalogus die eigendom is van deze tenant.
- Subscribed maakt een alleen-lezen catalogus die als gepubliceerde kopie wordt beheerd.
Als er al een Authored catalogus met dezelfde slug bestaat, kies je hoe daarmee wordt omgegaan:
- Samenvoegen werkt resources uit de ZIP bij en behoudt lokaal aanwezige resources die niet in de ZIP staan.
- Vervangen maakt de catalogus exact gelijk aan de ZIP en verwijdert lokaal aanwezige resources die ontbreken.
Bekijk validatie- of conflictmeldingen en bevestig de import.
Bekijk belangrijke templates na de import in preview.

Een import in een nieuwe Authored catalogus kan de geldige releaseversie uit de ZIP overnemen. Een import in een bestaande Authored catalogus wijzigt de werkversie; er wordt niet automatisch een release aangemaakt. Publiceer bewust wanneer de content klaar is.

Een nieuwere ZIP importeren in een Subscribed catalogus is een upgrade. Epistola controleert conflicten voordat er iets wordt gewijzigd en laat de vorige versie intact als een item niet kan worden geïnstalleerd. Je kunt het probleem oplossen en opnieuw proberen.

Goede gewoonte

Gebruik een Authored catalogus om herbruikbare content te beheren en releasen en deel deze daarna als Subscribed catalogus met een andere tenant. Gebruik een ZIP-export voor eenmalige verplaatsing, back-up, herstel of projectoverdracht. Bekijk templates altijd in preview en controleer na het importeren hun afhankelijkheden.