Skip to content
Helpcentrum-gids · Projecten & ordeningOnboardingfase 3
4 min leestijdGecontroleerd 2026-11-16

Sjablonen & passen ordenen

Houd overzichten overzichtelijk met naamgevingsregels, archieffilters, unieke externe ID's en weergaven.

In deze gids

Interactieve UI-weergaven

Openen in onboardinggids (6 fasen)

Bekijk de exacte dashboardpanelen, knoppen en ingezoomde toelichtingen bij deze gids.

Ingezoomde UI-focus
Belangrijke UI-onderdelen

Template Settings — Ondertekening & External IDs (Ingezoomd)

Controleer certificaatstatus, Wallet-volgorde, Published-status en External ID-regels in Settings.

Overzicht

Naarmate uw organisatie groeit over seizoenscampagnes, regionale winkelvestigingen en test- versus productieomgevingen heen, biedt Passinstance gelaagde organisatietools voor uw werkruimte: Sjablooncategorisatie & tags, Sjablonen klonen (Template Duplication Wizard), rowKind-levenscyclusfiltering (DRAFT, PUBLISHED, PRODUCTION, ARCHIVED), Samengestelde uniciteit voor externe ID's, GIN-geïndexeerd zoeken op attributen (attribute search index) en Projectoverstijgende sjabloonkoppeling.

Systeemarchitectuur: werkruimtetaxonomie, klonen & opgeslagen weergaven

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
WERKRUIMTETAXONOMIE, KLONEN & OPGESLAGEN WEERGAVEN
FASE 01 ORGANISATIE (Organization-model)
+-- Productiewerkruimte (Customer: kind = 'production')
+-- Sandbox-werkruimte (Customer: kind = 'sandbox')
FASE 02 SJABLOONCATALOGUS & PROJECTCLUSTERS (Template / PassProject)
Filter op rowKind: PUBLISHED | PRODUCTION | DRAFT | ARCHIVED
Categorisatie: Programma-tags[], passType & PassProjectTemplate-links
Kloonengine: POST/api/v1/templates/:id/duplicate (Template Duplication Wizard)
External ID-beleid: Unieke beperking op (customerId, externalId)
FASE 03 SNELLE PASMAP & OPGESLAGEN WEERGAVEN (Pass-tabel)
B-Tree-indexen: (customerId, templateId, status, serialNumber, externalId)
Gestructureerde JSON-zoekindex (attribute search index): Directe zoekopdracht
Opgeslagen weergaven: Vaste EN/OF-filterbomen per beheerder of werkruimte

1. Een sjabloon kopiëren: een bestaand sjabloon dupliceren (sjablonen klonen)

In plaats van voor elk nieuw kaartprogramma opnieuw kleuren, veldindelingen, barcodes en schema's voor aangepaste eigenschappen op te zetten, kunt u elk bestaand sjabloon binnen enkele seconden dupliceren.

Klonen vanuit het Dashboard

Beheerders kunnen het klonen van sjablonen op twee plekken starten:

  1. 1
    Vanuit het sjabloonoverzicht: Klik op een sjabloonkaart op het menu met de drie puntjes (...) en kies Dupliceren.
  2. 2
    Vanuit de Visuele editor: Klik in de bovenste CommandBar op Acties -> Sjabloon dupliceren.

De 4-stapsworkflow van de Template Duplication Wizard

De Template Duplication Wizard begeleidt beheerders stap voor stap bij het dupliceren van een sjabloon:

  1. 1
    Stap 1: Bronsjabloon selecteren: Bevestigt het bronsjabloon en toont het pastype, het aantal velden en de gekoppelde afbeeldingen.
  2. 2
    Stap 2: Naam & beschrijving: Vult de nieuwe sjabloonnaam vooraf in als ${sourceTemplate.name} (Copy) en laat u een eigen beschrijving invoeren.
  3. 3
    Stap 3: Aanpassing:

- Gekoppelde PassFlow-registratiepagina: Kies of u het gekoppelde openbare registratieformulier mee wilt klonen via duplicatePassFlow (waarmee een zelfstandige /f/:newUrl PassFlow-pagina wordt aangemaakt) of het nieuwe sjabloon zonder gekoppeld formulier wilt laten. - Merkkleuren: Pas backgroundColor, foregroundColor en labelColor aan. De wizard voert realtime WCAG AA-contrastvalidatie uit om de leesbaarheid te waarborgen. - Visuele assets: Kies of u de afbeeldingen van het bronsjabloon behoudt (icon, logo, strip, thumbnail) of nieuwe merkassets uploadt.

  1. 4
    Stap 4: Certificaattoewijzing: Kies een bestaand Apple Pass Type ID-ondertekeningscertificaat uit de werkruimte-instellingen of upload een nieuw .p12- / .cer-certificaat.

2. Werkruimte-isolatie & nette sjabloonnaamgeving

Passinstance isoleert sjablonen, passen, certificaten en API-sleutels op de grens van de Customer-werkruimte binnen uw bovenliggende Organization (POST /api/v1/organizations/current/workspaces):

  1. 1
    Scheid omgevingen per werkruimte: Bewaar experimentele concepten en integratietests in een sandbox-werkruimte en reserveer uw production-werkruimte uitsluitend voor live klantprogramma's.
  2. 2
    Standaardiseer sjabloonnamen & tags: Neem programmadomein, regio en versie op in sjabloontitels (bijvoorbeeld Loyalty-CoffeeClub-EU-v2) en koppel gestructureerde tags (bijv. ["retail", "q4-2026", "dach"]) voor directe filtering in de catalogus.
  3. 3
    Archiveer verouderde sjablonen (rowKind: ARCHIVED): Verwijder historische promotiesjablonen waaraan nog uitgegeven pasrecords hangen niet, maar zet ze op Gearchiveerd. Gearchiveerde sjablonen blijven verborgen in standaard actieve keuzelijsten, terwijl historische analyses en scanlogboeken behouden blijven onder het filter Alle / Gearchiveerd.

