1. Homepage
  2. APIkit (4.x)
  3. APIkit for OData v4

  4. APIkit for OData v4 Module リファレンス

APIkit for OData v4 Module リファレンス

APIkit for OData v4 の連動関係、名前空間、スキーマ情報に関する基礎を学び、コラボレーション、アプリケーションの構築、コードベースの管理を行います。

連動関係情報

<dependency>
  <groupId>org.mule.modules</groupId>
  <artifactId>mule-odata-module</artifactId>
  <version>LATEST_VERSION</version> (1)
  <classifier>mule-plugin</classifier>
</dependency>
1 LATEST_VERSION​ を入手するには、 APIkit リリースノート​を確認してください。

名前空間とスキーマ

xmlns:apikit-odata="http://www.mulesoft.org/schema/mule/apikit-odata"
xsi:schemaLocation="http://www.mulesoft.org/schema/mule/apikit-odata http://www.mulesoft.org/schema/mule/apikit-odata/current/mule-apikit-odata.xsd"

設定

設定

デフォルト設定

パラメーター

名前 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

この設定の名前。コネクタはこの名前の設定を参照します。

x

Api Definition (API 定義)

String (文字列)

API 定義。

x

Name (名前)

String (文字列)

他のコンポーネント内のこの要素を参照するために使用するこの要素の識別子。

x

関連操作

関連付けられたソース

操作

Route (ルート)

<apikit-odata:route>

パラメーター

名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Content (コンテンツ)

Any (いずれか)

#[payload]

Output MIME Type (出力 MIME タイプ)

String (文字列)

この操作で出力されるペイロードの MIME タイプ。

Output Encoding (出力エンコード)

String (文字列)

この操作で出力されるペイロードのエンコード。

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

x

Streaming Strategy (ストリーミング戦略)

反復可能なストリームとその動作を使用するかどうかを設定します。

Method (メソッド)

Enumeration (列挙)。次のいずれかになります。

  • GET

  • POST

  • PUT

  • PATCH

  • DELETE

HTTP 要求メソッド名。

x

Masked Request Path (マスクされた要求パス)

String (文字列)

OData 要求パス。リスナーに対して相対的。

x

スキーマ

Enumeration (列挙)。次のいずれかになります。

  • HTTP

  • HTTPS

HTTP 要求スキーム。

x

Host (ホスト)

String (文字列)

要求ホスト。

x

Listener Path (リスナーパス)

String (文字列)

"*" で終わるリスナーパス。

x

Http Headers (HTTP ヘッダー)

Object (オブジェクト)

HTTP リクエストヘッダー。

クエリ文字列

String (文字列)

HTTP クエリ文字列。

Target Variable (対象変数)

String (文字列)

操作の出力が配置される変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。その式の結果は対象変数に保存されます。

#[payload]

出力

型

Any (いずれか)

Attributes Type (属性型)

RouteOutputAttributes

次の設定の場合

スロー

  • APIKIT-ODATA:DESERIALIZATION

  • APIKIT-ODATA:INTERNAL_SERVER_ERROR​

  • APIKIT-ODATA:MALFORMED_SEARCH​

  • APIKIT-ODATA:MALFORMED_URI​

  • APIKIT-ODATA:NOT_FOUND​

  • APIKIT-ODATA:NOT_IMPLEMENTED​

  • APIKIT-ODATA:SERIALIZATION

  • APIKIT-ODATA:TRANSFORMATION

  • APIKIT-ODATA:EXPANSION

Serialize Entity

<apikit-odata:serialize-entity>

パラメーター

名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Inbound Content (インバウンドコンテンツ)

Binary (バイナリ)

#[payload]

Output MIME Type (出力 MIME タイプ)

String (文字列)

この操作で出力されるペイロードの MIME タイプ。

Output Encoding (出力エンコード)

String (文字列)

この操作で出力されるペイロードのエンコード。

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

x

Streaming Strategy (ストリーミング戦略)

反復可能なストリームとその動作を使用するかどうかを設定します。

Method (メソッド)

Enumeration (列挙)。次のいずれかになります。

  • GET

  • POST

  • PUT

  • PATCH

  • DELETE

HTTP メソッド。

x

Path (パス)

String (文字列)

エンティティ種別へのパス。

x

Target Variable (対象変数)

String (文字列)

操作の出力が配置される変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。その式の結果は対象変数に保存されます。

