Atynios ScriptX
Atynios har sitt eget enkla scriptspråk med tre olika familjer: STEP-steg, funktioner och fältreferenser.
STEP-steg
Används uteslutande vid import via IPS
- <<EVALUATE>>
- <<SCRIPT>>
- <<XML_XPATH>>
- <<XML_ARRAY_STRING>>
- <<XML_ARRAY_NUM>>
- <<JSON_GET>>
- <<JSON_ARRAY_STRING>>
- <<JSON_ARRAY_NUM>>
- <<JSON_ARRAY_OBJECT>>
- <<JSON_ARRAY_ARRAY>>
- <<SHIPPMENTDATE>>
- <<INSERT_FROM_URL>>
- <<ATYNIOS_SCRIPT>>
Funktioner
En funktion skrivs inom dubbla klammerparenteser, {{Namn}}, och argumenten skiljs åt med |, till exempel {{Namn|argument1|argument2}}. Argumenten kan innehålla fältreferenser och andra funktioner.
{{Instance}}
Återger instansens namn. Om ingen instans är satt används den första delen av filnamnet, fram till första _.
{{Instance}}
{{DateToday}}
Återger dagens datum.
{{DateToday}}
{{DateOffset}}
Återger ett datum som utgår från dagens datum justerat med <DATE_DIFF> dagar. Ange exempelvis 5 för att visa datumet 5 dagar framåt i tiden eller -1 för att ange gårdagens datum.
{{DateOffset|<DATE_DIFF>}}
Exempel: {{DateOffset|-1}} ger gårdagens datum.
{{Upper}}
Gör om en text till versaler.
{{Upper|<TEXT>}}
Exempel: {{Upper|[[TABELL::FÄLT]]}} återger fältets värde med versaler.
{{FormatWeight}}
Formaterar en vikt.
{{FormatWeight|<VALUE>|<INPUT_TYPE>|<OUTPUT_TYPE>|<DECIMALS>}}
{{JSON_Get}}
Hämtar ett värde ur den JSON som skickats med till scriptet. Sökvägen anges med punkt mellan nivåerna och index inom hakparenteser. Ett inledande $. är valfritt. Saknas värdet blir resultatet tomt.
{{JSON_Get|<JSON_PATH>}}
Exempel: {{JSON_Get|person.name}}, {{JSON_Get|person.phones[0].number}}
{{AtyniosID}}
Återger AtyniosID för den post som visas.
{{AtyniosID}}
{{If}}
Återger en av två texter beroende på ett villkor. Funktionen kan skrivas på två sätt.
Kort form – lika med:
{{If|<VÄNSTER>=<HÖGER>|<OM SANT>|<OM FALSKT>}}
Lång form – med operator:
{{If|<VÄNSTER>|<OPERATOR>|<HÖGER>|<OM SANT>|<OM FALSKT>}}
| Operator | Betydelse | |---|---| | = | lika med | | ≠ eller != | inte lika med | | > >= < <= | större än, större än eller lika med, mindre än, mindre än eller lika med (jämförs som tal) | | contains | vänster innehåller höger | | startswith | vänster börjar med höger | | endswith | vänster slutar med höger |
Exempel: {{If|[[TABELL::FÄLT]]|>|0|Finns i lager|Slut}}
{{List}}
Hämtar ett fält från alla relaterade poster och återger värdena som en lista, på samma sätt som FileMakers List ( ). Används i mallar som etiketter (ZPL), e-post och texter.
{{List|TABELL::FÄLT}}
{{List|TABELL::FÄLT|<NYCKEL>|<VÄRDE>|<NYCKEL>|<VÄRDE> ...}}
Första argumentet är fältreferensen (tabellförekomst och fält, med eller utan [[ ]]). Resten är tillval som skrivs parvis, nyckel och värde, i valfri ordning.
| Nyckel | Beskrivning | Standard | |---|---|---| | MaxLength | Kortar varje värde till angivet antal tecken. | Ingen kortning. Om nyckeln finns men värdet är tomt eller mindre än 1 blir det 25. | | Separator | Text mellan raderna. | Radbrytning | | Prefix | Text före varje rad. | Inget | | Suffix | Text efter varje rad. | Inget |
- Nycklarna är inte skiftlägeskänsliga, och okända nycklar ignoreras.
- Mellanslag i prefix, suffix och avgränsare behålls.
- MaxLength kortar bara själva värdet, inte prefix och suffix.
Exempel – enkel lista
{{List|PQU_WSC_WSM_ART::Common_Name}}
700x1000 CNCO_264705
700x1000 CNCO_264706
Exempel – kortade värden med punkt framför
{{List|PQU_WSC_WSM_ART::Common_Name|MaxLength|20|Prefix|• }}
• 700x1000 CNCO_2647
• 700x1000 CNCO_2647
Exempel – kommaseparerat på en rad
{{List|PQU_WSC_WSM_ART::Common_Name|Separator|, }}
700x1000 CNCO_264705, 700x1000 CNCO_264706
Exempel – ZPL-etikett med textblock (^FB)
I ZPL räknas en vanlig radbrytning inte som ny rad, så använd \& som avgränsare.
^FO225,180^FB560,12,10,L^A0N,26,24^FD{{List|PQU_WSC_WSM_ART::Common_Name|MaxLength|30|Separator|\&}}^FS
Bra att veta
- Högst 100 värden tas med. Tomma värden hoppas över.
- Fältreferensen måste innehålla exakt en
::och bara bokstäver, siffror och_, annars blir resultatet tomt. - Tecknet
|kan inte användas i ett värde, eftersom det skiljer argumenten åt. - En fältreferens i prefix eller suffix hämtar värdet från aktuell post, inte från varje listrad.
- Resultatet beror på vilken post mallen renderas från, eftersom relationen utgår därifrån.
Fältreferenser
Återger värdet i ett fält. Skrivs inom dubbla hakparenteser.
[[TABELL::FÄLT]]
Exempel: [[ART::PrimaryKey_AtyniosID]]