配置觀看的資料夾端點 configuring-watched-folder-endpoints

管理員可以配置網路資料夾，稱為 已觀看的資料夾，以便當使用者將檔案(例如PDF檔案)放入觀看的資料夾時，會叫用已設定的服務操作並操作該檔案。 服務執行指定操作後，會將修改的檔案保存在指定的輸出資料夾中。

配置監看資料夾服務 configuring-the-watched-folder-service

配置監看資料夾端點之前，請配置「監看資料夾」服務。 Watched資料夾服務的設定參數有兩個用途：

設定「觀看資料夾」服務後，您會為目標服務新增「觀看資料夾」端點。 添加端點時，可以設定值（如服務名和操作名），以在檔案或資料夾置於配置的「監視資料夾」服務的輸入資料夾中時調用。 如需設定「觀看資料夾」服務的詳細資訊，請參閱 已觀看資料夾服務設定.

建立已觀看的資料夾 creating-a-watched-folder

您可以透過下列兩種方式建立已監看的資料夾：

在群集環境中，將用作監視資料夾的資料夾必須在檔案系統或網路上可訪問、可寫和共用。 在此情況下，群集的每個應用程式伺服器實例都必須具有對同一共用資料夾的訪問權限。

在Windows中，如果應用程式伺服器以服務形式運行，則必須以以下方式之一以適當訪問共用資料夾的方式啟動它：

將監視的資料夾連結在一起 chaining-together-watched-folders

監視資料夾可以連結在一起，這樣一個監視資料夾的結果文檔就是下一個監視資料夾的輸入文檔。 每個已觀看的資料夾都可叫用不同的服務。 以此方式配置受監視的資料夾，可以叫用多個服務。 例如，一個觀看的資料夾可將PDF檔案轉換為Adobe PostScript®，而另一個觀看的資料夾可將PostScript檔案轉換為PDF/A格式。 若要這麼做，只需將 結果 由您的第一個端點定義的已觀看資料夾的資料夾，以指向 輸入 由第二個端點定義的監看資料夾的資料夾。

第一次轉換後的輸出將轉到\path\result。 第二次轉換的輸入為\path\result，第二次轉換的輸出將轉到\path\result\result （或在「結果資料夾」框中為第二次轉換定義的目錄）。

使用者與已觀看資料夾互動的方式 how-users-interact-with-watched-folders

對於觀看資料夾端點，使用者可以複製輸入檔案或資料夾，或將其從案頭拖曳至觀看資料夾，借此叫用。 系統會依檔案到達的順序處理檔案。

對於監看資料夾端點，如果作業僅需要一個輸入檔案，則用戶可將該檔案複製到監看資料夾的根目錄。

如果作業包含多個輸入檔案，則用戶必須在包含所有必需檔案的監視資料夾層次結構之外建立資料夾。 此新資料夾應包含輸入檔案（若處理程式需要，還可選擇使用DDX檔案）。 建立作業資料夾後，使用者會將其複製到監看資料夾的輸入資料夾中。

已監看資料夾輸出 watched-folder-output

當輸入是資料夾且輸出包含多個檔案時，AEM Forms將建立一個與輸入資料夾同名的輸出資料夾，並將輸出檔案複製到該資料夾中。 當輸出包含包含鍵值對的文檔映射時（如輸出進程的輸出），鍵將用作輸出檔案名。

端點進程產生的輸出檔案名不能包含字母、數字和句點(.)以外的字元 在副檔名之前。 AEM表單會將其他字元轉換為十六進位值。

客戶端應用程式從監視的資料夾結果資料夾中提取結果文檔。 進程錯誤記錄在監看的資料夾失敗資料夾中。

監看資料夾如何運作 how-watched-folder-works

「已觀看資料夾」模組包含下列服務：

除了上述服務外，「觀看資料夾」還取決於其他服務，包括調度作業的調度程式服務和支援非同步調用目標服務的作業管理器服務。

Watched Folder如何處理調用請求 how-watched-folder-processes-an-invocation-request

Watched Folder服務會處理端點的建立、更新和刪除。 管理員建立端點後，會根據指定的重複間隔或cron運算式，排程由排程器服務觸發這些端點。

此圖表說明Watched Folder如何處理調用請求。

使用觀看資料夾叫用服務的程式如下：

已監看資料夾端點設定 watched-folder-endpoint-settings

使用下列設定來配置監看的資料夾端點。

名稱： （必要）識別端點。 請勿包含<字元，因為它會截斷工作區中顯示的名稱。 如果您輸入URL作為端點的名稱，請確保它符合RFC1738中指定的語法規則。

說明： 端點的說明。 請勿包含<字元，因為它會截斷工作區中顯示的說明。

