Skip to content

Commit cb1ec47

Browse files
committed
Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into rolyon-aadroles-custom-roles-users
2 parents e16974c + bd59b29 commit cb1ec47

File tree

48 files changed

+567
-253
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

48 files changed

+567
-253
lines changed

articles/aks/use-wasi-node-pools.md

Lines changed: 90 additions & 148 deletions
Large diffs are not rendered by default.

articles/applied-ai-services/form-recognizer/concept-composed-models.md

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,13 +7,23 @@ manager: nitinme
77
ms.service: applied-ai-services
88
ms.subservice: forms-recognizer
99
ms.topic: conceptual
10-
ms.date: 10/10/2022
10+
ms.date: 10/20/2022
1111
ms.author: lajanuar
1212
recommendations: false
1313
---
1414

1515
# Composed custom models
1616

17+
::: moniker range="form-recog-3.0.0"
18+
[!INCLUDE [applies to v3.0](includes/applies-to-v3-0.md)]
19+
::: moniker-end
20+
21+
::: moniker range="form-recog-2.1.0"
22+
[!INCLUDE [applies to v2.1](includes/applies-to-v2-1.md)]
23+
::: moniker-end
24+
25+
::: moniker range=">=form-recog-2.1.0"
26+
1727
**Composed models**. A composed model is created by taking a collection of custom models and assigning them to a single model built from your form types. When a document is submitted for analysis using a composed model, the service performs a classification to decide which custom model best represents the submitted document.
1828

1929
With composed models, you can assign multiple custom models to a composed model called with a single model ID. It's useful when you've trained several models and want to group them to analyze similar form types. For example, your composed model might include custom models trained to analyze your supply, equipment, and furniture purchase orders. Instead of manually trying to select the appropriate model, you can use a composed model to determine the appropriate custom model for each analysis and extraction.
@@ -45,6 +55,8 @@ With composed models, you can assign multiple custom models to a composed model
4555

4656
* The limit for maximum number of custom models that can be composed is 100.
4757

58+
::: moniker-end
59+
4860
## Development options
4961

5062
::: moniker range="form-recog-3.0.0"

articles/applied-ai-services/form-recognizer/concept-model-overview.md

Lines changed: 161 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -7,19 +7,32 @@ manager: nitinme
77
ms.service: applied-ai-services
88
ms.subservice: forms-recognizer
99
ms.topic: conceptual
10-
ms.date: 08/22/2022
10+
ms.date: 10/20/2022
1111
ms.author: lajanuar
1212
recommendations: false
13-
ms.custom: ignite-fall-2021
1413
---
14+
15+
<!-- markdownlint-disable MD024 -->
1516
<!-- markdownlint-disable MD033 -->
1617

1718
# Form Recognizer models
1819

20+
::: moniker range="form-recog-3.0.0"
21+
[!INCLUDE [applies to v3.0](includes/applies-to-v3-0.md)]
22+
::: moniker-end
23+
24+
::: moniker range="form-recog-2.1.0"
25+
[!INCLUDE [applies to v2.1](includes/applies-to-v2-1.md)]
26+
::: moniker-end
27+
28+
::: moniker range=">=form-recog-2.1.0"
1929
Azure Form Recognizer supports a wide variety of models that enable you to add intelligent document processing to your apps and flows. You can use a prebuilt document analysis or domain specific model or train a custom model tailored to your specific business needs and use cases. Form Recognizer can be used with the REST API or Python, C#, Java, and JavaScript SDKs.
30+
::: moniker-end
2031

2132
## Model overview
2233

34+
::: moniker range="form-recog-3.0.0"
35+
2336
| **Model** | **Description** |
2437
| --- | --- |
2538
|**Document analysis**||
@@ -49,7 +62,7 @@ The Read API analyzes and extracts ext lines, words, their locations, detected l
4962
> [!div class="nextstepaction"]
5063
> [Learn more: read model](concept-read.md)
5164
52-
### W-2
65+
### W-2
5366

