跳至主要內容
文件
文件
Administrator Guide
上次更新時間 ：2023-06-23
參照︰電子郵件傳出傳輸屬性

參照︰電子郵件傳出傳輸屬性

通用分頁

屬性
XML 屬性內容名稱
說明
ID
id
集合內
電子郵件寄出
 元件的唯一 ID。
將回覆送交至
routes-response-to
電子郵件傳出
 傳輸的回應訊息目的地。
執行時間
execute-when
決定是否執行傳輸的條件。
收件者
to
目標收件者的主要電子郵件地址。遵循格式
mailto:[emailaddress]
。
如果您只想使用「密件抄送」地址，請在欄位中指定一個空白。
mailto:
 值。
主旨
subject
電子郵件的主旨行。
開始
from
應顯示在已發送電子郵件的「
寄件者
 」欄位中的電子郵件地址。
SSL
ssl
指定連線是否為 SSL。
開始
starttls
指定是否要在開始 SMTP 階段作業之前，發出 STARTTLS 命令，立即啟用與遠端 SMTP 伺服器的 SSL 協商。SMTP 伺服器以下列其中一個回覆代碼做為回應︰
  • 220 準備開始。
  • TLS 501 語法錯誤 (不允許參數)。
  • 454 TLS 由於暫時性原因而無法使用。
Ssl
 和
starttls
 屬性互斥。
主機
host
傳輸系統用來傳送訊息的 SMTP 郵件伺服器的名稱或 IP 位址。
如果您使用的是 OAuth，請將此值設為
localhost
。
連接埠
port
執行郵件伺服器的連接埠號。預設值為 25，即標準 SMTP 連接埠。例外︰
  • 如果
    SSL
     屬性設為
    true
     且未指定連接埠，則預設為 465。
  • 如果
    Starttls
     屬性設為
    true
     且未指定連接埠，則預設為 587。
使用者
用於存取電子郵件伺服器的使用者名稱。
密碼
password
在
「使用者」
 屬性中指定的使用者名稱的密碼。

進階分頁

屬性
XML 屬性內容名稱
說明
商店訊息
store-message
除非 Workday 支援團隊另有建議，否則請指定
「無」
。
若要儲存訊息，請使用 Studio 的
儲存
 步驟。
傳輸類別
transport-class
視需要逐一指定替代實作類別。
您可透過編輯 WEB-INF/classes/spring/assembly-bean.xml 檔案，全域變更實作類別。
忽略動態端點
ignore-dynamic-endpoints
指定是否要忽略傳入訊息標頭中的動態 WS-Addressing (WSA) 值，或使用該值覆寫傳輸的
「端點」
 屬性中的值。
請使用
set- Dynamic-endpoint
 步驟指定 WS-Addressing 詳細資料。
密件抄送
bcc
指定密件副本的電子郵件收件者 (以分號分隔)。範例︰
logan.mcneil@workday.com; jake.lee@workday.com
。
Cc
cc
使用分號分隔符號指定複寫電子郵件收件者。範例︰
logan.mcneil@workday.com; jake.lee@workday.com
。
回覆
reply-to
使用者回覆電子郵件時，系統會自動插入
「收件人」
 欄位中的電子郵件地址。對於大多數電子郵件，
「寄件者」
 欄位中的地址就足夠了，因此不需要定義
「回覆」
 屬性。指定多個電子郵件地址時請使用分號分隔符號。範例︰
logan.mcneil@workday.com; jake.lee@workday.com
。
逾時
timeout
指定用戶端與傳輸正在偵聽的 FTP 伺服器之間的 FTP 階段作業逾時期間 (以毫秒為單位)。如果您未指定值，則階段作業會在 300000 毫秒 (5 分鐘) 後逾時。
暫時性例外
transient-exceptions
暫時性例外是在重試時不做任何修改即可成功的例外。「非暫時性例外」是指在問題的根本原因得到更正之前，重試時仍會失敗的例外情況。
根據預設，Workday 只會處理
java.net.ConnectException
 和
java.net.SocketException
 錯誤列為暫時性例外。
請將其他暫時性例外指定為逗號、空格或逗號與空格分隔的類別名稱列舉。範例︰
  • java.net.UknownHostException java.net.ConnectException java.net.SocketException
  • java.net.UknownHostException,java.net.ConnectException,java.net.SocketException
  • java.net.UknownHostException, java.net.ConnectException, java.net.SocketException
  • @{new java.net.UnknownHostException().getClass().getName()}
如果您指定其他暫時性例外，則還必須包含預設例外
java.net.ConnectException
 和
java.net.SocketException
 。否則 Workday 會覆寫這些內容。

SMTP 標頭分頁

屬性
XML 屬性內容名稱
說明
名稱
name
自訂 SMTP 標頭的名稱。
若要在任何現有的列下方新增自訂標頭，請按一下
新增
，然後提供
名稱
 和
值
。
若要在現有列上方新增標頭，請將游標移到該列，然後在
新增
 下拉式功能表上按一下
插入
 。
使用
SMTP 標頭
 分頁右側的按鈕可刪除列或重新排序。
值
value
自訂 SMTP 標頭的值。

OAuth 分頁

若要將 Microsoft Outlook OAuth 驗證搭配 Studio 的電子郵件寄出元件使用，請在 Microsoft Azure 中將 Studio 註冊為應用程式，提供全網域委派，並授予管理者同意以下權限︰
Mail.Send
 權限，並取得各種值。詳情請參閱 https://learn.microsoft.com/en-gb/azure/active-directory/develop/v2-oauth2-client-creds-grant-flow。
