REST.Backend.EMSApi.TEMSClientAPI.QueryResource

• 親: TEMSClientAPI

Delphi

procedure QueryResource(const AResource: string;  const AQuery: array of string; const AJSONArray: TJSONArray; AReset: Boolean; const AAddParameters: TProc = nil);

C++

void __fastcall QueryResource(const System::UnicodeString AResource, System::UnicodeString const *AQuery, const int AQuery_High, System::Json::TJSONArray* const AJSONArray, bool AReset, const System::Sysutils::_di_TProc AAddParameters = System::Sysutils::_di_TProc());

プロパティ

種類	可視性	ソース	ユニット	親
procedure function	protected	REST.Backend.EMSApi.pas REST.Backend.EMSApi.hpp	REST.Backend.EMSApi	TEMSClientAPI

説明

指定されたリソース タイプのリソースのリストを EMS サーバーに問い合わせます。

QueryResource が受け取るパラメータは次のとおりです。

• AResource： 対象となるリソース タイプです。
• AQuery： 等号で区切られたキーと値のペアの文字列（たとえば、"my_parameter=my_value" など）を要素とする文字列配列です。QueryResource では、これらのキー/値ペアをパラメータとして要求に追加します。
• AJSONArray： QueryResource で EMS サーバーから取得された結果の格納先です。
• AReset： QueryResource で要求パラメータをリセットするか（True）、それとも、前回の要求のパラメータを基に新しい要求を作成するか（False）を指定します。

  たとえば、パラメータが同じで対象リソースだけが異なる問い合わせを 1 つの行で数回実行する場合は、AReset として False を渡してパフォーマンスを向上させることができます。

• AAddParameters（任意指定）： 要求の更新に使用できるパラメータなしの手続きです。たとえば、要求にパラメータを追加できます。

例外

例外	メッセージ	説明
EEMSClientAPIError	MasterSecret が必要です	Authentication が TAuthentication.MasterSecret で、ConnectionInfo.MasterSecret が空の文字列になっています。
	セッション トークンが必要です	Authentication が TAuthentication.Session で、かつ、ログインが行われなかったか、Login の呼び出し時に渡されたセッション認証トークンが空の文字列になっています。

関連項目

• REST.Backend.EMSApi.TEMSClientAPI.AddResource
• REST.Backend.EMSApi.TEMSClientAPI.PutResource
• REST.Backend.EMSApi.TEMSClientAPI.DeleteResource

• REST.Backend.EMSApi.TEMSClientAPI.QueryUsers
• REST.Backend.EMSApi.TEMSClientAPI.QueryGroups
• REST.Backend.EMSApi.TEMSClientAPI.QueryModules
• REST.Backend.EMSApi.TEMSClientAPI.QueryModuleResources
• REST.Backend.EMSApi.TEMSClientAPI.QueryInstallations