5467
[:::image type="icon" source="media/studio/w2.png":::](https://formrecognizer.appliedai.azure.com/studio/prebuilt?formType=tax.us.w2)
5568

@@ -62,7 +75,7 @@ The W-2 model analyzes and extracts key information reported in each box on a W-
6275
> [!div class="nextstepaction"]
6376
> [Learn more: W-2 model](concept-w2.md)
6477
65-
### General document
78+
### General document
6679

6780
[:::image type="icon" source="media/studio/general-document.png":::](https://formrecognizer.appliedai.azure.com/studio/document)
6881

@@ -181,15 +194,15 @@ A composed model is created by taking a collection of custom models and assignin
181194

182195
| **Model ID** | **Text extraction** | **Language detection** | **Selection Marks** | **Tables** | **Paragraphs** | **Paragraph roles** | **Key-Value pairs** | **Fields** |
183196
|:-----|:----:|:----:|:----:|:----:|:----:|:----:|:----:|:----:|
184-
| [prebuilt-read](concept-read.md#data-extraction) ||| | || | | |
197+
| [prebuilt-read](concept-read.md#data-extraction) ||| | || | | |
185198
| [prebuilt-tax.us.w2](concept-w2.md#field-extraction) || || || | ||
186199
| [prebuilt-document](concept-general-document.md#data-extraction)|| |||| || |
187-
| [prebuilt-layout](concept-layout.md#data-extraction) || ||||| | |
188-
| [prebuilt-invoice](concept-invoice.md#field-extraction) || |||| |||
189-
| [prebuilt-receipt](concept-receipt.md#field-extraction) || | | || | ||
190-
| [prebuilt-idDocument](concept-id-document.md#field-extractions) || | | || | ||
191-
| [prebuilt-businessCard](concept-business-card.md#field-extractions) || | | || | ||
192-
| [Custom](concept-custom.md#compare-model-features) || |||| | ||
200+
| [prebuilt-layout](concept-layout.md#data-extraction) || ||||| | |
201+
| [prebuilt-invoice](concept-invoice.md#field-extraction) || |||| |||
202+
| [prebuilt-receipt](concept-receipt.md#field-extraction) || | | || | ||
203+
| [prebuilt-idDocument](concept-id-document.md#field-extractions) || | | || | ||
204+
| [prebuilt-businessCard](concept-business-card.md#field-extractions) || | | || | ||
205+
| [Custom](concept-custom.md#compare-model-features) || |||| | ||
193206

194207
## Input requirements
195208

@@ -202,8 +215,143 @@ A composed model is created by taking a collection of custom models and assignin
202215

203216
Learn how to use Form Recognizer v3.0 in your applications by following our [**Form Recognizer v3.0 migration guide**](v3-migration-guide.md)
204217

218+
::: moniker-end
219+
220+
::: moniker range="form-recog-2.1.0"
221+
222+
| **Model** | **Description** |
223+
| --- | --- |
224+
|**Document analysis**||
225+
| [Layout](#layout) | Extract text and layout information from documents.|
226+
|**Prebuilt**||
227+
| [Invoice](#invoice) | Extract key information from English and Spanish invoices. |
228+
| [Receipt](#receipt) | Extract key information from English receipts. |
229+
| [ID document](#id-document) | Extract key information from US driver licenses and international passports. |
230+
| [Business card](#business-card) | Extract key information from English business cards. |
231+
|**Custom**||
232+
| [Custom](#custom) | Extract data from forms and documents specific to your business. Custom models are trained for your distinct data and use cases. |
233+
| [Composed](#composed-custom-model) | Compose a collection of custom models and assign them to a single model built from your form types.
234+
235+
### Layout
236+
237+
The Layout API analyzes and extracts text, tables and headers, selection marks, and structure information from documents.
238+
239+
***Sample document processed using the [sample labeling tool](https://fott-2-1.azurewebsites.net/layout-analyze)***:
240+
241+
:::image type="content" source="media/overview-layout.png" alt-text="Screenshot of layout analysis using the sample labeling tool.":::
242+
243+
> [!div class="nextstepaction"]
244+
>
245+
> [Learn more: layout model](concept-layout.md)
246+
247+
### Invoice
248+
249+
The invoice model analyzes and extracts key information from sales invoices. The API analyzes invoices in various formats and extracts key information such as customer name, billing address, due date, and amount due.
250+
251+
***Sample invoice processed using the [sample labeling tool](https://fott-2-1.azurewebsites.net/prebuilts-analyze)***:
252+
253+
:::image type="content" source="./media/overview-invoices.jpg" alt-text="Screenshot of a sample invoice analysis using the sample labeling tool.":::
254+
255+
> [!div class="nextstepaction"]
256+
> [Learn more: invoice model](concept-invoice.md)
257+
258+
### Receipt
259+
260+
* The receipt model analyzes and extracts key information from printed and handwritten sales receipts.
261+
262+
***Sample receipt processed using [sample labeling tool](https://fott-2-1.azurewebsites.net/prebuilts-analyze)***:
263+
264+
:::image type="content" source="./media/receipts-example.jpg" alt-text="Screenshot of a sample receipt." lightbox="./media/overview-receipt.jpg":::
265+
266+
> [!div class="nextstepaction"]
267+
> [Learn more: receipt model](concept-receipt.md)
268+
269+
### ID document
270+
271+
The ID document model analyzes and extracts key information from the following documents:
272+
273+
* U.S. Driver's Licenses (all 50 states and District of Columbia)
274+
275+
* Biographical pages from international passports (excluding visa and other travel documents). The API analyzes identity documents and extracts
276+
277+
***Sample U.S. Driver's License processed using the [sample labeling tool](https://fott-2-1.azurewebsites.net/prebuilts-analyze)***:
278+
279+
:::image type="content" source="./media/id-example-drivers-license.jpg" alt-text="Screenshot of a sample identification card.":::
280+
281+
> [!div class="nextstepaction"]
282+
> [Learn more: identity document model](concept-id-document.md)
283+
284+
### Business card
285+
286+
The business card model analyzes and extracts key information from business card images.
287+
288+
***Sample business card processed using the [sample labeling tool](https://fott-2-1.azurewebsites.net/prebuilts-analyze)***:
289+
290+
:::image type="content" source="./media/business-card-example.jpg" alt-text="Screenshot of a sample business card.":::
291+
292+
> [!div class="nextstepaction"]
293+
> [Learn more: business card model](concept-business-card.md)
294+
295+
### Custom
296+
297+
* Custom models analyze and extract data from forms and documents specific to your business. The API is a machine-learning program trained to recognize form fields within your distinct content and extract key-value pairs and table data. You only need five examples of the same form type to get started and your custom model can be trained with or without labeled datasets.
298+
299+
***Sample custom model processing using the [sample labeling tool](https://fott-2-1.azurewebsites.net/)***:
300+
301+
:::image type="content" source="media/overview-custom.jpg" alt-text="Screenshot: Form Recognizer tool analyze-a-custom-form window.":::
302+
303+
> [!div class="nextstepaction"]
304+
> [Learn more: custom model](concept-custom.md)
305+
306+
#### Composed custom model
307+
308+
A composed model is created by taking a collection of custom models and assigning them to a single model built from your form types. You can assign multiple custom models to a composed model called with a single model ID. you can assign up to 100 trained custom models to a single composed model.
309+
310+
***Composed model dialog window using the [sample labeling tool](https://formrecognizer.appliedai.azure.com/studio/customform/projects)***:
311+
312+
:::image type="content" source="media/custom-model-compose.png" alt-text="Screenshot of Form Recognizer Studio compose custom model dialog window.":::
313+
314+
> [!div class="nextstepaction"]
315+
> [Learn more: custom model](concept-custom.md)
316+
317+
## Model data extraction
318+
319+
| **Model** | **Text extraction** | **Language detection** | **Selection Marks** | **Tables** | **Paragraphs** | **Paragraph roles** | **Key-Value pairs** | **Fields** |
320+
|:-----|:----:|:----:|:----:|:----:|:----:|:----:|:----:|:----:|
321+
| [Layout](concept-layout.md#data-extraction) || ||||| | |
322+
| [Invoice](concept-invoice.md#field-extraction) || |||| |||
323+
| [Receipt](concept-receipt.md#field-extraction) || | | || | ||
324+
| [ID Document](concept-id-document.md#field-extractions) || | | || | ||
325+
| [Business Card](concept-business-card.md#field-extractions) || | | || | ||
326+
| [Custom Form](concept-custom.md#compare-model-features) || |||| | ||
327+
328+
## Input requirements
329+
330+
[!INCLUDE [input requirements](./includes/input-requirements.md)]
331+
332+
> [!NOTE]
333+
> The [Sample Labeling tool](https://fott-2-1.azurewebsites.net/) does not support the BMP file format. This is a limitation of the tool not the Form Recognizer Service.
334+
335+
### Version migration
336+
337+
You can learn how to use Form Recognizer v3.0 in your applications by following our [**Form Recognizer v3.0 migration guide**](v3-migration-guide.md)
338+
339+
::: moniker-end
340+
205341
## Next steps
206342

207-
* [Learn how to process your own forms and documents](quickstarts/try-sample-label-tool.md) with our [Form Recognizer sample tool](https://fott-2-1.azurewebsites.net/)
343+
::: moniker range="form-recog-3.0.0"
344+
345+
* [Learn how to process your own forms and documents](quickstarts/try-v3-form-recognizer-studio.md) with the [Form Recognizer Studio](https://formrecognizer.appliedai.azure.com/studio)
346+
347+
* Complete a [Form Recognizer quickstart](quickstarts/get-started-sdks-rest-api.md?view=form-recog-3.0.0&preserve-view=true) and get started creating a document processing app in the development language of your choice.
348+
349+
::: moniker-end
350+
351+
::: moniker range="form-recog-2.1.0"
352+
353+
* [Learn how to process your own forms and documents](quickstarts/try-sample-label-tool.md) with the [Form Recognizer sample labeling tool](https://fott-2-1.azurewebsites.net/)
354+
355+
* Complete a [Form Recognizer quickstart](quickstarts/get-started-sdks-rest-api.md?view=form-recog-2.1.0&preserve-view=true) and get started creating a document processing app in the development language of your choice.
208356

209-
* Complete a [Form Recognizer quickstart](/azure/applied-ai-services/form-recognizer/how-to-guides/v2-1-sdk-rest-api) and get started creating a document processing app in the development language of your choice.
357+
::: moniker-end

articles/applied-ai-services/form-recognizer/containers/form-recognizer-container-configuration.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,8 +7,10 @@ manager: nitinme
77
ms.service: applied-ai-services
88
ms.subservice: forms-recognizer
99
ms.topic: how-to
10-
ms.date: 08/22/2022
10+
ms.date: 10/20/2022
1111
ms.author: lajanuar
12+
monikerRange: '>=form-recog-2.1.0'
13+
recommendations: false
1214
---
1315
# Configure Form Recognizer containers
1416

articles/applied-ai-services/form-recognizer/containers/form-recognizer-container-image-tags.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,9 +7,10 @@ manager: nitinme
77
ms.service: applied-ai-services
88
ms.subservice: forms-recognizer
99
ms.topic: reference
10-
ms.date: 06/23/2022
10+
ms.date: 10/20/2022
1111
ms.author: lajanuar
12-
keywords: Docker, container, images
12+
monikerRange: '>=form-recog-2.1.0'
13+
recommendations: false
1314
---
1415

1516
# Form Recognizer container image tags and release notes

articles/applied-ai-services/form-recognizer/containers/form-recognizer-container-install-run.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,9 +7,10 @@ manager: nitinme
77
ms.service: applied-ai-services
88
ms.subservice: forms-recognizer
99
ms.topic: how-to
10-
ms.date: 12/16/2021
10+
ms.date: 10/20/2022
1111
ms.author: lajanuar
12-
keywords: on-premises, Docker, container, identify
12+
monikerRange: '>=form-recog-2.1.0'
13+
recommendations: false
1314
---
1415

1516
# Install and run Form Recognizer v2.1-preview containers

articles/applied-ai-services/form-recognizer/create-a-form-recognizer-resource.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,14 +7,17 @@ manager: nitinme
77
ms.service: applied-ai-services
88
ms.subservice: forms-recognizer
99
ms.topic: how-to
10-
ms.date: 08/22/2022
10+
ms.date: 10/20/2022
1111
ms.author: bemabonsu
12+
monikerRange: '>=form-recog-2.1.0'
1213
recommendations: false
1314
#Customer intent: I want to learn how to use create a Form Recognizer service in the Azure portal.
1415
---
1516

1617
# Create a Form Recognizer resource
1718

19+
[!INCLUDE [applies to v3.0 and v2.1](includes/applies-to-v3-0-and-v2-1.md)]
20+
1821
Azure Form Recognizer is a cloud-based [Azure Applied AI Service](../../applied-ai-services/index.yml) that uses machine-learning models to extract key-value pairs, text, and tables from your documents. Here, you'll learn how to create a Form Recognizer resource in the Azure portal.
1922

2023
## Visit the Azure portal

articles/applied-ai-services/form-recognizer/create-sas-tokens.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,13 +6,16 @@ author: laujan
66
manager: nitinme
77
ms.service: applied-ai-services
88
ms.subservice: forms-recognizer
9-
ms.date: 05/27/2022
9+
ms.date: 10/20/2022
1010
ms.author: lajanuar
11+
monikerRange: '>=form-recog-2.1.0'
1112
recommendations: false
1213
---
1314

1415
# Create SAS tokens for storage containers
1516

17+
[!INCLUDE [applies to v3.0 and v2.1](includes/applies-to-v3-0-and-v2-1.md)]
18+
1619
In this article, you'll learn how to create user delegation, shared access signature (SAS) tokens, using the Azure portal or Azure Storage Explorer. User delegation SAS tokens are secured with Azure AD credentials. SAS tokens provide secure, delegated access to resources in your Azure storage account.
1720

1821
At a high level, here's how SAS tokens work:

articles/applied-ai-services/form-recognizer/encrypt-data-at-rest.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,13 +7,17 @@ manager: venkyv
77
ms.service: applied-ai-services
88
ms.subservice: forms-recognizer
99
ms.topic: conceptual
10-
ms.date: 08/28/2020
10+
ms.date: 10/20/2022
1111
ms.author: egeaney
1212
ms.custom: applied-ai-non-critical-form
13+
monikerRange: '>=form-recog-2.1.0'
14+
recommendations: false
1315
---
1416

1517
# Form Recognizer encryption of data at rest
1618

19+
[!INCLUDE [applies to v3.0 and v2.1](includes/applies-to-v3-0-and-v2-1.md)]
20+
1721
Azure Form Recognizer automatically encrypts your data when persisting it to the cloud. Form Recognizer encryption protects your data to help you to meet your organizational security and compliance commitments.
1822

1923
[!INCLUDE [cognitive-services-about-encryption](../../cognitive-services/includes/cognitive-services-about-encryption.md)]

articles/applied-ai-services/form-recognizer/faq.yml

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,12 +7,14 @@ metadata:
77
ms.service: applied-ai-services
88
ms.subservice: forms-recognizer
99
ms.topic: faq
10-
ms.date: 09/09/2022
10+
ms.date: 10/20/2022
1111
ms.author: lajanuar
12+
monikerRange: '>=form-recog-2.1.0'
13+
recommendations: false
1214

1315
title: Form Recognizer frequently asked questions
1416
summary: |
15-
17+
[!INCLUDE [applies to v3.0 and v2.1](includes/applies-to-v3-0-and-v2-1.md)]
1618
sections:
1719
- name: General concepts
1820
questions:

0 commit comments

Comments
 (0)