Merge pull request #248556 from MicrosoftDocs/main

Merge main to live, 4 AM

Author: v-ccolin

articles/active-directory/saas-apps/sap-cloud-platform-identity-authentication-provisioning-tutorial.md

@@ -1,6 +1,6 @@
 ---
 title: 'Tutorial: Configure SAP Cloud Identity Services for automatic user provisioning with Microsoft Entra ID'
-description: Learn how to configure Microsoft Entra ID to automatically provision and de-provision user accounts to SAP Cloud Identity Services.
+description: Learn how to configure Microsoft Entra ID to automatically provision and deprovision user accounts to SAP Cloud Identity Services.
 services: active-directory
 author: twimmers
 writer: twimmers
@@ -15,7 +15,7 @@ ms.author: thwimmer
 
 # Tutorial: Configure SAP Cloud Identity Services for automatic user provisioning
 
-The objective of this tutorial is to demonstrate the steps to be performed in SAP Cloud Identity Services and Microsoft Entra ID (Azure AD) to configure Microsoft Entra ID to automatically provision and de-provision users to SAP Cloud Identity Services.
+This tutorial aims to demonstrate the steps for configuring Microsoft Entra ID (Azure AD) and SAP Cloud Identity Services. The goal is to set up Microsoft Entra ID to automatically provision and deprovision users to SAP Cloud Identity Services.
 
 > [!NOTE]
 > This tutorial describes a connector built on top of the Microsoft Entra ID User Provisioning Service. For important details on what this service does, how it works, and frequently asked questions, see [Automate user provisioning and deprovisioning to SaaS applications with Microsoft Entra ID](../app-provisioning/user-provisioning.md).
@@ -41,7 +41,7 @@ Before configuring and enabling automatic user provisioning, you should decide w
 
 ## Important tips for assigning users to SAP Cloud Identity Services
 
-* It is recommended that a single Microsoft Entra ID user is assigned to SAP Cloud Identity Services to test the automatic user provisioning configuration. Additional users may be assigned later.
+* It's recommended that a single Microsoft Entra ID user is assigned to SAP Cloud Identity Services to test the automatic user provisioning configuration. More users may be assigned later.
 
 * When assigning a user to SAP Cloud Identity Services, you must select any valid application-specific role (if available) in the assignment dialog. Users with the **Default Access** role are excluded from provisioning.
 
@@ -60,9 +60,10 @@ Before configuring and enabling automatic user provisioning, you should decide w
 
 	![Screenshot of the SAP Cloud Identity Services Add SCIM.](media/sap-cloud-platform-identity-authentication-provisioning-tutorial/configurationauth.png)
 
-1. You will receive an email to activate your account and set a password for **SAP Cloud Identity Services Service**.
+1.  You'll get an email to activate your account and set up a password for the **SAP Cloud Identity Services Service**.
 
-1. Copy the **User ID** and **Password**. These values will be entered in the Admin Username and Admin Password fields respectively in the Provisioning tab of your SAP Cloud Identity Services application in the Azure portal.
+1. Copy the **User ID** and **Password**. These values are entered in the Admin Username and Admin Password fields respectively.
+This is done in the Provisioning tab of your SAP Cloud Identity Services application in the Azure portal.
 
 ## Add SAP Cloud Identity Services from the gallery
 
@@ -127,7 +128,45 @@ This section guides you through the steps to configure the Microsoft Entra ID pr
 
 1. Review the user attributes that are synchronized from Microsoft Entra ID to SAP Cloud Identity Services in the **Attribute Mapping** section. The attributes selected as **Matching** properties are used to match the user accounts in SAP Cloud Identity Services for update operations. Select the **Save** button to commit any changes.
 
