Workplace XT-Aktionen anpassen

Für die Objekte, die über die Popup-Menüs oder die Anzeige- und Suchmodi von IBM FileNet Workplace XT verfügbar sind, gibt es in der Anwendung eine Gruppe von Operationen oder Aktionen, die ein Benutzer für einen bestimmten Objekttyp ausführen kann. So gehören beispielsweise zu den für ein Dokumentobjekt verfügbaren Aktionen Auschecken, Herunterladen, In zusammengesetztes Dokument ändern und Verschieben. Für ein Ordnerobjekt gibt es Objekte hinzufügen, Verschieben und Löschen.

Als Administrator können Sie die Aktionen, die für Objekte ausgeführt werden können, die in der Workplace XT-Benutzeroberfläche angezeigt werden, anpassen. Sie können auch kosmetische Änderungen vornehmen, wie eine Aktion vollständig aus der Benutzeroberfläche zu entfernen. Unter Verwendung von Filterkriterien können Sie auch die Bedingungen definieren, unter denen eine Aktion angezeigt wird. So können Sie beispielsweise die Download-Aktion so definieren, dass sie nur angezeigt wird, wenn Benutzer auf Dokumente klicken, die eine bestimmte Klassenbeschreibung oder einen bestimmten Versionsstatus oder Inhaltstyp aufweisen.

Dieses Thema erläutert die Positionen in der Workplace XT-Schnittstelle, an denen Aktionen für die Benutzer angezeigt werden und beschreibt die XML-Deskriptordatei für Menüaktionen, die Sie verwenden, um diese Aktionen zu definieren.

HINWEIS  Wenn Sie zuvor Aktionen in der Anwendung Workplace angepasst haben, indem Sie die Datei 'Actions.xml' geändert haben, und Sie diese angepassten Aktionen in Workplace XT verwenden wollen, müssen Sie die Workplace-bezogenen Anpassungen der Workplace XT-Datei Actions.xml manuell hinzufügen.

Aktionen der Workplace XT-Benutzeroberfläche

Aktionen sind für den Benutzer in Popup-Menüs, im Menü Aktionen, im Menü Extras und auf den Seiten Eigenschaftsinformationen verfügbar. (Die Aktionen auf den Seiten Eigenschaftsinformationen und in den Popup-Menüs Eigener Workplace werden über die Datei Actions.xml definiert, alle anderen Aktionen über die Datei MenuActions.xml.) Das Popup-Menü wird angezeigt, wenn ein Benutzer mit der rechten Maustaste in einer Listenansicht auf ein Objekt oder in einer Pfadansicht auf ein Element klickt. Die Liste der verfügbaren Aktionen hängt vom Typ des ausgewählten Objekts ab. Dieselben Aktionen werden auf der Seite Eigenschaftsinformationen des Objekts angezeigt. Wählt ein Benutzer mindestens ein Element einer Listenansicht aus und klickt anschließend auf die Schaltfläche "Aktionen", wird das Menü Aktionen geöffnet. Sind mehrere Elemente ausgewählt, werden nur die Aktionen im Menü angezeigt, die für alle ausgewählten Elemente gültig sind.

In Workplace XT können Sie unter Verwendung des Kontextmenüs auch eine neue Aktion verfügbar machen. Sie müssen der Datei ActionsMenu.js ein benutzerdefiniertes JavaScript hinzufügen, um eine Aktion im Menü Aktionen zu aktivieren.

Fügen Sie in der Funktion showActionsMenu in ActionsMenu.js den folgenden Code hinzu:

            if ($("ACTIONS_MENU__actionid"))
                validActions.push("actionid");

Dabei ist "actionid" die ID Ihrer Aktion, wie sie in der Datei MenuActions.xml definiert ist.

XML-Deskriptordatei für Menüaktionen

MenuActions.xml enthält die Definitionen der Aktionen, die im Popup-Menü und Mehrfachauswahlmenü für den Anzeige- und Suchmodus angezeigt werden. Die Datei befindet sich im Ordner <XT-Implementierungspfad>\FileNet\Config\WebClient, wobei <XT-Implementierungspfad> den Pfad angibt, in dem Workplace XT implementiert ist. MenuActions.xml folgt dem XML-Schema der Workplace-Vorgaben, Preferences.xsd, das sich in <XT-Implementierungspfad>\FileNet\WebClient\WorkplaceXT\WEB-INF\xml befindet.

HINWEISE 

Dateistruktur

