Exempel på JavaScript-kod i arbetsflöden javascript-in-workflows

I följande exempel visas hur du kan använda JavaScript-kod i ett arbetsflöde:

Läs mer om statiska och icke-statiska SOAP.

I dessa exempel används tillägget ECMAScript för XML (E4X). Med det här tillägget kan du kombinera JavaScript-samtal och XML-primitiver i samma skript.

Följ de här stegen för att testa de här exemplen:

Exempel 1: skriv till databasen write-example

Om du vill skriva till databasen kan du använda den statiska metoden Write i xtk:session-schemat:

Steg 1: skapa en skrivbegäran

Du kan lägga till, uppdatera och ta bort poster.

Infoga en post

Eftersom åtgärden insert är standardåtgärden behöver du inte ange den.

Ange den här informationen som XML-attribut:

Exempel:

var myXML = <recipient xtkschema="nms:recipient"
    firstName="Isabel"
    lastName="Garcia"
    email="isabel.garcia@mycompany.com"/>

Uppdatera en post

Använd åtgärden _update. Läs mer.

Ange den här informationen som XML-attribut:

Exempel:

var myXML = <recipient xtkschema="nms:recipient"
    status="Client"
    email="isabel.garcia@mycompany.com"
    operation="_update"
    _key="@email"/>

Ta bort en post

Använd metoden DeleteCollection. Läs mer.

Ange den här informationen:

Exempel:

xtk.session.DeleteCollection(
    "nms:recipient",
    <where>
        <condition expr="[@email] = 'isabel.garcia@mycompany.com'"/>
    </where>,
    false
    )

Steg 2: skriv posten

Anropa den icke-statiska Write-metoden i xtk:session-schemat:

xtk.session.Write(myXML)

Inget värde returneras för metoden.

Lägg till den fullständiga koden i en JavaScript-kodsaktivitet i arbetsflödet:

var myXML = <recipient xtkschema="nms:recipient"
    firstName="Isabel"
    lastName="Garcia"
    email="isabel.garcia@mycompany.com"/>

xtk.session.Write(myXML)

I den här videon visas hur du skriver till databasen:

Exempel 2: fråga databasen read-example

Om du vill fråga databasen kan du använda den icke-statiska instansmetoden xtk:queryDef:

Steg 1: skapa en fråga

Ange XML-koden för en queryDef-entitet.

Syntax:

<queryDef schema="nms:recipient" operation="">
    <!-- select, where, and orderBy clauses as XML elements -->
</queryDef>

Ange den här informationen:

Du kan använda följande åtgärder:

Skriv select-, where- och orderBy-satserna som XML-element:

Steg 2: skapa ett frågeobjekt

Om du vill skapa en entitet från XML-koden använder du metoden create(content):

var query = xtk.queryDef.create(
    <queryDef schema="nms:recipient" operation="select">
    …
    </queryDef>)

Prefix the create(content) method with the schema of the entity to be created.

Argumentet content är ett strängargument och är valfritt. Det här argumentet innehåller XML-koden som beskriver entiteten.

Steg 3: kör frågan

Följ de här stegen:

Resultat av en select-åtgärd

Alla matchningar returneras som en samling:

<recipient-collection>
    <recipient email="jane.smith@mycompany.com">
    <recipient email="john.harris@mycompany.com">
</recipient-collection>

Använd for each-slingan om du vill iterera igenom resultaten:

for each (var rcp in res:recipient)
    logInfo(rcp.@email)

Slingan innehåller en lokal mottagarvariabel. För varje mottagare som returneras i mottagarsamlingen skrivs mottagarens e-post ut. Läs mer om funktionen logInfo.

Resultat av en getIfExists-åtgärd

Varje matchning returneras som ett element:

<recipient id="52,378,079">

Om det inte finns någon matchning returneras ett tomt element:

<recipient/>

Du kan referera till den primära nyckelnoden, till exempel attributet @id:

if (res.@id !=undefined)
    { // match was found
    …
    }

Resultat av en get-åtgärd

En matchning returneras som ett element:

<recipient id="52,378,079">

Om det inte finns någon matchning returneras ett fel.

Resultat av en count-åtgärd

Ett element med attributet count returneras:

<recipient count="200">

Se attributet @count om du vill använda resultatet:

if (res.@count > 0)
    { // matches were found
    …
    }

För åtgärden select lägger du till den här koden i en JavaScript-kodsaktivitet i arbetsflödet:

var myXML =
<queryDef schema="nms:recipient" operation="select">
    <select>
        <node expr="@firstName"/>
        <node expr="@lastName"/>
    </select>
</queryDef>

var query = xtk.queryDef.create(myXML)

var res = query.ExecuteQuery()

for each (var rcp in res.recipient)
    logInfo(rcp.@firstName + " " + rcp.@lastName)

Eftersom åtgärden select är standardåtgärden behöver du inte ange den.

I den här videon visas hur du läser från databasen:

Utlösa ett arbetsflöde trigger-example

Du kan starta arbetsflöden programmatiskt, till exempel i tekniska arbetsflöden eller för att bearbeta information som en användare har angett på en webbprogramsida.

Arbetsflöde som utlöser arbete genom användning av händelser. Du kan använda dessa funktioner för händelser:

Du kan utlösa arbetsflöden på olika sätt:

Syntax för metoden PostEvent:

PostEvent(
    String     //ID of the target workflow
    String     //Name of the target activity
    String     //Name of the transition to be activated in case of multiple transitions
    XML        //Event parameters, in the <variables/> element
    Boolean    //To trigger the target workflow only once, set this parameter to true.
)

