Skip to content

Commit 04a9235

Browse files
committed
formre freshness
1 parent eb906c9 commit 04a9235

File tree

7 files changed

+22
-20
lines changed

7 files changed

+22
-20
lines changed

articles/cognitive-services/form-recognizer/quickstarts/curl-receipts.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,22 +8,22 @@ manager: nitinme
88
ms.service: cognitive-services
99
ms.subservice: forms-recognizer
1010
ms.topic: quickstart
11-
ms.date: 01/27/2020
11+
ms.date: 05/27/2020
1212
ms.author: pafarley
1313
#Customer intent: As a developer or data scientist familiar with cURL, I want to learn how to use a prebuilt Form Recognizer model to extract my receipt data.
1414
---
1515

1616
# Quickstart: Extract receipt data using the Form Recognizer REST API with cURL
1717

18-
In this quickstart, you'll use the Azure Form Recognizer REST API with cURL to extract and identify relevant information in USA sales receipts.
18+
In this quickstart, you'll use the Azure Form Recognizer REST API with cURL to extract and identify relevant information from USA sales receipts.
1919

2020
If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
2121

2222
## Prerequisites
2323

2424
To complete this quickstart, you must have:
2525
- [cURL](https://curl.haxx.se/windows/) installed.
26-
- A URL for an image of a receipt. You can use a [sample image](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/curl/form-recognizer/contoso-allinone.jpg?raw=true) for this quickstart.
26+
- A URL for an image of a receipt. You can use a [sample image](https://raw.githubusercontent.com/Azure-Samples/cognitive-services-REST-api-samples/master/curl/form-recognizer/contoso-allinone.jpg) for this quickstart.
2727

2828
## Create a Form Recognizer resource
2929

articles/cognitive-services/form-recognizer/quickstarts/curl-train-extract.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ manager: nitinme
88
ms.service: cognitive-services
99
ms.subservice: forms-recognizer
1010
ms.topic: quickstart
11-
ms.date: 01/27/2020
11+
ms.date: 05/27/2020
1212
ms.author: pafarley
1313
#Customer intent: As a developer or data scientist familiar with cURL, I want to learn how to use Form Recognizer to extract my form data.
1414
---

articles/cognitive-services/form-recognizer/quickstarts/python-labeled-data.md

Lines changed: 12 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ manager: nitinme
88
ms.service: cognitive-services
99
ms.subservice: forms-recognizer
1010
ms.topic: quickstart
11-
ms.date: 02/19/2020
11+
ms.date: 05/27/2020
1212
ms.author: pafarley
1313

1414
---
@@ -23,23 +23,23 @@ If you don't have an Azure subscription, create a [free account](https://azure.m
2323

2424
To complete this quickstart, you must have:
2525
- [Python](https://www.python.org/downloads/) installed (if you want to run the sample locally).
26-
- A set of at least six forms of the same type. You will use this data to train the model and test a form. You can use a [sample data set](https://go.microsoft.com/fwlink/?linkid=2090451) for this quickstart. Upload the training files to the root of a blob storage container in an Azure Storage account.
26+
- A set of at least six forms of the same type. You'll use this data to train the model and test a form. You can use a [sample data set](https://go.microsoft.com/fwlink/?linkid=2090451) for this quickstart. Upload the training files to the root of a blob storage container in an Azure Storage account.
2727

2828
## Create a Form Recognizer resource
2929

3030
[!INCLUDE [create resource](../includes/create-resource.md)]
3131

3232
## Set up training data
3333

34-
Next you'll need to set up the required input data. The labeled data feature has special input requirements beyond those needed to train a custom model.
34+
Next you'll need to set up the required input data. The labeled data feature has special input requirements beyond what's needed to train a custom model without labels.
3535

3636
Make sure all the training documents are of the same format. If you have forms in multiple formats, organize them into sub-folders based on common format. When you train, you'll need to direct the API to a sub-folder.
3737

3838
In order to train a model using labeled data, you'll need the following files as inputs in the sub-folder. You will learn how to create these file below.
3939

4040
* **Source forms** – the forms to extract data from. Supported types are JPEG, PNG, PDF, or TIFF.
41-
* **OCR layout files** - JSON files that describe the sizes and positions of all readable text in each source form. You'll use the Form Recognizer Layout API to generate this data.
42-
* **Label files** - JSON files that describe data labels which a user has entered manually.
41+
* **OCR layout files** - these are JSON files that describe the sizes and positions of all readable text in each source form. You'll use the Form Recognizer Layout API to generate this data.
42+
* **Label files** - these are JSON files that describe the data labels that a user has entered manually.
4343

4444
All of these files should occupy the same sub-folder and be in the following format:
4545

@@ -113,7 +113,7 @@ You need OCR result files in order for the service to consider the corresponding
113113

114114
### Create the label files
115115

116-
Label files contain key-value associations that a user has entered manually. They are needed for labeled data training, but not every source file needs to have a corresponding label file. Source files without labels will be treated as ordinary training documents. We recommend five or more labeled files for reliable training.
116+
Label files contain key-value associations that a user has entered manually. They are needed for labeled data training, but not every source file needs to have a corresponding label file. Source files without labels will be treated as ordinary training documents. We recommend five or more labeled files for reliable training. You can use a UI tool like the [sample labeling tool](./label-tool.md) to generate these files.
117117

118118
When you create a label file, you can optionally specify regions—exact positions of values on the document. This will give the training even higher accuracy. Regions are formatted as a set of eight values corresponding to four X,Y coordinates: top-left, top-right, bottom-right, and bottom-left. Coordinate values are between zero and one, scaled to the dimensions of the page.
119119

@@ -184,8 +184,8 @@ For each source form, the corresponding label file should have the original file
184184
...
185185
```
186186

187-
> [!NOTE]
188-
> You can only apply one label to each text element, and each label can only be applied once per page. You cannot currently apply a label across multiple pages.
187+
> [!IMPORTANT]
188+
> You can only apply one label to each text element, and each label can only be applied once per page. You cannot apply a label across multiple pages.
189189

190190

191191
## Train a model using labeled data
@@ -551,4 +551,7 @@ We understand this scenario is essential for our customers, and we are working o
551551

552552
## Next steps
553553

554-
In this quickstart, you learned how to use the Form Recognizer REST API with Python to train a model with manually labeled data. Next, see the [API reference documentation](https://westus2.dev.cognitive.microsoft.com/docs/services/form-recognizer-api-v2-preview/operations/AnalyzeWithCustomForm) to explore the Form Recognizer API in more depth.
554+
In this quickstart, you learned how to use the Form Recognizer REST API with Python to train a model with manually labeled data. Next, see the API reference documentation to explore the Form Recognizer API in more depth.
555+
556+
> [!div class="nextstepaction"]
557+
> [REST API reference documentation](https://westus2.dev.cognitive.microsoft.com/docs/services/form-recognizer-api-v2-preview/operations/AnalyzeReceiptAsync)

articles/cognitive-services/form-recognizer/quickstarts/python-layout.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ manager: nitinme
88
ms.service: cognitive-services
99
ms.subservice: forms-recognizer
1010
ms.topic: quickstart
11-
ms.date: 02/19/2020
11+
ms.date: 05/27/2020
1212
ms.author: pafarley
1313
---
1414

articles/cognitive-services/form-recognizer/quickstarts/python-receipts.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ manager: nitinme
88
ms.service: cognitive-services
99
ms.subservice: forms-recognizer
1010
ms.topic: quickstart
11-
ms.date: 01/27/2020
11+
ms.date: 05/27/2020
1212
ms.author: pafarley
1313
#Customer intent: As a developer or data scientist familiar with Python, I want to learn how to use a prebuilt Form Recognizer model to extract my receipt data.
1414
---
@@ -23,7 +23,7 @@ If you don't have an Azure subscription, create a [free account](https://azure.m
2323

2424
To complete this quickstart, you must have:
2525
- [Python](https://www.python.org/downloads/) installed (if you want to run the sample locally).
26-
- A URL for an image of a receipt. You can use a [sample image](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/curl/form-recognizer/contoso-allinone.jpg?raw=true) for this quickstart.
26+
- A URL for an image of a receipt. You can use a [sample image](https://raw.githubusercontent.com/Azure-Samples/cognitive-services-REST-api-samples/master/curl/form-recognizer/contoso-allinone.jpg) for this quickstart.
2727

2828
## Create a Form Recognizer resource
2929

articles/cognitive-services/form-recognizer/quickstarts/python-train-extract.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ manager: nitinme
88
ms.service: cognitive-services
99
ms.subservice: forms-recognizer
1010
ms.topic: quickstart
11-
ms.date: 01/27/2020
11+
ms.date: 05/27/2020
1212
ms.author: pafarley
1313
#Customer intent: As a developer or data scientist familiar with Python, I want to learn how to use Form Recognizer to extract my form data.
1414
---
@@ -63,7 +63,7 @@ To train a Form Recognizer model with the documents in your Azure blob container
6363
'Ocp-Apim-Subscription-Key': '<subsription key>',
6464
}
6565

66-
body = {
66+
body = {
6767
"source": source,
6868
"sourceFilter": {
6969
"prefix": prefix,

articles/cognitive-services/form-recognizer/tutorial-form-recognizer-with-logic-apps.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ manager: nitinme
88
ms.service: cognitive-services
99
ms.subservice: forms-recognizer
1010
ms.topic: tutorial
11-
ms.date: 01/27/2020
11+
ms.date: 05/27/2020
1212
ms.author: nitinme
1313
---
1414

@@ -372,7 +372,6 @@ To test the logic app, use the sample invoices in the **/Test** folder of the sa
372372
}
373373
]
374374
```
375-
You have successfully completed this tutorial!
376375

377376
## Next steps
378377

0 commit comments

Comments
 (0)