正在設定watched資料夾端點 configuring-watched-folder-endpoints

管理員可以設定網路資料夾，稱為​ watched資料夾，這樣當使用者將檔案(例如PDF檔案)放入watched資料夾時，就會叫用已設定的服務作業並操作檔案。 服務執行指定的作業後，會將修改的檔案儲存在指定的輸出資料夾中。

正在設定Watched資料夾服務 configuring-the-watched-folder-service

設定watched資料夾端點之前，請先設定Watched資料夾服務。 Watched資料夾服務的設定引數有兩個用途：

在設定Watched資料夾服務後，您為目標服務新增Watched資料夾端點。 新增端點時，您可以設定值，例如將檔案或資料夾放在已設定之Watched資料夾服務的輸入資料夾中時，要呼叫的服務名稱和作業名稱。 如需設定Watched資料夾服務的詳細資訊，請參閱Watched資料夾服務設定。

正在建立watched資料夾 creating-a-watched-folder

您可以透過下列兩種方式建立watched資料夾：

在叢集環境中，用來當作watched資料夾的資料夾必須在檔案系統或網路上可以存取、寫入和共用。 在此案例中，叢集的每個應用程式伺服器執行個體都必須擁有相同共用資料夾的存取權。

在Windows中，如果應用程式伺服器是以服務的形式執行，則必須透過下列其中一種方式，以適當的共用資料夾存取權來啟動應用程式伺服器：

將watched資料夾鏈結在一起 chaining-together-watched-folders

Watched資料夾可以鏈結在一起，因此一個watched資料夾的結果檔案是下一個watched資料夾的輸入檔案。 每個watched資料夾都可以叫用不同的服務。 透過以這種方式設定watched資料夾，可以叫用多項服務。 例如，一個watched資料夾可以將PDF檔案轉換為Adobe PostScript®而另一個watched資料夾可以將PostScript檔案轉換為PDF/A格式。 若要這麼做，只要將您第一個端點所定義的watched資料夾的​ result ​資料夾設定為指向您第二個端點所定義的watched資料夾的​ input ​資料夾。

第一次轉換的輸出將轉至\path\result。 第二次轉換的輸入為\path\result，而第二次轉換的輸出會移至\path\result\result （或您在第二次轉換的「結果資料夾」方塊中定義的目錄）。

使用者如何與watched資料夾互動 how-users-interact-with-watched-folders

對於watched資料夾端點，使用者可以從案頭複製或拖曳輸入檔案或資料夾到watched資料夾，以叫用。 系統會依檔案到達的順序來處理這些檔案。

對於watched資料夾端點，如果工作只需要一個輸入檔案，使用者可以將該檔案複製到watched資料夾的根目錄。

如果作業包含多個輸入檔案，使用者必須在包含所有必要檔案的watched資料夾階層之外建立資料夾。 這個新資料夾應該包含輸入檔案（如果處理序有需要，還可以選擇包含DDX檔案）。 在建構工作資料夾後，使用者將其複製到watched資料夾的輸入資料夾中。

Watched資料夾輸出 watched-folder-output

當輸入為資料夾且輸出包含多個檔案時，AEM forms會建立與輸入資料夾同名的輸出資料夾，並將輸出檔案複製到該資料夾中。 當輸出包含包含索引鍵/值組的檔案對映時（例如輸出程式的輸出），索引鍵會用作輸出檔案名稱。

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

使用者端應用程式會從watched資料夾結果資料夾中擷取結果檔案。 處理程式錯誤記錄在watched資料夾失敗資料夾中。

Watched資料夾運作方式 how-watched-folder-works

Watched資料夾模組包含下列服務：

除了上述服務之外，Watched Folder還依賴其他服務，包括用於排程工作的排程器服務，以及支援非同步呼叫目標服務的工作管理員服務。

Watched資料夾如何處理呼叫要求 how-watched-folder-processes-an-invocation-request

Watched資料夾服務可處理端點的建立、更新及刪除。 管理員建立端點後，會根據指定的重複間隔或cron運算式，將端點排程為由「排程器」服務觸發。