路徑： （必要）指定已觀看的資料夾位置。 在群集環境中，此設定必須指向可從群集中的每台電腦訪問的共用網路資料夾。

非同步： 將調用類型標識為非同步或同步。 預設值為非同步。 對於長期進程，建議使用非同步，而對於暫時進程或短期進程，建議使用同步。

Cron運算式： 如果必須使用cron運算式排程已觀看的資料夾，請輸入cron運算式。 設定此設定時，會忽略重複間隔。

重複間隔： 掃描觀看的資料夾以進行輸入的間隔（秒）。 除非啟用「限制」設定，否則「重複間隔」應長於處理平均作業的時間；否則，系統可能會變得過載。 預設值為 5。如需詳細資訊，請參閱批次大小說明。

重複計數： 監視的資料夾掃描資料夾或目錄的次數。 值–1表示掃描不確定。 預設值為–1。

節流： 選取此選項時，會限制AEM表單在任何指定時間處理的已觀看資料夾作業數。 作業的最大數量由批大小值確定。 （請參閱關於限制。）

用戶名： （必要）從已觀看的資料夾叫用目標服務時所使用的使用者名稱。 預設值為SuperAdmin。

域名： （必要）使用者的網域。 預設值為DefaultDom。

批大小： 每次掃描要提取的檔案或資料夾數。 用於防止系統過載；一次掃描太多檔案可能會造成當機。 預設值為 2。

「重複間隔」和「批次大小」設定決定「監看資料夾」在每次掃描中擷取的檔案數。 「監視資料夾」使用Quartz線程池掃描輸入資料夾。 線程池與其他服務共用。 如果掃描間隔較小，線程將經常掃描輸入資料夾。 如果檔案經常被拖放到監看的資料夾中，則應將掃描間隔保持在較小。 如果檔案不常被刪除，請使用較大的掃描間隔，以便其他服務可以使用線程。

如果要刪除的檔案量很大，請使批處理大小較大。 例如，如果受監視資料夾端點調用的服務每分鐘可處理700個檔案，並且用戶以相同的速率將檔案拖放到輸入資料夾中，則將「批大小」設定為350，將「重複間隔」設定為30秒，將有助於「受監視資料夾」的效能，而不會導致掃描受監視資料夾的成本過多。

將檔案放入觀看的資料夾時，會列出輸入中的檔案，如果每秒都進行掃描，會降低效能。 增加掃描間隔可以提高效能。 如果要丟棄的檔案量較小，請相應調整「批大小」和「重複間隔」。 例如，如果每秒丟棄10個檔案，請嘗試將「重複間隔」設定為1秒，將「批大小」設定為10。

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

此設定對於確保將檔案或資料夾完全複製到輸入資料夾非常有用。 例如，如果要處理大型檔案，而要下載該檔案需要10分鐘，請將等待時間設定為10*60*1000毫秒。 如果檔案未保存10分鐘，則禁止監視的資料夾掃描該檔案。

排除檔案模式： 分號 ; 已分隔的模式清單，受監視的資料夾用於確定要掃描和拾取的檔案和資料夾。 不會掃描任何具有此模式的檔案或資料夾以進行處理。

如果輸入是包含多個檔案的資料夾，此設定就十分實用。 資料夾的內容可複製到資料夾中，而資料夾的名稱將被觀看的資料夾擷取。 這樣，在資料夾完全複製到輸入資料夾之前，監視的資料夾就無法擷取資料夾以進行處理。

您可以使用檔案模式來排除：

如需檔案模式的詳細資訊，請參閱 關於檔案模式.

包含檔案模式： （必填）分號 ; 已分隔的模式清單，受監視的資料夾用於確定要掃描和拾取的資料夾和檔案。 例如，如果「包含檔案模式」為input*，則所有與input&ast匹配的檔案和資料夾；被撿起。 這包括名為input1、input2等的檔案和資料夾。

預設值為*並指示所有檔案和資料夾。

您可以使用檔案模式來包括：

如需檔案模式的詳細資訊，請參閱 關於檔案模式.

結果資料夾： 儲儲存存結果的資料夾。 如果結果未出現在此資料夾中，請檢查失敗資料夾。 不會處理唯讀檔案，且會儲存在失敗資料夾中。 此值可以是具有下列檔案模式的絕對或相對路徑：

例如，如果是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/。

失敗資料夾： 保存故障檔案的資料夾。 此位置一律與已觀看的資料夾相對。 可以使用檔案模式，如「結果資料夾」中所述。

不會處理唯讀檔案，且會儲存在失敗資料夾中。

預設值為failure/%Y/%M/%D/。