3. Uniciteit van externe ID's, eigen identificatoren & bundelgroepering

Om dubbele pasuitgifte via webformulieren, kassaterminals en CRM-webhooks te voorkomen, configureert u identificatie- en bundelingsbeleid in de Sjablooninstellingen:

Instelling / modeleigenschapHandhaving in database & API
externalId (Pass.externalId)Door de aanroeper meegegeven string (max. 255 tekens) met unieke index per actieve, niet-verwijderde tenantpas (@@unique([customerId, externalId]) WHERE archivedAt IS NULL). Dubbele POST /api/v1/passes-aanroepen worden geweigerd, terwijl POST /api/v1/passes/upsert-by-external-id de bestaande pas direct bijwerkt.
Eigen identificatieregels (Template)Configureer customIdentifiersEnabled, externalIdentifierPattern en customIdentifierValidationPattern in de Sjablooninstellingen om organisatiebrede regex-patronen af te dwingen op gegenereerde/geïmporteerde externe identificatoren.
Groepering van meerdere kaarten (Pass.bundleId)Vreemde sleutel bundleId die tot 10 passen koppelt in één pass bundle (bundle grouping mode: AUTO \MANUAL) voor levering als .pkpasses.
Koppeling aan één apparaat (limitToOneActivePerPass)Beperkt slimme downloadlinks zodat één pas niet gelijktijdig kan worden gedeeld en geïnstalleerd op ongeautoriseerde apparaten.

Belangrijk: Het afdwingen van een unieke externalId wordt sterk aanbevolen voor loyaliteitskaarten, lidmaatschappen en prepaid cadeaukaarten. Het zacht verwijderen van een testpas (SOFT delete) vult archivedAt in en geeft die externalId onmiddellijk weer vrij voor hergebruik.


4. Gestructureerde JSON-attribuutindexering (attribute search index) & opgeslagen weergaven

Elke aangepaste eigenschap die in Pass.attributes wordt opgeslagen, wordt automatisch geïndexeerd door de Generalized Inverted Index van de database (attribute search index). Zo kunnen beheerders en API-gebruikers miljoenen passen organiseren en doorzoeken zonder schemamigraties:

  • Opgeslagen weergaven voor beheerders: Combineer in het overzicht Passen (/passes) EN/OF-filterpredicaten op status (passtatus), lifecycleStatus, walletVoidStatus (WalletPropagationStatus), bundleId, externalId, apparaatplatform (APPLE_WALLET versus GOOGLE_WALLET) en aangepaste JSON-sleutels (attributes.tier, attributes.storeId), en sla de zoekopdracht op als Opgeslagen weergave.
  • Projectoverstijgende sjabloonkoppeling: Groepeer verwante sjablonen in Wallet Experiences (PassProject) in plaats van losstaande sjablonen te blijven klonen. Eén enkel sjabloon kan als LINKED, VIP, CUSTOM of PRIVACY_MODE fungeren over meerdere PassProject-containers (PassProjectTemplateRole) met behoud van centraal beheer van assets en mechanieken.

API-referentie: sjablonen dupliceren & filteren

1. Een sjabloon dupliceren via de API (POST /api/v1/templates/:id/duplicate)

Kloont een bestaand sjabloon en neemt de indeling van velden, kleuren, barcodes en definities van aangepaste eigenschappen over:

POST /api/v1/templates/tmpl_01hxyz987654321/duplicate Headers: X-API-Key: <API_KEY> | Content-Type: application/json

JSON
{
  "name": "Artisan Coffee Club - Platinum Tier (Copy)",
  "duplicatePassFlow": true,
  "certificateId": "cert_01j7k8m9n2p3"
}

HTTP-respons (201 Created)

JSON
{
  "success": true,
  "data": {
    "id": "tmpl_new_clone_01h987",
    "name": "Artisan Coffee Club - Platinum Tier (Copy)",
    "kind": "storeCard",
    "status": "PUBLISHED",
    "versionNumber": 1,
    "rowKind": "PRODUCTION",
    "createdAt": "2026-11-16T21:20:00.000Z"
  },
  "statusCode": 201
}

2. Sjablonen filteren op status, pastype & tags

GET /api/v1/templates?rowKind=PRODUCTION&kind=storeCard&tag=retail&search=Coffee&page=1&limit=20
Headers
X-API-Key <API_KEY>
JSON
{
  "success": true,
  "data": {
    "items": [
      {
        "id": "tmpl_01hxyz987654321",
        "groupId": "grp_01hxyz987654321",
        "name": "Loyalty-CoffeeClub-EU-v2",
        "kind": "storeCard",
        "rowKind": "PRODUCTION",
        "status": "PUBLISHED",
        "versionNumber": 2,
        "tags": ["retail", "q4-2026", "dach"],
        "activePassesCount": 14820
      }
    ],
    "total": 1,
    "page": 1,
    "limit": 20
  },
  "statusCode": 200
}

Ontdek Projecten beheren om passen uit meerdere sjablonen samen te brengen, of lees Uw werkruimte begrijpen voor de regels rond multi-werkruimtetenancy.

Klaar om uw eerste kaartprogramma te lanceren?

Maak uw workspace aan, configureer uw sjabloon en test een echte kaart in Apple Wallet en Google Wallet voordat u opschaalt.