Parameters bekijken en maken
- Lango: Language and translation manager
Moeilijkheidsgraad: beginner
Leerdoelen
Na het lezen van dit artikel zul je in staat zijn om:
Parameters identificeren.
Weet waar parameters vandaan komen.
Nieuwe parameters maken.
Wat zijn parameters in Workplace?
Een parameter in Workplace is een variabele die wordt gebruikt om de waarde weer te geven die in het bijbehorende veld wordt weergegeven. Wanneer de waarde van een veld wordt bijgewerkt, wordt de parameter automatisch ook bijgewerkt. Parameters worden bijvoorbeeld gebruikt als dynamische invoer voor: sjablonen, formules en voor de e-mailbody bij het verzenden van workflow e-mails.
Voorbeelden van parameters zijn {referentie} en {voornaam}. In een e-mailsjabloon kan deze parameter worden gebruikt om de aanvrager van een reservering persoonlijk aan te spreken. Bijvoorbeeld:
Dear {firstname},
Reservation {reference} is confirmed by the serviceDesk.
The reservation can now be found on your personal login page.
Warm regards,
{nameofhost}
Welke parameters zijn beschikbaar op een pagina?
Om de parameters te bekijken die beschikbaar zijn op een instantie de pagina:
Open de pagina (bijvoorbeeld een reservering);
Navigeer naar de versnellingssymbool;
Klik op Parameters.
Er wordt nu een lijst weergegeven met alle parameters die beschikbaar zijn in de context van deze pagina.
De kolom "Parameter" toont de parameter die u kunt gebruiken in een sjabloon.
De kolom "waarde" toont de waarde die zal verschijnen wanneer de sjabloon wordt toegepast.
NB! Elke parameter is beschikbaar op de parameterpagina die begint met zowel een kleine letter als een hoofdletter.
Parameters die beginnen met een kleine letter gebruiken de waarde van de instantie.
Parameters met een hoofdletter gebruiken het label van het veld.
De parameterdefinitie bekijken
Parameters worden aangemaakt op de PDF-parameterpagina die gelinkt is aan de paginadefinitie van een pagina. Als er geen parameterpagina gekoppeld is aan de paginadefinitie, wordt de parameterpagina gekoppeld aan een bovenliggende pagina.
De gekoppelde pagina in het veld 'PDF-parameters' bevat de parameters
Als de PDF-parameterpagina inclusief is, zijn de parameters die op die inclusief zijn gedefinieerd ook beschikbaar.
Van welke pagina komt een parameter?
Wanneer u een nieuwe parameter maakt of een bestaande parameter bewerkt, is het aan te raden eerst op te zoeken waar de bestaande parameters zijn gedefinieerd. Dit hulpmiddel is vooral handig als parameters afkomstig zijn van meerdere pagina's.
Open de pagina (bijvoorbeeld een verzoek);
Navigeer naar de versnellingssymbool;
Klik op Parameters;
Wanneer u op de parameterpagina bent. Zoek naar de parameter met "ctrl+F";
"Zoek op achter welke "parms-groep" de parameter wordt weergegeven. Dit is de pagina waarop de parameters worden gedefinieerd.
In het voorbeeld komt de parameter 'area' van de pagina "ParametersGOBStandaardRequest".
De parms-groepen kunnen worden geërfd van een bovenliggende pagina.
De parameters komen van de gekoppelde PDF-parameterpagina.
veld op de PDF-parameterpagina.
velden op de inclusief gekoppeld aan de PDF-parameterpagina.
velden van rapporten die gekoppeld zijn aan de PDF-parameterpagina.
Een parameter maken - eenvoudig
Volg deze stappen om een parameter toe te voegen op de pagina Gekoppelde PDF-parameters van de instantie:
Navigeer naar de back-end van de instantiepagina met behulp van pagina definitie;
Open de gekoppelde PDF-parameterpagina;
Navigeer naar het tabblad Velden;
Een nieuw veld toevoegen aan de PDF-parameterpagina;
Vul het object en het veld in;
De parameter op de pagina zal gelijk zijn aan het oorspronkelijke 'Veldlabel';
Als echter het veld "Override label'' is ingevuld, wordt dat de naam van de parameter.
Een parameter maken - geavanceerd
Naast het toevoegen van een gewone parameter aan de parameterpagina, is het ook mogelijk om:
Wijzig de parameternaam, maar niet het veldlabel.
Voeg een vertaaltekenreeks toe als parameter. Dit is vooral handig bij het genereren van een (e-mail)sjabloon die vertaald moet worden op basis van de taal van de eindgebruiker.
Gebruik een parameter op basis van een formule. Dit wordt gebruikt wanneer de waarde van een parameter gebaseerd is op de berekening van andere velden op de pagina.
Houd er rekening mee dat voor het maken van parameters dezelfde logica voor velden geldt als bij het toevoegen van velden aan een instantiepagina. Dit betekent dat om de waarde van een parameter te bepalen, Workplace omhoog kijkt om te bepalen welke informatie van andere objecten moet worden getoond. Dit betekent ook dat je velden aan elkaar kunt koppelen als bijvoorbeeld de parameters voor een contact niet de informatie opleveren die je zou verwachten.
Wijzig de parameternaam, maar niet het veldlabel
Om unieke parameters te maken, kan het nodig zijn dat de parameternaam afwijkt van de labelnaam. Bijvoorbeeld als er twee contactpersonen op een pagina worden weergegeven.
Navigeer naar de back-end van de instantiepagina met behulp van pagina definitie;
Open de gekoppelde PDF-parameterpagina;
Navigeer naar het tabblad Velden;
Een nieuw veld toevoegen aan de PDF-parameterpagina;
Vul het object en het veld in;
Vul het veld 'Parameter
Een vertaalstringparameter genereren
Navigeer naar de back-end van de instantiepagina met behulp van pagina definitie;
Open de gekoppelde PDF-parameterpagina;
Navigeer naar het tabblad Velden;
Een nieuw veld toevoegen aan de PDF-parameterpagina;
Laat het object en het veld leeg;
Vul het parameterveld in;
Deze waarde wordt de parameter waarnaar u kunt verwijzen in uw sjabloon.
Vul een nieuwe vertaalstring in of maak deze in het veld "Overschrijven label";
De waarde in het opheffingslabel is de waarde die wordt gegenereerd wanneer naar de parameter wordt verwezen met een hoofdletter.
Gebruik een parameter op basis van een formule
Navigeer naar de back-end van de instantiepagina met behulp van pagina definitie;
Open de gekoppelde PDF-parameterpagina;
Navigeer naar het tabblad Velden;
Een nieuw veld toevoegen aan de PDF-parameterpagina;
Laat het object en het veld leeg;
Vul het formuleveld in. Gebruik de helptekst van dit veld om uw formule te configureren.
[We streven naar een artikel over het gebruik van formules in 2023].
Parameters van rapporten en inclusies toevoegen
Behalve dat ze kunnen worden toegevoegd als een veld op een PDF-parameterpagina, kunnen parameters ook afkomstig zijn van rapporten en inclusies die zijn gekoppeld aan de gekoppelde PDF-parameterpagina.
Om de rapporten en bijlagen te vinden die zijn gekoppeld aan de PDF-parameterpagina:
Navigeer naar de back-end van de instantiepagina met behulp van pagina definitie.
Open de gekoppelde PDF-parameterpagina.
De rapporten op de instantiepagina zijn beschikbaar onderaan de PDF-parameterpagina.
Samenvatting
Zoek op