REST.Backend.EMSApi.TEMSClientAPI.QueryResource
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, const System::UnicodeString *AQuery, const System::NativeInt 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(任意指定): 要求の更新に使用できるパラメータなしの手続きです。たとえば、要求にパラメータを追加できます。
例外
| 例外 | メッセージ | 説明 | 
|---|---|---|
| MasterSecret が必要です | Authentication が TAuthentication.MasterSecret で、ConnectionInfo.MasterSecret が空の文字列になっています。 | |
| セッション トークンが必要です | Authentication が TAuthentication.Session で、かつ、ログインが行われなかったか、Login の呼び出し時に渡されたセッション認証トークンが空の文字列になっています。 |