建立或配置監看資料夾

管理員可以配置網路資料夾(稱為​watched資料夾),以便當用戶將檔案(如PDF檔案)放置到監視資料夾時,啟動預先配置的操作並操作該檔案。 執行指定操作後,操作會將修改的檔案保存到指定的輸出資料夾中。 有關管理已監視資料夾的詳細資訊,請參閱管理幫助

您可以使用觀看的資料夾使用者介面來:

  • 建立已觀看的資料夾
  • 修改現有監視資料夾的屬性
  • 刪除已監視的資料夾

建立已觀看的資料夾

設定已監看資料夾之前,請確定下列事項:

  • 監看資料夾是AEM表單的進階功能。 需要AEM Forms附加套件才能運作。 請確定已安裝並設定適當的AEM Forms附加元件套件。
  • 您可以在共用或本機儲存空間中建立已觀看的資料夾。 確保配置為運行觀看資料夾的AEM Forms用戶具有觀看資料夾的讀寫權限。
  • 您可以使用服務、工作流程或指令碼,以自動執行有已觀看資料夾的操作。 請確定已建立對應的服務、工作流程或指令碼,並準備好執行。 有關建立服務、工作流和指令碼的資訊,請參閱各種處理檔案的方法
  • 已觀看的資料夾有各種屬性,請參閱已觀看的資料夾屬性