此圖表說明Watched資料夾如何處理呼叫要求。

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

Watched資料夾端點設定 watched-folder-endpoint-settings

使用下列設定來設定watched資料夾端點。

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

描述： ​端點的描述。 請勿包含<字元，因為這會截斷Workspace中顯示的說明。

路徑： （必要）指定watched資料夾位置。 在叢集環境中，此設定必須指向可以從叢集中的每台電腦存取的共用網路資料夾。

非同步： ​將呼叫型別識別為非同步或同步。 預設值為非同步。 建議將非同步處理用於長效處理作業，而建議將同步處理用於暫時性或短效處理作業。

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

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

重複計數： ​監看資料夾掃描資料夾或目錄的次數。 值–1表示無限掃描。 預設值為 -1。

節流： ​選取此選項時，它會限制AEM表單在任何指定時間處理的watched資料夾工作數目。 最大作業數由「批次大小」值決定。 （請參閱關於節流）。

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

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

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

「重複間隔」和「批次大小」設定決定了Watched Folder在每次掃描中擷取的檔案數。 Watched資料夾使用Quartz執行緒集區來掃描輸入資料夾。 執行緒集區與其他服務共用。 如果掃描間隔很小，執行緒會經常掃描輸入資料夾。 如果檔案經常被拖放到watched資料夾中，則您應該將掃描間隔維持在較小的範圍內。 如果檔案不常捨棄，請使用較大的掃描間隔，讓其他服務可以使用執行緒。

如果有大量檔案被捨棄，請讓批次大小變大。 例如，如果由watched資料夾端點叫用的服務每分鐘可以處理700個檔案，而且使用者以相同的速率將檔案放入輸入資料夾，則將「批次大小」設定為350，並將「重複間隔」設定為30秒，將有助於Watched資料夾的效能，而不會產生經常掃描watched資料夾的成本。

當檔案被放入watched資料夾時，它會列出輸入中的檔案，如果每秒都進行掃描，這會降低效能。 增加掃描間隔可以改善效能。 如果捨棄的檔案量很小，請相應地調整「批次大小」和「重複間隔」。 例如，如果每秒丟棄10個檔案，請嘗試將「重複間隔」設定為1秒，並將「批次大小」設定為10。

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

此設定對於確保檔案或資料夾完全複製到輸入資料夾非常有用。 例如，如果您有大型檔案要處理，且檔案下載需要10分鐘，請將等待時間設為10&amp；ast；60&amp；ast；1000毫秒。 這可防止watched資料夾掃描未滿十分鐘的檔案。

排除檔案模式： ​分號​ ； ​分隔的模式清單，Watched資料夾會使用這些模式來決定要掃描和擷取的檔案和資料夾。 將不會掃描任何具有此模式的檔案或資料夾以進行處理。

當輸入是具有多個檔案的資料夾時，此設定非常有用。 資料夾的內容可以複製到資料夾中，其名稱會由watched資料夾擷取。 這可防止watched資料夾在資料夾完全複製到輸入資料夾之前擷取資料夾進行處理。

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

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

包含檔案模式： （必要）分號​ ； ​分隔的模式清單，Watched資料夾會使用這些模式來決定要掃描和擷取的資料夾和檔案。 例如，如果「包含檔案模式」是input&amp；ast；，則會擷取符合input&amp；ast；的所有檔案和資料夾。 這包括名為input1、input2等的檔案和資料夾。

預設值為&amp；ast；，表示所有檔案和資料夾。

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

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

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

例如，如果是2009年7月17日晚上8點，而您指定C:/Test/WF0/failure/%Y/%M/%D/%H/，則結果資料夾為C:/Test/WF0/failure/2009/07/17/20。

如果路徑不是絕對路徑而是相對路徑，則會在watched資料夾內建立資料夾。 預設值為result/%Y/%M/%D/，這是watched資料夾內的Result資料夾。 如需檔案模式的詳細資訊，請參閱關於檔案模式。

