캠페인 탐색기 탐색 트리 구성

전문가 사용자는 탐색기 트리에서 폴더를 추가하고 이를 사용자 정의할 수 있습니다.

이 섹션🔗에서 캠페인 탐색기 및 탐색 계층 에 대해 자세히 알아보십시오.

탐색 목록에 사용되는 폴더 유형은 xtk:navtree 스키마의 문법을 따르는 XML 문서에 설명되어 있습니다.

XML 문서는 다음과 같이 구성됩니다.

<navtree name="name" namespace="name_space">
  <!-- Global commands -->
  <commands>
      ...
  </commands>
  
  <!-- Structured space for adding a folder -->
  <model name="<name>" label="<Label>">
    <!-- Folder type -->
    <nodeModel>
      ...
    </nodeModel>
<model name="<name>" label="<Sub model>">
      ...
    </model>
  </model> 
</navtree>

XML 문서에는 문서 이름 및 네임스페이스를 지정하는 name 및 namespace 특성이 있는 <navtree> 루트 요소가 포함되어 있습니다. 이름 및 네임스페이스는 문서 식별 키를 구성합니다.

응용 프로그램의 전역 명령은 <commands> 요소에서 문서에 선언됩니다.

파일 유형의 선언은 다음 요소가 포함된 문서에 구조화되어 있습니다.<model> 및 <nodemodel>.

전역 명령

전역 명령을 사용하면 액션을 실행할 수 있습니다. 이 작업은 입력 양식 또는 SOAP 호출일 수 있습니다.

전역 명령은 기본 Tools 메뉴에서 액세스할 수 있습니다.

명령 구성 구조는 다음과 같습니다.

<commands>
  <!-- Description of a command -->
  <command name="<name>" label="<label>" desc="<Description>" form="<form>" rights="<rights>">
    <soapCall name="<name>" service="<schema>">
      <param type="<type>" exprIn="<xpath>"/>  
        ...
    </soapCall>
    <enter>
      ...
    </enter>
  </command>
  <!-- Separator -->
  <command label="-" name="<name>"/>
  <!-- Command structure -->
  <command name="<name>" label="<Label>">
    <command...
  </command>
</commands>

전역 명령에 대한 설명은 <command> 요소에 다음 속성을 사용하여 입력됩니다.

이름:명령의 내부 이름:이름을 입력하고 고유해야 합니다.
레이블:명령의 레이블입니다.
desc:기본 화면의 상태 표시줄에 나타나는 설명입니다.
양식:실행할 양식:입력할 값은 입력 양식의 식별 키(예:"cus:recipient")
권한:이 명령에 액세스할 수 있는 명명된 권한 목록(쉼표로 구분) 사용 가능한 권한 목록은 Administration > Access management > Named rights 폴더에서 액세스할 수 있습니다.
promptLabel:명령을 실행하기 전에 확인 상자를 표시합니다.

<command> 요소에는 <command> 하위 요소가 포함될 수 있습니다. 이 경우 상위 요소를 사용하면 이러한 하위 요소로 구성된 하위 메뉴를 표시할 수 있습니다.

명령은 XML 문서에서 선언된 순서대로 표시됩니다.

명령 구분 기호를 사용하면 명령 간 분리 막대를 표시할 수 있습니다. 명령 레이블에 포함된 '-' 값으로 식별됩니다.

입력 매개 변수와 함께 <soapcall> 태그의 선택 사항은 실행할 SOAP 메서드 호출을 정의합니다. SOAP API에 대한 자세한 내용은 캠페인 JSAPI 설명서를 참조하십시오.

양식 컨텍스트는 <enter> 태그에서 초기화 시 업데이트할 수 있습니다. 이 태그에 대한 자세한 내용은 입력 양식에 대한 설명서를 참조하십시오.

예제:

"xtk:import" 양식을 시작하는 전역 명령 선언:
```
<command desc="Start the data import wizard" form="xtk:import" label="&amp;Data import..." name="import" rights="import,recipientImport"/>
```
키보드 단축키는 명령 레이블에 &이 있기 때문에 'I' 문자에서 선언됩니다.

구분 기호가 있는 하위 메뉴의 예:

