Contact Us 1-800-596-4880
  1. Homepage
  2. APIkit (4.x)
  3. APIkit for OData V4

  4. Module Reference

APIkit for OData v4 Module Reference

Learn the fundamentals about dependency, namespace, and schema information in APIkit for OData v4 to collaborate, build applications, and maintain codebases.

Dependency Information

<dependency>
  <groupId>org.mule.modules</groupId>
  <artifactId>mule-odata-module</artifactId>
  <version>LATEST_VERSION</version> (1)
  <classifier>mule-plugin</classifier>
</dependency>
1 Check APIkit release notes to get the LATEST_VERSION.

Namespace and Schema

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"

Configurations

Config

Default configuration

Parameters

Name Type Description Default Value Required

Name

String

Name for this configuration. Connectors reference the configuration with this name

None

Yes

Api Definition

String

API definition

None

Yes

Name

String

Identifier of this element used to reference it in other components

None

Yes

Associated Operations

Associated Sources

Operations

Route

<apikit-odata:route>

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use

None

Yes

Content

Any

The content to be routed.

#[payload]

No

Route correlation Id

Boolean

Consistent correlation Ids across subsequent flows

true

No

Output MIME Type

String

MIME type of the payload that this operation outputs

None

No

Output Encoding

String

Encoding of the payload that this operation outputs

None

No

Config Ref

ConfigurationProvider

Name of the configuration used to execute this component

None

Yes

Streaming Strategy

Configure if repeatable streams and their behavior are used

non-repeatable-stream

No

Method

Enumeration, one of:

  • GET

  • POST

  • PUT

  • PATCH

  • DELETE

HTTP request method name

None

Yes

Masked Request Path

String

OData request path, relative to listener

None

Yes

Scheme

Enumeration, one of:

  • HTTP

  • HTTPS

HTTP request scheme

None

Yes

Host

String

Request host

None

Yes

Listener Path

String

Listener path ending with "*"

None

Yes

Http Headers

Object

HTTP request headers

#[attributes.headers]

No

Query String

String

HTTP query string

#[attributes.queryString]

No

Target Variable

String

Name of a variable on which the operation output is placed

None

No

Target Value

String

An expression that is evaluated against the operation output and the outcome of that expression is stored in the target variable

#[payload]

No

Output

Type

Any

Attributes Type

RouteOutputAttributes

For Configurations

Throws

  • 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>

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use

None

Yes

Inbound Content

Binary

The binary content to serialize.

#[payload]

No

Output MIME Type

String

MIME type of the payload that this operation outputs

None

No

Output Encoding

String

Encoding of the payload that this operation outputs

None

No

Config Ref

ConfigurationProvider

Name of the configuration used to execute this component

None

Yes

Streaming Strategy

Configure if repeatable streams and their behavior are used

non-repeatable-stream

No

Method

Enumeration, one of:

  • GET

  • POST

  • PUT

  • PATCH

  • DELETE

HTTP Method

None

Yes

Path

String

Path to Entity Type

None

Yes

Target Variable

String

Name of a variable on which the operation output is placed

None

No

Target Value

String

An expression that is evaluated against the operation output and the outcome of that expression is stored in the target variable

#[payload]

No

Output

Type

Binary

For Configurations

Serialize Entity Collection

<apikit-odata:serialize-entity-collection>

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration

None

Yes

Inbound Content

Binary

The binary content to serialize.

#[payload]

No

Output MIME Type

String

MIME type of the payload that this operation outputs

None

No

Output Encoding

String

Encoding of the payload that this operation outputs

None

No

Config Ref

ConfigurationProvider

Name of the configuration used to execute this component

None

Yes

Streaming Strategy

Configure if repeatable streams and their behavior are used

non-repeatable-stream

No

Method

Enumeration, one of:

  • GET

  • POST

  • PUT

  • PATCH

  • DELETE

HTTP Method

None

Yes

Path

String

Path to Entity Type

None

Yes

Target Variable

String

Name of a variable on which the operation output is placed

None

No

Target Value

String

An expression that is evaluated against the operation output and the outcome of that expression is stored in the target variable

#[payload]

No

Output

Type

Binary

For Configurations

Transform to SQL Select

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

Parameters

Name Type Description Default Value Required

Config Ref

ConfigurationProvider

Name of the configuration used to execute this component

None

Yes

Configuration

String

Name of the configuration to use

None

Yes

Database Schema

String

Database schema name to which the entity set belongs. If not empty, it’s prefixed to the table name in the WHERE clause

None

No

Entity Set Name

String

Table name in the database for the requested entity set

None

Yes

Entity Type Fields

Array of String

List of property fields from the Entity type

None

Yes

Entity Type Keys

Object

Map of entity key names and values

None

Yes

Entity Type Name

String