失敗時保留： 如果無法對服務執行操作，則保留輸入檔案。 預設值為true。

覆寫重複檔案名： 設為True時，會覆寫結果資料夾和保留資料夾中的檔案。 設為False時，名稱使用帶有數值索引尾碼的檔案和資料夾。 預設值為False。

清除持續時間： （必要）結果資料夾中的檔案和資料夾在早於此值時被清除。 此值以天計量。 此設定有助於確保結果資料夾不會填滿。

值為–1天表示絕不刪除結果資料夾。 預設值為–1。

操作名稱： （必要）可指派給監看資料夾端點的作業清單。

輸入參數映射： 用於配置處理服務和操作所需的輸入。 可用的設定取決於使用觀看資料夾端點的服務。 以下是兩種輸入：

常值： 監看的資料夾會使用在欄位中輸入的值顯示。 支援所有基本Java類型。 例如，如果API使用String、long、int和Boolean等輸入，則字串會轉換為適當的類型，並叫用服務。

變數： 輸入的值是檔案模式，監看資料夾用於選擇輸入。 例如，在加密密碼服務中，輸入文檔必須是PDF檔案，用戶可以使用*.pdf作為檔案模式。 監視資料夾將提取監視資料夾中符合此模式的所有檔案，並為每個檔案調用服務。 使用變數時，所有輸入檔案都會轉換為檔案。 僅支援使用檔案作為輸入類型的API。

輸出參數映射： 用於配置服務和操作的輸出。 可用的設定取決於使用觀看資料夾端點的服務。

「監看的資料夾」輸出可以是單個文檔、文檔清單或文檔地圖。 然後，使用輸出參數映射中指定的模式將這些輸出文檔保存到結果資料夾中。

關於檔案模式 about-file-patterns

管理員可以指定可叫用服務的檔案類型。 可為每個觀看的資料夾建立多個檔案模式。 檔案模式可以是下列檔案屬性之一：

管理員可以定義要儲存結果的輸出資料夾的檔案模式。 對於輸出資料夾（結果、保留和失敗），管理員可以指定以下任一檔案模式：

例如，結果資料夾的路徑可能是 C:\Adobe\Adobe_Experience_Manager_forms\BarcodedForms\%y\%m\%d.

輸出參數映射也可以指定其他模式，例如：

如果輸出參數映射模式以「File.separator」（路徑分隔符）結尾，則會建立資料夾並將內容複製到該資料夾中。 如果模式的結尾不是「File.separator」，則會以該名稱建立內容（結果檔案或資料夾）。 如需有關輸出參數映射的詳細資訊，請參閱 觀看資料夾的提示與秘訣.

關於節流 about-throttling

為監看資料夾端點啟用限制時，它會限制在任何指定時間可處理的監視資料夾作業數量。 作業的最大數量由「批大小」值確定，也可在「監視資料夾」端點中配置。 達到限制限制時，將不會輪詢監視資料夾輸入目錄中的傳入文檔。 在其他已監視的資料夾作業完成並進行另一輪輪詢嘗試之前，文檔還將保留在輸入目錄中。 在同步處理的情況下，即使在單個線程中連續處理作業，在單個輪詢中處理的所有作業都將計入限制。

節流如何運作 how-throttling-works

「監視的資料夾」在每個重複間隔掃描輸入資料夾，提取批大小中指定的檔案數，並為每個檔案調用目標服務。 例如，如果批大小為4，則在每次掃描時，「監看資料夾」將拾取4個檔案、建立4個調用請求，並調用目標服務。 在完成這些請求之前，如果調用了「監視的資料夾」，則無論前四個作業是否完成，它都將再次啟動四個作業。

當前的作業未完成時，限制阻止「監視的資料夾」調用新作業。 「監看的資料夾」將根據批次大小減去進行中的作業來偵測進行中的作業，並處理新作業。 例如，在第二個調用中，如果已完成的作業數僅為三個，並且一個作業仍在進行中，則「監視的資料夾」僅調用另外三個作業。

效能和可擴充性 performance-and-scalability

「觀看的資料夾」可在單一節點上共提供100個資料夾。 「觀看的資料夾」的效能取決於表單伺服器的效能。 對於非同步調用，效能更取決於作業管理器隊列中的系統負載和作業。

向叢集新增節點，可改善「監看資料夾」的效能。 通過Quartz調度程式和非同步請求時通過作業管理器服務在群集節點間分配觀看的資料夾作業。 所有作業都保存在資料庫中。

「監看資料夾」取決於調度程式服務，用於調度、取消調度和重新計畫作業。 其他服務（如事件管理服務、用戶管理器服務和電子郵件提供程式服務）可共用調度程式服務線程池。 這會影響「已監看資料夾」的效能。 當所有服務開始使用調度程式服務線程池時，將需要調整該調度程式服務線程池。