Wie in der folgenden Auflistung gezeigt, besteht MenuActions.xml aus fünf Abschnitten: multiSelectActions, toolbarActions, folderToobarActions, topLevelActions und actionDefinitions.

Im Array topLevelActions und im Array multiSelectActions definieren Sie die Reihenfolge der Aktionen, wie sie in der Benutzeroberfläche angezeigt werden. Das heißt, im Array topLevelActions wird die Reihenfolge der Wertelemente im Popup-Menü und auf den Informationsseiten wiedergegeben. Im Array multiSelectActions wird die Reihenfolge der Wertelemente im Mehrfachauswahlmenü wiedergegeben. Sie können Aktionen ausblenden, indem Sie sie auskommentieren.

Im Array multiSelectActions können Sie nur Mehrfachauswahl-Aktionen angeben, das bedeutet, dass eine Mehrfachauswahl-Aktion nicht im Array topLevelActions aufgelistet werden muss.

In den Abschnitten toolbarActions und folderToolbarActions definieren Sie die Schaltflächen in der Symbolleiste, die neben den Aktionsschaltflächen in der Symbolleiste angezeigt werden, wenn Sie Dokumente und Ordner anzeigen oder danach suchen. Der Abschnitt toolbarActions steuert Aktionen, die sich auf Dokumente beziehen, der Abschnitt folderToolbarActions steuert Aktionen, die sich auf Ordner beziehen.

Die Liste actionDefinitions besteht aus Aktionsobjekten, von denen jedes eine Liste mit Bedingungen enthält, die definieren, ob die Aktion für die einzelnen Objekte angezeigt wird. Berücksichtigen Sie, dass eine Aktion der höchsten Ebene ein Untermenü enthalten kann, und dass die Aktionsdefinition der höchsten Ebene in diesem Fall die Einstellung subActions enthalten muss. Berücksichtigen Sie weiterhin, dass die Definition einer Aktion, die im Array multiSelectActions aufgelistet ist, die Einstellung multiSelectURL einschließen muss. Die Beschreibungen aller Einstellungen finden Sie in Einstellungen für die Menüaktionsdefinition.

Abschnitte in der XML-Deskriptordatei für Menüaktionen

<object key="actionsConfiguration" version="1.0">
...

  <array key="multiSelectActions">
    <value>download</value>
    <value>checkout</value>
    <value>cancelCheckout</value>
    <value>file</value>
    <value>delete</value>
    <value>assignSecurityPolicy</value>
    <value>sendMail</value>
  </array>
  <array key="toolbarActions">
    <value>download</value>
    <value>checkout</value>
    <value>quickCheckin</value>
    <value>cancelCheckout</value>
    <value>addToFavorites</value>
    <value>infoProperties</value>
    <value>sendMail</value>
  </array>
  <array key="folderToolbarActions">
    <value>addDocument</value>
    <value>addFolder</value>
  </array>
  <array key="topLevelActions">
    <value>view</value> <!-- for documents, publish templates -->
    <value>open</value> <!-- for folders, searches, object stores -->
    <value>download</value>
    <value>checkout</value>
    <value>quickCheckin</value>
    <value>cancelCheckout</value>
    <value>addToFavorites</value>
    <value>removeFavorite</value>
    <value>renameFavorite</value>
    <value>sendMail</value>
    <value>launch</value>
    <value>transfer</value>
    <value>addSubscription</value>
    <value>declareAsRecord</value>
    <value>declareVersionsAsRecord</value>
    <value>testFormTemplate</value>
    <value>modifyDocumentPolicy</value>
    <value>modifyWorkflowPolicy</value>
    <value>takeOffline</value>
    <value>modifyEntryTemplate</value>
    <value>modifyRecordEntryTemplate</value>
    <!-- RM changes start-->
    <value>requestchargeout</value>
    <value>viewDocumentInfo</value>
    <!-- RM changes end -->
    <value>infoProperties</value>
    <value>moreInformation</value>
    <value>documentActions</value>
    <value>folderActions</value>
    <!-- always in the end -->
    <value>addDocument</value>
    <value>addFolder</value>
  </array>

<list key="actionDefinitions">

...

