Log ind

nShift Help Center

Brug af Custom Operations opsætningselementet

Avatar
Malene Tidemann
Opdateret

ship-label.png on-premises-label.png


Custom Operations opsætningselementet gør det muligt at oprette udtryk uden at skulle oprette en Shipping rules-fil. Du kan inkludere de udtryk, der understøttes i Shipping Rules <expressions>-noden. Se beskrivelsen af Shipping Rules-noder her.

 

Tilføjelse af setup-elementet

  1. Gå til Setup og naviger til den Location/Actor i din installation, hvor du ønsker, at udtryk skal fungere.
     
  2. Højreklik i panelet til højre og vælg New > Custom Operations.

    custom-operations.png
     
  3. Vælg typen af operation og klik på New. Der findes 5 forskellige typer operationer:
    1. Expressions when reading request - udtrykket køres efter, at shipment JSON er blevet parsed.
    2. Expressions at submit - udtrykket køres ved submit, dvs. når en forsendelse oprettes.
    3. Expressions at transmit - udtrykket køres ved transmit, dvs. når EDI sendes til transportøren.
    4. Expression at validation - udtrykket køres sammen med andre valideringer.
    5. Patch Options for API - angiv standardværdier for Option-parameteren for Shipment Server. (Ikke relevant for On-premises-kunder).
    6. Patch Data for API - erstat værdier, angiv en delimiter osv. (Ikke relevant for On-premises-kunder).

      customoperationsform.png
       
  4. Tilføj udtrykket/koden i feltet. Hvis du opretter en ny XML-fil, skal du tilføje dit udtryk i den foruddefinerede <Expressions>-node. 

    expressions-box.PNG
     
  5. Klik på OK for at gemme.

 

 

Eksempler

Expressions

Dette udtryk sætter en standardværdi på 15:00 i Pickup start-feltet, hvis det aktuelle tidspunkt (når udtrykket køres, afhængigt af operationstypen) er mindre end 14:00. Hvis du ønsker, at udtrykket kun skal køre for en specifik transportør, er det vigtigt at angive dette. (Bemærk: denne funktion virker ikke med custom carriers.) 

Du kan bruge udtryk, der understøttes i Shipping Rules <expressions>-noden. Se beskrivelsen af Shipping Rules-noder her. 

 

<Expression targetfield="fld_RefPickupStart">
<!-- if(currenttime less than 14:00) today 15:00     -->
<Condition name="intlimits" field="fld_SubcarrierConceptID" min="448" max="448" />
<Condition name="timelimits" field="fld_Now" min="00:00" max="14:00"/>
<Item special="datenow" format="YYYY-MM-DD"/>
<Item expression=" "/>
<Item expression="15:00:00"/>
</Expression>
<Expression targetfield="fld_RefPickupStart">
<!-- if(currenttime more than 14:00) today(+1) 15:00     -->
<Item special="datenow" adddays="1" format="YYYY-MM-DD"/>
<Item expression=" "/>
<Item expression="15:00:00"/>
</Expression>

 

 

SSOptions.ini

I dette eksempel er postnummer-validering slået fra for PreAdviseOrder, og labels er sat til ZPLGK.

[PreAdviseOrder]
ValidatePostCode=0

[SubmitOrder]
Labels=ZPLGK

Patch options-filen følger dette format:

[<MethodName>]

<Param Name]=[Param Value]

Hvis parameteren findes i kaldet, ændres den ikke. Den tilføjes kun, hvis den ikke er inkluderet.

 

 

SSData.ini

I dette eksempel er delimiter sat til standard |, og fire strenge erstattes for PreAdviseOrder.

[PreAdviseOrder]
Delimeter=|
1="Name2"|"Street2"|
2="Kind": 176,|"Kind": 177,
3="Kind": 176,|"Kind": 177,
4="Kind": 176,|"Kind": 177,

Patch data-filen følger dette format:

[<MethodName>]

<n>=<OldValue><NewValue>

n er et tal, der starter med 1. Hvis der er huller i nummereringen, ignoreres værdier efter hullet.

OldValue er strengen, der skal erstattes, og NewValue er strengen, der erstatter den gamle værdi.

 

Bemærk

Hvis en konfiguration er lavet på en måde, hvor både Custom Operations og Shipping Rules målretter det samme felt, vil værdien fra Shipping Rules blive anvendt sidst og kan overskrive den værdi, der tidligere er sat af Custom Operations.

Relaterede artikler