Voimassa alkaen: Opter 2024.06.00, Opter Driver iOS:lle 2.4.3, Opter Driver Labs Androidille 2.4.3

Ehdot: App.OpterDriver.Design

Ehtoja käytetään näyttämään tietty teksti sovelluksessa sen perusteella, onko tilauksessa tiettyjä tietoja, esimerkiksi "näytä lähettäjän puhelinnumero, jos se on tilauksessa". Jos sitä ei ole, sovelluksessa ei näytetä mitään. Näin voit välttää hämmennystä aiheuttavien tyhjien kenttien näkymisen sovelluksessa, esimerkiksi "Puhelin: ".

Esimerkkejä siitä, miten ehtoja käytetään omassa asiayhteydessään, löytyy oletusmuotoisena kohdasta App.OpterDriver.Design 2023.12.00 ja 2024.06.00. Tässä artikkelissa tarkastelemme tiettyjä esimerkkejä.

Syntaksi

Ehdon asettamiseen käytetään condition-määritettä item-tunnisteessa. Useimmiten tiedot halutaan näyttää sovelluksessa, jos ne ovat tilauksessa. Tämä tarkoittaa sitä, että samaa tunnistetta käytetään yleensä sekä ehdolle että näytettäville tiedoille, ja niitä täydentää selittävä teksti. Esimerkkejä ovat ENTRECODE ja PACKAGECOUNT alla.

Esimerkki 1: Näytä teksti "Ovikoodi: <xxxx>", jos tilauksessa on lähettäjän osoitteen porttikoodi. $Design_PortCode hakee tekstin "Ovikoodi" (katso Tunnisteet tiedostossa App.OpterDriver.Design).

1
2
3
<row>
    <item itemname="'$Design_PortCode',': ',ENTRECODEFROM" condition="ENTRECODEFROM != " width="100"/>
</row>

Esimerkki 2: Näytä teksti "Kollien määrä: <xx>", jos tilauksessa on vähintään yksi kolli. $Design_PackageCount hakee tekstin ”Kollien määrä” (katso Tunnisteet tiedostossa App.OpterDriver.Design).

1
2
3
<row>
    <item itemname="'$Design_PackageCount',': ',PACKAGECOUNT" condition="PACKAGECOUNT &gt; 0" width="100" font="LARGEBOLD" />
</row>

Useita ehtoja samalla rivillä

Samalla rivillä voi olla yksi tai useampi ehto. "+" (plusmerkki) ja "," (pilkku) tarkoittavat "ja", ja "|" (pystyviiva) tarkoittaa "tai".

• Rivi 2: Näytä teksti "Huomio! Tarkista tilauksen lisävalinnat", jos tilauksessa on jokin lisävalinnoista koodilla "V" tai "L". DELIVERYOPTIONS on luettelo lisävalintojen koodeista.

• Rivi 5: Näytä teksti ”Lisävalinta: jäähdytys ja nokkakärry”. jos tilauksella on lisävalinnat ”Jäähdytys” ja ”Nokkakärry”. DELIVERYOPTIONNAMES on luettelo lisävalintojen nimistä.

DELIVERYOPTIONS ja DELIVERYOPTIONNAMES ovat luettelot lisävalintojen koodeista ja nimistä. Niitä ei voi käyttää sovelluksessa tunnisteina lisävalinnan koodin tai nimen näyttämiseen. Näin ollen, jos ehto on ”tai”, kuten alla olevan esimerkin rivillä 2, ei voida tekstiä näytettäessä tietää, kumpi lisävalinnoista on tilauksessa, tai ovatko ne molemmat.

1
2
3
4
5
6
<row>
    <item itemname="'Huomio! Tarkista tilauksen lisävalinnat'" condition="DELIVERYOPTIONS : V | DELIVERYOPTIONS : L " />
</row>
<row>
    <item itemname="'Lisävalinta: jäähdytys ja nokkakärry'" condition="DELIVERYOPTIONNAMES : Jäähdytys , DELIVERYOPTIONNAMES : Nokkakärry " />
</row>

Ehdot erityyppisille tiedoille

Tilauksissa on neljä erilaista tietotyyppiä, joita voit käyttää ehtoina:

• Numeeriset arvot (esim. jos tilauksessa on tietty numero).

• Aika (esim. jos tilauksessa on ilmoitettu viimeisin toimitusaika).

