Mit ActiveView können Entwickler höher gestufte Befehle für einen Untertyp überschreiben und Befehle hinzufügen, ändern oder löschen. Das allgemeine Konzept und die Methode zum Überschreiben des Menüs ähnelt den Überschreibungen des Menüs Funktion, der Leiste Hauptmenü und des Menüs Objekt hinzufügen. In den folgenden Beispielen wird die für die Überschreibung von „Höher gestufte Befehle“ erforderliche allgemeine Syntax demonstriert.

Die grundlegende Struktur der XML-Syntax für die Überschreibung von „Höher gestufte Befehle“ sieht wie folgt aus. Sämtliche Anpassungen und Änderungen werden zwischen der Registerkarte <override type="promotedcommands"> und der Registerkarte </override> angegeben.

<?xml version="1.0" encoding="ISO-8859-1" ?>
<overrides>
	<override type="promotedcommands">
		<!-- Add content here -->
	</override>
</overrides>

Sie können eine Überschreibung zum Anpassen des Menüs Höher gestufte Befehle wie folgt verwenden:

Neue höher gestufte Befehle hinzufügen

Mit dem Attribut subtypes= können Sie eine durch Komma getrennte Liste der Untertypen angeben, auf die die Überschreibung von Höher gestufte Befehle angewendet werden soll. In diesem Beispiel werden die höher gestuften Befehle für sämtliche Ordner (0) und Dokumente (144) überschrieben. Sie können WebReports-Tags und -Konstanten in Befehlen verwenden. Im folgenden Beispiel wird das Tag [LL_REPTAG_OVERRIDEOBJID /] verwendet, um die Objekt-ID des aktuellen Objekts abzurufen. Mit dem Tag [LL_REPTAG_$WRURL /] wird ein konstanter Wert abgerufen, der die Objekt-ID eines WebReports enthält.

Im Befehlsabschnitt werden die folgenden Attribute verwendet:

  • Mit dem erforderlichen Attribut newcmd= können Sie den Namen des Befehls festlegen.

  • Das Attribut newurl= ist erforderlich. Es ermöglicht Ihnen, die URL des Befehls festzulegen.

  • Das Attribut neworder= ist optional und ermöglicht Ihnen, die Position des Befehls in der Befehlsliste festzulegen. Wenn „newordner“ nicht bereitgestellt wurde, werden Befehle am Anfang der Befehlsliste hinzugefügt.

 

Hinweis

Hinweis:
Höher gestufte Befehle können nur auf gültige Content Server-URLs verweisen.

 
<?xml version="1.0" encoding="ISO-8859-1" ?>
<overrides>
	<override type="promotedcommands">
		<commands subtypes="0,144">
			<addcommand newcmd="New Command" newurl="func=ll&objId=[LL_REPTAG_OVERRIDEOBJID /]&objAction=NewAction" />
			<addcommand newcmd="Run WebReport" newurl="[LL_REPTAG_$WRURL LLURL:REPORT /]" neworder="2" />
		</commands>
	</override>
</overrides>

Wenn Sie das Argument addcommand verwenden, um zwei höher gestufte Befehle hinzuzufügen, geschieht Folgendes:

  • New Command Mit wird die NewAction-WebNodeAction für das aktuelle Objekt ausgeführt.

  • Run WebReport führt den WebReport aus, dessen ID in der WRURL-Konstante angegeben ist.

Vorhandene höher gestufte Befehle ändern

Im Befehlsabschnitt:

  • Das Attribut oldcmd ist ein obligatorisches Argument, mit dem Sie den Namen des Befehls angeben können, den Sie ändern möchten.

  • Beim Attribut newcmd handelt es sich um ein optionales Argument, mit dem Sie einen neuen Namen für den Befehl festlegen können.

  • Beim Attribut neworder handelt es sich um ein optionales Argument, mit dem Sie eine neue Position für den Befehl in der Liste für höher gestufte Befehle festlegen können.

  • Beim Attribut newurl handelt es sich um ein optionales Argument, mit dem Sie eine neue URL für den Befehl festlegen können.

<?xml version="1.0" encoding="ISO-8859-1" ?>
<overrides>
	<override type="promotedcommands">
		<commands subtypes="144">
		<changecommand oldcmd="Edit" newcmd="New Edit" neworder="3" newurl="[LL_REPTAG_$WRURL LLURL:REPORT /]" />
		</commands>
	</override>
</overrides>

In diesem Beispiel wurde der Befehl Edit für ein Dokument an Position 3 in der Liste verschoben. Zudem wurden sein Name und seine URL geändert.

Höher gestufte Befehle löschen

Der folgende Code zeigt, wie mehrere höher gestufte Befehle für ein Dokument gelöscht werden.

<?xml version="1.0" encoding="ISO-8859-1" ?>
<overrides>
	<override type="promotedcommands">
		<commands subtype="144">
			<deletecommand oldcmd="Edit" />
			<deletecommand oldcmd="Download" />
		</commands>
	</override>
</overrides>
 

Tipp

Tipps:

  • Die Standardvorlage (promoted_commands_sample) dient Entwicklern als hilfreicher Ausgangspunkt, um höher gestufte Befehle zu überschreiben.

  • Wie auch in den Überschreibungen des Menüs Funktion, der Hauptmenüleiste und des Menüs Objekt hinzufügen können Sie die WebReports IF/ELSE-Logik, Tags, Untertags, Konstanten und Parameter in der XML-Syntax angeben.

  • Wenn ein Benutzer die Standardantwort zu einer überschriebenen Anforderung anzeigen möchte, wird sie durch das Anfügen von '&avid=0' an die Browser-URL angezeigt, sofern diese Funktion nicht explizit deaktiviert wurde.