1. Support
  2. Knowledge Base
  3. Transacties
  4. Automatische variabelen

Automatische variabelen

We vernieuwen onze gebruikersinterface. Sommige informatie is nog niet aangepast. Lees meer.

Met Uptrends' controleregeltypes Transactie en Multi-Step API kunt u een stroom doorlopen die uit verschillende stappen bestaat, hetzij over een pagina op het web, hetzij door rechtstreeks met een API te communiceren. In sommige gevallen moet u mogelijk data van variabelen verstrekken. Een bepaald formulier in een van uw transacties vereist bijvoorbeeld een tijdstempel, of u moet een unieke ID genereren om in een van de API-requests te gebruiken. We ondersteunen een aantal automatische variabelen die wij voor u maken. De meeste zijn feitelijk functies die een waarde genereren die u in uw HTTP-requests kunt gebruiken of invullen in tekstvelden in uw transactiecontroleregels.

Generieke automatische variabelen

De volgende automatische variabelen zijn beschikbaar voor de controleregeltypes Transactie en Multi-Step API:

Datum en tijd

{{@DateTime(format,offset)}} : deze variabele genereert dynamische datum/tijd-waarden, in overeenstemming met het formaat dat u specificeert en met een optionele offset. De datum/tijd (zonder offset) is altijd de huidige tijd uitgedrukt in de UTC-standaard (gecoördineerde universele tijd).

Om de datum/tijd naar uw wensen op te maken, stelt u de parameter format in op:

  • een waarde die wordt ondersteund door .NET date-notatie, bijv. dd/MM/yyyy of MM/dd/yyyy
  • Iso, voor het formaat ISO 8601
  • Unix, voor Unix epoch time

De optionele offset parameter kan worden gebruikt om de datum/tijd opnieuw te berekenen op basis van een bepaald verschil (in seconden) of een datum/tijd-functie. Als u de offsetparameter weglaat, wordt er geen offset toegepast. Om de datum/tijd opnieuw te berekenen gebruikt u de volgende opties:

  • Stel de offset-parameter in op een positief of negatief aantal seconden. Het opgegeven aantal seconden wordt opgeteld bij of afgetrokken van de huidige datum/tijd-waarde. Een typisch gebruiksscenario is om de datum/tijd in een andere tijdzone te berekenen of om naar een andere dag voor of na de huidige datum/tijd te gaan.

    Zie de onderstaande tabel voor enkele voorbeelden.

  • Gebruik een datum/tijd-functie om de laatste of eerste dag van de huidige, vorige of volgende maand te berekenen ten opzichte van de opgegeven datum/tijd-waarde. De mogelijke waarden voor de offset zijn:

    • LastDayOfMonth
    • FirstDayOfMonth
    • LastDayOfPreviousMonth
    • FirstDayOfPreviousMonth
    • LastDayOfNextMonth
    • FirstDayOfNextMonth

De volgende tabel toont enkele voorbeelden, gebaseerd op het idee dat het nu 24 februari 2018 22:30 UTC is.

Expressie Waarde Beschrijving
{{@DateTime(dd-MM-yyyy HH:mm)}} 24-02-2018 22:30 Nu, in het formaat dd-MM-yyyy HH:mm
{{@DateTime(dd-MM-yyyy HH:mm),-18000}} 24-02-2018 17:30 Nu, in Eastern Standard Time (UTC-5)
{{@DateTime(ISO)}} 2018-02-24T22:30:00.0000000Z Nu, in het formaat ISO 8601
{{@DateTime(UNIX)}} 1519511400 Nu, in Unix epoch time
{{@DateTime(MM/dd/yyyy,-86400)}} 02/23/2018 Gisteren, in het formaat MM/dd/yyyy
{{@DateTime(MM/dd/yyyy,86400)}} 02/25/2018 Morgen, in het formaat MM/dd/yyyy
{{@DateTime(MM/dd/yyyy,FirstDayOfMonth)}} 02/01/2018 Eerste dag van deze maand, in het formaat MM/dd/yyyy
{{@DateTime(MM/dd/yyyy,LastDayOfMonth)}} 02/28/2018 Laatste dag van deze maand, in het formaat MM/dd/yyyy

Willekeurige unieke identifier

{{@RandomGuid}} : deze variabele produceert een willekeurige waarde in de vorm AB0AD14D-9611-41A8-9C25-7D94B895CFF1. U kunt deze variabele gebruiken als u een willekeurige waarde moet opnemen in uw URL, POST-data of HTTP-header. Gebruikt u de variabele @RandomGuid in meerdere stappen, dan krijgt elke stap een andere willekeurige waarde. Elke keer dat de controleregel wordt uitgevoerd, krijgt u volledig nieuwe willekeurige waarden.