保留資料夾： ​成功掃描及擷取檔案後，儲存檔案的位置。 路徑可以是絕對、相對或Null目錄路徑。 您可以使用檔案模式，如「結果資料夾」中所述。 預設值為preserve/%Y/%M/%D/。

失敗資料夾： ​儲存失敗檔案的資料夾。 此位置永遠是相對於watched資料夾。 您可以使用檔案模式，如「結果資料夾」中所述。

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

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

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

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

清除持續時間： （必要）結果資料夾中的檔案和資料夾早於此值時會被清除。 此值以天為單位測量。 此設定對於確保結果資料夾不會填滿非常有用。

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

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

輸入引數對應： ​用來設定處理服務與作業所需的輸入。 可用的設定視使用watched資料夾端點的服務而定。 以下是兩種輸入型別：

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

變數： ​輸入的值是watched資料夾用來挑選輸入的檔案模式。 例如，如果存在加密密碼服務，其中輸入檔案必須是PDF檔案，則使用者可以使用&amp；ast；.pdf作為檔案模式。 Watched資料夾會擷取Watched資料夾中符合此模式的所有檔案，並叫用每個檔案的服務。 使用變數時，所有輸入檔案都會轉換為檔案。 僅支援使用Document作為輸入型別的API。

輸出引數對應： ​用來設定服務與作業的輸出。 可用的設定視使用watched資料夾端點的服務而定。

Watched資料夾輸出可以是單一檔案、檔案清單或檔案地圖。 然後這些輸出檔案會使用「輸出引數對應」中指定的模式儲存在結果資料夾中。

關於檔案模式 about-file-patterns

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

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

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

輸出引數對應也可以指定其他模式，例如：

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

關於節流 about-throttling

為監看資料夾端點啟用節流時，會限制可在任何指定時間處理的監看資料夾工作數目。 作業的最大數量由「批次大小」值決定，此值也可在Watched資料夾端點中設定。 當達到節流限制時，不會輪詢watched資料夾輸入目錄中的傳入檔案。 檔案也會保留在輸入目錄中，直到其他watched資料夾工作完成且進行另一次輪詢嘗試為止。 如果有同步處理，即使作業在單一執行緒中連續處理，在單一輪詢中處理的所有作業都將計入節流限制中。

節流如何運作 how-throttling-works

Watched Folder會以每一個「重複間隔」掃描輸入資料夾，擷取在「批次大小」中指定的檔案數目，並叫用這些檔案的目標服務。 例如，如果「批次大小」為4，則每次掃描時，Watched Folder會挑選四個檔案、建立四個呼叫請求，然後呼叫目標服務。 在完成這些要求之前，如果叫用Watched資料夾，將會再次啟動4個工作，無論前4個工作是否已完成。

節流可防止Watched資料夾在先前工作未完成時叫用新工作。 Watched資料夾會偵測進行中的工作，並根據批次大小減去進行中的工作來處理新工作。 例如，在第二個叫用中，如果完成的工作只有三個，而一個工作仍在進行中，則Watched資料夾只會叫用另外三個工作。

效能與擴充性 performance-and-scalability

Watched資料夾可在單一節點上提供總計100個資料夾。 Watched資料夾的效能取決於Forms伺服器的效能。 對於非同步叫用，效能更取決於系統載入和「作業管理員」佇列中的作業。

Watched資料夾效能可藉由將節點新增至叢集來改善。 Watched資料夾工作會透過Quartz排程器散佈到叢集節點，而且如果有非同步要求，則由Job Manager服務散佈。 所有工作都會保留在資料庫中。

Watched資料夾依賴排程器服務來排程、取消排程和重新排程工作。 其他服務，例如「事件管理」服務、「使用者管理員」服務，以及「電子郵件提供者」服務，都可共用排程器服務執行緒集區。 這可能會影響Watched資料夾的效能。 當所有服務都開始使用排程器服務執行緒集區時，將需要對其進行調整。

叢集中的Watched資料夾 watched-folders-in-a-cluster

在叢集中，Watched資料夾依賴於Quartz排程器和Job Manager服務來進行負載平衡和容錯移轉。 如需Quartz叢集行為的詳細資訊，請參閱Quartz檔案。

