設定Campaign Explorer導覽樹

作為專家用戶，您可以在資源管理器樹中添加資料夾並對其進行自定義。

在本小節🔗中進一步了解Campaign瀏覽器和導覽階層。

導航清單使用的資料夾類型在遵循​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的詳細資訊，請參閱Campaign 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> 的捷徑清單（以逗號分隔）。
  • 插入右、 編輯右、 刪除右:插入、編輯和刪除資料夾的權限。

<nodemodel>​元素下的​<view>​元素包含與檢視相關聯的清單的設定。 清單的架構輸入在​<view>​元素的​schema​屬性中。

要編輯清單的記錄，將隱式使用與清單架構同名的輸入表單。 <view>​元素上的​type​屬性會影響表單的顯示。 可能的值包括：

  • listdet:在清單底部顯示表單。
  • 清單:單獨顯示清單。表單會以連按兩下或透過選取清單功能表中的「開啟」來啟動。
  • 表單:顯示只讀表單。
  • 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:在執行命令之前顯示確認框
  • monoSelection:強制單選（預設為多個選取）。
  • refreshView:執行命令後強制重新載入清單。
  • enabledIf:根據輸入的表達式激活該命令。
  • img:輸入允許從清單工具欄訪問命令的影像。

<command>​元素可以包含​<command>​子元素。 在這種情況下，父元素可讓您顯示由這些子元素組成的子菜單。

命令的顯示順序與在XML文檔中聲明的順序相同。

命令分隔符允許您顯示命令之間的分隔條。 它由命令標籤中包含的​'-'​值標識。

<soapcall>​標籤及其輸入參數的可選存在定義要執行的SOAP方法的調用。 如需SOAP API的詳細資訊，請參閱Campaign 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>

本頁內容