自訂 Workplace XT 動作

對於可以從蹦現功能表或從 IBM FileNet Workplace XT 的瀏覽和搜尋模式存取的物件,應用程式會提供一組作業或動作,供一般使用者對特定物件類型執行。例如,文件物件可用的動作包括移出、下載、變更為複合及移動;若為資料夾物件,則包括新增物件、移動和刪除。

身為管理者,您可以針對出現在 Workplace XT 使用者介面中的物件,自訂可執行的動作。 您也可以執行外觀上的變更,例如從使用者介面完全移除動作。您也可以使用過濾準則, 定義出現動作的條件。例如,您可以定義下載動作只在使用者按一下特定類別說明、 版本狀態和內容類型的文件時才出現。

本主題指出 Workplace XT 介面中向使用者顯示動作的位置, 並說明您可用來配置那些動作的功能表動作描述子 XML 檔

附註  如果您先前曾修改 Workplace 應用程式的 Actions.xml 檔來自訂 Workplace 應用程式中的動作,而您現在想要在 Workplace XT 中使用相同的自訂動作,則您必須手動將 Workplace 相關的自訂新增到 Workplace XT Actions.xml 檔。

Workplace XT 使用者介面中的動作

動作會在蹦現功能表、動作功能表、工具功能表和內容資訊頁面中提供給使用者。 (「內容」資訊頁面和「我的工作區」蹦現功能表中的動作是由 Actions.xml 檔定義;MenuActions.xml 檔定義所有其他動作)。當使用者在清單視圖中的某物件上或路徑視圖中的某項目上按一下滑鼠右鍵時,會出現蹦現功能表。 可用的動作清單取決於所選取的物件類型。 相同的動作會出現在該物件的「內容」資訊頁面上。當使用者選取清單視圖中的一個或多個項目,然後按一下「動作」按鈕,「動作」功能表就會開啟。 如果選取了多個項目,只有對所有選取項目都有效的動作,才會顯示在功能表中。

在 Workplace XT,您也可以使用快速功能表公開新動作。 您必須將自訂 JavaScript 新增至 ActionsMenu.js 檔,才能在「動作」功能表中啟用動作。

ActionsMenu.js 的 showActionsMenu 函數中,新增下列程式碼:

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

     其中 "actionid" 是指定在 MenuActions.xml 檔中的動作 ID。

功能表動作描述子 XML 檔

MenuActions.xml 包含蹦現功能表及複選功能表中,針對瀏覽和搜尋模式所顯示動作之定義。 此檔案位於 <XT_deploy_path>\FileNet\Config\WebClient 資料夾,其中 <XT_deploy_path> 是 Workplace XT 的部署路徑。MenuActions.xml 遵循工作區喜好設定 XML 綱目 Preferences.xsd,它位於 <XT_deploy_path>\FileNet\WebClient\WorkplaceXT\WEB-INF\xml

附註 

檔案結構

如下面的清單所示,MenuActions.xml 是由五個區段組成:multiSelectActionstoolbarActionsfolderToobarActionstopLevelActionsactionDefinitions

topLevelActions 陣列和 multiSelectActions 陣列中,您可定義這些動作出現在使用者介面中的順序。 也就是說,在 topLevelActions 陣列中,值元素的順序會反映在蹦現功能表和資訊頁面上。 在 multiSelectActions 陣列中,值元素的順序會反映在複選功能表上。 您可以註銷動作來隱藏它們。

multiSelectActions 陣列中,您可以將動作指定為只能複選;也就是說,複選動作不必列在 topLevelActions 陣列中。

toolbarActionsfolderToolbarActions 區段中,您可定義工具列按鈕,當瀏覽或搜尋文件和資料夾時,這些按鈕會出現在工具列的「動作」按鈕旁邊。toolbarActions 區段控制文件相關動作;folderToolbarActions 區段控制資料夾相關動作。

actionDefinitions 清單由 action 物件組成,每一個物件都包含一份清單,其中會定義是否顯示每一個個別物件的動作。 請注意,最上層動作可包含子功能表,如果它包含子功能表,最上層動作定義必須包括 subActions 設定。另請注意,multiSelectActions 陣列中列出的動作定義必須包括 multiSelectURL 設定。如需所有設定的說明,請參閱 MenuAction 定義設定

功能表動作描述子 XML 檔中的區段

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

功能表動作定義設定

下表說明 MenuActions.xml 中的每一項動作定義設定。 每一項設定由其鍵內容識別。除非另外指定,否則設定是選用的。 如果選用的設定不存在,則使用其預設值。

URL 型樣巨集

下表的巨集用於動作定義的 url 設定中。 它們定義實作此動作之頁面的 URL,以及傳遞至 URL 的該頁面的參數。 巨集將由實際 URL 中的對應值取代。例如,如果型樣是 operations/Test.jsp?id={OBJECT_ID},且呼叫此作業的物件含有 {A73BEEB2-B0B7-11D2-8853-0000F80883E3} 的 ID,則作業 URL 是 operations/Test.jsp?id={A73BEEB2-B0B7-11D2-8853-0000F80883E3}

巨集
{OBJECT_STORE_NAME} 物件儲存庫名稱;例如,"TEST_OS"。
{OBJECT_ID} GUID 或路徑格式中的物件 ID。
{OBJECT_LABEL} 出現在使用者介面中的標籤的物件標籤。
{OBJECT_TYPE} 「字串」物件類型;例如,"document" 或 "folder"。
{VERSION_SERIES_ID} GUID 格式的版本系列 ID。
{CLASS_ID} GUID 格式的類別 ID。
{CONTENT_TYPE} 「字串」內容類型,URL 編碼。
{MAJOR_VERSION} 主要版本;例如,"1"。
{MINOR_VERSION} 次要版本;例如,"2"。
{VERSION_STATUS} 版本狀態號碼;例如,"1"。
{RETURN_URL} 傳回 URL,URL 編碼;例如,"http://<server>:<port>/WorkplaceXT/Browse.jsf"
{TIME_ZONE} 時區 ID。