I det här exemplet skickas en kort text till signal-aktiviteten för arbetsflödet wkfExampleReceiver när arbetsflödet har slutförts:

var strLabel = "Adobe Campaign, Marketing that delivers"
xtk.workflow.PostEvent(
    "wkfExampleReceiver",
    "signal",
    "",
    <variables strLine={strLabel}/>,
    false)

Eftersom den sista parametern är inställd på false aktiveras arbetsflödet wkfExampleReceiver varje gång det inledande arbetsflödet slutförs.

Tänk på följande när du utlöser arbetsflöden:

I den här videon visas hur du använder statiska API-metoder:

I den här videon visas hur du utlöser arbetsflöden:

Interagera med databasen interact-example

I följande exempel visas hur du utför dessa åtgärder:

Följ de här stegen:

Syntax för metoden queryDef med en select-sats

<queryDef schema="schema_key" operation="operation_type">
    <select>
        <node expr="expression1">
        <node sql="expression2">
    </select>
    <where>
        <condition expr="expression1"/>
        <condition sql="expression2"/>
    </where>
    <orderBy>
        <node expr="expression1">
        <node sql="expression2">
    </orderBy>
    <groupBy>
        <node expr="expression1">
        <node sql="expression2">
    </groupBy>
    <having>
        <condition expr="expression1"/>
        <condition sql="expression2"/>
    </having>
</queryDef>

Create-metod

Exempel 1: välj poster och skriv till journalen

De interna namnen på de arbetsflöden som finns i mappen wfExamples markeras. Resultaten sorteras efter internt namn, i stigande ordning och skrivs till journalen.

var query = xtk.queryDef.create(
    <queryDef schema="xtk:workflow" operation="select">
        <select>
            <node expr="@internalName"/>
        </select>
        <where>
            <condition expr="[folder/@name]='wfExamples'"/>
        </where>
        <orderBy>
            <node expr="@internalName" sortDesc="false"/>
        </orderBy>
    </queryDef>
    )

var res = query.ExecuteQuery()
for each (var w in res.workflow)
    logInfo(w.@internalName)

Exempel 2: ta bort poster

Förnamn, efternamn, e-postadress och ID för alla mottagare som heter Chris Smith markeras. Resultaten sorteras efter e-post, i stigande ordning och skrivs till journalen. En delete-åtgärd används för att ta bort de markerade posterna.

// Build the query, create a query object and hold the object in a variable
var query = xtk.queryDef.create(
        <queryDef schema="nms:recipient" operation="select">
            <select>
                <node expr="@firstName"/>
                <node expr="@lastName"/>
                <node expr="@email"/>
                <node expr="@id"/>
            </select>
            <where>
                <condition expr="[folder/@label]='Recipients'"/>
                <condition expr="[@lastName]='Smith'"/>
                <condition expr="[@firstName]='Chris'"/>
            </where>
            <orderBy>
                <node expr="@email" sortDesc="false"/>
            </orderBy>
        </queryDef>
)

//Run the query using the ExecuteQuery method against the created object
var res = query.ExecuteQuery()

//Loop through the results, print out the person's name and email, then delete the records
for each (var rec in res.recipient)
    {
     logInfo("Delete record = Email: " + rec.@email + ', ' + rec.@firstName + ' ' + rec.@lastName)
     xtk.session.Write(<recipient xtkschema="nms:recipient" _operation="delete" id={rec.@id}/>)
    }

Exempel 3: välj poster och skriv till journalen

I det här exemplet används en icke-statisk metod. E-post- och födelseåret för alla mottagare vars information lagras i mappen 1234 och vars e-postdomännamn börjar med adobe markeras. Resultaten sorteras efter födelsedatum i fallande ordning. Mottagarens e-postadress skrivs till journalen.

var query = xtk.queryDef.create(
<queryDef schema="nms:recipient" operation="select">
    <select>
        <node expr="@email"/>
        <node sql="sEmail"/>
        <node expr="Year(@birthDate)"/>
    </select>
    <where>
        <condition expr="[@folder-id] = 1234 and @domain like 'adobe%'"/>
        <condition sql="iFolderId = 1234 and sDomain like 'adobe%'"/>
    </where>
    <orderBy>
        <node expr="@birthDate" sortDesc="true"/>
    </orderBy>
</queryDef>
)

var res = query.ExecuteQuery()
for each (var w in res.recipient)
    logInfo(w.@email)

Write-metod

Du kan infoga, uppdatera och ta bort poster. Du kan använda metoden Write på vilket schema som helst i Adobe Campaign. Eftersom den här metoden är statisk behöver du inte skapa något objekt. Du kan använda följande åtgärder:

Exempel 1: infoga eller uppdatera en post

xtk.session.Write(
<recipient
    xtkschema="nms:recipient"
    _operation="insertOrUpdate" _key="@email"
    lastName="Lennon"
    firstName="John"
    email="johnlennon@thebeatles.com"
/>
)

Exempel 2: ta bort poster

I det här exemplet kombineras en statisk metod och en icke-statisk metod.

var query=xtk.queryDef.create(
<queryDef schema="nms:recipient" operation="select">
    <select>
        <node expr="@Id"/>
    </select>
    <where>
        <condition expr="[@email]='johnlennon@thebeatles.com'"/>
    </where>
</queryDef>
);

var res = query.ExecuteQuery()
for each (var w in res.recipient) {
xtk.session.Write(
    <recipient xtkschema="nms:recipient" _operation="delete" id={w.@id}/>
);
}

I den här videon visas hur du använder icke-statiska API-metoder:

I den här videon visas ett exempel på hur en icke-statisk API-metod används i ett arbetsflöde:

Relaterade ämnen

API-dokumentation