共用方式為


元件介面使用者定義方法

Microsoft BizTalk Adapter for PeopleSoft Enterprise 支援在元件介面中使用使用者定義的方法。 簽章的格式如下:

myRet=myCI.myMethod(parameter1, parameter2, ...)  

位置:

  • parameter1parameter2 輸入參數。

  • myRet 是傳回的值。

    這些參數只能是方法的輸入參數。 只有一個值可以從方法傳回當做傳回參數。

注意

包含使用者定義方法的元件介面應該只啟用 PeopleSoft Get 函式。 如果元件介面有索引鍵,自訂方法就無法運作。

自訂 CI 限制

BizTalk Adapter for PeopleSoft Enterprise 可以處理所提供的自訂 PeopleSoft 方法,但元件介面不能有索引鍵。 如果元件介面有索引鍵,自訂方法就無法運作。

因應措施

建立一個沒有索引鍵的新元件介面,然後寫入將索引鍵併為呼叫參數一部分的新自訂方法。 例如,您可以在 USER_PROFILE 元件介面中使用 SetPassword 自訂方法;但 USER_PROFILE 有索引鍵。 您可以建立一個沒有索引鍵的新元件介面,然後在新元件介面中建立自訂的方法。 這個方法會接受兩個參數、使用者識別碼和密碼。 然後,自訂方法可以使用 叫用 USER_PROFILE,然後叫 SetPasswordGet 。 如需詳細資訊,請參閱 PeopleSoft 文件。

由於 PeopleSoft、 DateDateTimeTime 類型的限制出現在使用者定義方法中,會對應為用戶端程式代碼中的字串。

集合限制

使用者定義的方法無法傳回集合,甚至是任何 API 物件。 這表示 您只能傳回簡單類型,例如字串和數字。 避開這個限制的一個方法是,以 XML 字串形式傳送集合,並將用戶端寫成剖析這個字串以用正確格式來擷取項目。 您可以檢視 GET_CI_INFO 自訂元件介面,以查看這個解決方法的範例。

自訂方法範例

您可以使用下列的基本自訂方法 SayHello,測試您的元件介面使用自訂方法的功能。

下列 PeopleCode 函式是 ACB_EMPLOYEE 這個 PeopleSoft 元件介面的使用者定義方法。 此範例會傳回字串,其中傳回值為 Hello ,後面接著輸入參數的值。

Function SayHello(&sName As string) Returns string  
      &EOL = Char(10);  
      &sResult = "Hello " | &sName | &EOL;  
      Return &sResult;  
End-Function;  

注意

若要同時 (使用一個命令) 修改多個表格,您可以建立另一個元件介面,或是建立一個元件介面使用者定義方法。

另請參閱

附錄 A:元件介面方法