Entity Data Model specifies the entity type name

None

Yes

Page Size

Number

The number of records to retrieve.

None

No

searchFieldsAsType

Object

Data type to which fields are type-casted for the $search operation. If empty, no type-casting is performed

None

No

Search Transformation Enabled

Boolean

Enabling $search transformation to WHERE clause

true

No

Sql Identifiers Delimiter

Enumeration, one of:

  • DOUBLE_QUOTES

  • BRACKETS

  • BACK_TICKS

Option to delimit identifiers

DOUBLE_QUOTES

No

Sql Limit Rows

Enumeration, one of:

  • LIMIT

  • FETCH_NEXT_ROWS_ONLY

Option to limit the number of rows

LIMIT

No

Strict Search Term Match

Boolean

Enabling full term match for $search. If enabled, terms in WHERE clause aren’t enclosed between '%'.

false

No

Streaming Strategy

Configure if repeatable streams and their behavior are used

non-repeatable-stream

No

System Query Options

Object

System Query Options map. The grammar and syntax rules for system query options are defined in [OData-ABNF]. To simplify usability, the initial dollar sign is removed to avoid escaping within DataWeave. For example, to access System Query Option, $skip uses the following expression #[attributes.systemQueryOptions.'skip']

#[attributes.systemQueryOptions]

Yes

Target Variable

String

Name of a variable on which the operation output is placed

None

No

Target Value

String

An expression that is evaluated against the operation output and the outcome of that expression is stored in the target variable

#[payload]

No

Output

Type

Binary

Attributes Type

* SqlTransformerOutputAttributes

For Configurations

Throws

  • APIKIT-ODATA:INTERNAL_SERVER_ERROR

  • APIKIT-ODATA:MALFORMED_SEARCH

  • APIKIT-ODATA:MALFORMED_URI

  • APIKIT-ODATA:NOT_IMPLEMENTED

  • APIKIT-ODATA:TRANSFORMATION

Sources

On Entity Collection Request

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

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use

None

Yes

Output MIME Type

String

MIME type of the payload that this operation outputs

None

No

Output Encoding

String

Encoding of the payload that this operation outputs

None

No

Config Ref

ConfigurationProvider

Name of the configuration used to execute this component

None

Yes

Primary Node Only

Boolean

Specify if this source executes only on the primary node when running in Cluster

false

No

Streaming Strategy

Configure if repeatable streams and their behavior are used

non-repeatable-stream

No

Redelivery Policy

Policy for processing the redelivery of the same message

None

No

Method

Enumeration, one of:

  • GET

  • POST

  • PUT

  • PATCH

  • DELETE

HTTP Method

None

Yes

Path

String

Path to Entity Type

None

Yes

Collection Success Response

One of:

No

Supported System Query Options - $expand

Boolean

Enabling support for $expand

true

No

Ignore errors on expansion enabled

Boolean

Disallowing errors from the flows that generic expansion calls to propagate to this flow. When true, failed expansions render as null.

false

No

Expandable navigation properties

List<String>

List of types that can be generically expanded from this flow.

[]

No

Output

Type

Any

Attributes Type

ListenerRequestAttributes

For Configurations

On Entity Request

<apikit-odata:request-entity-listener>

Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use

None

Yes

Output MIME Type

String

MIME type of the payload that this operation outputs

None

No

Output Encoding

String

Encoding of the payload that this operation outputs

None

No

Config Ref

ConfigurationProvider

Name of the configuration used to execute this component

None

Yes

Primary Node Only

Boolean

If this source must only be executed on the primary node when running in Cluster

false

No

Streaming Strategy

Configure if repeatable streams and their behavior are used

non-repeatable-stream

No

Redelivery Policy

Policy for processing the redelivery of the same message

None

No

Method

Enumeration, one of:

  • GET

  • POST

  • PUT

  • PATCH

  • DELETE

HTTP Method

None

Yes

Path

String

Path to Entity Type

None

Yes

Supported System Query Options - $expand

Boolean

Enabling support for $expand

true

No

Ignore errors on expansion enabled

Boolean

Disallowing errors from the flows that generic expansion calls to propagate to this flow. When true, failed expansions render as null

false

No

Expandable navigation properties

List<String>

List of types that can be generically expanded from this flow

[]

No

Output

Type

Any

Attributes Type

ListenerRequestAttributes

For Configurations

Types

Listener Request Attributes

Field Type Description Default Value Required

Entity Set Name

String

Name of the requested entity set.

#[attributes.entitySetName]

No

Odata Http Attributes

ODataHttpAttributes

HTTP attributes of the OData request.

#[attributes.odataHttpAttributes]

No

Odata Request Attributes

ODataRequestAttributes

OData-specific attributes of the OData request.

#[attributes.odataRequestAttributes]

No

