METHOD GET ATTRIBUTES
METHOD GET ATTRIBUTES ( path ; attributes {; *} )
| 引数 | 型 | 説明 | |
|---|---|---|---|
| path | Text, Text配列 | → | メソッドのパス |
| attributes | Object, Object array | ← | 選択したメソッドの属性 |
| * | 演算子 | → | 指定すると、コマンドはコンポーネントから実行されたときにホストデータベースへと適用されます (このコンテキスト外ではこの引数は無視されます) |
説明
METHOD GET ATTRIBUTES コマンドは、path で指定されたメソッドのすべての属性のカレント値を attributes に返します。
このコマンドはプロジェクトメソッドに対してのみ使用できます。path に無効なパスを渡した場合、エラーが生成されます。
path にはメソッドパスを含んだテキストか、パスの配列を含んだテキスト配列を渡す事ができます。attributes には、属性を適切に取得するために、同様の引数 (文字列または配列) を渡す必要があります。
attributes には、path に渡した引数の種類に応じて、オブジェクトまたはオブジェクトの配列を渡します。すべてのメソッドの属性はオブジェクトプロパティとして返され、その内部は "true"/"false" 値を持つブール型の属性ですが、必要に応じてテキストなどの追加の値が渡されます (例えば "scope":"table" 4D Mobile property など)。
このコマンドがコンポーネントから実行された場合、デフォルトではコンポーネントメソッドに対して適用されます。* 引数を渡した場合、ホストデータベースのメソッドへとアクセスします。
注: 既存の METHOD Get attribute コマンドは引き続きサポートはされますが、ブール型の値しか返せないため、4D Mobileプロパティのような拡張された属性に対しては使用はできません。
互換性に関する注記: 4D v18 以降、published4DMobile プロパティは廃止予定です。
例題
sendMail プロジェクトメソッドの属性を取得したい場合を考えます。以下の用にコードを書くことができます:
var $att : Object
METHOD GET ATTRIBUTES("sendMail";$att)
実行後、$att には例えば以下のような値が含まれます:
{
"invisible":false,
"preemptive":"capable",
"publishedWeb":false,
"publishedSoap":false,
"publishedWsdl":false,
"shared":false,
"publishedSql":false,
"executedOnServer":false,
"published4DMobile":{
"scope":"table",
"table":"Table_1"
}
}