Voorbeelden van JavaScript-code in workflows javascript-in-workflows

Deze voorbeelden laten zien hoe u JavaScript-code kunt gebruiken in een workflow:

leer meerover statische en niet-statische methodes van SOAP.

In deze voorbeelden wordt de extensie ECMAScript for XML (E4X) gebruikt. Met deze extensie kunt u JavaScript-aanroepen en XML-primitieven combineren in hetzelfde script.

Voer de volgende stappen uit om deze voorbeelden uit te proberen:

Voorbeeld 1: schrijven naar de database write-example

Als u naar de database wilt schrijven, gebruikt u de statische methode Write in het xtk:session -schema:

Stap 1: stel een schrijfverzoek samen

U kunt records toevoegen, bijwerken en verwijderen.

Een record invoegen

Omdat de bewerking insert de standaardbewerking is, hoeft u deze niet op te geven.

Geef deze informatie op als XML-kenmerken:

Voorbeeld:

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

Een record bijwerken

Gebruik de bewerking _update . Meer informatie.

Geef deze informatie op als XML-kenmerken:

Voorbeeld:

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

Een record verwijderen

Gebruik de methode DeleteCollection . Meer informatie.

Geef deze informatie op:

Voorbeeld:

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

Stap 2: de record schrijven

Roep de niet-statische Write methode op het xtk:session schema aan:

xtk.session.Write(myXML)

Er wordt geen waarde geretourneerd voor deze methode.

Voeg de volledige code toe aan een JavaScript-codeactiviteit in de workflow:

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

xtk.session.Write(myXML)

In deze video wordt getoond hoe u naar de database kunt schrijven:

Voorbeeld 2: de database opvragen read-example

Als u een query op de database wilt uitvoeren, gebruikt u de niet-statische methode van de xtk:queryDef -instantie:

Stap 1: stel een query samen

Geef de XML-code op voor een entiteit queryDef .

Syntaxis:

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

Geef deze informatie op:

U kunt de volgende bewerkingen gebruiken:

Schrijf de clausules select, where en orderBy als XML-elementen:

Stap 2: een queryobject maken

Als u een entiteit wilt maken op basis van de XML-code, gebruikt u de methode create(content) :

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

Plaats de methode create(content) vooraf in het schema van de entiteit die u wilt maken.

Het argument content is een tekenreeksargument en is optioneel. Dit argument bevat de XML-code die de entiteit beschrijft.

Stap 3: voer de query uit

Voer de volgende stappen uit:

Resultaten van een select -bewerking

Alle overeenkomsten worden geretourneerd als een verzameling:

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

Als u de resultaten wilt doorlopen, gebruikt u de lus for each :

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

De lus bevat een variabele voor lokale ontvangers. Voor elke ontvanger die in de inzameling van ontvangers is teruggekeerd, wordt de e-mail van de ontvanger gedrukt. leer meerover de logInfo functie.

Resultaten van een getIfExists -bewerking

Elke overeenkomst wordt geretourneerd als een element:

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

Als er geen gelijke is, dan is een leeg element teruggekeerd:

<recipient/>

U kunt verwijzen naar het knooppunt met de primaire sleutel, bijvoorbeeld het kenmerk @id :

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

Resultaat van een get -bewerking

Eén overeenkomst wordt geretourneerd als een element:

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

Als er geen overeenkomst is, wordt een fout geretourneerd.

Resultaat van een count -bewerking

Er wordt een element met het kenmerk count geretourneerd:

<recipient count="200">

Als u het resultaat wilt gebruiken, raadpleegt u het kenmerk @count :

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

Voeg voor de bewerking select deze code toe aan een JavaScript-codeactiviteit in de workflow:

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)

Omdat de bewerking select de standaardbewerking is, hoeft u deze niet op te geven.

In deze video wordt getoond hoe u van de database kunt lezen:

Een workflow activeren trigger-example

U kunt werkstromen programmatically, bijvoorbeeld, in technische werkschema's of aan procesinformatie teweegbrengen die een gebruiker op een pagina van de Webtoepassing is ingegaan.

Workflowactivering werkt door het gebruik van gebeurtenissen. U kunt deze functies voor gebeurtenissen gebruiken:

U kunt workflows op verschillende manieren activeren:

Syntaxis van de methode 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.
)

In dit voorbeeld, op voltooiing van het werkschema, wordt een korte tekst overgegaan tot de signaal activiteit van het wkfExampleReceiver werkschema:

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

Omdat de laatste parameter aan false wordt geplaatst, wordt het wkfExampleReceiver werkschema teweeggebracht telkens als het aanvankelijke werkschema wordt voltooid.

Houd rekening met de volgende beginselen wanneer u workflows activeert:

In deze video wordt getoond hoe u statische API-methoden kunt gebruiken:

In deze video wordt getoond hoe workflows kunnen worden geactiveerd:

Interactie met de database interact-example

Deze voorbeelden laten zien hoe u deze handelingen uitvoert:

Voer de volgende stappen uit:

Syntaxis van de methode queryDef met een component select

<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 , methode

Voorbeeld 1: selecteer records en schrijf naar het journaal

De interne namen van de werkschema's die in de wfExamples omslag worden gevestigd worden geselecteerd. De resultaten worden gesorteerd op interne naam, in oplopende volgorde, en naar het dagboek geschreven.

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)

Voorbeeld 2: records verwijderen

De voornaam, de achternaam, het e-mailbericht en de id van alle ontvangers met de naam Chris Smith worden geselecteerd. De resultaten worden gesorteerd per e-mail, in oplopende volgorde, en geschreven aan het dagboek. Een delete -bewerking wordt gebruikt om de geselecteerde records te verwijderen.

// 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}/>)
    }

Voorbeeld 3: selecteer records en schrijf naar het tijdschrift

In dit voorbeeld wordt een niet-statische methode gebruikt. Het e-mail en geboortejaar van alle ontvangers de waarvan informatie in 1234 omslag wordt opgeslagen en waarvan e-maildomeinnaam met "adobe"begint worden geselecteerd. De resultaten worden gesorteerd op geboortedatum in aflopende volgorde. De e-mail van de ontvangers wordt geschreven aan het dagboek.

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 , methode

U kunt records invoegen, bijwerken en verwijderen. U kunt de methode Write op elk schema in Adobe Campaign gebruiken. Omdat deze methode statisch is, hoeft u geen object te maken. U kunt de volgende bewerkingen gebruiken:

Voorbeeld 1: een record invoegen of bijwerken

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

Voorbeeld 2: records verwijderen

In dit voorbeeld worden een statische methode en een niet-statische methode gecombineerd.

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}/>
);
}

In deze video wordt getoond hoe u niet-statische API-methoden kunt gebruiken:

In deze video ziet u een voorbeeld van het gebruik van een niet-statische API-methode in een workflow:

Verwante onderwerpen

API-documentatie