OData Http Attributes

Field Type Description Default Value Required

Headers

Object

An object containing the HTTP headers of the incoming request. This allows the router to access the request headers.

#[attributes.headers]

No

Method

Enumeration, one of:

  • GET

  • POST

  • PUT

  • PATCH

  • DELETE

The HTTP method of the OData request.

None

No

Raw Base Uri

String

Base URI of the OData request

#[attributes.baseUri]

No

Raw Odata Path

String

Raw OData path of the OData request

#[attributes.rawODataPath]

No

Raw Query Path

String

Raw query path of the OData request

#[attributes.rawQueryPath]

No

Raw Request Uri

String

Raw request URI of the OData request

#[attributes.rawRequestUri]

No

Scheme

Enumeration, one of:

  • HTTP

  • HTTPS

No

OData Request Attributes

Field Type Description Default Value Required

Custom Query Options

Object

Custom query options of the OData request

#[attributes.customQueryOptions]

No

Entity Type Fields

Array of String

Entity-type fields of the OData request

#[attributes.entityTypeFields]

No

Entity Type Keys

Object

Entity-type keys of the OData request

#[attributes.entityTypeKeys]

No

Entity Type Name

String

Entity-type name of the OData request

#[attributes.entityTypeName]

No

System Query Options

Object

System query options of the OData request

#[attributes.systemQueryOptions]

No

Repeatable in Memory Stream

Field Type Description Default Value Required

Initial Buffer Size

Number

Amount of memory allocated to consume the stream and provide random access to it. If the stream has more data than the buffer capacity, it expands according to the bufferSizeIncrement attribute, with an upper limit of maxInMemorySize.

None

No

Buffer Size Increment

Number

Expansion of the buffer size if exceeding its initial size. If you set a value of zero or lower, the buffer doesn’t expand and raises a STREAM_MAXIMUM_SIZE_EXCEEDED error when the buffer gets full.

None

No

Max Buffer Size

Number

The maximum amount of memory for the buffer to use. When memory usage exceeds this limit, a STREAM_MAXIMUM_SIZE_EXCEEDED error is raised. A value lower or equal to zero means no limit.

None

No

Buffer Unit

Enumeration, one of:

  • BYTE

  • KB

  • MB

  • GB

Unit to express these attributes

None

No

Repeatable File Store Stream

Field Type Description Default Value Required

In Memory Size

Number

Maximum memory that the stream uses to keep data in memory. If more memory is consumed, the stream starts to buffer the content on the disk

None

No

Buffer Unit

Enumeration, one of:

  • BYTE

  • KB

  • MB

  • GB

Unit to express maxInMemorySize

KB

No

Redelivery Policy

Field Type Description Default Value Required

Max Redelivery Count

Number

Maximum number of times a message can be redelivered and processed unsuccessfully before triggering process-failed-message

None

No

Message Digest Algorithm

String

Secure hashing algorithm (default: SHA-256)

SHA-256

No

Message Identifier

RedeliveryPolicyMessageIdentifier

Strategy to identify the messages

None

No

Object Store

ObjectStore

The object store where the redelivery counter for each message is stored

None

No

Use Secure Hash

Boolean

Whether to use a secure hash algorithm to identify a redelivered message

None

No

Id Expression

String

One or more expressions that determine when a message is redelivered. You can set this property if useSecureHash is false

none

No

Redelivery Policy Message Identifier

Field Type Description Default Value Required

Use Secure Hash

Boolean

Whether to use a secure hash algorithm to identify a redelivered message

No

Id Expression

String

One or more expressions that determine when a message is redelivered. You can set this property if useSecureHash is false

No

Route Output Attributes

Field Type Description Default Value Required

Headers

Object

An object representing the HTTP headers to be included in the response.

#[attributes.headers]

No

Status Code

Number

The HTTP status code to be returned in the response.

None

No

SQL Transformer Output Attributes

Field Type Description Default Value Required

Query Parameters

Object

An object representing the query parameters to be included in the response.

None

No

Raw Entity Success Response

Field Type Description Default Value Required

Raw Content

Binary

Raw response content of the response message

#[payload]

No

Entity Success Response

Field Type Description Default Value Required

Body Content

Binary

Body of the response message

#[payload]

No

Raw Entity Collection Success Response

Field Type Description Default Value Required

Raw Content

Binary

Raw response message

#[payload]

No

Entity Collection Success Response

Field Type Description Default Value Required

Body Content

Binary

Body of the response message

#[payload]

No

Serialization Parameters

SerializationParameters

Set of serialization-related parameters.

Yes

Serialization Parameters

Field Type Description Default Value Required

Count

Number

The number of entities.

None

No

Page Size

Number

The number of entities per page.

None

No

Token

String

The token to retrieve the next page.

None

No

See Also