Skip to content

Commit 8a33ad1

Browse files
committed
Rewording
1 parent f32be69 commit 8a33ad1

File tree

1 file changed

+9
-16
lines changed

1 file changed

+9
-16
lines changed

content/en/docs/refguide/modeling/integration/odata-services/published-odata-services/published-odata-entity.md

Lines changed: 9 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -111,7 +111,7 @@ When the app receives a request to insert a new object, it does the following:
111111

112112
This is the behavior when you choose the action **Write to database**.
113113

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.
115115

116116
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).
117117

@@ -156,19 +156,15 @@ When the app receives a request to change values, it does the following:
156156

157157
This is the behavior when you choose the action **Write to database**.
158158

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.
162160

163161
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).
164162

165163
### 6.4 Deletable {#deletable}
166164

167165
Select the checkbox for **Deletable** to indicate that clients can delete the values of attributes and associations.
168166

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.
172168

173169
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.
174170

@@ -196,15 +192,12 @@ When **Use paging** is set to **Yes**, the number of objects per page can be set
196192

197193
Default: **10000**
198194

199-
## 8 Customising outgoing HTTP response (only applicable when **Call a microflow** is selected)
195+
## 8 Customizing the Outgoing HTTP Response {#custom-http-response}
200196

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.
203198

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:
205200

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

Comments
 (0)