<command label="Administration" name="admin">
  <command name="cmd1" label="Example 1" form="cus:example1"/>
  <command name="sep" label="-"/>
  <command name="cmd1" label="Example 2" form="cus:example2">
    <enter>
      <set xpath="@type" expr="1"/>
    </enter>
  </command>
</command>

SOAP 메서드 실행:

<command name="cmd3" label="Example 3" promptLabel="Do you really want to execute the command?">
  <soapCall name="Execute" service="xtk:sql"/>
</command>

폴더 유형

폴더 유형을 사용하면 스키마 데이터에 액세스할 수 있습니다. 폴더와 연관된 보기는 목록과 입력 양식으로 구성됩니다.

폴더 유형 구성 구조는 다음과 같습니다.

<!-- Structured location to add the folder -->
<model name="name" label="Labelled">
  <!-- Type of folder -->
  <nodeModel name="<name>" label="<Labelled>" img="<image>">
    <view name="<name>" schema="<schema>" type="<listdet|list|form|editForm>">
      <columns>
        <node xpath="<field1>"/>
        ...
    </columns>
    </view> 
  </nodeModel>
  <model name="<name>" label="<Sous modèle>">
    ...
  </model>
</model>

폴더 유형 선언을 <model> 요소 아래에 입력해야 합니다. 이 요소를 사용하면 Add new folder 메뉴에서 볼 수 있는 계층적 조직을 정의할 수 있습니다. <model> 요소에는 <nodemodel> 요소와 기타 <model> 요소가 포함되어야 합니다.

name 및 label 속성은 요소의 내부 이름과 Add new folder 메뉴에 표시되는 레이블을 채웁니다.

<nodemodel> 요소에는 다음 속성이 있는 폴더 유형의 설명이 포함되어 있습니다.

이름:내부 이름
레이블:레이블을 Add new folder 메뉴에 사용하고 폴더를 삽입할 때 기본 레이블로 사용합니다.
img:폴더 삽입에 대한 기본 이미지입니다.
hiddenCommands:마스크할 명령 목록(쉼표로 구분)입니다. 가능한 값:"adbnew", "adbsave", "adbcancel" 및 "adbdup"
newFolderShortCuts:폴더 생성 시 모델의 단축키 목록(쉼표로 <nodemodel> 구분).
insertRight, editRight, deleteRight:폴더 삽입, 편집 및 삭제를 위한 권리.

<nodemodel> 요소 아래의 <view> 요소에는 뷰와 연결된 목록의 구성이 포함되어 있습니다. 목록 스키마가 <view> 요소의 스키마 특성에 입력됩니다.

목록 레코드를 편집하려면 목록 스키마와 동일한 이름의 입력 양식이 암시적으로 사용됩니다. <view> 요소의 type 속성은 양식 표시에 영향을 줍니다. 가능한 값은 다음과 같습니다.

목록:목록 맨 아래에 양식을 표시합니다.
목록:목록만 표시합니다. 양식을 두 번 클릭하거나 목록 선택 메뉴의 "열기"를 통해 시작합니다.
양식:읽기 전용 양식을 표시합니다.
editForm:편집 모드로 양식을 표시합니다.

노트

입력 양식의 이름은 <view> 요소에 form 특성을 입력하여 오버로드할 수 있습니다.

목록 열의 기본 구성은 <columns> 요소를 통해 입력됩니다. 스키마에서 값으로 참조할 필드를 포함하는 xpath 특성이 포함된 <node> 요소에 열이 선언됩니다.

예:"nms:recipient" 스키마의 폴더 유형 선언입니다.

<model label="Profiles and targets" name="nmsProfiles">
  <nodeModel deleteRight="folderDelete" editRight="folderEdit" folderLink="folder"
             img="nms:folder.png" insertRight="folderInsert" label="Recipients"
             name="nmsFolder">
    <view name="listdet" schema="nms:recipient" type="listdet">
      <columns>
        <node xpath="@firstName"/>
        <node xpath="@lastName"/>
        <node xpath="@email"/>
        <node xpath="@account"/>
      </columns>
    </view>
  </nodeModel>
  <nodeModel name="nmsGroup" label="Groups"...
</model>

해당 폴더 삽입 메뉴:

목록을 불러오고 있을 때 필터링 및 정렬을 적용할 수 있습니다.

