웹 서비스 정보

Adobe Campaign API 정의

Adobe Campaign 애플리케이션 서버는 점차 다양하고 복잡한 회사 정보 시스템과의 개방성과 간편한 통합을 위해 설계되었습니다.

Adobe Campaign API는 애플리케이션 내의 JavaScript와 애플리케이션 외부의 SOAP에서 사용됩니다. 이들은 보강될 수 있는 일반적인 기능의 라이브러리를 구성합니다. 자세한 내용은 SOAP 메서드 구현을 참조하십시오.

필수 구성 요소

Adobe Campaign API를 사용하려면 먼저 다음 주제를 숙지해야 합니다.

• Javascript
• SOAP 프로토콜
• Adobe Campaign 데이터 모델

Adobe Campaign API 사용

Adobe Campaign에서는 두 가지 유형의 API를 사용합니다.

• 데이터 모델 데이터를 쿼리하기 위한 일반 데이터 액세스 API. 데이터 지향 API를 참조하십시오.
• 각 객체에 대해 작업을 수행할 수 있는 비즈니스 특정 API: 게재, 워크플로우, 구독 등 비즈니스 지향 API를 참조하십시오.

API를 개발하고 Adobe Campaign과 상호 작용하려면 데이터 모델을 숙지해야 합니다. Adobe Campaign에서 베이스에 대한 전체 설명을 생성할 수 있습니다. 모델 설명을 참조하십시오.

SOAP 호출

SOAP 프로토콜을 사용하면 기본적으로 리치 클라이언트, 웹 서비스를 사용하는 타사 애플리케이션 또는 JSP를 통해 API 메서드를 호출할 수 있습니다.

SOAP 메시지의 구조는 다음과 같습니다.

• 메시지 구조를 정의하는 봉투
• 선택적 헤더,
• 호출 및 응답에 대한 정보가 들어 있는 본문,
• 오류 조건을 정의하는 오류 관리.

리소스 및 교환

다음 스키마는 Adobe Campaign API 사용과 관련된 다양한 리소스를 보여줍니다.

'ExecuteQuery' 메서드의 SOAP 메시지 예

이 예제에서 SOAP 쿼리는 문자열을 인증(세션 토큰)의 매개 변수로 사용하고 실행할 쿼리 설명에 대한 XML 콘텐츠로 가져오는 "ExecuteQuery" 메서드를 호출합니다.

자세한 내용은 ExecuteQuery(xtk:queryDef)를 참조하십시오.

SOAP 쿼리

<?xml version='1.0' encoding='ISO-8859-1'?>
  <SOAP-ENV:Envelope xmlns:xsd='http://www.w3.org/2001/XMLSchema' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xmlns:ns='http://xml.apache.org/xml-soap' xmlns:SOAP-ENV='http://schemas.xmlsoap.org/soap/envelope/'>
    <SOAP-ENV:Body>
      <ExecuteQuery xmlns='urn:xtk:queryDef' SOAP-ENV:encodingStyle='http://schemas.xmlsoap.org/soap/encoding/'>
        <__sessiontoken xsi:type='xsd:string'/>
        <entity xsi:type='ns:Element' SOAP-ENV:encodingStyle='http://xml.apache.org/xml-soap/literalxml'>
          <queryDef firstRows="true" lineCount="200" operation="select" schema="nms:rcpGrpRel" startLine="0" startPath="/" xtkschema="xtk:queryDef">
          ...
          </queryDef>
        </entity>
      </ExecuteQuery>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<soap-env:envelope> 요소는 SOAP 봉투를 나타내는 메시지의 첫 번째 요소입니다.

<soap-env:body> 요소는 봉투의 첫 번째 하위 요소입니다. 여기에는 메시지의 설명, 즉 쿼리의 콘텐츠 또는 응답이 포함됩니다.

호출할 메서드는 SOAP 메시지 본문의 <executequery> 요소에 입력됩니다.

SOAP에서 매개 변수는 모양새 순서로 인식됩니다. 첫 번째 매개 변수인 <__sessiontoken>은 인증 체인을 가져오고 두 번째 매개 변수는 <querydef> 요소에서 쿼리의 XML 설명입니다.

SOAP 응답

<?xml version='1.0' encoding='ISO-8859-1'?>
  <SOAP-ENV:Envelope xmlns:xsd='http://www.w3.org/2001/XMLSchema' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xmlns:ns='http://xml.apache.org/xml-soap' xmlns:SOAP-ENV='http://schemas.xmlsoap.org/soap/envelope/'>
    <SOAP-ENV:Body>
      <ExecuteQueryResponse xmlns='urn:xtk:queryDef' SOAP-ENV:encodingStyle='http://schemas.xmlsoap.org/soap/encoding/'>
        <pdomOutput xsi:type='ns:Element' SOAP-ENV:encodingStyle='http://xml.apache.org/xml-soap/literalxml'>
          <rcpGrpRel-collection><rcpGrpRel group-id="1872" recipient-id="1362"></rcpGrpRel></rcpGrpRel-collection>
        </pdomOutput>
      </ExecuteQueryResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

쿼리 결과는 <pdomoutput> 요소에서 입력됩니다.

오류 관리

SOAP 오류 응답 예:

<?xml version='1.0' encoding='ISO-8859-1'?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV='http://schemas.xmlsoap.org/soap/envelope/'>
  <SOAP-ENV:Body>
    <SOAP-ENV:Fault>
      <faultcode>SOAP-ENV:Server</faultcode>
      <faultstring>Error while executing 'Write' of the 'xtk:persist'.</faultstring> service
      <detail>ODBC error: [Microsoft][ODBC SQL Server Driver][SQL Server]Cannot insert duplicate key row in object 'XtkOption' with unique index 'XtkOption_name'. SQLSTate: 23000
ODBC error: [Microsoft][ODBC SQL Server Driver][SQL Server]The statement has been terminated. SQLSTate: 01000 Cannot save the 'Options (xtk:option)' document </detail>
    </SOAP-ENV:Fault>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

SOAP 메시지 본문의 <soap-env:fault> 요소는 웹 서비스를 처리하는 동안 발생하는 오류 신호를 전달하는 데 사용됩니다. 다음은 다음 하위 요소로 구성됩니다.

• <faultcode> : 오류 유형을 나타냅니다. 오류 유형은 다음과 같습니다.

  • 사용된 SOAP 버전과 호환되지 않는 경우 "VersionMismatch",
  • 메시지 헤더에 문제가 있을 경우 "MustUnderstand"를 참조하십시오.
  • 클라이언트에 정보가 없는 경우 "클라이언트"
  • 서버에서 처리를 실행하는 데 문제가 있는 경우 "서버"가 발생합니다.

• <faultstring> : 오류를 설명하는 메시지

• <detail> : 긴 오류 메시지

<faultcode> 요소가 확인되면 서비스 호출의 성공 또는 실패가 식별됩니다.

C#의 오류 처리 예:

try 
{
  // Invocation of method
  ...
}
catch (SoapException e)
{
  System.Console.WriteLine("Soap exception: " + e.Message);        
  if (e.Detail != null)
    System.Console.WriteLine(e.Detail.InnerText);
}

웹 서비스 서버의 URL(또는 EndPoint)

웹 서비스를 제출하려면 해당 서비스 방법을 구현하는 Adobe Campaign 서버에 연결해야 합니다.

서버 URL은 다음과 같습니다.

https://serverName/nl/jsp/soaprouter.jsp

<server> Adobe Campaign 애플리케이션 서버(nlserver web)가 있는 경우