IBM FileNet P8, 5.2.1 版            

夥伴鏈結函數

「表示式建置器」對話框中的「夥伴鏈結」函數顯示「呼叫」夥伴鏈結的「夥伴鏈結」標頭。

「夥伴鏈結」標頭儲存在傳送時所產生的欄位中,稱為 F_EndPointRef<partner-link-name>。您可以修改所產生的欄位 F_EndPointRef<partner-link-name> 來修改標頭,以達成下列作業。

訊息標頭

在上述範例標頭中,「呼叫夥伴鏈結」的名稱是 InvAuth1。如果要修改標頭,請使用 Assign 系統函數,或在步驟中使用 Assignment,把已修改的標頭指定至「夥伴」端點參照 - 在此案例中是指 F_EndPointRefInvAuth1。

編碼

如果您需要在 F_EndPointRef<partner-link-name> 中放入機密性資訊,則應該使用 encode() 函數,使機密性資訊編碼。 在傳送訊息之前,工作流程系統會將已編碼的資訊解碼。

鑑別

在上述範例標頭中,所呼叫的服務需要鑑別,因此 Security 區段會包含在標頭中。 一般而言,您會以變數取代 USERNAME 和 PASSWORD,且使用者將在 Invoke 步驟之前的某個步驟輸入這些值。 您可以使用 assignment 將那些值插入標頭中。

  1. 在 Assign 系統函數或 Invoke 步驟之前的一般步驟的 Assignment 中,輸入指定的暫時名稱,然後開啟「表示式建置器」。
  2. 在「表示式建置器」中,請將標頭編輯如下,使它成為有效的字串表示式:
    1. 從訊息開頭處剪下名稱(放到剪貼簿)(在此範例中是指 F_EndPointRefInvAuth1)。 我們將它貼上,作為指派的名稱。
    2. 如果您未定義變數最終端點,請刪除方框中顯示的 Optional Final Soap Address 行。
    3. 對每一個現有的引號加上雙引號 ("),同時在訊息開頭和結尾也加上雙引號。
    4. 以適當的欄位名稱取代 USERNAME 和 PASSWORD(例如,MyUserNameMyPassword),並加上左右引號和加號,將欄位名稱插入字串表示式中。
          "<wsa:EndPointReference xmlns:wsa=""http://schemas.xmlsoap.org/ws/2003/03/addressing"">    
                  <wsa:ReferenceProperties>           
                         <wsse:Security xmlns:wsse=""http://schemas.xmlsoap.org/ws/2002/12/secext"">      
                               <wsse:UsernameToken>                           
                                      <wsse:Username>" + MyUserName + "</wsse:Username>                               
                                      <wsse:Password>" + MyPassword + "</wsse:Password>                       
                               </wsse:UsernameToken>          
                         </wsse:Security>     
                 </wsa:ReferenceProperties>
          </wsa:EndPointReference>"
  3. 關閉「表示式建置器」,然後將端點參照名稱(在此範例中是指 F_EndPointRefInvAuth1)貼到指派的「名稱」欄位中。
提示: 如果您想要直接將使用者名稱和密碼輸入訊息中(此情況較罕見),輸入字串時請不要包含引號和加號。

替代端點

替代端點

所呼叫的 Web 服務的 WSDL 指定端點。 您可以使用下列程序指定不同的端點。 您將以新端點取代標頭中的 OPTIONAL_SOAP_ADDRESS。請注意,替代端點提供的服務必須具有完全相同的輸入及輸出需求。

  1. 在 Assign 系統函數或 Invoke 步驟之前的一般步驟的 Assignment 中,輸入指定的暫時名稱,然後開啟「表示式建置器」。
  2. 在「表示式建置器」中,請將標頭編輯如下,使它成為有效的字串表示式:
    1. 從訊息開頭處剪下(放到剪貼簿)名稱(在此範例中是指 F_EndPointRefInvAuth1)。 我們將它貼上,作為指派的名稱。
    2. 以新端點字串(不含引號)取代 OPTIONAL_FINAL_SOAP_ADDRESS,或在適當之處,以使用雙引號和加號的值插入先前定義的變數。
    3. 對每一個現有的引號加上雙引號 ("),同時在訊息開頭和結尾也加上雙引號。
  3. 關閉「表示式建置器」,然後將端點參照名稱(在此範例中是指 F_EndPointRefInvAuth1)貼到指派的「名稱」欄位中。


前次更新: 2015 年 10 月
bpfe011.htm

© Copyright IBM Corp. 2015.