You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/en/docs/refguide/modeling/integration/odata-services/published-odata-services/published-odata-entity.md
+9-16Lines changed: 9 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -111,7 +111,7 @@ When the app receives a request to insert a new object, it does the following:
111
111
112
112
This is the behavior when you choose the action **Write to database**.
113
113
114
-
You can also choose the **Call a microflow** action to use your own logic. Specify a microflow that takes the entity as a parameter, and optionally a [System.HttpRequest](/refguide/http-request-and-response-entities/) and/or a [System.HttpResponse](/refguide/http-request-and-response-entities/)parameters. In the microflow, you can use the [Commit](/refguide/committing-objects/) activity to commit the changes to the database.
114
+
You can also choose the **Call a microflow** action to use your own logic. Specify a microflow that takes the entity as a parameter, and optionally a [System.HttpRequest](/refguide/http-request-and-response-entities/) and/or a [System.HttpResponse](/refguide/http-request-and-response-entities/)parameter. In the microflow, you can use the [Commit](/refguide/committing-objects/) activity to commit the changes to the database. See [Customizing the Outgoing HTTP Response](#custom-http-response) below for more information.
115
115
116
116
In the publishing app, you can use a validation message action to report a validation error. The client app can include a custom error handler on the [Send External Object](/refguide/send-external-object/) activity to handle the error. If the microflow reports [validation feedback](/refguide/validation-feedback/), the runtime informs the client that the request has failed. For more information, see [Supported OData Operations](/refguide/supported-odata-operations/#updating-objects).
117
117
@@ -156,19 +156,15 @@ When the app receives a request to change values, it does the following:
156
156
157
157
This is the behavior when you choose the action **Write to database**.
158
158
159
-
You can also choose the **Call a microflow** action to use your own logic.
160
-
Specify a microflow that takes the entity as a parameter, and optionally a [System.HttpRequest](/refguide/http-request-and-response-entities/) and/or a [System.HttpResponse](/refguide/http-request-and-response-entities/) parameters.
161
-
In the microflow, you can use the [Commit](/refguide/committing-objects/) activity to commit the changes to the database.
159
+
You can also choose the **Call a microflow** action to use your own logic. Specify a microflow that takes the entity as a parameter, and optionally a [System.HttpRequest](/refguide/http-request-and-response-entities/) and/or a [System.HttpResponse](/refguide/http-request-and-response-entities/) parameter. In the microflow, you can use the [Commit](/refguide/committing-objects/) activity to commit the changes to the database. See [Customizing the Outgoing HTTP Response](#custom-http-response) below for more information.
162
160
163
161
In the publishing app, you can use a validation message action to report a validation error. The client app can include a custom error handler on the [Send External Object](/refguide/send-external-object/) activity to handle the error. If the microflow reports [validation feedback](/refguide/validation-feedback/), the runtime informs the client that the request has failed. For more information, see [Supported OData Operations](/refguide/supported-odata-operations/#updating-objects).
164
162
165
163
### 6.4 Deletable {#deletable}
166
164
167
165
Select the checkbox for **Deletable** to indicate that clients can delete the values of attributes and associations.
168
166
169
-
Choose whether the object should be deleted from the database directly, or whether to call a microflow.
170
-
Specify a microflow that takes the entity as a parameter, and optionally a [System.HttpRequest](/refguide/http-request-and-response-entities/) and/or a [System.HttpResponse](/refguide/http-request-and-response-entities/) parameters.
171
-
In the microflow, you can use the [Delete](/refguide/deleting-objects/) activity to delete the object from the database.
167
+
Choose whether the object should be deleted from the database directly, or whether to call a microflow. Specify a microflow that takes the entity as a parameter, and optionally a [System.HttpRequest](/refguide/http-request-and-response-entities/) and/or a [System.HttpResponse](/refguide/http-request-and-response-entities/) parameter. In the microflow, you can use the [Delete](/refguide/deleting-objects/) activity to delete the object from the database. See [Customizing the Outgoing HTTP Response](#custom-http-response) below for more information.
172
168
173
169
You can use a validation message to report a validation error if you are performing, for example, a soft delete. If the microflow reports [validation feedback](/refguide/validation-feedback/), the runtime informs the client that the request has failed.
174
170
@@ -196,15 +192,12 @@ When **Use paging** is set to **Yes**, the number of objects per page can be set
196
192
197
193
Default: **10000**
198
194
199
-
## 8 Customising outgoing HTTP response (only applicable when **Call a microflow** is selected)
195
+
## 8 Customizing the Outgoing HTTP Response {#custom-http-response}
200
196
201
-
It is possible to manipulate response which would be produced as a result of the request.
202
-
In order to do that the microflow must take a parameter of [System.HttpResponse](/refguide/http-request-and-response-entities/) type.
197
+
When using **Call a microflow** for any of these capabilities, the selected microflow can take a [System.HttpResponse](/refguide/http-request-and-response-entities/) parameter.
203
198
204
-
If no changes were made to HttpResponse object then actual response won't be changed as well.
199
+
You can use this parameter to affect the HTTP response:
205
200
206
-
If only headers of the HttpResponse were changed (for instance a new header was added to the response) then those headers would be merged with default headers, replacing values of the same name.
207
-
208
-
If status code OR content of the HttpResponse were changed then actual response would be produced exclusively from HttpResponse parameter, including status code, headers and response body.
209
-
210
-
Note. Reason phrase field is ignored.
201
+
* The microflow can create headers associated to the HttpResponse parameter. These headers will be added to the response, overwriting headers with the same key if those would otherwise have been created.
202
+
* The microflow can change the StatusCode and/or the Content attributes of the HttpResponse parameter to completely ignore the default behavior and response with that StatusCode and Content instead.
203
+
* Changing the ReasonPhrase attribute has no effect.
0 commit comments