若要將 Google Gmail OAuth 驗證與 Studio 的電子郵件寄出元件搭配使用，請在 Google Cloud 註冊服務帳戶、提供全網域的委派，並取得各種值的 JSON 說明。詳情請參閱 https://support.google.com/cloud/answer/6158849?hl=en。
屬性
XML 屬性內容名稱
說明
提供者
provider
電子郵件服務業者的名稱，兩者擇一
MICROSOFT_OUTLOOK
 或
GOOGLE_GMAIL
。
名稱
name
您的 Workday 強制定義名稱，與從 Microsoft Azure 入口網站或 Google 雲端主控台取得的各種值相關聯。
若為 Microsoft Outlook，請輸入以下名稱︰
  • outlook.client.id
  • outlook.client.secret
  • outlook.tenant.id
  • outlook.user.id
對於 GoogleGmail，輸入︰
  • gmail.service.account.key.json
  • gmail.delegated.user
值
value
從 Microsoft 或 Google 取得且與上述名稱相關聯的值。
若為 Microsoft Outlook，請建立以下名稱/值組合︰
名稱
值
outlook.client.id
從 Microsoft Azure 入口網站上已註冊應用程式的
「總覽」
 頁面︰
應用程式 (用戶端) ID
outlook.client.secret
從 Microsoft Azure 入口網站上已註冊應用程式的
「憑證和密鑰」
 頁面︰
用戶端密鑰 ID
outlook.tenant.id
從 Microsoft Azure 入口網站上已註冊應用程式的
「總覽」
 頁面︰
目錄 (用戶) ID
outlook.user.id
傳送電子郵件的帳戶 Outlook 位址。也在
「通用」
 分頁的
「來源」
 欄位中輸入。
對於 GoogleGmail，請建立以下名稱/值組合︰
名稱
值
gmail.service.account.key.json
從 Google 雲端主控台
「服務帳戶」
 頁面的
「KEYS」
 區段下載的檔案中的 JSON 文字。
gmail.delegated.user
用來傳送電子郵件的Gmail 地址。必須是與 Google 服務帳戶相關聯的委託人。也在
「通用」
 分頁的
「來源」
 欄位中輸入。

透過 SSL 或使用 STARTTLS 的Gmail

配置
電子郵件傳出
 傳輸方式以使用透過 SSL 或 STARTTLS 的Gmail 時，請確保︰
  • 使用者名稱
     和
    密碼
     包含有效的Gmail 憑證。
  • 端點
     為
    mailto:[name]@gmail.com
    。
  • 主機
     為
    smtp.gmail.com
    。
  • ssl
     或
    starttls
     設為
    true
    。
  • 連接埠
     為︰
    • 465 (如果
      ssl
       設定為)
      true
      。
    • 587 (如果
      starttls
       設為
      true
      。
  • 逾時時間
     為
    30000
     (30 秒)。

Microsoft Office 365 over SSL 或 STARTTLS

配置
電子郵件傳出
 傳輸以使用 Microsoft Office 365 over SSL 或 STARTTLS 時，請確保︰
  • user
     和
    password
     包含有效的 Office 365 使用者憑證。
  • 端點
     為
    mailto:[name]@[domain-name.top-level-domain]
    。
  • 主機
     為
    smtp.office365.com
    。
  • ssl
     或
    starttls
     設為
    true
    。
  • 連接
     以下任一項︰
    • 465 (如果
      ssl
       設定為)
      true
      。
    • 587 (如果
      starttls
       設為
      True
      )
  • 逾時時間
     為
    30000
     (30 秒)。

配置非二進位格式的訊息內文和附件

許多電子郵件應用程式在接收傳入訊息時，會比對 MIME 訊息中的第一個文字部分，並將其當做訊息文字使用。將根訊息部分的 MIME 類型設為
text/plain
，將訊息的
輸入
 和
輸出
 屬性設為
訊息
，然後
將輸出
 MIME 類型設為
文字/純文字
。
使用
訊息建置器
 ，透過
文字
 元素定義電子郵件內文的訊息內容。
將附件的
「輸出」
 屬性設為
「」
，將
「輸出」
 附件索引設為
0
，
輸出
 MIME 類型為
「純文字/純文字」
。
同樣，請使用
訊息建置器
 ，透過
文字
 元素定義附件的訊息內容。
若要避免某些電子郵件應用程式在訊息內文中顯示文字附件，請將附件 MIME 類型設為
application/octet-Stream
，即使附件實際上是文字也是如此。為此，請在
評估
 步驟內使用 MVEL 運算式。範例︰
parts[1].setMimeType('application/octet-stream')
若要設定附件檔案名稱，請使用 MVEL 運算式來設定其附件檔案名稱。
Content-Disposition
 頁首。範例︰
parts[1].setHeader('Content-Disposition', 'attachment; filename=payload.txt')
。
最後，配置
電子郵件寄出
 步驟。

配置二進位格式的訊息內文和附件

若要將二進位檔案插入
MediationContext
，請為從 FTP 或 SFTP 傳輸擷取檔案的
Workday-in
 定義擷取服務。
建立訊息內文，然後使用
評估
 步驟將擷取的檔案複製到變數。您可以使用
da
 文件存取器變數和
toVar
 方法來達成此目的。範例︰
da.toVar(Rising_2011_Logo.jpg', 'wd.retrieve.variable')
。
使用
複制
 步驟，將檔案從
wd.retrieve.variable
 至附件。為此，請將
輸入
 屬性設為
「變數」
 並指定
wd.retrieve.variable
 做為輸入變數。將
輸出
 屬性設為
附件「
」，指定的
輸出
 附件索引為
0
和
「image/jpeg」
的
輸出
 MIME 類型。
最後，配置
電子郵件寄出
 步驟。