DOCS

Managing rules

/

Geavanceerde regels

KOMT BINNENKORT

Zonos ondersteunt geavanceerde aanpassing van hoe berekeningen plaatsvinden in uw account door het gebruik van regels. Regels kunnen worden gebruikt om buffers toe te voegen aan verschillende delen van de berekening, vergoedingen aan te passen, en meer. Voor een volledige uitleg van hoe Zonos regels behandelt, inclusief een lijst van alle mogelijke regeltypes, zie ons document over regels. Regels kunnen worden beheerd via Zonos Dashboard of via de GraphQL API.

Belangrijk: Regels zijn een geavanceerde functie, en verkeerd gebruik kan een verscheidenheid aan onbedoelde gevolgen hebben voor hoe Zonos zich gedraagt en berekent voor u.

Bekijk regels

Dashboard
GraphQL

Om regels binnen het Dashboard te beheren:

  1. Log in op uw Zonos Dashboard account.
  2. Navigeer naar Instellingen -> Regels.

Op de pagina “Regels” kunt u alle regels bekijken die aan uw Zonos account zijn gekoppeld, regels filteren en snel regels in- of uitschakelen.

Regels aanmaken

Dashboard
GraphQL

Om een nieuwe regel binnen het Dashboard aan te maken:

  1. Log in op uw Zonos Dashboard account.
  2. Navigeer naar Instellingen -> regels.
  3. Klik op Regel aanmaken.
  4. Voeg een naam toe aan uw regel zodat u deze later kunt identificeren. Deze zijn alleen zichtbaar voor teamleden in uw organisatie.
  5. Volg de stappen in de sectie “Specificeer regelvoorwaarde” hieronder om een voorwaarde aan uw regel toe te voegen.
  6. Volg de stappen in de sectie “Specificeer regelactie” hieronder om een actie aan uw regel toe te voegen.
  7. Optioneel kunt u een opmerking toevoegen voor extra context. Deze zijn alleen zichtbaar voor teamleden in uw organisatie.
  8. Volg de onderstaande stappen om een specifieke start- en/of einddatum voor uw regel toe te voegen (optioneel).
  9. Stel uw regel in op Ingeschakeld of Uitgeschakeld.
  10. Klik op Opslaan.

Specificeer start- en einddata

Regels kunnen optioneel een startdatum, een einddatum of beide hebben. Start- en einddata bepalen wanneer en hoe uw regel actief wordt en kunnen worden gebruikt om regels te creëren die alleen actief zijn voor specifieke periodes, zoals seizoensgebonden kortingen of andere tijdgevoelige situaties.

Gedrag van de regel

DataGedrag
Start- en einddatumRegel is actief tussen de opgegeven start- en einddatum.
Alleen een startdatum, geen einddatumRegel wordt actief na de opgegeven startdatum en moet handmatig worden uitgeschakeld.
Geen start- of einddatumRegel is altijd actief, tenzij handmatig uitgeschakeld.

Specificeer regelvoorwaarde

Elke regel vereist dat een voorwaarde wordt gespecificeerd om te bepalen waar deze op van toepassing is en welke variabelen beschikbaar zijn op het moment dat de regel wordt uitgevoerd. Met andere woorden, de voorwaarde bepaalt of de regel überhaupt moet worden uitgevoerd en wanneer. Verschillende voorwaarden hebben verschillende opties beschikbaar.

Als u bijvoorbeeld “Verzendcarrier” als voorwaarde kiest, kunt u bovendien selecteren welke carrier deel uitmaakt van de voorwaarde, wat u zou kunnen gebruiken als u een buffer instelt voor alleen een specifieke carrier.

Regels ondersteunen slechts één voorwaarde per regel en ondersteunen geen complexe logica zoals “anders als”, “en/of” of vergelijkbare termen. Als u regels wilt koppelen, is het het beste om na te denken over hoe u dezelfde logica met meerdere regels kunt bereiken in plaats van met één grote, complexe regel.

Specificeer regelactie

De actie van een regel is wat er gebeurt zodra aan de voorwaarde is voldaan. Net als bij voorwaarden zijn er verschillende acties mogelijk, elk met verschillende opties.