• Kentän teksti (esim. jos asiakasviite sisältää sanan ”John”).

• Asetukset käytössä / ei käytössä (esim. jos Hyväksy toimitus vaikka et ole kotona on valittuna/ei ole valittuna tilauksessa).

Koska App.OpterDriver.Design on XML-tiedosto, merkit ”<” ja ”>” on kirjoitettava muodossa &lt; ja &gt; ehtoihin. Merkkien "<" ja ">" käyttö ei ole mahdollista.

Numeerisia arvoja ja aikaa koskevat ehdot

Esimerkki 4: Näytä teksti "Tilausnumero: <Tilausnumero>" riippuen siitä, mikä tilausnumero on. $Design_OrderNumber hakee tekstin "Tilausnumero" (katso Tunnisteet tiedostossa App.OpterDriver.Design).

• Rivi 2: Näyttää aina tekstin riippumatta siitä, mikä tilausnumero on. Ehdossa käytetään ehtoa "ei yhtä kuin”, jota ei seuraa mikään.

• Rivi 5: Näyttää tekstin, jos tilausnumero ei ole 116. Jos tilausnumero on 116, tekstiä ei näytetä lainkaan.

• Rivi 8: Näyttää tekstin, jos tilausnumero on täsmälleen 116. Jos tilausnumero on jotain muuta kuin 116, tekstiä ei näytetä lainkaan.

• Rivi 11: Näyttää tekstin, jos tilausnumero on suurempi kuin 116. Jos tilausnumero on 1–116, tekstiä ei näytetä lainkaan.

• Rivi 14: Näyttää tekstin, jos tilausnumero on pienempi kuin 116. Jos tilausnumero on 116 tai suurempi, tekstiä ei näytetä lainkaan.

• Rivi 17: Näyttää tekstin, jos tilausnumero on 116 tai suurempi. Jos tilausnumero on 1–115, tekstiä ei näytetä lainkaan.

• Rivi 20:  Näyttää tekstin, jos tilausnumero on 116 tai pienempi. Jos tilausnumero on 117 tai suurempi, tekstiä ei näytetä lainkaan.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
<row>
    <item itemname="'$Design_OrderNumber',': ',ORDERID" condition="ORDERID != " />
</row>
<row>
    <item itemname="'$Design_OrderNumber',': ',ORDERID" condition="ORDERID != 116" />
</row>
<row>
    <item itemname="'$Design_OrderNumber',': ',ORDERID" condition="ORDERID = 116" />
</row>
<row>
    <item itemname="'$Design_OrderNumber',': ',ORDERID" condition="ORDERID &gt; 116" />
</row>
<row>
    <item itemname="'$Design_OrderNumber',': ',ORDERID" condition="ORDERID &lt; 116" />
</row>
<row>
    <item itemname="'$Design_OrderNumber',': ',ORDERID" condition="ORDERID &gt;= 116" />
</row>
<row>
    <item itemname="'$Design_OrderNumber',': ',ORDERID" condition="ORDERID &lt;= 116" />
</row>

Esimerkki 5: Näyttää tekstin Toimitusaika (viimeistään): <päivämäärä ja/tai kellonaika> riippuen tilauksen sisältämistä tiedoista. Vastaavat tunnisteet on olemassa varhaisimmalle noutoajankohdalle, esimerkiksi EARLIESTPICKUPTIME ja EARLIESTPICKUPDATE. $Design_Delivery hakee tekstin "Toimitus" (katso Tunnisteet tiedostossa App.OpterDriver.Design).

• Rivi 2: Näyttää tekstin, jos tilauksessa on myöhäisin toimituspäivä tai myöhäisin toimitusaika. Jos molemmat ovat mukana, ne näytetään välilyönnillä erotettuna.

• Rivi 5: Näyttää tekstin, jos myöhäisin toimitusaika on 12:01 tai myöhemmin. Jos myöhäisin toimitusaika on 12:00 tai aikaisemmin, tekstiä ei näytetä lainkaan.

• Rivi 8: Näyttää tekstin, jos myöhäisin toimitusaika on 11:59 tai aiemmin. Jos myöhäisin toimitusaika on 12:00 tai myöhemmin, tekstiä ei näytetä lainkaan.

