v7

워크플로우의 JavaScript 코드 예

다음 예에서는 워크플로우에서 JavaScript 코드를 사용하는 방법을 보여 줍니다.

• 데이터베이스에 쓰기
• 데이터베이스 쿼리
• 정적 SOAP 메서드를 사용하여 워크플로우 트리거
• 비정적 SOAP 메서드를 사용하여 데이터베이스와 상호 작용합니다

자세히 알아보기 정적 및 비정적 SOAP 메서드 기본 정보.

이 예제에서는 ECMAScript for XML (E4X) 확장 프로그램이 사용됩니다. 이 확장을 사용하면 JavaScript 호출과 XML 프리미티브를 동일한 스크립트에 결합할 수 있습니다.

이러한 예를 시도하려면 다음 단계를 수행합니다.

1. 워크플로우를 만들고 다음 활동을 워크플로우에 추가합니다.

   1. 활동 시작
   2. JavaScript 코드 활동
   3. 종료 활동

   자세히 알아보기 워크플로우 구축 기본 정보.

2. 활동에 JavaScript 코드를 추가합니다. 자세히 알아보기

3. 워크플로우를 저장합니다.

4. 예제를 테스트합니다.

   1. 워크플로우 시작. 자세히 알아보기
   2. 분개를 엽니다. 자세히 알아보기

예제 1: 데이터베이스에 쓰기

데이터베이스에 쓰려면 정적 변수를 사용할 수 있습니다 Write 다음에 대한 메서드 xtk:session 스키마:

1. XML로 쓰기 요청을 작성합니다.

2. 레코드를 작성합니다.

   1. 호출 Write 다음에 대한 메서드 xtk:session 스키마.

      중요

      Adobe Campaign v8을 사용하는 경우 스테이징 메커니즘을 수집 및 데이터 업데이트/삭제 API Write Snowflake 테이블의 메서드. 자세히 보기.

   2. 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: 데이터베이스 쿼리

데이터베이스를 쿼리하기 위해 비정적 xtk:queryDef 인스턴스 메서드:

1. XML로 쿼리를 작성합니다.
2. 쿼리 개체를 만듭니다.
3. 쿼리를 실행합니다.

1단계: 쿼리 작성

에 대한 XML 코드 지정 queryDef 엔티티.

구문:

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

다음 정보를 지정합니다.

• 읽을 테이블의 스키마
• 작업
• 반환할 열, select 절
• 조건, where 절
• 의 필터링 기준 orderBy 절

다음 작업을 사용할 수 있습니다.

다음을 작성합니다. select, where, 및 orderBy 절을 XML 요소로 변환:

• select 절

  반환할 열을 지정합니다. 예를 들어 개인의 이름과 성을 선택하려면 다음 코드를 작성합니다.

  <select>
      <node expr="@firstName"/>
      <node expr="@lastName"/>
  </select>
  

  포함 nms:recipient 스키마, 요소는 다음 형식으로 반환됩니다.

  <recipient firstName="Bo" lastName="Didley"/>
  

• where 절

  조건을 지정하려면 where 절. 예를 들어, 교육 폴더, 다음 코드를 작성할 수 있습니다.

  <where>
      <condition expr="[folder/@label]='Training'"/>
  </where>
  

  여러 표현식을 결합할 때는 첫 번째 표현식에 부울 연산자를 사용하십시오. 예를 들어 Isabel Garcia라는 이름을 가진 모든 사람을 선택하려면 다음 코드를 작성할 수 있습니다.

  <condition boolOperator="AND" expr="@firstName='Isabel'"/>
  <condition expr="@lastName='Garcia'"/>
  

• orderBy 절

  결과 집합을 정렬하려면 orderBy 절을 사용하여 XML 요소로서 sortDesc 특성. 예를 들어 성을 오름차순으로 정렬하려면 다음 코드를 작성할 수 있습니다.

  <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단계: 쿼리 실행

다음 단계를 수행하십시오.

1. 호출 ExecuteQuery 다음에 대한 메서드 queryDef 엔티티:

   var res = query.ExecuteQuery()
   

2. 결과를 처리합니다.

   1. 다음 결과를 반복합니다. select 루프 구문을 사용하는 연산입니다.
   2. 다음을 사용하여 결과 테스트 getIfExists 작업.
   3. 다음을 사용하여 결과 계산 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">

일치하는 항목이 없으면 오류가 반환됩니다.

결과 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 작업은 기본 작업이므로 지정할 필요가 없습니다.

이 비디오는 데이터베이스에서 를 읽는 방법을 보여 줍니다.

워크플로우 트리거

예를 들어 기술 워크플로우에서 프로그래밍 방식으로 워크플로우를 트리거하거나 사용자가 웹 애플리케이션 페이지에 입력한 정보를 처리할 수 있습니다.

워크플로우 트리거는 이벤트를 사용하여 작동합니다. 이벤트에 다음 기능을 사용할 수 있습니다.

• 이벤트를 게시하려면 정적 PostEvent 메서드를 사용합니다. 자세히 알아보기
• 이벤트를 수신하려면 External signal 활동. 자세히 알아보기

다음과 같은 다양한 방법으로 워크플로우를 트리거할 수 있습니다.

• 워크플로우 인라인, 즉 의 기본 스크립트에서 트리거할 수 있습니다. JavaScript code 활동.
• 다른 작업이 완료되면 워크플로우를 트리거할 수 있습니다.

  • 초기화 스크립트를 End 초기 워크플로의 활동입니다.

  • 추가 External signal target 워크플로우의 시작 시 활동.

    초기 워크플로가 완료되면 이벤트가 게시됩니다. 나가는 전환이 활성화되고 이벤트 변수가 채워집니다. 그런 다음 대상 워크플로우에서 이벤트를 수신합니다.

    팁

    가장 좋은 방법은 활동에 스크립트를 추가할 때 활동 이름을 이중 하이픈으로 묶는 것입니다. 예: -- 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 메서드를 사용하는 방법을 보여 줍니다.

이 비디오는 워크플로우를 트리거하는 방법을 보여 줍니다.

데이터베이스와 상호 작용

다음 예에서는 이러한 작업을 수행하는 방법을 보여 줍니다.

• 사용 get 및 create 비정적 SOAP 메서드를 사용하기 위한 스키마 메서드
• SQL 쿼리를 수행하는 메서드 만들기
• 사용 write 레코드 삽입, 업데이트 및 삭제 방법

다음 단계를 수행하십시오.

1. 쿼리를 정의합니다.

   • 를 사용하여 엔티티 검색 create 해당 스키마의 메서드(예: ) xtk:workflow 스키마. 자세히 알아보기
   • 사용 queryDef sql 쿼리를 실행하는 메서드입니다.

2. 다음을 사용하여 쿼리 실행 ExecuteQuery 메서드를 사용합니다. 자세히 알아보기

   사용 for each 를 클릭하여 결과를 검색합니다.

구문 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: 레코드 선택 및 저널에 쓰기

에 있는 워크플로의 내부 이름 wfExample 폴더가 선택됩니다. 결과는 내부 이름별로 오름차순으로 정렬되고 저널에 기록됩니다.

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 작업

예제 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 메소드의 사용 예를 보여 줍니다.

관련 항목

• 데이터 지향 API
• JavaScript 스크립트 및 템플릿
• JavaScript의 SOAP 메서드

API 설명서

• SOAP 호출 샘플
• 방법:
  • 만들기
  • DeleteCollection
  • ExecuteQuery
  • PostEvent
  • 쓰기
• logInfo 함수