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
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
Vanuit het sjabloonoverzicht: Klik op een sjabloonkaart op het menu met de drie puntjes (...) en kies Dupliceren.
-
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
Stap 1: Bronsjabloon selecteren: Bevestigt het bronsjabloon en toont het pastype, het aantal velden en de gekoppelde afbeeldingen.
-
2
Stap 2: Naam & beschrijving: Vult de nieuwe sjabloonnaam vooraf in als
${sourceTemplate.name} (Copy)en laat u een eigen beschrijving invoeren. -
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.
-
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
Scheid omgevingen per werkruimte: Bewaar experimentele concepten en integratietests in een
sandbox-werkruimte en reserveer uwproduction-werkruimte uitsluitend voor live klantprogramma's. -
2
Standaardiseer sjabloonnamen & tags: Neem programmadomein, regio en versie op in sjabloontitels (bijvoorbeeld
Loyalty-CoffeeClub-EU-v2) en koppel gestructureerdetags(bijv.["retail", "q4-2026", "dach"]) voor directe filtering in de catalogus. -
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 / modeleigenschap | Handhaving 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
externalIdwordt sterk aanbevolen voor loyaliteitskaarten, lidmaatschappen en prepaid cadeaukaarten. Het zacht verwijderen van een testpas (SOFTdelete) vultarchivedAtin en geeft dieexternalIdonmiddellijk 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 opstatus(passtatus),lifecycleStatus,walletVoidStatus(WalletPropagationStatus),bundleId,externalId, apparaatplatform (APPLE_WALLETversusGOOGLE_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 alsLINKED,VIP,CUSTOMofPRIVACY_MODEfungeren over meerderePassProject-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
{
"name": "Artisan Coffee Club - Platinum Tier (Copy)",
"duplicatePassFlow": true,
"certificateId": "cert_01j7k8m9n2p3"
}
HTTP-respons (201 Created)
{
"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
/api/v1/templates?rowKind=PRODUCTION&kind=storeCard&tag=retail&search=Coffee&page=1&limit=20
{
"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.