<object key="action">
    <setting key="id">download</setting>
    <setting key="title" localizationKey="server.MenuActions_xml.download">Download…</setting>
    <setting key="url">
       getContent?
       mode=download&amp;
       objectType={OBJECT_TYPE}&amp;
       id={OBJECT_ID}&amp;
       vsId={VERSION_SERIES_ID}&amp;
       objectStoreName={OBJECT_STORE_NAME}&amp;
       returnUrl={RETURN_URL}
    </setting>
    <setting key="multiSelectURL">
       operations/WcmMultiDownloadObject.jsp?
       returnUrl={RETURN_URL}
    </setting>
    <setting key="img">images/action/toolbar/Download23.gif</setting>
    <array key="objectTypes">
       <value>document</value>
    </array>
    <array key="excludedContentTypes">
       <!--RM Change start -->
       <value>application/x-filenet-rm-physicalrecord</value>
       <value>application/x-filenet-rm-electronicrecord</value>
       <value>application/x-filenet-rm-emailrecord</value>
       <!-- RM Change ends -->

<!-- entry template mime types -->
       <value>application/x-filenet-entrytemplate</value>
       <value>application/x-filenet-documententrytemplate</value>
       <value>application/x-filenet-folderentrytemplate</value>
       <value>application/x-filenet-customobjectentrytemplate</value>
       <value>application/x-filenet-formdataentrytemplate</value>
       <value>application/x-filenet-declarerecordentrytemplate</value>
       <value>application/x-filenet-pageentrytemplate</value>
       <value>application/x-filenet-sectionentrytemplate</value>
       <value>application/x-filenet-cfwpageentrytemplate</value>
       <value>application/x-filenet-cfwsectionentrytemplate</value>
       <value>application/x-filenet-cfwtextentrytemplate</value>
       <value>application/x-filenet-localsectionentrytemplate</value>

<!-- wcm mime types -->
       <value>application/x-filenet-sp-cr</value>
       <value>application/x-filenet-sp-target</value>
       <value>application/x-filenet-sp-page</value>
       <value>application/x-filenet-sp-section</value>
       <!-- Form policies -->
       <value>application/x-filenet-documentpolicy</value>
       <value>application/x-filenet-workflowpolicy</value>

<!-- external documents (pointing to an URL) -->
       <value>application/x-filenet-external</value>
    </array>
    <setting key="isPopup">false</setting>
    <setting key="popupHeight">600</setting>
    <setting key="popupWidth">750</setting>
</object>

Einstellungen für die Menüaktionsdefinition

Die folgende Tabelle beschreibt jede Aktionsdefinitionseinstellung in MenuActions.xml. Jede Einstellung wird über ihr Schlüsselattribut angegeben. Sofern nichts anderes angegeben ist, ist eine Einstellung optional. Ist eine optionale Einstellung nicht vorhanden, wird ihr Standardwert verwendet.

Makros für URL-Muster

Die Makros in der folgenden Tabelle werden in der Einstellung url von Aktionsdefinitionen verwendet. Sie definieren die URL der Seite, die die Aktion und die Parameter implementiert, die in der URL an die Seite übergeben werden. In der tatsächlichen URL werden die Makros durch den entsprechenden Wert ersetzt. Wenn beispielsweise das Muster operations/Test.jsp?id={OBJECT_ID} angegeben wurde, und das Objekt, für das die Operation aufgerufen wird, die ID {A73BEEB2-B0B7-11D2-8853-0000F80883E3} hat, sieht die Operations-URL wie folgt aus: operations/Test.jsp?id={A73BEEB2-B0B7-11D2-8853-0000F80883E3}.

Makro Wert
{OBJECT_STORE_NAME} Objektspeichername, z. B. "TEST_OS".
{OBJECT_ID} Objekt-ID im GUID- oder Pfadformat.
{OBJECT_LABEL} Objektbezeichnung, wie die Bezeichnung in der Benutzeroberfläche angezeigt wird.
{OBJECT_TYPE} Objekttyp als Zeichenfolge, z. B. "document" oder "folder".
{VERSION_SERIES_ID} Versionsserien-ID im GUID-Format.
{CLASS_ID} Klassen-ID im GUID-Format.
{CONTENT_TYPE} Inhaltstyp als URL-codierte Zeichenfolge.
{MAJOR_VERSION} Übergeordnete Version, z. B. "1".
{MINOR_VERSION} Untergeordnete Version, z. B. "2".
{VERSION_STATUS} Versionsstatus als Zahl, z. B. "1".
{RETURN_URL} URL-codierte Rückgabe-URL, z. B. "http://<Server>:<Port>/WorkplaceXT/Browse.jsf"
{TIME_ZONE} Zeitzonen-ID.