-	![Screenshot of the SAP Business Technology Platform Identity Authentication User Attributes.](media/sap-cloud-platform-identity-authentication-provisioning-tutorial/userattributes.png)
+	|Attribute|Type|Supported for filtering|Required by SAP Cloud Identity Services|
+	|---|---|---|---|
+	|userName|String|✓|✓
+	|emails[type eq "work"].value|String||✓
+	|active|Boolean||
+	|displayName|String||
+	|urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager|Reference||
+	|addresses[type eq "work"].country|String||
+	|addresses[type eq "work"].locality|String||
+	|addresses[type eq "work"].postalCode|String||
+	|addresses[type eq "work"].region|String||
+	|addresses[type eq "work"].streetAddress|String||
+	|name.givenName|String||
+	|name.familyName|String||
+	|name.honorificPrefix|String||
+	|phoneNumbers[type eq "fax"].value|String||
+	|phoneNumbers[type eq "mobile"].value|String||
+	|phoneNumbers[type eq "work"].value|String||
+	|urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter|String||
+	|urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department|String||
+	|urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division|String||
+	|urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber|String||
+	|urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization|String||
+	|locale|String||
+	|timezone|String||
+	|userType|String||
+	|company|String||
+	|urn:sap:cloud:scim:schemas:extension:custom:2.0:User:attributes:customAttribute1|String||
+	|urn:sap:cloud:scim:schemas:extension:custom:2.0:User:attributes:customAttribute2|String||
+	|urn:sap:cloud:scim:schemas:extension:custom:2.0:User:attributes:customAttribute3|String||
+	|urn:sap:cloud:scim:schemas:extension:custom:2.0:User:attributes:customAttribute4|String||
+	|urn:sap:cloud:scim:schemas:extension:custom:2.0:User:attributes:customAttribute5|String||
+	|urn:sap:cloud:scim:schemas:extension:custom:2.0:User:attributes:customAttribute6|String||
+	|urn:sap:cloud:scim:schemas:extension:custom:2.0:User:attributes:customAttribute7|String||
+	|urn:sap:cloud:scim:schemas:extension:custom:2.0:User:attributes:customAttribute8|String||
+	|urn:sap:cloud:scim:schemas:extension:custom:2.0:User:attributes:customAttribute9|String||
+	|urn:sap:cloud:scim:schemas:extension:custom:2.0:User:attributes:customAttribute10|String||
+	|sendMail|String||
+	|mailVerified|String||
 
 1. To configure scoping filters, refer to the following instructions provided in the [Scoping filter tutorial](../app-provisioning/define-conditional-rules-for-provisioning-user-accounts.md).
 
@@ -139,7 +178,7 @@ This section guides you through the steps to configure the Microsoft Entra ID pr
 
 	![Screenshot of Provisioning Scope.](common/provisioning-scope.png)
 
-1. When you are ready to provision, click **Save**.
+1. When you're ready to provision, click **Save**.
 
 	![Screenshot of Saving Provisioning Configuration.](common/provisioning-configuration-save.png)
 
@@ -151,7 +190,7 @@ For more information on how to read the Microsoft Entra ID provisioning logs, se
 
 * SAP Cloud Identity Services's SCIM endpoint requires certain attributes to be of specific format. You can know more about these attributes and their specific format [here](https://help.sap.com/viewer/6d6d63354d1242d185ab4830fc04feb1/Cloud/en-US/b10fc6a9a37c488a82ce7489b1fab64c.html#).
 
-## Additional resources
+## More resources
 
 * [Managing user account provisioning for Enterprise Apps](../app-provisioning/configure-automatic-user-provisioning-portal.md)
 * [What is application access and single sign-on with Microsoft Entra ID?](../manage-apps/what-is-single-sign-on.md)

articles/ai-services/.openpublishing.redirection.ai-services-from-applied.json

@@ -555,6 +555,31 @@
       "source_path_from_root": "/articles/ai-services/document-intelligence/sdk-preview.md",
       "redirect_url": "/azure/ai-services/document-intelligence/sdk-overview-v3-1",
       "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/ai-services/document-intelligence/quickstarts/includes/get-started/csharp.md",
+      "redirect_url": "/azure/ai-services/document-intelligence/quickstarts/includes/v2-1/csharp",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/ai-services/document-intelligence/quickstarts/includes/get-started/java.md",
+      "redirect_url": "/azure/ai-services/document-intelligence/quickstarts/includes/v2-1/java",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/ai-services/document-intelligence/quickstarts/includes/get-started/javascript.md",
+      "redirect_url": "/azure/ai-services/document-intelligence/quickstarts/includes/v2-1/javascript",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/ai-services/document-intelligence/quickstarts/includes/get-started/python.md",
+      "redirect_url": "/azure/ai-services/document-intelligence/quickstarts/includes/v2-1/python",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/ai-services/document-intelligence/quickstarts/includes/get-started/rest-api.md",
+      "redirect_url": "/azure/ai-services/document-intelligence/quickstarts/includes/v2-1/rest-api",
+      "redirect_document_id": true
     }
   ]
 }

articles/ai-services/document-intelligence/how-to-guides/includes/v3-0/csharp-sdk.md

@@ -6,7 +6,7 @@ manager: nitinme
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: include
-ms.date: 07/18/2023
+ms.date: 08/16/2023
 ms.author: lajanuar
 ms.custom: devx-track-csharp
 ---

articles/ai-services/document-intelligence/media/quickstarts/azure-nuget-package.png

@@ -8,7 +8,7 @@ ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.custom: devx-track-dotnet, devx-track-extended-java, devx-track-js, devx-track-python
 ms.topic: quickstart
-ms.date: 07/18/2023
+ms.date: 08/15/2023
 ms.author: lajanuar
 zone_pivot_groups: programming-languages-set-formre
 monikerRange: '<=doc-intel-3.1.0'
@@ -17,16 +17,29 @@ monikerRange: '<=doc-intel-3.1.0'
 
 # Get started with Document Intelligence
 