• Rivi 11: Näyttää tekstin, jos myöhäisin toimitusaika on 12:00 tai myöhemmin. Jos myöhäisin toimitusaika on 11:59 tai aikaisemmin, tekstiä ei näytetä lainkaan.

• Rivi 14: Näyttää tekstin, jos myöhäisin toimitusaika on 12:00 tai aiemmin. Jos myöhäisin toimitusaika on 12:01 tai myöhemmin, tekstiä ei näytetä lainkaan.

• Rivi 17: Näyttää tekstin, jos tilauksessa on arvioitu toimituspäivä tai arvioitu toimitusaika.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
<row>
    <item itemname="'$Design_Delivery',': ',LATESTDELIVERYDATE,' ',LATESTDELIVERYTIME" condition="LATESTDELIVERYDATE != | LATESTDELIVERYTIME != " />
</row>
<row>
    <item itemname="'$Design_Delivery',': ',LATESTDELIVERYTIME" condition="LATESTDELIVERYTIME &gt; 12:00" />
</row>
<row>
    <item itemname="'$Design_Delivery',': ',LATESTDELIVERYTIME" condition="LATESTDELIVERYTIME &lt; 12:00" />
</row>
<row>
    <item itemname="'$Design_Delivery',': ',LATESTDELIVERYTIME" condition="LATESTDELIVERYTIME &gt;= 12:00" />
</row>
<row>
    <item itemname="'$Design_Delivery',': ',LATESTDELIVERYTIME" condition="LATESTDELIVERYTIME &lt;= 12:00" />
</row>
<row>
    <item itemname="'$Design_Delivery',': ',ESTIMATEDDELIVERYDATE,' ',ESTIMATEDDELIVERYTIME" condition="ESTIMATEDDELIVERYDATE != | ESTIMATEDDELIVERYTIME != " />
</row>

Tekstiä koskevat ehdot

Esimerkki 6: Näyttää tekstin "Asiakkaan yhteyshenkilö: <nimi>" asiakkaan viitteen mukaan. $Design_CustomerContact hakee tekstin "Asiakkaan yhteyshenkilö" (ks. Tunnisteet tiedostossa App.OpterDriver.Design).

• Rivi 2: Näyttää aina tekstin, jos tilauksessa on asiakasviite. Ehdossa käytetään ehtoa "ei yhtä kuin”, jota ei seuraa mikään.

• Rivi 5: Näyttää tekstin vain, jos asiakasviitteen nimi on "John Stattin".

• Rivi 8: Näyttää tekstin, jos asiakasviite sisältää tekstin "john". Teksti näytetään myös, jos sukunimi sisältää sanan "john", esimerkiksi "Brian Johnson". Ehto ei erota isoja ja pieniä kirjaimia. Sovelluksessa näkyy koko nimi, ei vain se osa, jota ehto koskee.

1
2
3
4
5
6
7
8
9
<row>
    <item itemname="'$Design_CustomerContact',':',CUSTOMERREFERENCE" condition="CUSTOMERREFERENCE != " />
</row>
<row>
    <item itemname=="'$Design_CustomerContact',':',CUSTOMERREFERENCE" condition="CUSTOMERREFERENCE = John Stattin" />
</row>
<row>
    <item itemname=="'$Design_CustomerContact',':',CUSTOMERREFERENCE" condition="CUSTOMERREFERENCE : John" />
</row>

Ehdot asetusten määrittämiseen käyttöön ja käytöstä pois

Esimerkki 7: Näyttää eri tekstit sen mukaan, onko valintaruutu Hyväksy toimitus vaikka et ole kotona valittuna vai ei.

• Rivi 2: Näyttää tekstin "Jätä ovelle, jos ketään ei ole kotona", jos Hyväksy toimitus vaikka et ole kotona on merkitty tilaukseen.

• Rivi 5: Näyttää tekstin "Palauta terminaaliin, jos ketään ei ole kotona", jos kohtaa Hyväksy toimitus vaikka et ole kotona ei ole merkitty tilaukseen.

1
2
3
4
5
6
<row>
    <item itemname="'Jätä ovelle, jos ketään ei ole kotona'" condition="ALLOWDELIVERYNOTHOME = true" />
</row>
<row>
    <item itemname="'Palauta terminaaliin, jos ketään ei ole kotona'" condition="ALLOWDELIVERYNOTHOME = false" />
</row>