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

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

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

탐색 목록에 사용되는 폴더 유형은 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 문서에는 문서 이름 및 네임스페이스를 지정하는 namenamespace 특성이 있는 <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> 요소가 포함되어야 합니다.

namelabel 속성은 요소의 내부 이름과 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:목록 도구 모음에서 명령에 액세스할 수 있는 이미지를 입력합니다.

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

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

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

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

초기화 시 양식 컨텍스트를 <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>

연결된 폴더

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

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

연결된 폴더의 경우 <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>

이 페이지에서는

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now