Konfigurera navigeringsträdet i Campaign Explorer configuration

Som expertanvändare kan du lägga till mappar i utforskarträdet och anpassa det.

Läs mer om Campaign Explorer och navigeringshierarki i det här avsnittet.

De typer av mappar som används i navigeringslistan beskrivs i ett XML-dokument som lyder grammatiken i xtk:navtree schema.

XML-dokumentet är strukturerat på följande sätt:

<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-dokumentet innehåller <navtree> rotelementet med name och namespace -attribut för att ange dokumentnamnet och namnutrymmet. Namnet och namnutrymmet utgör dokumentets ID-nyckel.

Programmets globala kommandon deklareras i dokumentet från <commands> -element.

Deklarationen av filtyper är strukturerad i dokumentet med följande element: <model> och <nodemodel>.

Globala kommandon global-commands

Med ett globalt kommando kan du starta ett funktionsmakro. Den här åtgärden kan vara ett indataformulär eller ett SOAP-anrop.

Globala kommandon är tillgängliga från huvudsidan Tools -menyn.

Kommandokonfigurationsstrukturen är följande:

<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>

Beskrivningen av ett globalt kommando anges i <command> element med följande egenskaper:

A <command> -element kan innehålla <command> delelement. I det här fallet kan du med det överordnade elementet visa en undermeny som består av dessa underordnade element.

Kommandona visas i samma ordning som de deklareras i XML-dokumentet.

Med en kommandoavgränsare kan du visa ett avgränsningstecken mellan kommandona. Den identifieras av '-' värdet i kommandoetiketten.

Den valfria närvaron av <soapcall> -taggen med indataparametrarna definierar anropet till en SOAP-metod som ska köras. Mer information om SOAP API finns i Kampanj-JSAPI-dokumentation.

Formulärkontexten kan uppdateras vid initiering från <enter> -tagg. Mer information om den här taggen finns i dokumentationen om indataformulär.

Exempel:

Mapptyp folder-type

Med en mapptyp kan du ge åtkomst till data i ett schema. Vyn som är associerad med mappen består av en lista och ett inmatningsformulär.

Konfigurationsstrukturen för mapptypen är följande:

<!-- 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>

Mapptypsdeklarationen måste anges under en <model> -element. Med det här elementet kan du definiera en hierarkisk organisation som visas från Add new folder -menyn. A <model> elementet måste innehålla <nodemodel> element och andra <model> -element.

The name och label attribut fyller i elementets interna namn och etiketten som visas i Add new folder -menyn.

The <nodemodel> -elementet innehåller en beskrivning av mapptypen med följande egenskaper:

The <view> -element under <nodemodel> -elementet innehåller konfigurationen för listan som är associerad med vyn. Schemat för listan anges i schema attributet för <view> -element.

Om du vill redigera posterna i listan används indataformuläret med samma namn som listschemat implicit. The type på <view> -elementet påverkar hur formuläret visas. Möjliga värden är:

Standardkonfigurationen för listkolumnerna anges via <columns> -element. En kolumn deklareras på en <node> elementet som innehåller xpath attribut med fältet som ska refereras i schemat som dess värde.

Exempel: deklaration av en mapptyp i schemat nms:mottagare.

<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>

Motsvarande inmatningsmeny för mappar:

Filtrering och sortering kan användas när listan läses in:

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

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

Kortkommandon shortcut-commands

Med ett kortkommando kan du starta en åtgärd när du markerar listan. Åtgärden kan vara ett indataformulär eller ett SOAP-anrop.

Kommandon är tillgängliga via Action menyn för listan eller den tillhörande menyknappen.

Kommandokonfigurationsstrukturen är följande:

<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>

Beskrivningen av ett kommando anges på <command> element med följande egenskaper:

A <command> -element kan innehålla <command> delelement. I det här fallet kan du med det överordnade elementet visa en undermeny som består av dessa underordnade element.

Kommandona visas i samma ordning som de deklareras i XML-dokumentet.

Med en kommandoavgränsare kan du visa ett avgränsningstecken mellan kommandona. Den identifieras av '-' värdet i kommandoetiketten.

Den valfria närvaron av <soapcall> -taggen med indataparametrarna definierar anropet till en SOAP-metod som ska köras. Mer information om SOAP API:er finns i Kampanj-JSAPI-dokumentation.

Formulärkontexten kan uppdateras vid initieringen via <enter> -tagg. Mer information om den här taggen finns i dokumentationen till indataformuläret.

Exempel:

<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>

Länkad mapp linked-folder

Det finns två typer av mapphanteringsåtgärder:

För en länkad mapp visas folderLink på <nodemodel> -elementet måste fyllas i. Det här attributet innehåller namnet på länken i mappen som är konfigurerad i dataschemat.

Exempel på deklaration av en länkad mapp i dataschemat:

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

Konfigurationen av <nodemodel> på länken till mappen "folder" är följande:

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