工作流程中的 JavaScript 程式碼範例 javascript-in-workflows
以下範例說明如何在工作流程中使用JavaScript程式碼：
瞭解更多 關於靜態和非靜態SOAP方法。
在這些範例中，會使用ECMAScript for XML (E4X)擴充功能。 透過此擴充功能，您可以在相同的指令碼中合併JavaScript呼叫和XML原始專案。
若要嘗試這些範例，請依照下列步驟進行：
範例1：寫入資料庫 write-example
若要寫入資料庫，您可以使用靜態 Write 上的方法 xtk:session 綱要：
-
以XML撰寫寫入要求。
-
寫入記錄：
-
呼叫
Write上的方法xtk:session綱要。note important IMPORTANT 如果您使用Adobe Campaign v8，我們建議您搭配 內嵌 和 資料更新/刪除 的API WriteSnowflake表中的方法。 深入了解. -
傳遞XML程式碼作為寫入要求的引數。
-
步驟1：撰寫寫入要求
您可以新增、更新和刪除記錄。
插入記錄
因為 insert 操作是預設的操作，您不需要指定它。
將此資訊指定為XML屬性：
- 要修改之資料表的綱要
- 要填入的表格欄位
例如：
var myXML = <recipient xtkschema="nms:recipient"
firstName="Isabel"
lastName="Garcia"
email="isabel.garcia@mycompany.com"/>
更新記錄
使用 _update 作業。 了解更多。
將此資訊指定為XML屬性：
- 要修改之資料表的綱要
- 要更新的表格欄位
- 識別要更新的記錄所需的索引鍵引數
例如：
var myXML = <recipient xtkschema="nms:recipient"
status="Client"
email="isabel.garcia@mycompany.com"
operation="_update"
_key="@email"/>
刪除記錄
使用 DeleteCollection 方法。 了解更多。
指定此資訊：
- 要修改之資料表的綱要
- 此
where以XML元素的形式識別要更新的記錄所需的子句
例如：
xtk.session.DeleteCollection(
"nms:recipient",
<where>
<condition expr="[@email] = 'isabel.garcia@mycompany.com'"/>
</where>,
false
)
步驟2：寫入記錄
呼叫非靜態 Write 上的方法 xtk:session 綱要：
xtk.session.Write(myXML)
此方法不會傳回任何值。
將完整程式碼新增至工作流程中的JavaScript程式碼活動：
var myXML = <recipient xtkschema="nms:recipient"
firstName="Isabel"
lastName="Garcia"
email="isabel.garcia@mycompany.com"/>
xtk.session.Write(myXML)
此影片說明如何寫入資料庫：
範例2：查詢資料庫 read-example
若要查詢資料庫，您可以使用非靜態 xtk:queryDef 執行個體方法：
- 以XML撰寫查詢。
- 建立查詢物件。
- 執行查詢。
步驟1：撰寫查詢
指定的XML程式碼 queryDef 實體。
語法：
<queryDef schema="nms:recipient" operation="">
<!-- select, where, and orderBy clauses as XML elements -->
</queryDef>
指定此資訊：
- 要讀取之資料表的綱要
- 作業
- 要傳回的欄，在
select子句 - 條件，在
where子句 - 篩選條件，在
orderBy子句
您可以使用下列操作：
selectgetIfExistsgetcountcount 屬性。撰寫 select， where、和 orderBy 子句作為XML元素：
-
select子句指定要傳回的欄。 例如，若要選取人員的名字和姓氏，請撰寫此程式碼：
code language-xml <select> <node expr="@firstName"/> <node expr="@lastName"/> </select>使用
nms:recipient結構描述，元素會以下列形式傳回：code language-xml <recipient firstName="Bo" lastName="Didley"/> -
where子句若要指定條件，請使用
where子句。 例如，若要選取位於 培訓 資料夾中，您可以撰寫此程式碼：code language-xml <where> <condition expr="[folder/@label]='Training'"/> </where>合併多個運算式時，請在第一個運算式中使用布林運運算元。 例如，若要選取所有名為Isabel Garcia的人，您可以撰寫此程式碼：
code language-xml <condition boolOperator="AND" expr="@firstName='Isabel'"/> <condition expr="@lastName='Garcia'"/> -
orderBy子句若要排序結果集，請指定
orderBy子句做為具有sortDesc屬性。 例如，若要以遞增順序排序姓氏，您可以編寫此程式碼：code language-xml <orderBy> <node expr="@lastName> sortDesc="false"/> </orderBy>
步驟2：建立查詢物件
若要從XML程式碼建立實體，請使用 create(content) 方法：
var query = xtk.queryDef.create(
<queryDef schema="nms:recipient" operation="select">
…
</queryDef>)
前置詞 create(content) 具有要建立之實體的結構描述的方法。
此 content 引數是字串引數，是選用專案。 此引數包含描述實體的XML程式碼。
步驟3：執行查詢
請依照下列步驟操作：
-
呼叫
ExecuteQuery上的方法queryDef實體：code language-javascript var res = query.ExecuteQuery() -
處理結果：
- 反複檢視的結果
select作業，使用回圈建構。 - 使用測試結果
getIfExists作業。 - 計算結果，使用
count作業。
- 反複檢視的結果
的結果 select 操作
所有相符專案都會傳回為集合：
<recipient-collection>
<recipient email="jane.smith@mycompany.com">
<recipient email="john.harris@mycompany.com">
</recipient-collection>
若要反複檢查結果，請使用 for each 回圈：
for each (var rcp in res:recipient)
logInfo(rcp.@email)
回圈包含本機收件者變數。 對於收件者集合中傳回的每個收件者，都會列印出收件者的電子郵件。 瞭解更多 關於 logInfo 函式。
的結果 getIfExists 操作
每個相符專案都會傳回為元素：
<recipient id="52,378,079">
如果沒有相符專案，則會傳回空白元素：
<recipient/>
您可以參照主鍵節點，例如 @id 屬性：
if (res.@id !=undefined)
{ // match was found
…
}
的結果 get 操作
會傳回一個相符專案作為元素：
<recipient id="52,378,079">
如果沒有相符專案，則會傳回錯誤。
get 作業。 否則，請使用 getIfExists 作業。 如果您使用此最佳實務，則錯誤會顯示非預期的問題。 如果您使用 get 操作，請勿使用 try…catch 陳述式。 問題由工作流程的錯誤處理程式處理。的結果 count 操作
具有下列專案的元素 count 屬性會傳回：
<recipient count="200">
若要使用結果，請參閱 @count 屬性：
if (res.@count > 0)
{ // matches were found
…
}
對於 select 作業，將此程式碼新增至工作流程中的JavaScript程式碼活動：
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)
因為 select 操作是預設的操作，您不需要指定它。
此影片說明如何從資料庫讀取：
觸發工作流程 trigger-example
您可以程式設計方式觸發工作流程，例如，在技術工作流程中或處理使用者在網頁應用程式頁面上輸入的資訊。
工作流程觸發可透過使用事件來運作。 您可以對事件使用這些功能：
您可以透過不同方式觸發工作流程：
-
您可以內嵌觸發工作流程，也就是說，從的主指令碼 JavaScript code 活動。
-
另一個工作流程完成後，您可以觸發此工作流程：
-
將初始化指令碼新增至 End 初始工作流程的活動。
-
新增 External signal 目標工作流程開始時的活動。
完成初始工作流程後，事件就會發佈。 會啟動傳出轉變並填入事件變數。 然後，目標工作流程會接收事件。
note tip TIP 最佳做法是，將指令碼新增至活動時，請以雙連字型大小將活動名稱括住，例如 -- end --. 瞭解更多 關於工作流程最佳實務。
-
的語法 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.
)
在此範例中，完成工作流程後，會將簡短文字傳送至 訊號 的活動 wkfExampleReceiver 工作流程：
var strLabel = "Adobe Campaign, Marketing that delivers"
xtk.workflow.PostEvent(
"wkfExampleReceiver",
"signal",
"",
<variables strLine={strLabel}/>,
false)
因為最後一個引數設定為 false，則 wkfExampleReceiver 每次完成初始工作流程時都會觸發工作流程。
觸發工作流程時，請牢記以下原則：
- 此
PostEvent命令會以非同步方式執行。 命令會放置在伺服器佇列中。 方法會在事件發佈後傳回。 - 必須啟動目標工作流程。 否則，錯誤會寫入記錄檔。
- 如果目標工作流程已暫停，則
PostEvent命令會排入佇列，直到工作流程恢復為止。 - 觸發的活動不需要進行中的任務。
本影片說明如何使用靜態API方法：
本影片說明如何觸發工作流程：
與資料庫互動 interact-example
這些範例顯示如何執行下列動作：
- 使用
get和create使用非靜態SOAP方法的結構描述方法 - 建立執行SQL查詢的方法
- 使用
write插入、更新和刪除記錄的方法
請依照下列步驟操作：
的語法 queryDef 具有的方法 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 方法
範例1：選取記錄並寫入分錄
位於「 」的工作流程的內部名稱 wfExamples 已選取資料夾。 結果會依內部名稱以遞增順序排序，並寫入日誌。
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)
範例2：刪除記錄
系統會選取名為Chris Smith之所有收件者的名字、姓氏、電子郵件及ID。 結果會依電子郵件遞增順序排序，並寫入日誌。 A delete 作業用於刪除選取的記錄。
// 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}/>)
}
範例3：選取記錄並寫入分錄
在此範例中，使用非靜態方法。 其資訊儲存在中的所有收件者的電子郵件和出生年份 1234 資料夾及其電子郵件網域名稱以「adobe」開頭會被選取。 結果會依出生日期遞減排序。 收件者的電子郵件會寫入日誌。
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 方法
您可以插入、更新和刪除記錄。 您可以使用 Write Adobe Campaign中任何結構描述的方法。 由於此方法為靜態方法，因此您不需要建立物件。 您可以使用下列操作：
-
此
update操作 -
此
insertOrUpdate作業，使用_key識別要更新之記錄的引數如果您不指定 收件者 資料夾中，如果存在相符專案，則會更新任何子資料夾中的記錄。 否則，該記錄將在根中建立 收件者 資料夾。
-
此
delete操作
Write Snowflake表中的方法。 深入了解.範例1：插入或更新記錄
xtk.session.Write(
<recipient
xtkschema="nms:recipient"
_operation="insertOrUpdate" _key="@email"
lastName="Lennon"
firstName="John"
email="johnlennon@thebeatles.com"
/>
)
範例2：刪除記錄
此範例結合了靜態方法和非靜態方法。
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}/>
);
}
本影片說明如何使用非靜態API方法：
本影片說明在工作流程中使用非靜態API方法的範例：