#[payload]

出力

型

Binary (バイナリ)

次の設定の場合

Serialize Entity Collection

<apikit-odata:serialize-entity-collection>

パラメーター

名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

設定の名前。

x

Inbound Content (インバウンドコンテンツ)

Binary (バイナリ)

#[payload]

Output MIME Type (出力 MIME タイプ)

String (文字列)

この操作で出力されるペイロードの MIME タイプ。

Output Encoding (出力エンコード)

String (文字列)

この操作で出力されるペイロードのエンコード。

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

x

Streaming Strategy (ストリーミング戦略)

反復可能なストリームとその動作を使用するかどうかを設定します。

Method (メソッド)

Enumeration (列挙)。次のいずれかになります。

  • GET

  • POST

  • PUT

  • PATCH

  • DELETE

HTTP メソッド。

x

Path (パス)

String (文字列)

エンティティ種別へのパス。

x

Target Variable (対象変数)

String (文字列)

操作の出力が配置される変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。その式の結果は対象変数に保存されます。

#[payload]

出力

型

Binary (バイナリ)

次の設定の場合

Transform to SQL Select

<apikit-odata:transform-to-sql-select>

パラメーター

名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Entity Set Name (エンティティセット名)

String (文字列)

要求されたエンティティセットのデータベース内のテーブル名。

x

Database Schema (データベーススキーマ)

String (文字列)

エンティティセットが属するデータベーススキーマ名。空でない場合、​WHERE​ 句でテーブル名にプレフィックスが付けられます。

Page Size (ページサイズ)

Number (数値)

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

x

Streaming Strategy (ストリーミング戦略)

反復可能なストリームとその動作を使用するかどうかを設定します。

Entity Type Name (エンティティ種別名)

String (文字列)

エンティティデータモデルにより、エンティティ種別名が指定されます。

x

Entity Type Fields (エンティティ種別項目)

Array of String (文字列の配列)

エンティティ種別のプロパティ項目のリスト。

x

Entity Type Keys (エンティティ種別キー)

Object (オブジェクト)

エンティティキー名と値のマップ。

x

System Query Options (システムクエリオプション)

Object (オブジェクト)

システムクエリオプションマップ。システムクエリオプションの文法と構文のルールは [OData-ABNF] で定義されています。より使いやすくするために、DataWeave 内のエスケープを回避するように最初のドル記号は削除されます。たとえば、システムクエリオプション ​$skip​ にアクセスするには、式 #[attributes.systemQueryOptions.'skip'] を使用します。

x

Search Transformation Enabled (検索変換を有効化)

Boolean (ブール)

WHERE​ 句への ​$search​ 変換を有効にします。

true

Strict Search Term Match (厳密な検索語の一致)

Boolean (ブール)

$search​ で完全一致を有効にします。有効になっている場合、​WHERE​ 句内の用語は「%」で囲まれません。

false

Sql Limit Rows (SQL 制限行数)

Enumeration (列挙)。次のいずれかになります。

  • LIMIT

  • FETCH_NEXT_ROWS_ONLY​

行数を制限するオプション。

Sql Identifiers Delimiter (SQL 識別子の区切り文字)

Enumeration (列挙)。次のいずれかになります。

  • DOUBLE_QUOTES​

  • BRACKETS

  • BACK_TICKS​

識別子を区切るオプション。

Target Variable (対象変数)

String (文字列)

操作の出力が配置される変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。その式の結果は対象変数に保存されます。

#[payload]

出力

型

Binary (バイナリ)

Attributes Type (属性型)

* SqlTransformerOutputAttributes

次の設定の場合

スロー

  • APIKIT-ODATA:INTERNAL_SERVER_ERROR​

  • APIKIT-ODATA:MALFORMED_SEARCH​

  • APIKIT-ODATA:MALFORMED_URI​

  • APIKIT-ODATA:NOT_IMPLEMENTED​

  • APIKIT-ODATA:TRANSFORMATION

ソース

On Entity Collection Request

<apikit-odata:request-entity-collection-listener>

パラメーター

名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

出力 MIME タイプ

String (文字列)

この操作で出力されるペイロードの MIME タイプ。

Output Encoding (出力エンコード)

String (文字列)

この操作で出力されるペイロードのエンコード。

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

x

Primary Node Only (プライマリノードのみ)

Boolean (ブール)