執行下列步驟以建立已觀看的資料夾:

  1. 點選畫面左上角的​Adobe Experience Manager​圖示。

  2. 點選​工具 > Forms > 設定已觀看的資料夾。 將顯示已配置的監視資料夾清單。

  3. 點選​新增。 此時會顯示建立觀看資料夾所需的欄位清單:

    • 名稱:識別已觀看的資料夾。名稱僅使用英數字元。

    • 路徑:指定已監視的資料夾位置。在群集環境中,此設定必須指向一個共用網路資料夾,該資料夾可供在群集的不同節點上運行AEM的每個用戶訪問。

    • 使用​處理檔案:要啟動的進程類型。您可以指定工作流程、指令碼或服務。

    • 服務名稱/指令碼路徑/工作流路徑:欄位的行為基於為「進程檔案使用」欄位指 定的 值。您可以指定下列值:

      • 對於「工作流」,指定要執行的工作流模型。 例如, /etc/workflow/models/<workflow_name>/jcr:content/model
      • 對於指令碼,指定要執行的指令碼的JCR路徑。 例如, /etc/watchfolder/test/testScript.ecma
      • 針對服務,指定用於找到OSGi服務的篩選器。 此服務已註冊為com.adobe.aemfd.watchfolder.service.api.ContentProcessor介面的實作。 例如,以下代碼是ContentProcessor介面的自定義實現,該介面具有自定義(foo=bar)屬性。
    注意

    如果已為​使用​處理檔案欄位選擇​服務,則服務名稱(inputProcessorType)欄位的值必須括在括弧中。 例如(foo=bar)。

    @Component(metatype = true, immediate = true, label = "WF Test Service", description = "WF Test Service")
    @Service(value = {OutputWriter.class, ContentProcessor.class})
    @Property(name = "foo", value = "bar")
    public class OutputWriter implements ContentProcessor {
    
    • 輸出檔案模式:指定分號(;)分隔的模式清單,監視資料夾會使用該清單來判斷輸出檔案和資料夾的名稱和位置。有關檔案模式的詳細資訊,請參閱關於檔案模式
  4. 點選​進階。 進階標籤包含更多欄位。 這些欄位大多包含預設值。

    • 裝載對應器篩選: 當您建立已監看的資料夾時,會在正在觀看的資料夾內建立資料夾結構。資料夾結構具有階段、結果、保留、輸入和失敗資料夾。 資料夾結構可作為工作流的輸入裝載,並接受來自工作流的輸出。 它也可以列出故障點(如果有)。 有效負載的結構與已觀看資料夾的結構不同。 您可以撰寫自訂指令碼,將已觀看資料夾的結構對應至裝載。 這類指令碼稱為裝載映射器篩選器。 提供兩種現成可用的裝載映射器實施。 如果您沒有自訂實作,請使用其中一個現成可用的實作:

      • 預設對應器: 使用預設裝載對應器,將已監視資料夾的輸入和輸出內容保留在裝載中個別的輸入和輸出資料夾中。
      • 簡單檔案式裝載對應器: 使用簡單檔案式裝載對應器,將輸入和輸出內容直接保留在裝載資料夾中。它不會建立任何額外的階層,例如預設映射器。
    • 運行模式:指定以逗號分隔的允許執行模式清單以執行工作流程。

    • ​之後逾時分段檔案:指定在已擷取以進行處理的輸入檔案/資料夾被視為已逾時並標示為失敗之前,要等候的秒數。超時機制僅在此屬性的值為正數時激活。

    • 在限制時刪除超時分段檔案:如果啟用, 則僅當為觀看的資 料夾開啟節流時,才激活「超時分段檔案後」機制。

    • 每次掃描輸入資料夾: 指定掃描觀看的資料夾以取得輸入的時間間隔(以秒為單位)。除非啟用「調節」設定,否則輪詢間隔應比處理平均作業的時間長;否則,系統可能會超載。 間隔的值必須大於或等於1。

    • 排除檔案模式:指定分號(;)分隔的模式清單,監視資料夾會使用該清單來判斷要掃描和擷取的檔案和資料夾。系統不會掃描具有指定模式的任何檔案或資料夾以進行處理。 有關檔案模式的詳細資訊,請參閱關於檔案模式

    • 包含檔案模式:指定分號(;)分隔的模式清單,監視資料夾會使用該清單來判斷要掃描和擷取的資料夾和檔案。例如,如果「包含檔案模式」為input&ast;,則所有符合input&ast的檔案和資料夾;被撿起。 預設值為&ast;並指示所有檔案和資料夾。 有關檔案模式的詳細資訊,請參閱關於檔案模式

    • 等待時間: 指定在建立資料夾或檔案後,在掃描該資料夾或檔案之前等待的時間(以毫秒為單位)。例如,如果等待時間為3,600,000毫秒(一小時),而檔案是在一分鐘前建立的,則此檔案將在59分鐘或更長時間過後擷取。 預設值為 0。

      此設定非常實用,可確保檔案或資料夾的所有內容都複製到輸入資料夾。 例如,若您有要處理的大型檔案,且該檔案需要10分鐘才能下載,請將等待時間設為10&ast;60&ast;1000毫秒。 如果檔案未保存10分鐘,此間隔將阻止監視的資料夾掃描該檔案。

    • 刪除早於: 指定在刪除早於指定值的檔案和資料夾之前等待的時間(以天為單位)。此設定有助於確保結果資料夾不會填滿。 值為–1天表示絕不刪除結果資料夾。 預設值為–1。

    • 結果資料夾名稱: 指定要儲存結果的資料夾名稱。如果結果未出現在此資料夾中,請檢查失敗資料夾。 不會處理唯讀檔案,且會將其儲存在失敗資料夾中。 您可以使用具有下列檔案模式的絕對或相對路徑:

      • %F =檔案名首碼
      • %E =副檔名
      • %Y =年(已滿)
      • %y =年(最後兩位)
      • %M =月
      • %D =月中的第幾天
      • %d =年
      • %H =小時(24小時時鐘)
      • %h =小時(12小時時鐘)
      • %m =分鐘
      • %s =秒
      • %l =毫秒
      • %R =隨機數(介於0到9之間)
      • %P =進程或作業ID
      • 例如,如果它是2009年7月17日的晚上8點,並且您指定C:/Test/WF0/failure/%Y/%M/%D/%H/,則結果資料夾為C:/Test/WF0/failure/2009/07/17/20。
      • 如果路徑不是絕對路徑,而是相對路徑,則會在觀看的資料夾內建立資料夾。 預設值為result/%Y/%M/%D/,即監視資料夾內的「結果」資料夾。 有關檔案模式的詳細資訊,請參閱關於檔案模式
    • 失敗資料夾名稱: 指定儲存失敗檔案的資料夾。此位置一律與已觀看的資料夾相對。 可以使用檔案模式,如「結果資料夾」中所述。

    • 保留資料夾名稱: 指定成功掃描和拾取後儲存檔案的資料夾。路徑可以是絕對目錄、相對目錄或空目錄。 可以使用檔案模式,如「結果資料夾」中所述。 預設值為preserve/%Y/%M/%D/。

    • 批大小: 指定每次掃描要擷取的檔案或資料夾數量。它防止了系統過載;一次掃描太多檔案可能會造成當機。 預設值為 2。

      如果掃描間隔較小,線程會經常掃描輸入資料夾。 如果檔案經常被拖放到監看的資料夾中,則應將掃描間隔保持在較小。 如果檔案不常被刪除,請使用較大的掃描間隔,以便其他服務可以使用線程。

    • 限制開啟: 啟用此選項時,它會限制AEM表單在任何指定時間處理的已監看資料夾作業數量。「批大小」值確定作業的最大數量。 有關詳細資訊,請參閱throttling

    • 以類似名稱覆寫現有檔案:設為True時,會覆寫結果資料夾和保留資料夾中的檔案。設為False時,名稱使用帶有數值索引尾碼的檔案和資料夾。 預設值為False。

    • 失敗時保留檔案: 設為True時,會在失敗時保留輸入檔案。預設值為true。

    • 包含具有模式的檔案: 指定分號(;)分隔的模式清單,監看的資料夾會使用該清單來判斷要掃描和擷取的資料夾和檔案。例如,如果輸入了「包含檔案模式」,則會拾取所有與輸入匹配的檔案和資料夾。 如需詳細資訊,請參閱管理說明

    • 非同步叫用監看資料夾: 將呼叫類型識別為非同步或同步。預設值為非同步。 對於長期進程,建議使用非同步,而對於暫時進程或短期進程,建議使用同步。

    • 啟用監看資料夾: 啟用此選項時,就會啟用監看資料夾。預設值為True。

修改現有監視資料夾的屬性

除了更改監視資料夾的名稱外,您還可以修改現有監視資料夾的所有屬性。 執行以下步驟修改現有監視資料夾的屬性:

  1. 點選畫面左上角的​Adobe Experience Manager​圖示。
  2. 點選​工具 > Forms > 設定已觀看的資料夾。 將顯示已配置的監視資料夾清單。
  3. 在「觀看資料夾」畫面的左側,選取觀看資料夾,然後點選「編輯」。 隨即顯示建立觀看資料夾所需的欄位清單。Basic​索引標籤中列出的欄位是必填欄位。 進階標籤包含更多欄位。 這些欄位大多包含預設值。 您可以根據需求修改這些屬性。
  4. 修改屬性後,點選​Update。 已修改的屬性將被保存。

本頁內容