在群集中監視資料夾 watched-folders-in-a-cluster

在群集中，Watched Folder取決於Quartz調度程式和作業管理器服務，以實現負載平衡和故障切換。 有關Quartz群集行為的詳細資訊，請參見 Quartz文檔.

「已觀看資料夾」在每次輪詢中執行以下三項主要任務：

負載平衡和故障轉移行為會根據監視的資料夾配置為同步還是非同步調用而改變。

群集中的同步監視資料夾 synchronous-watched-folder-in-a-cluster

對於同步調用，Quartz負載平衡器將決定哪個節點將獲取輪詢事件。 獲取輪詢事件的節點將執行所有任務：掃描資料夾、調用目標服務並處理結果。

對於同步調用，當一個節點失敗時，Quartz調度程式會向其他節點發送新的輪詢事件。 在失敗節點上啟動的調用將丟失。 有關如何恢復與失敗作業關聯的檔案的詳細資訊，請參見 故障點和恢復.

叢集中的非同步監看資料夾 asynchronous-watched-folder-in-a-cluster

對於非同步調用，Quartz負載平衡器將決定哪個節點將獲取輪詢事件。 獲取輪詢事件的節點將掃描輸入資料夾，並將請求放在作業管理器服務隊列中以調用目標服務。 作業管理器服務負載平衡器則負責決定要處理調用請求的節點。 即使節點A建立了調用請求，節點B最終仍可能處理該請求。 或者，啟動調用請求的節點也可能最終處理該請求。

對於非同步調用，當一個節點失敗時，Quartz調度程式會向其他節點發送新的輪詢事件。 在失敗節點上建立的調用請求將位於作業管理器服務隊列中，並將發送到其他節點進行處理。 未建立調用請求的檔案將保留在階段資料夾中。 有關如何恢復與失敗作業關聯的檔案的詳細資訊，請參見 故障點和恢復.

故障點和恢復 failure-points-and-recovery

在每個民調問答事件中，「觀看的資料夾」都會鎖定輸入資料夾、將符合包含檔案模式的檔案移動到階段資料夾，然後解鎖輸入資料夾。 需要鎖定，這樣兩個線程就不會提取同一組檔案並處理兩次。 發生此情況的機率會隨著小重複間隔和大批次大小而增加。 將檔案移到舞台資料夾後，輸入資料夾將解除鎖定，以便其他線程可以掃描資料夾。 此步驟有助於提供高吞吐量，因為其他線程可以在一個線程處理檔案時進行掃描。

將檔案移到階段資料夾後，會為每個檔案建立調用請求，並調用目標服務。 有時候，「監視的資料夾」無法恢復階段資料夾中的檔案：

同步： 如果「監看資料夾」配置為同步調用服務，則舞台資料夾中的所有檔案在舞台資料夾中都將保留為未處理。

非同步： 在這種情況下，「觀看的資料夾」需仰賴「工作管理員」服務。 如果作業管理器服務回叫「監看資料夾」，則階段資料夾中的檔案會根據調用的結果移動到「保留」或「失敗」資料夾。 如果作業管理器服務未回叫「已監看資料夾」，則檔案在預備資料夾中將保留未處理。 當工作管理員回呼時，「已監看資料夾」未執行時，就會發生此情況。

在階段資料夾中恢復未處理的源檔案 recovering-unprocessed-source-files-in-the-stage-folder

當「監看資料夾」無法處理階段資料夾中的源檔案時，您可以恢復未處理的檔案。

觀看資料夾的安全性考量事項 security-considerations-for-watched-folders

每個觀看的資料夾都設定有使用者名稱和密碼。 叫用服務時會使用這些憑證。 「監視的資料夾」依賴於共用資料夾受基礎安全檔案系統的保護，這樣只有監視的資料夾的所有者才能訪問共用資料夾。

觀看資料夾的提示與秘訣 tips-and-tricks-for-watched-folders

以下是設定「觀看資料夾」端點時的一些秘訣和技巧：

受監視資料夾的服務專屬建議 service-specific-recommendations-for-watched-folders

對於所有服務，您應調整已觀看資料夾的批次大小和重複間隔，使「已觀看資料夾」擷取新檔案和資料夾以進行處理的速率不超過AEM表單伺服器可處理的作業速率。 使用的實際參數可能會因配置的監視資料夾數量、使用監視資料夾的服務以及處理器上作業的密集程度而有所不同。

產生PDF服務建議 generate-pdf-service-recommendations

條碼式表單服務建議 barcoded-forms-service-recommendations