クラスターでの実行時、このソースをプライマリノード上でのみ実行するかどうかを指定します。

Streaming Strategy (ストリーミング戦略)

反復可能なストリームとその動作を使用するかどうかを設定します。

Redelivery Policy (再配信ポリシー)

同じメッセージの再配信を処理するためのポリシー。

Method (メソッド)

Enumeration (列挙)。次のいずれかになります。

  • GET

  • POST

  • PUT

  • PATCH

  • DELETE

HTTP メソッド。

x

Path (パス)

String (文字列)

エンティティ種別へのパス。

x

Collection Success Response (収集成功応答)

次のいずれかになります。

サポートされるシステムクエリオプション - ​$expand

Boolean (ブール)

$expand​ のサポートを有効にします。

true

展開が有効な場合のエラーを無視

Boolean (ブール)

一般的展開がコールするフローからのエラーをこのフローに伝達できないようにします。​true​ の場合、失敗した展開は ​null​ として表示されます。

false

展開可能なナビゲーションプロパティ

List<String>

このフローから一般的に展開できる種別のリスト。

[]

出力

型

Any (いずれか)

Attributes Type (属性型)

ListenerRequestAttributes

次の設定の場合

On Entity Request

<apikit-odata:request-entity-listener>

パラメーター

名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

出力 MIME タイプ

String (文字列)

この操作で出力されるペイロードの MIME タイプ。

Output Encoding (出力エンコード)

String (文字列)

この操作で出力されるペイロードのエンコード。

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

x

Primary Node Only (プライマリノードのみ)

Boolean (ブール)

クラスターでの実行時、このソースをプライマリノード上でのみ実行する必要があるかどうか。

Streaming Strategy (ストリーミング戦略)

反復可能なストリームとその動作を使用するかどうかを設定します。

Redelivery Policy (再配信ポリシー)

同じメッセージの再配信を処理するためのポリシー。

Method (メソッド)

Enumeration (列挙)。次のいずれかになります。

  • GET

  • POST

  • PUT

  • PATCH

  • DELETE

HTTP メソッド。

x

Path (パス)

String (文字列)

エンティティ種別へのパス。

x

サポートされるシステムクエリオプション - ​$expand

Boolean (ブール)

$expand​ のサポートを有効にします。

true

展開が有効な場合のエラーを無視

Boolean (ブール)

一般的展開がコールするフローからのエラーをこのフローに伝達できないようにします。​true​ の場合、失敗した展開は ​null​ として表示されます

false

展開可能なナビゲーションプロパティ

List<String>

このフローから一般的に展開できる種別のリスト。

[]

出力

型

Any (いずれか)

Attributes Type (属性型)

ListenerRequestAttributes

次の設定の場合

型

Listener Request Attributes (リスナー要求属性)

項目 型 説明 デフォルト値 必須

Entity Set Name (エンティティセット名)

String (文字列)

Odata Http Attributes (OData HTTP 属性)

ODataHttpAttributes

Odata Request Attributes (Odata 要求属性)

ODataRequestAttributes

OData Http Attributes (OData HTTP 属性)

項目 型 説明 デフォルト値 必須

Headers (ヘッダー)

Object (オブジェクト)

Method (メソッド)

Enumeration (列挙)。次のいずれかになります。

  • GET

  • POST

  • PUT

  • PATCH

  • DELETE

Raw Base Uri (未加工ベース URI)

String (文字列)

Raw Odata Path (未加工データパス)

String (文字列)

Raw Query Path (未加工クエリパス)

String (文字列)

Raw Request Uri (未加工要求 URI)

String (文字列)

Scheme (スキーム)

Enumeration (列挙)。次のいずれかになります。

  • HTTP

  • HTTPS

OData Request Attributes (Odata 要求属性)

項目 型 説明 デフォルト値 必須

Custom Query Options (カスタムクエリオプション)

Object (オブジェクト)

Entity Type Fields (エンティティ種別項目)

Array of String (文字列の配列)

Entity Type Keys (エンティティ種別キー)

Object (オブジェクト)

Entity Type Name (エンティティ種別名)

String (文字列)

System Query Options (システムクエリオプション)

Object (オブジェクト)

Repeatable In Memory Stream (反復可能なメモリ内ストリーム)

項目 型 説明 デフォルト値 必須

Initial Buffer Size (初期バッファサイズ)

Number (数値)

