Page Properties | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
Feedback are user is approved or corrected extraction values that are submitted by you back to the extraction system.
You should always submit the feedback on extractions. The feedback that is correctly submitted allows enables Gini to measure the extraction quality in order to provide the best possible user experience. Moreover, it helps us to continuously improve the extraction system and perform valuable data analytics for you.
Info |
---|
The feedback should only be sent if real users can see, approve, correct, and complement the extractions extraction-based data. |
Gini employs various machine learning techniques in order to learn from feedback automatically. Therefore, it is equally important for Gini to receive both feedback on correct and on incorrect extractions.
...
Ways of submitting feedback
There are currently two ways to submit the feedback.
The first and the most common one is to submit the complete feedback in one request. This is the easiest way if your frontend (application) displays the extractions on a screen in an editable form. A user can modify the extractions before pressing the confirmation button.
The second (a rare use case) rarely used) way is where the final approvement signal (button click) is not possible. In such case you can , send the feedback on one label per request.
Types of feedback
There are three different types of feedback:
positive feedback : (our preferred type): the extraction was correct and confirmed by the user without modification.
complementary feedback: The the extraction system extracted nothing, e.g. the response does not , for example, the response doesn't contain the requested label. The user manually entered the correct value.
negative feedback: The the extraction was incomplete or erroneous. The user manually corrected the extraction.
informative feedback: The the extraction was changed for another reason. For , for example, if a line item is returned, the quantity extraction gets feedback "0" and a return reason.
...
.
...
The Gini Pay API allows you to submit the feedback on multiple extractions for a single document with a single request. It is strongly recommended that you submit your feedback in this way for two reasons. On the one hand, the total number of round trips is reduced to one and the feedback is handled internally as a batch. Therefore, the update is more efficient for multiple extractions compared to submitting the feedback with each separate request (see single feedback). On the other hand, Gini's machine learning training techniques can benefit from the feedback on multiple extractions since Gini will be is aware of the fact that single parts of the submitted feedback belong together.
Info |
---|
You should send the Send feedback only on those labels that has been are physically seen by the user. Unseen labels should be filtered out. |
...
Give feedback and correct or verify multiple specific labeled extraction patterns with a single PUT
or POST
request to the document extractions URI.
The labels must should correspond to the names of the extraction types e.g. , for example, amountToPay
. See available specific extractions Available Specific Extractions for possible values.
Headers
...
The boxes are optional. Boxes should only be sent if your use case visualize visualizes the document with the locations of the extractions. Thus, the user can confirm the correct location of a an extraction.
Response
Status Code | Description |
---|---|
204 (No Content) | The feedback was successfully processed. |
404 (Not Found) | The document or the label could not be found. |
406 (Not Acceptable) | The request headers were not set correctly. |
422 (Unprocessable Entity) | At least one value was not valid regarding entity validation rules of the label. |
...
Test Example
In order to test the integration of the feedback functionality, we offer a PDF test document with the expected outcome in a JSON format. This document can be used for an integration test of Gini’s Pay API in general. Furthermore, we provide a query for sending feedback where all fields are correct except for the amountToPay. After sending this feedback, we show you how you can to ensure that the feedback with your confirmation and correction for the field values was successful.
Sending the test document to the Gini Pay API (see also submitting files). See Submit Files.
Requesting the results (see also retrieving extractions). See Retrieve Extractions.
You should get a JSON like in the example.
Correcting the document with the following JSON (see also submitting feedback on extractions). Here we change the amountToPay from "995.00:EUR" to "950.00:EUR" and confirm the other field values (iban, bic, paymentRecipient, paymentReference).
Code Block |
---|
{ "feedback": { "amountToPay": { "value": "950.00:EUR" }, "iban": { "value": "DE68130300000017850360" }, "bic": { "value": "BYLADEM1001" }, "paymentPurpose": { "value": "RE-20170512-02" }, "paymentRecipient": { "value": "Fahrrad Rückenwind" } } } |
...
Submit Feedback on Invalid Extractions
Request
In case an extraction was erroneously found (i.e. , that is, not present in the source document), you can delete it by issuing a DELETE
request to the extraction URI:
Response
Status Code | Description |
---|---|
204 (No Content) | Label removal was successful. |
404 (Not Found) | The document or the label could not be found. |