v7

實作SOAP方法

簡介

您可以在JavaScript中建立SOAP方法。 此函式只會啟用應用程式流程，可以避免在表單中開發JSP及其呼叫。

這些SOAP方法的行為方式與應用程式中原生定義的相同。 支援相同的屬性：靜態、僅金鑰和常數。

定義方法程式庫

建立方法程式庫涉及兩個階段：

• SOAP方法宣告，
• JavaScript中的定義（或實施）。

宣告

首先，請在綱要中宣告方法(如需如何建立和編輯綱要的詳細資訊，請參閱 本節)。

它們的宣告與原生方法的宣告類似，但是您必須新增「library」屬性，指定定義所在的方法程式庫名稱。

此名稱與「JavaScript程式碼」型別實體的名稱（連同名稱空間）一致。

範例:

testLog(msg)方法在nms：recipient擴充功能中宣告

<method name="testLog" static="true" library="cus:test">
     <parameters>
       <param name="message" type="string" inout="in"/>
     </parameters>
   </method>

定義

SOAP方法會以JavaScript函式的形式實作，這些函式會分組在代表程式庫的指令碼中。

指令碼可包含要在初始程式庫載入期間執行的程式碼。

1. 名稱

函式的名稱必須符合下列格式：

 <schema-namespace>_<schema-name>_<method-name>

範例:

下列JavaScript函式為上述方法的實作。 應使用「cus：test」名稱，在「JavaScript程式碼」型別實體中定義。

function nms_recipient_testLog(message)
 {
   logInfo("*** " + message)
 }

2. 簽章

函式的簽章必須為宣告的每個'in'或'inout'引數包含一個引數。

特定案例：

• 非靜態方法：函式必須先包含一個額外引數，與以「xml」(E4X)型別物件的形式傳遞的XML實體一致。
• "key only"型別方法：函式必須先包含其他引數，符合以字元字串形式傳遞的鍵值。

3. 傳回的值

函式必須傳回每個'out'或'inout'型別引數的值。 特定案例：如果宣告方法時不含任何「static」、「key only」或「const」屬性，則第一個傳回值必須與修改的實體一致。 可以傳回新物件或傳回第一個修改過的引數。

例如：

function nms_recipient_setLastName(self, name)
 {
   self.@lastName = name
   return self
 }

要傳回數個值時，必須將其顯示在表格中。

範例:

function nms_recipient_getKey(self)
 {
   return [self.@firstName, self.@lastName]
 }