Als u bijvoorbeeld een buffer wilt toevoegen voor alleen een specifieke verzendcarrier, zou u de actie instellen op “een buffer toepassen” en het bedrag van uw buffer en waar deze op van toepassing is invoeren. U kunt vervolgens precies bepalen op welke carrier de buffer van toepassing is door dat in de voorwaarde van de regel op te geven.

Net als bij voorwaarden ondersteunen regels slechts één actie per regel. Als u meerdere acties wilt, is het het beste om na te denken over hoe u dezelfde logica met meerdere regels kunt bereiken in plaats van met één grote, complexe regel.

Update regels

Het is niet mogelijk om regels die van kracht zijn bij te werken met hoe ons systeem werkt. Dit komt omdat we een traceerbare geschiedenis moeten bijhouden van welke regels in welke situaties zijn toegepast en wat de regel deed toen deze werd uitgevoerd. Als alternatief kunt u een regel archiveren en opnieuw creëren, waarbij u de gewijzigde waarden doorgeeft, waardoor u effectief een "update" van de regel bereikt.

Dit voorbeeld van een mutatie toont aan hoe u de ruleArchive en ruleCreate mutaties kunt combineren om dit gedrag te bereiken:

Mutatie

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
mutation ruleUpdate(
  $ruleId: ID!
  $action: String!
  $condition: String!
  $context: String!
  $description: String!
  $name: String!
) {
  ruleArchive(id: $ruleId)
  ruleCreate(
    input: {
      action: $action
      condition: $condition
      context: $context
      name: $name
      description: $description
    }
  ) {
    id
    action
    context
    condition
  }
}

Variabelen

1
2
3
4
5
6
7
8
{
  "ruleId": "rule_935ee1ca-0c4d-4147-826a-1cb0894d9f43",
  "action": "amount = amount + 5 % amount",
  "condition": "ship_to_country == CA",
  "context": "SHIPMENT_RATING_BUFFER",
  "description": "test",
  "name": "test"
}

Archiveregels

Dashboard
GraphQL

Zodra regels zijn toegevoegd, kunnen ze eenvoudig worden in- of uitgeschakeld om te bepalen of ze invloed moeten hebben op uw berekeningen. Het handmatig in- of uitschakelen van een regel overschrijft elke logica op basis van start- en einddatums die in de regel is opgenomen.

Regels kunnen één voor één worden in- of uitgeschakeld vanuit de “Bewerk een regel” screen, of in bulk door de selectievakjes naast elke regel op het “Alle regels” screen te gebruiken.

Lijst alle mogelijke regelcontexten

We bieden enkele globale queries voor het omgaan met regels die nuttig zijn voor het ontdekken hoe regels werken, het creëren van UIs bovenop regels, enz. Deze zijn van toepassing op alle gebruikers, zijn niet organisatie-specifiek en worden aangeboden voor gemak. Deze query retourneert een lijst van alle mogelijke contexten waartoe regels kunnen behoren. Een regelcontext bepaalt wanneer een regel wordt uitgevoerd en welke variabelen beschikbaar zijn.

Query

1
2
3
4
5
6
7
8
9
10
query {
  ruleContexts {
    name
    context
    variables {
      ruleTokenType
      value
    }
  }
}

Antwoord

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
{
  "data": {
    "ruleContexts": [
      {
        "name": "SHIPMENT_RATING_BUFFER",
        "context": "buffer",
        "variables": [
          {
            "ruleTokenType": "MONEY",
            "value": "amount"
          },
          {
            "ruleTokenType": "NUMBER",
            "value": "item_count"
          },
          {
            "ruleTokenType": "MONEY",
            "value": "items_total"
          },
          {
            "ruleTokenType": "COUNTRY",
            "value": "ship_from_country"
          },
          {
            "ruleTokenType": "COUNTRY",
            "value": "ship_to_country"
          },
          {
            "ruleTokenType": "WEIGHT",
            "value": "weight"
          },
          {
            "ruleTokenType": "STRING",
            "value": "service_level"
          },
          {
            "ruleTokenType": "STRING",
            "value": "carrier"
          }
        ]
      }
    ]
  }
}

Was deze pagina nuttig?