跳至主要內容
文件
文件
Administrator Guide
上次更新時間 ：2023-07-14
設定整合擷取

設定整合擷取

安全性︰「系統」功能區中的
「業務流程管理」
 和
「管理︰業務流程定義」
 網域。
若要從外部位置擷取整合文件，請將「
文件擷取
服務」
 步驟新增至整合業務流程。此步驟說明整合檔案的檔案選擇、傳輸和解密選項。
「擷取文件」也可讓您擷取自訂報告的輸出。在這種情況下，文件擷取︰
  • 從 Workday 內擷取資料。
  • 將報告輸出儲存在「我的報告」儲存庫中，以供後續整合步驟使用。
  1. 存取您要新增步驟 的業務流程定義 。
  2. 如果業務流程定義中還沒有
    「文件擷取
    服務」
     步驟，請將其新增至業務流程。
  3. 選取
    配置文件擷取
    。
  4. 在
    「文件保留原則」
     欄位中，輸入 Workday 儲存由業務流程匯入的檔案的天數。
  5. 在
    文件標記
     區段中，選取您希望 Workday 套用至傳入檔案的任何文件標記。
  6. 在
    擷取設定
     區段中，指定擷取配置︰
    選項 說明
    要手動附加檔案的群組
    若要手動附加 1 個或多個檔案以供匯入，請指定接收業務流程要求的區段安全群組。
    從外部位置擷取檔案
    選取現有的整合交付服務。
  7. 選取擷取的
    檔案名稱選項
     ︰
    選項 說明
    檔案名稱/模式
    讓 Workday 在遠端端點上搜尋具有特定名稱模式的檔案。
    序列產生器
    讓 Workday 在遠端端點上搜尋具有特定依序檔案名稱模式的檔案。
  8. (僅限檔案名稱/模式) 在
    「檔案」
     區段中︰
    1. 針對要從外部端點上傳至 Workday 的檔案，輸入檔案名稱或檔案名稱模式 (regex)。
      此欄位區分大小寫。Workday 不支援完整的 regex 語法來擷取檔案。Workday 僅支援 (*) 和 (?) 字元做為檔案名稱模式中的萬用字元。
      對於 Amazon Simple Storage Service (S3)，Workday 接受 (*) 和 (?)。
      對於 S3 傳輸，您可以使用以下格式從資料夾擷取檔案
      ︰folder1/folderN/filename.format
      。
    2. 在
      檔案
      區段中，使用
      通用內容類型
       提示指定 MIME 類型、指定
      自訂內容類型
      ，或選取
      以上皆非
      。
      Workday 會將指定的 MIME 類型套用至整合系統擷取的所有檔案。
  9. (僅限序列產生器) 指定檔案名序列選項。
    如果某個流程產生了多個要求下一個序號的要求，彼此非常接近，Workday 會嘗試產生序號。此流程可能會產生略過的非連續數字。
    選項 說明
    序列 ID 增量 - 依據
    輸入一個非零值，每當 Workday 產生新的 ID 時，序號就會增加該值。
    內邊距
    使用
    「間距」
     來指出序列中的位數。請輸入足夠大的填補值，以免序列發生溢位情況。Workday 建議的填補值至少為 6。如果序列超過您在此處輸入的位數，
    則序列 ID 溢位行為
     設定會決定序列中的下一個數字。當您在
    填補
     欄位中輸入 0 或未輸入值時︰
    • 序號會無限增加。
    • Workday 會在
      「序列 ID 溢位行為」
       中填入
      「自動忽略填補」
      。
    序列 ID 格式
    請指定 ID 的格式。
    您可以將任何文字字串與這 4 個特殊變數搭配使用。日期相關值代表任務產生 ID 的日期。
    • [seq] - 序號。其增加數為在
      序列 ID 增量依據
       欄位中指定的值，並以
      填補
       欄位中指定的位數增加。對於每個使用此變數的 ID 定義，Workday 會使用不同的序列。
    • [day] - 月份中的某幾天，採用兩位數格式，01 - 31。
    • [month] - 月份，採用兩位數格式，01 - 12。
    • [year] - 四位數格式的年份。範例︰2020。
    如果您設定
    「重新開始頻率」
     間隔，請在格式中包含特定時段，以確保產生的序號是唯一的。例如，如果
    「重新開始頻率」
     時段為
    「月」
    ，請在格式中包含
    「[month]」
     和
    「[year]」
    。請確定內邊距值足夠大，以使序列產生器在時段內不會遇到溢位情況。
    例如，您可以輸入以下內容來定義檔案名稱格式︰
    • 字串常數。
    • 日期和時間的模式。
    • 序號模式。
    • 副檔名
    Workday 只能動態產生日期值和序號，以供在檔案名稱中使用。任何其他值都是靜態的；整合所產生的所有檔案皆相同。將游標移到此欄位上方，即可查看有效序列產生器和日期/時間模式的完整清單。
    重新啟動頻率
    (選用) 若要定期將 [seq] 值重設為初始值，請指定 Workday 重設序號的頻率。
    選項為
    「日」
    、
    「月」
    或
    「年」
    ；如果您希望 [seq] 在此 ID 定義中是唯一的，請將此欄位保留空白。日期從中午 12:01 開始。月份會從該月的第一天凌晨 12:01 開始。年份的開始日期為 1 月 1 日凌晨 12:01。
    重新開始編號
    (選用) 若要定期將 [seq] 值重設為初始值，請指定 Workday 在重新啟動序號時使用的數字。您可以將此欄位與
    「重新啟動頻率」
     欄位搭配使用。
    時區用途
    「重新開始頻率」
     欄位中指定的間隔所依據的其他時區。
    此值並未表示 ID 實際產生的時間。Workday 僅使用它來將日期本地化為指定的時區。如果您未指定時區，Workday 會使用太平洋標準時間/太平洋夏令時間 (PST/PDT)。
    序列 ID 溢位行為
    配置您希望 Workday 處理潛在溢位情況的方式。填寫欄位時，請參考以下說明︰
    • 允許溢位且有截斷的序列
       - 發生溢位時，Workday 會截斷序列號的最高位。範例︰
      「填補
       」值為 3 時，999 之後的下一個序號為 1000，但 1 會被截斷，因此下一個值會顯示為 000。
    • 自動忽略填補
       - 發生溢位情況時，序列產生器會忽略
      填補
       值。範例︰
      「填補」
       值為 3，則 999 之後的下一個序號為 1000。如果
      「填補」
       值為 0，Workday 會自動選取此選項。
    覆寫用戶設定溢位通知群組
    指定安全群組以覆寫
    預設用戶設定溢位通知群組
    。當序列接近
    「填補」
     值所施加的限制時，Workday 會自動向溢位通知安全群組傳送通知。如果您未在此欄位中選取安全群組，Workday 會將這些溢位通知傳送至︰
    • 您在
      「編輯用戶設定 - 系統」
       任務的
      「預設序列產生器通知群組」
       欄位中選取的安全群組。
    • 當您未在
      「編輯用戶設定 - 系統」
       任務中選取預設的溢位通知安全群組時，Workday 為溢位通知指定的預設安全群組。
    預設用戶設定溢位通知群組
    顯示
    預設用戶設定溢位通知群組
    。當序列接近
    「填補」
     值所施加的限制時，Workday 會自動向溢位通知安全群組傳送通知。
    上次使用的序列
    手動設定最後一個序號。在下列情況下，此選項會很有用︰
    • 您先前使用了不同的 ID 產生應用程式。
    • 您想要從 ID 結束的位置繼續。
    設定數字時，初始序號將是您的數字加上
    序列 ID 增量
     值。
    上次使用日期
    指定此日期，加上
    重新啟動頻率
     的間隔，以確定日期是早於還是晚於上次重新啟動的間隔。然後，Workday 會依據日期設定序號。
    低交易量
    (選用) 選取此項可確保序列產生器產生的序列沒有間隔。當您同時遇到以下兩種情況時，請使用此選項︰
    • 您未在大量交易中使用此序列。
    • 您會在產生的序列中遇到不必要的間隔。
  10. 在
    傳輸
     區段中，選取並配置傳輸通訊協定︰
    運輸
    附註
    Amazon Simple Storage Service
    對於 S3 傳輸，請使用
    Workday-type
     鍵和
    Integration
    值將標籤新增至您的 IAM 使用者。此標記區分大小寫，且不會忽略空格。
    • 在
      Bucket
       欄位中輸入您的 S3 儲存桶名稱。您無法在此欄位中指定資料夾。
    • 輸入 AWS KMS 用戶端加密的金鑰別名。
    • 無法為使用 Amazon Simple Storage 的 EIB 配置 Pretty Good Privacy (PGP) 加密。
    • 選取
      啟用傳輸加速
       核取方塊以提高傳輸速度。
    • 從
      「物件儲存類別」
       提示中選取選項時，您不需要在 Amazon Simple Storage Service 中手動更新儲存類別。
    Custom Report (自訂報告)
    • 任何啟用為 Web 服務的自訂報告都會顯示在
      自訂報告
       提示中。
    • 值類型
       和
      值
      ︰
      • 指定值
        。輸入您希望 Workday 在每次執行時做為整合條件的值。
      • 在執行階段決定值
        選取您希望 Workday 在每次執行時用來決定值的欄位。
      • 使用系統預設值
         會使用在企業介面定義中配置的值。
    FTP
    • 請使用以下格式輸入地址 (當您未指定連接埠號碼時，Workday 會使用預設值)︰
      ftp://xxxx:port-number
      。
    • 此傳輸通訊協定要求您在
      「加密方式」提示中選取 PGP 公開金鑰憑證，以
       加密傳出檔案。
    • 目錄名稱區分大小寫。僅在完整路徑 (而非相對路徑) 中包含前導斜線 (/)。
    • 選取
      使用臨時檔案
       核取方塊，將輸出寫入隨機命名的檔案。Workday 會在完成資料傳輸時將檔案重新命名為正確的名稱。此選項可防止自動指令碼在資料傳輸完成前從 FTP 伺服器擷取檔案。
    FTP/SSL
    • 使用這些格式︰
      • 隱式 SSL︰ftpsi
        ://xxxx:port-number
      • 顯式 SSL︰ftpse
        ://xxxx:port-number
    • 當您未指定連接埠號碼時，Workday 會將連接埠 990 用於隱式 SSL，將連接埠 21 用於顯式 SSL。
    • 目錄名稱區分大小寫。僅在完整路徑 (而非相對路徑) 中包含前導斜線 (/)。
    • 選取
      使用臨時檔案
       核取方塊，將輸出寫入隨機命名的檔案。Workday 會在完成資料傳輸時將檔案重新命名為正確的名稱。此選項可防止自動指令碼在資料傳輸完成前從 FTP 伺服器擷取檔案。
    REST
    使用以下格式輸入主機名稱或伺服器地址︰http:
    //www.example.com/rest/
    。
    SFTP
    • 請使用以下格式輸入地址 (當您未指定連接埠號碼時，Workday 會使用預設值)︰
      sftp://xxxx:port-number
      。
    • 目錄名稱區分大小寫。僅在完整路徑 (而非相對路徑) 中包含前導斜線 (/)。
    • 選取
      使用臨時檔案
       核取方塊，將輸出寫入隨機命名的檔案。Workday 會在完成資料傳輸時將檔案重新命名為正確的名稱。此選項可防止自動指令碼在資料傳輸完成前從 FTP 伺服器擷取檔案。您也可以指定
      主機金鑰指紋
       ，以指出 FTP 伺服器用於 SSH 通訊的加密金鑰。
    • 將
      區塊大小
       設為 SFTP 端點支援的區塊大小。如果未指定，Workday 會使用
      32K
      。增加區塊大小可提高傳送效能。如果端點不支援您選取的區塊大小，則整合交付會失敗。Workday 強烈建議您使用「測試傳輸」功能測試區塊大小。找到最佳區塊大小後，請更新您的文件發送配置以使用此區塊大小。
  11. (僅
    自訂報告
     傳輸時需要) 在
    「報告選項」
     區段中，選取 Workday 用來執行自訂報告的憑證。
    僅當您在上一步驟中選取自訂報告時，Workday 才會在
    「報告選項」
     區段中顯示
    「以使用者身分執行報告」
     提示。
  12. 在
    「檔案實用工具」
     區段中，指定以下 1 個或多個選項︰
    選項 說明
    擷取後刪除
    如果 Workday 無法從來源 S/FTP/S 伺服器刪除檔案，則文件擷取失敗。
    解壓縮
    選取以解壓縮傳入的檔案。
    解密使用
    (僅限 FTP、FTP/SSL 和 SFTP) 如果您要使用 Pretty Good Privacy (PGP) 將上傳的檔案解密，請選取您所產生金鑰對中的 PGP 私人金鑰，以解密傳入整合檔案。
    使用 FTP、FTP/SSL 或 SFTP 通訊協定加密傳出整合檔案時，您也可以︰
    • 在檔案中包含資料完整性檢查。
    • 以數位方式簽署檔案。
    強製完整性檢查
    (僅限 FTP、FTP/SSL 和 SFTP) 若要驗證加密檔案在傳輸期間未遭變更或損毀，請選取此核取方塊。
    數位簽章驗證使用
    (僅限 FTP、FTP/SSL 和 SFTP) 若要驗證加密傳入檔案的來源，請選取您的交易夥伴提供的 PGP 公開金鑰。
  13. (選用) 在
    「環境限制」
     區段的
    「限制」
     提示下，選取此傳輸通訊協定的目標環境。
    如果您將此欄位保留空白，Workday 會將傳輸通訊協定套用至每個執行整合的環境。每個環境 (正式環境、沙箱環境、實作環境等等) 只能有 1 個傳輸通訊協定。為避免不慎將測試資料上傳至非測試端點或從非測試端點上傳，Workday 強烈建議您︰
    • 為每個環境建立單獨的傳輸。
    • 將每個傳輸限制在其預期的環境中。
整合執行後，整合流程事件會依據這些指示從外部伺服器擷取選取的檔案。