Merge pull request #192048 from laujan/1925568-single-script-javascript

complete qs build and output

Author: Court72

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

@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: conceptual
-ms.date: 03/09/2022
+ms.date: 03/16/2022
 ms.author: lajanuar
 recommendations: false
 ms.custom: ignite-fall-2021
@@ -22,7 +22,7 @@ Azure Form Recognizer prebuilt models enable you to add intelligent document pro
 
 | **Model**   | **Description**   |
 | --- | --- |
-| 🆕[Read (preview)](#read-preview) | Extract text lines, words, their locations, detected languages, and handwritten style if detected.  |
+| 🆕[Read (preview)](#read-preview) | Extract printed and handwritten text lines, words, locations, and detected languages.|
 | 🆕[W-2 (preview)](#w-2-preview) | Extract employee, employer, wage information, etc. from US W-2 forms.  |
 | 🆕[General document (preview)](#general-document-preview) | Extract text, tables, structure, key-value pairs, and named entities.  |
 | [Layout](#layout)  | Extracts text and layout information from documents.  |
@@ -49,7 +49,7 @@ The Read API analyzes and extracts ext lines, words, their locations, detected l
 
 [:::image type="icon" source="media/studio/w2.png":::](https://formrecognizer.appliedai.azure.com/studio/prebuilt?formType=tax.us.w2)
 
-The W-2 model analyzes and extracts key information reported in each box on a W-2 form. The model supports standard and customized forms from 2018 to the present, including both single form and multiple forms (copy A, B, C, D, 1, 2) on one page. 
+The W-2 model analyzes and extracts key information reported in each box on a W-2 form. The model supports standard and customized forms from 2018 to the present, including single and multiple forms on one page.
 
 ***Sample W-2 document processed using [Form Recognizer Studio](https://formrecognizer.appliedai.azure.com/studio/prebuilt?formType=tax.us.w2)***:
 
@@ -81,7 +81,7 @@ The W-2 model analyzes and extracts key information reported in each box on a W-
 
 The Layout API analyzes and extracts text, tables and headers, selection marks, and structure information from forms and documents.
 
-***Sample form processed using the [Form Recognizer Studio](https://formrecognizer.appliedai.azure.com/studio/layout)***:
+***Sample document processed using the [Form Recognizer Studio](https://formrecognizer.appliedai.azure.com/studio/layout)***:
 
 :::image type="content" source="media/studio/analyze-layout.png" alt-text="Screenshot: Screenshot of sample document processed using Form Recognizer studio":::
 
@@ -105,7 +105,7 @@ The invoice model analyzes and extracts key information from sales invoices. The
 
 [:::image type="icon" source="media/studio/receipt.png":::](https://formrecognizer.appliedai.azure.com/studio/prebuilt?formType=receipt)
 
-The receipt model analyzes and extracts key information from sales receipts. The API analyzes printed and handwritten receipts and extracts key information such as merchant name, merchant phone number, transaction date, tax, and transaction total. 
+The receipt model analyzes and extracts key information from printed and handwritten receipts.
 
 ***Sample receipt processed using [Form Recognizer Studio](https://formrecognizer.appliedai.azure.com/studio/prebuilt?formType=receipt)***:
 
@@ -118,7 +118,11 @@ The receipt model analyzes and extracts key information from sales receipts. The
 
 [:::image type="icon" source="media/studio/id-document.png":::](https://formrecognizer.appliedai.azure.com/studio/prebuilt?formType=idDocument)
 
-The ID document model analyzes and extracts key information from U.S. Driver's Licenses (all 50 states and District of Columbia) and biographical pages from international passports (excluding visa and other travel documents). The API analyzes identity documents and extracts key information such as first name, last name, address, and date of birth.
+ The ID document model analyzes and extracts key information from the following documents:
+
+* U.S. Driver's Licenses (all 50 states and District of Columbia)
+
+* Biographical pages from international passports (excluding visa and other travel documents). The API analyzes identity documents and extracts
 
 ***Sample U.S. Driver's License processed using [Form Recognizer Studio](https://formrecognizer.appliedai.azure.com/studio/prebuilt?formType=idDocument)***:
 
@@ -131,7 +135,7 @@ The ID document model analyzes and extracts key information from U.S. Driver's L
 
 [:::image type="icon" source="media/studio/business-card.png":::](https://formrecognizer.appliedai.azure.com/studio/prebuilt?formType=businessCard)
 
-The business card model analyzes and extracts key information from business card images. The API analyzes printed business card images and extracts key information such as first name, last name, company name, email address, and phone number.
+The business card model analyzes and extracts key information from business card images.
 
 ***Sample business card processed using [Form Recognizer Studio](https://formrecognizer.appliedai.azure.com/studio/prebuilt?formType=businessCard)***:
 

articles/applied-ai-services/form-recognizer/quickstarts/try-v3-csharp-sdk.md

@@ -119,9 +119,10 @@ This version of the client library defaults to the 2021-09-30-preview version of
 
  1. Choose the **Include prerelease** checkbox and select version **4.0.0-beta.3*** from the dropdown menu and install the package in your project.
 <!-- --- -->
+
 ## Build your application
 
-To interact with the Form Recognizer service, you'll need to create an instance of the `DocumentAnalysisClient` class. To do so, you'll create an `AzureKeyCredential` with your key from the Azure portal and a `DocumentAnalysisClient`  instance with the `AzureKeyCredential` and your Form Recognizer `endpoint`.
+To interact with the Form Recognizer service, you'll need to create an instance of the `DocumentAnalysisClient` class. To do so, you'll create an `AzureKeyCredential` with your `key` from the Azure portal and a `DocumentAnalysisClient`  instance with the `AzureKeyCredential` and your Form Recognizer `endpoint`.
 
 > [!NOTE]
 >
@@ -144,6 +145,22 @@ To interact with the Form Recognizer service, you'll need to create an instance
 >
 > * Remember to remove the key from your code when you're done, and never post it publicly. For production, use secure methods to store and access your credentials. For more information, *see* Cognitive Services [security](../../../cognitive-services/cognitive-services-security.md).
 
+## Run your application
+
+Once you've added a code sample to your application, choose the green **Start** button next to formRecognizer_quickstart to build and run your program, or press **F5**.
+
+  :::image type="content" source="../media/quickstarts/run-visual-studio.png" alt-text="Screenshot: run your Visual Studio program.":::
+
+<!-- ### [.NET Command-line interface (CLI)](#tab/cli)
+
+Open your command prompt and go to the directory that contains your project and type the following:
+
+```console
+dotnet run formrecognizer-quickstart.dll
+```
+
+### [Visual Studio](#tab/vs) -->
+
 ## General document model
 
 Analyze and extract text, tables, structure, key-value pairs, and named entities.
@@ -270,8 +287,20 @@ for (int i = 0; i < result.Tables.Count; i++)
 
 ### General document model output
 
-Visit the Azure samples repository on GitHub to  view the [general document model output](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/dotnet/FormRecognizer/v3-csharp-sdk-general-document-output.md).
-___
+Here's a snippet of the expected output:
+
+```console
+  Detected key-value pairs:
+  Found key with no value: '?'
+  Found key-value pair: 'QUARTERLY REPORT PURSUANT TO SECTION 13 OR 15(d) OF THE SECURITIES EXCHANGE ACT OF 1934' and ':selected:'
+  Found key-value pair: 'For the Quarterly Period Ended March 31, 2020' and 'OR'
+  Found key with no value: '?'
+  Found key-value pair: 'TRANSITION REPORT PURSUANT TO SECTION 13 OR 15(d) OF THE SECURITIES EXCHANGE ACT OF 1934' and ':unselected:'
+  Found key with no value: 'For the Transition Period From'
+  Found key-value pair: 'to Commission File Number' and '001-37845'
+```
+
+To view the entire output, visit the Azure samples repository on GitHub to  view the [general document model output](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/dotnet/FormRecognizer/v3-csharp-sdk-general-document-output.md).
 
 ## Layout model
 
@@ -369,7 +398,25 @@ for (int i = 0; i < result.Tables.Count; i++)
 
 ### Layout model output
 
-Visit the Azure samples repository on GitHub to view the [layout model output](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/dotnet/FormRecognizer/v3-csharp-sdk-layout-output.md).
+Here's a snippet of the expected output:
+
+```console
+  Document Page 1 has 69 line(s), 425 word(s), and 15 selection mark(s).
+  Line 0 has content: 'UNITED STATES'.
+    Its bounding box is:
+      Upper left => X: 3.4915, Y= 0.6828
+      Upper right => X: 5.0116, Y= 0.6828
+      Lower right => X: 5.0116, Y= 0.8265
+      Lower left => X: 3.4915, Y= 0.8265
+  Line 1 has content: 'SECURITIES AND EXCHANGE COMMISSION'.
+    Its bounding box is:
+      Upper left => X: 2.1937, Y= 0.9061
+      Upper right => X: 6.297, Y= 0.9061
+      Lower right => X: 6.297, Y= 1.0498
+      Lower left => X: 2.1937, Y= 1.0498
+```
+
+To view the entire output, visit the Azure samples repository on GitHub to view the [layout model output](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/dotnet/FormRecognizer/v3-csharp-sdk-layout-output.md).
 
 ## Prebuilt model
 
@@ -501,26 +548,19 @@ for (int i = 0; i < result.Documents.Count; i++)
 
 ### Prebuilt model output
 
-Visit the Azure samples repository on GitHub to view the [prebuilt invoice model output](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/dotnet/FormRecognizer/v3-csharp-sdk-prebuilt-invoice-output.md).
-
-
-## Run your application
-
-<!-- ### [.NET Command-line interface (CLI)](#tab/cli)
-
-Open your command prompt and go to the directory that contains your project and type the following:
+Here's a snippet of the expected output:
 
 ```console
-dotnet run formrecognizer-quickstart.dll
+  Document 0:
+  Vendor Name: 'CONTOSO LTD.', with confidence 0.962
+  Customer Name: 'MICROSOFT CORPORATION', with confidence 0.951
+  Item:
+    Description: 'Test for 23 fields', with confidence 0.899
+    Amount: '100', with confidence 0.902
+  Sub Total: '100', with confidence 0.979
 ```
 
-### [Visual Studio](#tab/vs) -->
-
-Choose the green **Start** button next to formRecognizer_quickstart to build and run your program, or press **F5**.
-
-  :::image type="content" source="../media/quickstarts/run-visual-studio.png" alt-text="Screenshot: run your Visual Studio program.":::
-
-<!-- --- -->
+To view the entire output, visit the Azure samples repository on GitHub to view the [prebuilt invoice model output](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/dotnet/FormRecognizer/v3-csharp-sdk-prebuilt-invoice-output.md).
 
 That's it, congratulations!
 

articles/applied-ai-services/form-recognizer/quickstarts/try-v3-java-sdk.md

@@ -11,7 +11,7 @@ ms.date: 03/16/2022
 ms.author: lajanuar
 recommendations: false
 ---
-<!-- markdownlint-disable MD025 -->
+<!-- markdownlint-disable MD025 -->
 
 # Get started: Form Recognizer Java SDK v3.0 | Preview
 
@@ -100,9 +100,9 @@ This quickstart uses the Gradle dependency manager. You can find the client libr
     }
     ```
 
-### Create a Java application
+## Create a Java application
 
-To interact with the Form Recognizer service, you'll need to create an instance of the `DocumentAnalysisClient` class. To do so, you'll create an `AzureKeyCredential` with your key from the Azure portal and a `DocumentAnalysisClient` instance with the `AzureKeyCredential` and your Form Recognizer `endpoint`.
+To interact with the Form Recognizer service, you'll need to create an instance of the `DocumentAnalysisClient` class. To do so, you'll create an `AzureKeyCredential` with your `key` from the Azure portal and a `DocumentAnalysisClient` instance with the `AzureKeyCredential` and your Form Recognizer `endpoint`.
 
 1. From the form-recognizer-app directory, run the following command:
 
@@ -134,6 +134,22 @@ To interact with the Form Recognizer service, you'll need to create an instance
 >
 > Remember to remove the key from your code when you're done, and never post it publicly. For production, use secure methods to store and access your credentials. For more information, see* the Cognitive Services [security](../../../cognitive-services/cognitive-services-security.md).
 
+## Build and run your application
+
+Once you've added a code sample to your application, navigate back to your main project directory—**form-recognizer-app**.
+
+1. Build your application with the `build` command:
+
+    ```console
+    gradle build
+    ```
+
+1. Run your application with the `run` command:
+    
+    ```console
+    gradle run
+    ```
+
 ## General document model
 
 Extract text, tables, structure, key-value pairs, and named entities from documents.
@@ -243,7 +259,25 @@ Extract text, tables, structure, key-value pairs, and named entities from docume
 
 ### General document model output
 
-Visit the Azure samples repository on GitHub to view the [general document model output](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/java/FormRecognizer/v3-java-sdk-general-document-output.md).
+Here's a snippet of the expected output:
+
+```console
+Key content: For the Transition Period From
+Key content bounding region: [com.azure.ai.formrecognizer.models.BoundingRegion@14c053c6]
+Key content: to Commission File Number
+Key content bounding region: [com.azure.ai.formrecognizer.models.BoundingRegion@6c2d4cc6]
+Value content: 001-37845
+Value content bounding region: [com.azure.ai.formrecognizer.models.BoundingRegion@30865a90]
+Key content: (I.R.S. ID)
+Key content bounding region: [com.azure.ai.formrecognizer.models.BoundingRegion@6134ac4a]
+Value content: 91-1144442
+Value content bounding region: [com.azure.ai.formrecognizer.models.BoundingRegion@777c9dc9]
+Key content: Securities registered pursuant to Section 12(g) of the Act:
+Key content bounding region: [com.azure.ai.formrecognizer.models.BoundingRegion@71b1a49c]
+Value content: NONE
+```
+
+To view the entire output, visit the Azure samples repository on GitHub to view the [general document model output](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/java/FormRecognizer/v3-java-sdk-general-document-output.md).
 
 ## Layout model
 
@@ -286,8 +320,9 @@ Extract text, selection marks, text styles, table structures, and bounding regio
                 .endpoint(endpoint)
                 .buildClient();
 
-            // sample document 
+            // sample document
             String documentUrl = "https://raw.githubusercontent.com/Azure-Samples/cognitive-services-REST-api-samples/master/curl/form-recognizer/sample-layout.pdf";
+            
             String modelId = "prebuilt-layout";
 
             SyncPoller < DocumentOperationResult, AnalyzeResult > analyzeLayoutResultPoller =
@@ -340,7 +375,28 @@ Extract text, selection marks, text styles, table structures, and bounding regio
 
 ### Layout model output
 
-Visit the Azure samples repository on GitHub to view the [layout model output](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/java/FormRecognizer/v3-java-sdk-layout-output.md).
+Here's a snippet of the expected output:
+
+```console
+  Table 0 has 5 rows and 3 columns.
+  Cell 'Title of each class', has row index 0 and column index 0.
+  Cell 'Trading Symbol', has row index 0 and column index 1.
+  Cell 'Name of exchange on which registered', has row index 0 and column index 2.
+  Cell 'Common stock, $0.00000625 par value per share', has row index 1 and column index 0.
+  Cell 'MSFT', has row index 1 and column index 1.
+  Cell 'NASDAQ', has row index 1 and column index 2.
+  Cell '2.125% Notes due 2021', has row index 2 and column index 0.
+  Cell 'MSFT', has row index 2 and column index 1.
+  Cell 'NASDAQ', has row index 2 and column index 2.
+  Cell '3.125% Notes due 2028', has row index 3 and column index 0.
+  Cell 'MSFT', has row index 3 and column index 1.
+  Cell 'NASDAQ', has row index 3 and column index 2.
+  Cell '2.625% Notes due 2033', has row index 4 and column index 0.
+  Cell 'MSFT', has row index 4 and column index 1.
+  Cell 'NASDAQ', has row index 4 and column index 2.
+```
+
+To view the entire output,visit the Azure samples repository on GitHub to view the [layout model output](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/java/FormRecognizer/v3-java-sdk-layout-output.md).
 
 ## Prebuilt model
 
@@ -349,8 +405,6 @@ Analyze and extract common fields from specific document types using a prebuilt
 > [!TIP]
 > You aren't limited to invoices—there are several prebuilt models to choose from, each of which has its own set of supported fields. The model to use for the analyze operation depends on the type of document to be analyzed. See [**model data extraction**](../concept-model-overview.md#model-data-extraction).
 
-#### Try the prebuilt invoice model
-
 > [!div class="checklist"]
 >
 > * Analyze an invoice using the prebuilt-invoice model. You can use our [sample invoice document](https://raw.githubusercontent.com/Azure-Samples/cognitive-services-REST-api-samples/master/curl/form-recognizer/sample-invoice.pdf) for this quickstart.
@@ -382,13 +436,13 @@ Analyze and extract common fields from specific document types using a prebuilt
       private static final String key = "<your-key>";
 
       public static void main(final String[] args) throws IOException {
-        
+
         // create your `DocumentAnalysisClient` instance and `AzureKeyCredential` variable
         DocumentAnalysisClient client = new DocumentAnalysisClientBuilder()
           .credential(new AzureKeyCredential(key))
           .endpoint(endpoint)
           .buildClient();
-        
+
         // sample document
         String invoiceUrl = "https://raw.githubusercontent.com/Azure-Samples/cognitive-services-REST-api-samples/master/curl/form-recognizer/sample-invoice.pdf";
         String modelId = "prebuilt-invoice";
@@ -401,7 +455,7 @@ Analyze and extract common fields from specific document types using a prebuilt
           AnalyzedDocument analyzedInvoice = analyzeInvoiceResult.getDocuments().get(i);
           Map < String, DocumentField > invoiceFields = analyzedInvoice.getFields();
           System.out.printf("----------- Analyzing invoice  %d -----------%n", i);
-          System.out.printf("Analyzed document has doc type %s with confidence : %.2f%n.",
+          System.out.printf("Analyzed document has doc type %s with confidence : %.2f%n",
             analyzedInvoice.getDocType(), analyzedInvoice.getConfidence());
 
           DocumentField vendorNameField = invoiceFields.get("VendorName");
@@ -518,23 +572,20 @@ Analyze and extract common fields from specific document types using a prebuilt
 
 ### Prebuilt model output
 
-Visit the Azure samples repository on GitHub to view the [prebuilt invoice model output](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/java/FormRecognizer/v3-java-sdk-prebuilt-invoice-output.md)
-
-## Build and run your application
-
-Navigate back to your main project directory—**form-recognizer-app**.
-
-1. Build your application with the `build` command:
+Here's a snippet of the expected output:
 
 ```console
-gradle build
+  ----------- Analyzing invoice  0 -----------
+  Analyzed document has doc type invoice with confidence : 1.00
+  Vendor Name: CONTOSO LTD., confidence: 0.92
+  Vendor address: 123 456th St New York, NY, 10001, confidence: 0.91
+  Customer Name: MICROSOFT CORPORATION, confidence: 0.84
+  Customer Address Recipient: Microsoft Corp, confidence: 0.92
+  Invoice ID: INV-100, confidence: 0.97
+  Invoice Date: 2019-11-15, confidence: 0.97
 ```
 
-1. Run your application with the `run` command:
-
-```console
-gradle run
-```
+To view the entire output, visit the Azure samples repository on GitHub to view the [prebuilt invoice model output](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/java/FormRecognizer/v3-java-sdk-prebuilt-invoice-output.md)
 
 That's it, congratulations!