Merge pull request #226320 from laujan/61394-document-translation-language-studio

61394 document translation language studio

Author: American-Dipper

articles/cognitive-services/Translator/document-translation/language-studio.md

@@ -0,0 +1,138 @@
+---
+title: Try Document Translation in Language Studio
+description: "Document Translation in Azure Cognitive Services Language Studio."
+services: cognitive-services
+author: laujan
+manager: nitinme
+ms.service: cognitive-services
+ms.subservice: translator-text
+ms.topic: quickstart
+ms.date: 02/27/2023
+ms.author: lajanuar
+recommendations: false
+---
+
+# Document Translation in Language Studio (Preview)
+
+> [!IMPORTANT]
+> Document Translation in Language Studio is currently in Public Preview. Features, approaches and processes may change, prior to General Availability (GA), based on user feedback.
+
+ Document Translation in [**Azure Cognitive Services Language Studio**](https://language.cognitive.azure.com/home) is a no-code user interface that lets you translate documents from local storage or Azure Blob Storage interactively.
+
+## Prerequisites
+
+If you or an administrator have previously setup a Translator resource with a **system-assigned managed identity**, enabled a **Storage Blob Data Contributor** role assignment, and created an Azure Blob storage account, you can skip this section and [**Get started**](#get-started) right away.
+
+> [!NOTE]
+>
+> * Document Translation is currently supported in the Translator (single-service) resource only, and is **not** included in the Cognitive Services (multi-service) resource.
+>
+> * Document Translation is **only** supported in the S1 Standard Service Plan (Pay-as-you-go) or in the D3 Volume Discount Plan. *See* [Cognitive Services pricing—Translator](https://azure.microsoft.com/pricing/details/cognitive-services/translator/).
+>
+
+Document Translation in Language Studio requires the following resources:
+
+* An active [**Azure account**](https://azure.microsoft.com/free/cognitive-services/).  If you don't have one, you can [**create a free account**](https://azure.microsoft.com/free/).
+
+* A [**single-service Translator resource**](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation) (**not** a multi-service Cognitive Services resource) with [**system-assigned managed identity**](how-to-guides/create-use-managed-identities.md#enable-a-system-assigned-managed-identity) enabled and a [**Storage Blob Data Contributor**](how-to-guides/create-use-managed-identities.md#grant-access-to-your-storage-account) role assigned. For more information, *see* [**Managed identities for Document Translation**](how-to-guides/create-use-managed-identities.md). Also, make sure the region and pricing sections are completed as follows:
+
+  * **Resource Region**. For this project, choose a **non-global** region. For Document Translation, [system-assigned managed identity](how-to-guides/create-use-managed-identities.md) isn't supported in the global region.
+  * **Pricing tier**. Select Standard S1 or D3 to try the service. Document Translation isn't supported in the free tier.
+
+* An [**Azure blob storage account**](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM). An active Azure blob storage account is required to use Document Translation in the Language Studio.
+
+Now that you've completed the prerequisites, let's start translating documents!
+
+## Get started
+
+At least one **source document** is required. You can download our [document translation sample document](https://raw.githubusercontent.com/Azure-Samples/cognitive-services-REST-api-samples/master/curl/Translator/document-translation-sample.docx).
+
+1. Navigate to [Language Studio](https://language.cognitive.azure.com/home).
+
+1. If you're using the Language Studio for the first time, a **Select an Azure resource** pop-up screen appears. Make the following selections:
+
+   * **Azure directory**.
+   * **Azure subscription**.
+   * **Resource type**. Choose **Translator**.
+   * **Resource name**. The resource you select must have [**managed identity enabled**](how-to-guides/create-use-managed-identities.md).
+
+   :::image type="content" source="media/language-studio/choose-azure-resource.png" alt-text="Screenshot of the language studio choose your Azure resource dialog window.":::
+
+    > [!TIP]
+    > You can update your selected directory and resource by selecting the Translator settings icon located in the left navigation section.
+
+1. Navigate to Language Studio and select the **Document translation** tile:
+
+    :::image type="content" source="media/language-studio/welcome-home-page.png" alt-text="Screenshot of the language studio home page.":::
+
+1. If you're using the Document Translation feature for the first time, start with the **Initial Configuration** to select your **Azure Translator resource** and **Document storage** account:
+
+   :::image type="content" source="media/language-studio/initial-configuration.png" alt-text="Screenshot of the initial configuration page.":::
+
+1. In the **Job** section, choose the language to **Translate from** (source) or keep the default **Auto-detect language** and select the language to **Translate to** (target). You can select a maximum of 10 target languages. Once you've selected your source and target language(s), select **Next**:
+
+   :::image type="content" source="media/language-studio/basic-information.png" alt-text="Screenshot of the language studio basic information page.":::
+
+## File location and destination
+
+Your source and target files can be located in your local environment or your Azure Blob storage [container](../../../storage/blobs/storage-quickstart-blobs-portal.md#create-a-container). Follow the steps to select where to retrieve your source and store your target files:
+
+### Choose a source file location
+
+#### [**Local**](#tab/local-env)
+
+ 1. In the **files and destination** section, choose the files for translation by selecting the **Upload local files** button.
+
+ 1. Next, select **➕ Add file(s)**, choose the file(s) for translation, then select **Next**:
+
+   :::image type="content" source="media/language-studio/upload-file.png" alt-text="Screenshot of the select files for translation page.":::
+
+#### [**Azure blob storage**](#tab/blob-storage)
+
+1. In the **files and destination** section, choose the files for translation by selecting the **Select for Blob storage** button.
+
+1. Next, choose your *source* **Blob container**, find and select the file(s) for translation, then select **Next**:
+
+   :::image type="content" source="media/language-studio/select-blob-container.png" alt-text="Screenshot of select files from your blob container.":::
+
+---
+
+### Choose a target file destination
+
+#### [**Local**](#tab/local-env)
+
+While still in the **files and destination** section, select **Download translated file(s)**. Once you have made your choice, select **Next**:
+
+   :::image type="content" source="media/language-studio/target-file-upload.png" alt-text="Screenshot of the select destination for target files page.":::
+
+#### [**Azure blob storage**](#tab/blob-storage)
+
+1. While still in the **files and destination** section, select **Upload to Azure blob storage**.
+1. Next, choose your *target* **Blob container** and select **Next**:
+
+   :::image type="content" source="media/language-studio/target-file-upload.png" alt-text="Screenshot of target file upload drop-down menu.":::
+
+---
+
+### Optional selections and review
+
+1. (Optional) You can add **additional options** for custom translation and/or a glossary file. If you don't require these options, just select **Next**.
+
+1. On the **Review and finish** page, check to make sure that your selections are correct. If not, you can go back. If everything looks good, select the **Start translation job** button.
+
+    :::image type="content" source="media/language-studio/start-translation.png" alt-text="Screenshot of the start translation job page.":::
+
+1. The **Job history** page contains the **Translation job id** and job status.
+
+    > [!NOTE]
+    > The list of translation jobs on the job history page includes all the jobs that were submitted through the chosen translator resource. If your colleague used the same translator resource to submit a job, you will see the status of that job on the job history page.
+
+   :::image type="content" source="media/language-studio/job-history.png" alt-text="Screenshot of the job history page.":::
+
+That's it! You now know how to translate documents using Azure Cognitive Services Language Studio.
+
+## Next steps
+
+> [!div class="nextstepaction"]
+>
+> [Use Document Translation REST APIs programmatically](how-to-guides/use-rest-api-programmatically.md)