Skip to Content
Last modified by Martijn Woudstra on 2022/06/16 14:08
Show last authors
1 {{container}}{{container layoutStyle="columns"}}(((
2 In this microlearning you can see how to configure an OData based operation in an API Gateway.
3
4 Should you have any questions, please get in touch with [[academy@emagiz.com>>mailto:academy@emagiz.com]].
5
6 * Last update: December 2021
7 * Required reading time: 10 minutes
8
9 == 1. Prerequisites ==
10
11 * Advanced knowledge of the eMagiz platform
12 * Completed the relevant microlearnings Key Concepts API Gateway (level crash course to intermediate)
13
14 == 2. Key concepts ==
15
16 The OData protocol stands for the Open Data protocol and was launched by Microsoft in 2007. It allows to create a queryable and interoperable REST API's. The lastest version is OData v4 and has become a standard protocal via the Oasis organisation. In the context of eMagiz, it allows to send a OData request to the API Gateway which take the form of an OData query. The API Gateway has a component inside that allows to interpret this query and use that information to fetch or post data. OData based REST services use the similar HTTP operations such as GET, POST, etc. Please refer to section 6 in this microlearning for more details.
17
18 == 3. eMagiz configuration ==
19
20 === 3.1 Design ===
21
22 In the Design phase, you have the option to select the type of API for the operation to be configured. In the screenshot below you can see that OData is one of the API types. All other configurations in eMagiz will work exactly the same as for another API type. Such a creating the request & response messages for the Gateway and the API provider. Or setting the security for the API gateway. Please consult the relevant microlearnings on this topics.
23
24 [[image:Main.Images.Microlearning.WebHome@advanced-configuration-apigateway-odata-2.png]]
25
26 === 3.2 Create ===
27
28 Once the Design phase is complete, the configuration can be added to the create phase. The exit gate will exactly the same in terms of how to configure that one. The All entry of the API Gateway will be updated according to the API type, in a sense that for this OData operation a specific inbound gateway is created (OData Storage Gateway). This component handles the translation from OData based queries to and from the exit gate. OData request will be transformed to a regular JMS message, and a response transformed into a OData readable format.
29
30 [[image:Main.Images.Microlearning.WebHome@advanced-configuration-apigateway-odata-1.png]]
31
32 == 4. Assignment ==
33
34 There is no assignment for now in this microlearning
35
36 == 5. Key takeaways ==
37
38 * Please note that eMagiz allows to publish a OData based API
39 * This functionality has been used in the context of the Mendix Data Hub
40
41 == 6. Suggested Additional Readings ==
42
43 Take a moment to read the following links:
44
45 * https://en.wikipedia.org/wiki/Open_Data_Protocol
46 * https://www.odata.org/
47 * https://www.odata.org/getting-started/understand-odata-in-6-steps/
48
49 == 7. Silent demonstration video ==
50
51 As this is a more theoretical microlearning, we have no video that accompanies this microlearning. The screenshot would suffice for the moment.)))((({{toc/}}))){{/container}}{{/container}}