ストリームをコンシュームし、ランダムアクセスを提供するために割り当てられたメモリ量。ストリームにバッファ容量を超えるデータが含まれる場合、バッファは ​bufferSizeIncrement​ 属性に従って上限の ​maxInMemorySize​ まで拡張されます。

Buffer Size Increment (バッファサイズ増分)

Number (数値)

バッファサイズが初期サイズを超えた場合のサイズの拡張。値を 0 以下に設定すると、バッファが拡張されません。つまり、バッファがフルになると、​STREAM_MAXIMUM_SIZE_EXCEEDED​ エラーが発生します。

Max Buffer Size (最大バッファサイズ)

Number (数値)

バッファで使用するメモリの最大量。メモリ使用量がこの制限を超えると、​STREAM_MAXIMUM_SIZE_EXCEEDED​ エラーが発生します。0 以下の値は無制限を意味します。

Buffer Unit (バッファ単位)

Enumeration (列挙)。次のいずれかになります。

  • BYTE (バイト)

  • KB

  • MB

  • GB

これらの属性を表現する単位。

Repeatable File Store Stream (反復可能なファイルストアストリーム)

項目 型 説明 デフォルト値 必須

In Memory Size (メモリ内サイズ)

Number (数値)

データをメモリ内に保持するためにストリームで使用する最大メモリ。これを超えると、ディスクへのコンテンツのバッファが開始されます。

Buffer Unit (バッファ単位)

Enumeration (列挙)。次のいずれかになります。

  • BYTE (バイト)

  • KB

  • MB

  • GB

maxInMemorySize​ を表す単位。

Redelivery Policy (再配信ポリシー)

項目 型 説明 デフォルト値 必須

Max Redelivery Count (最大再配信数)

Number (数値)

正常に処理されずにプロセス失敗メッセージがトリガーされるまでにメッセージを再配信できる最大回数。

Message Digest Algorithm (メッセージダイジェストアルゴリズム)

String (文字列)

セキュアハッシュアルゴリズム (デフォルト: SHA-256)。

Message Identifier (メッセージ識別子)

RedeliveryPolicyMessageIdentifier

メッセージを識別する戦略。

Object Store (オブジェクトストア)

ObjectStore

各メッセージの再配信カウンターが保存されるオブジェクトストア。

Redelivery Policy Message Identifier (再配信ポリシーメッセージ識別子)

項目 型 説明 デフォルト値 必須

Use Secure Hash (セキュアハッシュを使用)

Boolean (ブール)

再配信されたメッセージの識別にセキュアハッシュアルゴリズムを使用するかどうか。

Id Expression (ID 式)

String (文字列)

メッセージがいつ再配信されたのかを判断する 1 つ以上の式。このプロパティは、​useSecureHash​ が ​false​ の場合に設定できます。

Route Output Attributes (ルート出力属性)

項目 型 説明 デフォルト値 必須

Headers (ヘッダー)

Object (オブジェクト)

状況コード

Number (数値)

SQL Transformer Output Attributes (SQL トランスフォーマー出力属性)

項目 型 説明 デフォルト値 必須

Query Parameters (クエリパラメーター)

Object (オブジェクト)

Raw Entity Success Response (未加工エンティティ成功応答)

項目 型 説明 デフォルト値 必須

Raw Content (未加工コンテンツ)

Binary (バイナリ)

応答メッセージの未加工応答コンテンツ。

#[payload]

Entity Success Response (エンティティ成功応答)

項目 型 説明 デフォルト値 必須

Body Content (本文コンテンツ)

Binary (バイナリ)

応答メッセージの本文。

#[payload]

Raw Entity Collection Success Response (未加工エンティティ収集成功応答)

項目 型 説明 デフォルト値 必須

Raw Content (未加工コンテンツ)

Binary (バイナリ)

未加工応答メッセージ。

#[payload]

Entity Collection Success Response (エンティティ収集成功応答)

項目 型 説明 デフォルト値 必須

Body Content (本文コンテンツ)

Binary (バイナリ)

応答メッセージの本文。

#[payload]

Serialization Parameters (逐次化パラメーター)

SerializationParameters

逐次化関連のパラメーターセット。

x

Serialization Parameters (逐次化パラメーター)

項目 型 説明 デフォルト値 必須

Count (数)

Number (数値)

Page Size (ページサイズ)

Number (数値)

Token (トークン)

String (文字列)

関連情報