Home > リファレンスガイド > 設定 > リソース > OData リソース

OData リソース

ODataリソースを使用すると、ユーザーはODataサービスの詳細を構成できます。 ユーザーは、サービスのルートURLを設定し、追加のメタデータヘッダーを提供し、サービスにアクセスするための認証メカニズムを選択できます。 ユーザーは、サービスによって提供されるアノテーションを追加することもできます。

これらのODataアノテーションは、行の数、コンテキスト、または追加の操作を実行するためにアクセスできるエンドポイントへのリンクなど、ODataサービスから取得されるデータに関する追加情報を提供します。 アノテーションはOData応答データの一部であり、識別のために@odata接頭辞が付いています。

インスタンスレベルと行レベルのアノテーションは、それぞれGet AnnotationsプロパティとGet Row Annotationsプロパティに追加できます。

OData リソースには、以下のパラメータ(太字 のパラメータは必須)があります。

パラメータ

説明

ルート URL(Root URL)

ODataサービスのルートURL。

必要なルート URLを入力するか、をクリックして環境変数一覧を開きます。ここでルート URLとして使用する環境変数を選択します。

メタデータヘッダ(Metadata Headers)

ODataサービスのメタデータを取り出すためのHTTPヘッダ。[ヘッダ]ボタン(以下)をクリックして必要なHTTPヘッダ情報を入力します。

このフィールドは、リソース内でのみ有効で、実行中は利用できません。

Authentication Type

これはコンボボックスです。  ドロップダウンリストから必要な認証タイプを選択します。

  • None (デフォルト)

  • Basic

  • Digest

  • Windows

Since version: 4.7.2

User

ODataリソースを認証するためのユーザ名。

ユーザ名を入力するか、をクリックして環境変数一覧を開くことができます。ここでは、ユーザ名として使用する環境変数を選択できます。

Password

ODataリソースを認証するためのパスワード。

パスワードを入力するか、をクリックして環境変数一覧を開くことができます。ここでは、パスワードとして使用する環境変数を選択できます。

 環境変数として入力されたパスワードはアスタリスクでマスクされています。

Workstation

リクエストを出したコンピューターのワークステーション名。

これは、Authentication Typeパラメータ(上記)でWindowsを選択した場合にのみ使用可能です。

Domain

ODataリソースの認証に使用されるドメイン。

これは、Authentication Typeパラメータ(上記)でWindowsを選択した場合にのみ使用可能です。

Get Annotation

これらは、エンティティレベルまたはストリームレベルの注釈です。 それらはエンティティのルートレベルで適用できます。 データマッパーの下では、ルートレベルの注釈要素の下に表示されます。 ここでは、複数の注釈をコンマ区切り値として追加できます。 注釈を追加する際、@ odata接頭辞を追加しないでください。

使用可能なデフォルトのアノテーションは、カウントとコンテキストです。 これらはオプションであり、ユーザーが削除できます。

(Since version: 4.13)

row Annotation

これらは行レベルのアノテーションです。 それらは、取得されるエンティティの各行に適用されます。 データマッパーでは、行要素の子となるrowAnnotations要素の下に表示されます。 ここでは、複数の注釈をコンマ区切り値として追加できます。 アノテーションを追加する際、@ odata接頭辞を追加しないでください。

利用可能なデフォルトのアノテーションはetagとidです。 これらはオプションであり、ユーザーが削除できます。

(Since version: 4.13)

Odataリソースには以下のボタンがあります。

ボタン

説明

メタデータの取得

ODataサービスのメタデータを取り出す場合は、このボタンをクリックしてください。

ODataサービスがクラウド上で実行されている場合は、ODataサービスのメタデータを取得するために、TLS 1.2関連の設定を構成する必要があります。これを行うには、.NET FrameworkがTLS 1.2をサポートするように設定されていることを確認してください。

.NET 4.0は、デフォルトでTLS 1.2を有効にしません。TLS 1.2をデフォルトで有効にするには、次の手順を実行してくだい。

次の2つのレジストリキーで、SchUseStrongCrypto(DWORD)の値を1に設定します。

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\v4.0.30319

HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\.NETFramework\v4.0.30319

エンティティ

このボタンをクリックすると、エンティティ一覧が開きます。ここで、必要なODataエンティティを選択します。

エンティティの選択に先がけて、[メタデータの取得]ボタン(上記)をクリックしてメタデータを取り出す必要があります。

ヘッダ

このボタンをクリックすると、[ヘッダ]ダイアログボックスが開きます。ここで、ODataサービスのメタデータを取り出すためにHTTPヘッダを提供することができます。ヘッダには、改行されたキー値のペアとして入力する必要があります。

例:

Authorization: Bearer TXkgQWNjZXNzIFRva2Vu
Accept: application/json

 

Since version:

4.6