-::: moniker range=">=doc-intel-3.0.0"
-[!INCLUDE [applies to v3.1 and v3.0](../includes/applies-to-v3-1-v3-0.md)]
+**This article applies to:**![Document Intelligence v3.1 checkmark](../media/yes-icon.png) [**Document Intelligence v3.1**](?view=doc-intel-3.1.0&preserve-view=true) . **Earlier versions:** [**Document Intelligence v3.0**](?view=doc-intel-3.0.0&preserve-view=true) &#9679; [**Document Intelligence v2.1**](?view=doc-intel-2.1.0&preserve-view=true)
+
+> [!IMPORTANT]
+> Azure Cognitive Services Form Recognizer is now Azure AI Document Intelligence. However, some platforms are still awaiting naming updates. All references to Form Recognizer or Document Intelligence in documentation refer to the same Azure service.
+
+::: moniker range="doc-intel-3.1.0"
+
+Get started with Azure AI Document Intelligence latest GA version (v3.1). Azure AI Document Intelligence is a cloud-based Azure AI service that uses machine learning to extract key-value pairs, text, tables and key data from your documents. You can easily integrate Document Intelligence models into your workflows and applications by using an SDK in the programming language of your choice or calling the REST API.  For this quickstart, we recommend that you use the free service while you're learning the technology. Remember that the number of free pages is limited to 500 per month.
+
+To learn more about Document Intelligence features and development options, visit our [Overview](../overview.md) page.
+
 ::: moniker-end
 
-::: moniker range=">=doc-intel-3.0.0"
+::: moniker range="doc-intel-3.0.0"
 
-Get started with the latest version of Azure AI Document Intelligence. Azure AI Document Intelligence is a cloud-based Azure AI service that uses machine learning to extract key-value pairs, text, tables and key data from your documents. You can easily integrate Document Intelligence models into your workflows and applications by using an SDK in the programming language of your choice or calling the REST API.  For this quickstart, we recommend that you use the free service while you're learning the technology. Remember that the number of free pages is limited to 500 per month.
+Get started with Azure AI Document Intelligence GA version (3.0). Azure AI Document Intelligence is a cloud-based Azure AI service that uses machine learning to extract key-value pairs, text, tables and key data from your documents. You can easily integrate Document Intelligence models into your workflows and applications by using an SDK in the programming language of your choice or calling the REST API.  For this quickstart, we recommend that you use the free service while you're learning the technology. Remember that the number of free pages is limited to 500 per month.
 
 To learn more about Document Intelligence features and development options, visit our [Overview](../overview.md) page.
 
+> [!TIP]
+>
+> * For an enhance experience and advanced model quality, try the [Document Intelligence v3.1 (GA) quickstart](?view=doc-intel-3.1.0&preserve-view=true#get-started-with-document-intelligence) and [Document Intelligence Studio](https://formrecognizer.appliedai.azure.com/studio) API version: 2023-07-31 (3.1 General Availability).
+
 ::: moniker-end
 
 ::: zone pivot="programming-language-csharp"
@@ -70,6 +83,7 @@ To learn more about Document Intelligence features and development options, visi
 ::: zone-end
 
 ::: moniker range=">=doc-intel-3.0.0"
+
 That's it, congratulations!
 
 In this quickstart, you used a form Document Intelligence model to analyze various forms and documents. Next, explore the Document Intelligence Studio and reference documentation to learn about Document Intelligence API in depth.
@@ -98,39 +112,39 @@ To learn more about Document Intelligence features and development options, visi
 ::: zone pivot="programming-language-csharp"
 
 ::: moniker range="doc-intel-2.1.0"
-[!INCLUDE [C# SDK](includes/get-started/csharp.md)]
+[!INCLUDE [C# SDK](includes/v2-1/csharp.md)]
 ::: moniker-end
 
 ::: zone-end
 
 ::: zone pivot="programming-language-java"
 
 ::: moniker range="doc-intel-2.1.0"
-[!INCLUDE [Java SDK](includes/get-started/java.md)]
+[!INCLUDE [Java SDK](includes/v2-1/java.md)]
 ::: moniker-end
 
 ::: zone-end
 
 ::: zone pivot="programming-language-javascript"
 
 ::: moniker range="doc-intel-2.1.0"
-[!INCLUDE [NodeJS SDK](includes/get-started/javascript.md)]
+[!INCLUDE [NodeJS SDK](includes/v2-1/javascript.md)]
 ::: moniker-end
 
 ::: zone-end
 
 ::: zone pivot="programming-language-python"
 
 ::: moniker range="doc-intel-2.1.0"
-[!INCLUDE [Python SDK](includes/get-started/python.md)]
+[!INCLUDE [Python SDK](includes/v2-1/python.md)]
 ::: moniker-end
 
 ::: zone-end
 
 ::: zone pivot="programming-language-rest-api"
 
 ::: moniker range="doc-intel-2.1.0"
-[!INCLUDE [REST API](includes/get-started/rest-api.md)]
+[!INCLUDE [REST API](includes/v2-1/rest-api.md)]
 ::: moniker-end
 
 ::: zone-end