Willekeurig geheel getal

{{@RandomInt(min,max)}} : deze variabele produceert een willekeurig geheel getal, tussen de minimum- en maximumwaarden die u opgeeft (min en max inbegrepen). Geeft u bijvoorbeeld {{@RandomInt(0,100}} op, dan produceert deze variabele een getal in het bereik 0..100.

Transactie-specifieke (legacy) variabelen

De volgende set automatische variabelen is ouder, maar kan nog steeds worden gebruikt. Deze variabelen zijn alleen beschikbaar voor Transactie-controleregels.

Tijdstempels

{timespan 0}{now dd-MM-yyyy} : om een tijdstempel te genereren en in te stellen (huidige datum) in een tekstveld op uw pagina.

{timespan 1:0:0:0}{now dd-MM-yyyy} : om de dag te verschuiven met 1 (morgen).

{timespan 0:1:0:0}{now dd-MM-yyyy} : hetzelfde als hierboven, maar dan verschuiven met 1 uur.

{timespan 0:0:1:0}{now dd-MM-yyyy} en {timespan 0:0:0:1}{now dd-MM-yyyy} : om de huidige tijd te verschuiven met respectievelijk één minuut of één seconde.

Willekeurige waarde uit een reeks

{random 1 2 3 4 5} : stel een willekeurige variabele in uit een reeks. Deze functie stelt een willekeurige waarde in van één tot vijf.

{random apple banana orange} : deze functie stelt een willekeurige string in uit de geselecteerde reeks: ofwel apple, banana of orange wordt ingesteld.

Multi-Step API-specifieke variabelen

De volgende variabelen en informatie zijn alleen van toepassing op het controleregeltype Multi-Step API.

{{@ServerId}} : tijdens de uitvoering van een Multi-step API-controleregel voert deze variabele een numerieke waarde uit die de locatie van het Uptrends-controlestation die deze controle uitvoert, identificeert. Als de controle bijvoorbeeld wordt uitgevoerd op ons controlestation in Sydney, Australië, wordt de variabele 30 uitgevoerd. De lijst met controlestationservers en hun corresponderende Server ID’s is middels de Uptrends API verkrijgbaar op het Controlestationservers-eindpunt.

{{@RedirectUrl}} : in het geval dat een van de stappen in uw controleregel naar verwachting een redirect code retourneert en u die redirect respons wilt vastleggen en testen in plaats van deze automatisch te volgen, zal deze automatische variabele de URL bevatten waarnaar de redirect verwijst. Dit gebeurt alleen als u ervoor kiest om niet automatisch redirects te volgen, maar een Assertion instelt die controleert op de juiste redirectcode. Deze procedure wordt hier gedetailleerder uitgelegd: Multi-step monitoring - redirects verwerken.

Een automatisch gegenereerde waarde meerdere keren gebruiken

Sommige van deze variabele functies (met name de functies die willekeurige en datum/tijd-variabelen produceren) worden telkens wanneer u ze gebruikt opnieuw beoordeeld en zullen elke keer een nieuwe waarde genereren. Als u een bepaalde waarde wilt genereren en deze meerdere keren wilt gebruiken in uw meerstapsscenario, kunt u een voorgedefinieerde variabele definiëren (zoals besproken in het artikel Variabelen bij Multi-step monitoring) en een automatische variabele gebruiken als zijn waarde.

Voorbeelden van voorgedefinieerde waarden waarbij automatische variabelen worden gebruikt

Naam Waarde Gebruik
SearchDate {{@DateTime(dd-MM-yyyy)}} Gebruik een datumwaarde als input voor een zoekopdracht.
UniqueEmail {{@RandomGuid}}@mycompany.com Gebruik een willekeurige guid-waarde in combinatie met vaste tekst om een e-mailadres te genereren dat elke keer anders is.
OrderAmount {{@RandomInt(1, 10)}} Gebruik een willekeurig getal tussen 1 en 10 als het aantal te bestellen producten. In een volgende call kunt u deze variabele opnieuw gebruiken om de inhoud van een winkelwagen te controleren en te kijken of deze inderdaad de bestelde hoeveelheid bevat.
Door deze website te gebruiken, stemt u in met het gebruik van cookies in overeenstemming met ons Cookiebeleid.