<view name="listdet" schema="nms:recipient" type="listdet">
  <columns>
    ...
  </columns>

  <orderBy>
    <node expr="@lastName" desc="true"/>
</orderBy>
  <sysFilter>
    <condition expr="@type = 1"/>
  </sysFilter>
</view>

단축키 명령

단축키 명령을 사용하면 목록을 선택하는 작업을 시작할 수 있습니다. 작업은 입력 양식 또는 SOAP 호출일 수 있습니다.

명령은 목록의 Action 메뉴 또는 관련 메뉴 단추에서 액세스할 수 있습니다.

명령 구성 구조는 다음과 같습니다.

<nodeModel...
  ...
  <command name="<name>" label="<label>" desc="<Description>" form="<form>" rights="<rights>">
    <soapCall name="<name>" service="<schema>">
      <param type="<type>" exprIn="<xpath>"/>  
        ...
    </soapCall>
    <enter>
      ...
    </enter>
  </command>
</nodeModel>

명령에 대한 설명은 다음 속성이 있는 <command> 요소에 입력됩니다.

이름:명령의 내부 이름:이름을 입력하고 고유해야 합니다.
레이블:명령의 레이블입니다.
desc:기본 화면의 상태 표시줄에 나타나는 설명입니다.
양식:실행할 양식:입력할 값은 입력 양식의 식별 키(예:"cus:recipient").
권한:이 명령에 액세스할 수 있는 명명된 권한 목록(쉼표로 구분) 사용 가능한 권한 목록은 Administration > Access management > Named rights 폴더에서 액세스할 수 있습니다.
promptLabel:명령 실행 전에 확인 상자를 표시합니다.
모노 선택:모노 선택을 강제 적용합니다(기본적으로 다중 선택).
refreshView:명령 실행 후 목록을 다시 로드하는 강제입니다.
enabledIf:입력한 표현식에 따라 명령을 활성화합니다.
img:목록 도구 모음에서 명령에 액세스할 수 있는 이미지를 입력합니다.

명령은 XML 문서에서 선언된 순서대로 표시됩니다.

명령 구분 기호를 사용하면 명령 간 분리 막대를 표시할 수 있습니다. 명령 레이블에 포함된 '-' 값으로 식별됩니다.

초기화 시 양식 컨텍스트를 <enter> 태그를 통해 업데이트할 수 있습니다. 이 태그에 대한 자세한 내용은 입력 양식 설명서를 참조하십시오.

예제:

<command desc="Cancel execution of the job" enabledIf="EV(@status, 'running')"
         img="nms:difstop.bmp" label="Cancel..." name="cancelJob" 
         promptLabel="Do you really want to cancel this job?" refreshView="true">
  <soapCall name="Cancel" service="xtk:jobInterface"/>
</command>
<command label="-" name="sep1"/>
<command desc="Execute selected template" form="cus:form" lmonoSelection="true" name="executeModel"
         rights="import,export,aggregate">
  <enter>
    <set expr="0" xpath="@status"/>
  </enter>
</command>

연결된 폴더

폴더 관리 작업에는 두 가지 유형이 있습니다.

폴더는 보기입니다.목록에는 폴더 속성에 입력한 시스템 필터링 가능성과 함께 스키마와 연관된 모든 레코드가 표시됩니다.
폴더가 연결되어 있습니다.목록의 레코드는 폴더 링크에서 암시적으로 필터링됩니다.

연결된 폴더의 경우 <nodemodel> 요소의 folderLink 속성을 채워야 합니다. 이 속성에는 데이터 스키마에 구성된 폴더의 링크 이름이 포함됩니다.

데이터 스키마에 있는 연결된 폴더의 선언의 예:

<element default="DefaultFolder('nmsFolder', [@_folder-id])" label="Folder" name="folder" revDesc="Recipients in the folder" revIntegrity="define" revLabel="Recipients" target="xtk:folder" type="link"/>

"folder"라는 폴더의 링크에 있는 <nodemodel>의 구성은 다음과 같습니다.

<nodeModel deleteRight="folderDelete" editRight="folderEdit" folderLink="folder"
  img="nms:folder.png" insertRight="folderInsert" label="Recipients" name="nmsFolder">
...
</nodeModel>