建立公開程序值 (EPV)

線上編輯

您可以建立公開程序值 (EPV) ，以定義您要向特定使用者公開的一組變數。當程序實例執行時，使用者可以修改這些變數。例如，如果您建立處理費用給付的程序，則可能想要讓監督者變更每日支出的容許金額，或與各種核准者層次一致的金額。透過建立 EPV ，您可以提供這種類型的彈性，讓使用者可以將特定變數值調整為常數，從而影響所有執行中程序實例的流程、作業指派等。

關於此作業

傳回的 EPV 取決於是否在 EPV 中設定使用新值 ; 依預設會取消設定。

如果設定使用新值， tw.epv API 會傳回其生效日期為過去且最接近現行時間的 EPV。
如果未設定使用新值，則 tw.epv API 會使用作業實例啟動的時間，這表示它會尋找具有過去生效日期且最接近作業實例啟動時間的 EPV。

附註: 本主題中的指示說明如何建立新的 EPV ，並將它公開給團隊，其成員可以管理 EPV 並調整其變數值。如果您有尚未公開的現有 EPV ，您必須將它公開給設計程式中的團隊，並建立新的版本，才能編輯預設值。否則，將無法使用 EPV。 EPV 只能由其公開的團隊編輯。管理者無法編輯它。在 EPV 公開給特定團隊之後，您可以在執行時期使用一般團隊修改方法來變更團隊的內容。如需 EPV 的相關資訊，請參閱管理公開程序值 (EPV)主題。

限制: 您必須在用戶端人工服務的用戶端 Script 內使用變數名稱，以取得 EPV 的值。您無法在用戶端人工服務上使用外部名稱來呼叫到 EPV 變數。

程序

若要建立 EPV ，請執行下列動作:

開啟設計程式。
展開資料並選取公開程序值。
即會開啟「新建公開程序值」視窗。
在名稱欄位中，輸入值的名稱，然後按一下完成。
即會開啟 EPV 配置視圖。
配置 EPV:
1. 在 Documentation 欄位中，輸入開發人員的 EPV 說明。
2. 若要容許使用者傳送此 EPV 的相關意見，請在意見電子郵件聯絡人欄位中鍵入電子郵件位址。
  
  Process Admin Console 中的「管理公開程序值」頁面包含使用此電子郵件位址的意見鏈結。
3. 在外部說明欄位中，輸入使用者的 EPV 說明。
  您在這裡提供的說明會顯示在 Process Admin Console的「管理公開程序值」頁面中。
透過套用下列步驟，將一個或數個變數新增至 EPV:
1. 在「公開程序值變數」區段中，按一下 + 以將變數新增至此 EPV。
  
  例如，如果您想要讓使用者能夠調整費用給付程序的不同核准者層次所對應的金額，請為每一個可用的層次新增一個變數。
2. 在「變數詳細資料」區段的外部名稱欄位中，鍵入使用者的變數名稱。
  此名稱會出現在 Process Admin Console中此 EPV 的「變數清單」中。
3. 在變數名稱欄位中，鍵入用於內部處理的變數名稱。
  
  附註: 變數名稱應該以小寫字母開頭，且後續單字會大寫: myVar。請勿在變數名稱中使用空格。變數名稱區分大小寫。
4. 在外部說明欄位中，鍵入文字以向使用者說明此變數。
  此說明會出現在 Process Admin Console中此 EPV 的「變數清單」中。
5. 選用項目: 在預設值文字框中，輸入此變數的有效預設值。
6. 若要讓進行中作業在使用者編輯其值時使用此變數的更新值，請選取使用新值勾選框。
7. 若要選取變數類型，請按一下選取 ... 並選取商業物件，或按一下新建以建立新的自訂商業物件 (變數類型)。
  
  附註: 對 EPV 變數使用非字串類型時，您應該特別小心。不建議使用非字串類型，它可能會導致 JavaScript 類型轉換發生問題。如果您必須對 EPV 變數使用非字串類型，請參閱下面的「範例」區段。
在公開區段中，按一下選取以選擇其成員可以管理此 EPV 並調整其變數值的團隊。

依預設， EPV 不會向任何團隊公開。您必須透過選取團隊來公開 EPV ，才能編輯 EPV 的值。只有在 Process Admin Console中選取的團隊才能編輯 EPV。管理者無法編輯 EPV。在向特定團隊公開 EPV 之後，您可以使用一般團隊修改方法，在執行時期變更團隊的內容。如需 EPV 的相關資訊，請參閱管理公開程序值 (EPV)主題。
按一下儲存或完成編輯。

結果

即會建立 EPV ，您可以將它鏈結至程序、服務或報告。

您可以參照 EPV 及其變數的名稱，如下所示: tw.epv.[epv_name].[epv_variable_name]。

您可以在決策閘道中使用 EPV 來控制程序的流程。您也可以從鏈結程序中的任何 JavaScript 程式碼參照 EPV ，例如伺服器 Script 服務元件內的程式碼。

範例

若要對 EPV 變數使用整數或十進位類型 (而不是建議的字串類型) ，您應該考慮建立整數或十進位類型的對應區域變數。應該改為對區域變數執行作業，例如

tw.local.number = tw.epv.myepvs.number; tw.local.number = tw.local.number + 1;

或者，若要在 JavaScript 程式碼中使用 EPV 變數，您需要使用類型強制轉型，例如

var mynumber = parseFloat(tw.epv.myepvs.number);

下一步

建立 EPV 之後，您可以從「變數」標籤中公開的程序變數清單中選取，將它鏈結至程序或服務。