Watched Folder會在每次輪詢時執行以下三個主要工作：

負載平衡和容錯移轉行為會依據是否將watched資料夾設定為同步或非同步呼叫而變更。

叢集中的同步Watched資料夾 synchronous-watched-folder-in-a-cluster

對於同步叫用，Quartz負載平衡器會決定哪個節點會取得輪詢事件。 取得輪詢事件的節點會執行所有工作：掃描資料夾、呼叫目標服務及處理結果。

對於同步叫用，當一個節點失敗時，Quartz排程器會傳送新的輪詢事件到其他節點。 在失敗節點上啟動的呼叫將會遺失。 如需有關如何復原與失敗工作關聯的檔案的詳細資訊，請參閱失敗點和復原。

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

對於非同步呼叫，Quartz負載平衡器會決定哪個節點會取得輪詢事件。 取得輪詢事件的節點會掃描輸入資料夾，並透過將要求放入工作管理員服務佇列來叫用目標服務。 工作管理員服務負載平衡器接著負責決定哪個節點將處理呼叫請求。 即使節點A建立了叫用請求，節點B最終還是會處理請求。 或者，啟動呼叫請求的節點最終也可能處理請求。

對於非同步呼叫，當一個節點失敗時，Quartz排程器會傳送新的輪詢事件給其他節點。 在失敗節點上建立的呼叫要求會位於工作管理員服務佇列中，並傳送至其他節點進行處理。 未建立叫用要求的檔案將保留在stage資料夾中。 如需有關如何復原與失敗工作關聯的檔案的詳細資訊，請參閱失敗點和復原。

失敗點和復原 failure-points-and-recovery

在每個輪詢事件中，Watched Folder會鎖定輸入資料夾，將符合包含檔案模式的檔案移動到stage資料夾，然後解除鎖定輸入資料夾。 需要鎖定，這樣兩個執行緒就不會擷取相同的檔案集並處理它們兩次。 較小的重複間隔和較大的批次大小會增加發生此情形的機會。 將檔案移至stage資料夾後，輸入資料夾會解除鎖定，以便其他執行緒可以掃描該資料夾。 此步驟有助於提供高輸送量，因為其他執行緒可以在一個執行緒處理檔案時進行掃描。

將檔案移至stage資料夾後，系統會為每個檔案建立叫用請求，並叫用目標服務。 Watched資料夾可能無法復原stage資料夾中的檔案：

同步： ​如果Watched資料夾設定為同步叫用服務，stage資料夾中的所有檔案在stage資料夾中仍維持未處理狀態。

非同步： ​在此案例中，Watched資料夾依賴工作管理員服務。 如果「工作管理員服務」回撥Watched資料夾，系統會根據呼叫結果，將stage資料夾中的檔案移至preserve或failure資料夾。 如果「工作管理員」服務沒有回撥Watched資料夾，則暫存資料夾中的檔案將維持未處理狀態。 當Watched資料夾未執行時，作業管理員回撥時，就會發生這種情況。

正在復原stage資料夾中未處理的來源檔案 recovering-unprocessed-source-files-in-the-stage-folder

當Watched資料夾無法處理階段資料夾中的來源檔案時，您可以復原未處理的檔案。

watched資料夾的安全性考量 security-considerations-for-watched-folders

每個watched資料夾都設定了使用者名稱和密碼。 叫用服務時會使用這些認證。 Watched資料夾仰賴共用資料夾受到基礎安全性檔案系統的保護，因此只有watched資料夾的擁有者才能存取共用資料夾。

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

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

Watched資料夾的服務特定建議 service-specific-recommendations-for-watched-folders

對於所有服務，您應該調整watched資料夾的批次大小和重複間隔，以便Watched資料夾擷取新檔案和資料夾進行處理的速率，不會超過AEM Forms伺服器可以處理的工作速率。 實際使用的引數可能會有所不同，這取決於設定的watched資料夾數目、使用之watched資料夾的服務，以及處理器上的工作強度。

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

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