후기록 템플리트 파일 생성

후기록 템플리트 파일은 하나 이상의 후기록 템플리트가 포함된 XML 형식의 파일입니다.

후기록 템플리트는 템플리트 이름을 지정하는 WebMessage 요소, 접속 풀, 생성한 후기록 테이블 및 열에서 레코드를 삽입 및 업데이트하는 데 필요한 SQL 문으로 구성됩니다. 콘텐츠 설계자는 후기록을 위한 테이블 뷰를 사용으로 설정할 때 테이블 뷰에서 레코드 삽입 및 업데이트를 위해 사용할 후기록 템플리트의 이름을 지정해야 합니다.

후기록 템플리트 요구사항

후기록 템플리트는 다음 요구사항을 충족해야 합니다.

  • WebMessage: WebMessage 요소에서 name 속성을 사용하여 후기록 템플리트의 이름을 지정해야 합니다.

    후기록이 올바르게 작동하기 위해서는 후기록을 위한 테이블 뷰를 사용으로 설정할 때 콘텐츠 설계자가 뷰에서 레코드를 삽입 및 업데이트하는 데 사용할 후기록 템플리트의 이름을 지정해야 합니다.

    이 예시에서는 SetQuotaUseID라는 후기록 템플리트를 보여줍니다.

    <WebMessage name="SetQuotaUseID">
    
  • connectionPool: 보안 요구사항을 충족하기 위해서는 레코드를 삽입 및 업데이트하는 SQL 명령과 함께 접속 풀을 지정해야 합니다. 이러한 SQL 명령은 후기록 스키마에 전달되는 값을 참조하여 데이터베이스 테이블을 수정하는 SQL 문을 생성합니다.

  • VALUES: 열 값은 열 ID 또는 열 위치로 참조할 수 있습니다. 열 ID를 사용하는 것이 좋습니다.

    문자열 및 날짜 값을 작은 따옴표로 묶습니다. 숫자 값에는 작은 따옴표가 필요하지 않습니다.

    • 열 ID - 각 열 ID는 영숫자로 표시되며 무작위로 생성됩니다. 분석 편집기의 고급 탭에서 제공되는 분석 XML 정의에서 열 ID를 찾을 수 있습니다. 예를 들어 열 ID 값은 @{c5f6e60e1d6eb1098}, @{c3a93e65731210ed1}, '@{c6b8735ea60ff3011}'과 같습니다.

      열 ID를 사용하면 열 순서가 바뀌더라도 후기록이 계속 작동합니다.

      분석 편집기에서 고급 탭의 XML

    • 열 위치 - 열 위치는 1부터 번호 매김이 시작됩니다. 예를 들어 열 위치 값은 @1, @3, '@5'와 같습니다.

      열 순서가 바뀌면 후기록이 더 이상 작동하지 않습니다. 따라서 열 ID가 선호됩니다.

  • 템플리트에 <insert><update> 요소를 둘 다 포함해야 합니다. 요소 내에 SQL 명령을 포함하지 않으려면 여는 태그와 닫는 태그 사이에 공백을 삽입해야 합니다. 예를 들어 다음과 같이 요소를 입력해야 합니다.

    <insert> </insert>
    

    다음과 같이 입력하면 안됩니다.

    <insert></insert>
    

    공백을 생략하면 "후기록 템플리트 'my_template'을 읽을 수 없습니다."와 같은 후기록 오류 메시지가 표시됩니다.

  • 매개변수의 데이터 유형이 정수 또는 실수가 아니면 작은 따옴표로 묶습니다. 데이터베이스가 커밋을 자동으로 수행하지 않으면 insertupdate 노드 다음에 선택사항인 postUpdate 노드를 추가하여 커밋을 강제합니다. postUpdate 노드는 일반적으로 다음 예를 따릅니다.

    <postUpdate>COMMIT</postUpdate>
    

열 ID 구문을 사용하는 후기록 템플리트 파일 예

열 ID로 값을 참조하는 후기록 템플리트 파일은 다음 예와 비슷할 수 있습니다.

<?xml version="1.0" encoding="utf-8" ?>
<WebMessageTables xmlns:sawm="com.siebel.analytics.web/message/v1">
<WebMessageTable lang="en-us" system="WriteBack" table="Messages">
   <WebMessage name="SetQuotaUseID">
      <XML>
         <writeBack connectionPool="Supplier">
            <insert>INSERT INTO regiontypequota VALUES(@{c5f6e60e1d6eb1098},@{c5d7e483445037d9e},'@{c3a93e65731210ed1}','@{c6b8735ea60ff3011}',@{c0432jkl53eb92cd8})</insert>
            <update>UPDATE regiontypequota SET Dollars=@{c0432jkl53eb92cd8} WHERE YR=@{c5f6e60e1d6eb1098} AND Quarter=@{c5d7e483445037d9e} AND Region='@{c3a93e65731210ed1}' AND ItemType='@{c6b8735ea60ff3011}'</update>
         </writeBack>
      </XML>
   </WebMessage>
</WebMessageTable>
</WebMessageTables>

열 위치 구문을 사용하는 후기록 템플리트 파일 예

열 위치로 값을 참조하는 후기록 템플리트 파일은 다음 예와 비슷할 수 있습니다.

<?xml version="1.0" encoding="utf-8" ?>
<WebMessageTables xmlns:sawm="com.siebel.analytics.web/message/v1">
<WebMessageTable lang="en-us" system="WriteBack" table="Messages">
   <WebMessage name="SetQuota">
      <XML>
         <writeBack connectionPool="Supplier">
            <insert>INSERT INTO regiontypequota VALUES(@1,@2,'@3','@4',@5)</insert>
            <update>UPDATE regiontypequota SET Dollars=@5 WHERE YR=@1 AND Quarter=@2 AND Region='@3' AND ItemType='@4'</update>
         </writeBack>
      </XML>
   </WebMessage>
</WebMessageTable>
</WebMessageTables>