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

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

Meer informatie over statische en niet-statische SOAP-methoden.

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, kunt u de statische Write op de xtk:session schema:

Stap 1: stel een schrijfverzoek samen

U kunt records toevoegen, bijwerken en verwijderen.

Een record invoegen

Omdat de insert bewerking is de standaardbewerking, u hoeft 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 _update -bewerking. 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 DeleteCollection methode. 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 niet-statisch Write op de xtk:session schema:

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, kunt u de xtk:queryDef instantiemethode:

Stap 1: stel een query samen

De XML-code voor een queryDef entiteit.

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 select, where, en orderBy clausules als XML-elementen:

Stap 2: een queryobject maken

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

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

Voorvoegsel create(content) methode met het schema van de te creëren entiteit.

De content argument is een string argument 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 opdracht for each lus:

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. Meer informatie over 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 de primaire-sleutelknoop-bijvoorbeeld, @id kenmerk:

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

Resultaat van 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 count bewerking

Een element met de count attribute is returned:

<recipient count="200">

Raadpleeg de @count kenmerk:

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

Voor de select bewerking, voeg deze code toe aan een JavaScript-code-activiteit 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 select bewerking is de standaardbewerking, u hoeft 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 PostEvent methode:

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 wordt na voltooiing van de workflow een korte tekst doorgegeven aan de signaal van de wkfExampleReceiver workflow:

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

Omdat de laatste parameter is ingesteld op falsede wkfExampleReceiver elke keer dat de initiële workflow wordt voltooid, wordt een workflow gestart.

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 queryDef methode met een select clausule

<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 workflows die zich in de wfExamples is 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. A delete Deze 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 waarvan de gegevens in het 1234 en de map waarvan de e-maildomeinnaam begint met "adobe" zijn 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 Write in Adobe Campaign. 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