Introdução: bibliotecas de cliente de Tradução de Documentos

Configure o seu projeto

Em uma janela de console (como cmd, PowerShell ou Bash), use o dotnet new comando para criar um novo aplicativo de console com o nome batch-document-translation. Este comando cria um projeto C# "Hello World" simples com um único arquivo de origem: Program.cs.

dotnet new console -n batch-document-translation

Altere seu diretório para a pasta do aplicativo recém-criada. Crie seu aplicativo com o seguinte comando:

dotnet build

A saída da compilação não deve conter avisos ou erros.

...
Build succeeded.
 0 Warning(s)
 0 Error(s)
...

Instalar a biblioteca de cliente

Dentro do diretório do aplicativo, instale a biblioteca de cliente de Tradução de Documentos para .NET:

dotnet add package Azure.AI.Translation.Document --version 2.0.0-beta

Traduzir documentos de forma assíncrona

1. Para este projeto, você precisa de um documento de origem carregado em seu contêiner de origem. Você pode baixar nosso documento de exemplo de tradução de documentos para este guia de início rápido. A língua de partida é o inglês.

2. No diretório do projeto, abra o arquivo Program.cs em seu editor ou IDE preferido. Exclua o código pré-existente, incluindo a linha Console.WriteLine("Hello World!").

3. No Program.cs do aplicativo , crie variáveis para sua chave e ponto de extremidade personalizado. Para obter mais informações, consulte Recuperar sua chave e ponto de extremidade de domínio personalizado.

   private static readonly string endpoint = "<your-document-translation-endpoint>";
   private static readonly string key = "<your-key>";
   

4. Chame o StartTranslationAsync método para iniciar uma operação de tradução para um ou mais documentos em um único contêiner de blob.

5. Para chamar StartTranslationAsynco , você precisa inicializar um DocumentTranslationInput objeto que contenha os sourceUriparâmetros , targetUrie targetLanguageCode :

   • Para autorização de Identidade Gerenciada, crie estas variáveis:

     • fonteUri. A URL do contêiner de origem que contém os documentos a serem traduzidos.

     • targetUri A URL do contêiner de destino no qual os documentos traduzidos são gravados.

     • targetLanguageCode. O código do idioma para os documentos traduzidos. Você pode encontrar códigos de idioma em nossa página de suporte de idiomas .

       Para localizar suas URLs de origem e de destino, navegue até sua conta de armazenamento no portal do Azure. Na barra lateral esquerda, em Armazenamento de dados , selecione Contêineres e siga estas etapas para recuperar seus documentos de origem e contêiner URLSde destino.

       Origem	Destino
       1. Marque a caixa de seleção ao lado do contêiner de origem	1. Marque a caixa de seleção ao lado do contêiner de destino.
       2. Na área da janela principal, selecione um arquivo ou documentos para tradução.	2. Selecione as reticências localizadas à direita e, em seguida, escolha Propriedades.
       3. O URL de origem está localizado na parte superior da lista de Propriedades.	3. O URL de destino está localizado no topo da lista de Propriedades.

   • Para autorização SAS (Assinatura de Acesso Compartilhado), crie estas variáveis:

     • fonteUri. O URI SAS, com um token SAS anexado como uma cadeia de caracteres de consulta, para o contêiner de origem que contém documentos a serem traduzidos.
     • targetUri O URI SAS, com um token SAS anexado como uma cadeia de caracteres de consulta, para o contêiner de destino no qual os documentos traduzidos são gravados.
     • targetLanguageCode. O código do idioma para os documentos traduzidos. Você pode encontrar códigos de idioma em nossa página de suporte de idiomas .

Exemplo de código de tradução assíncrona

Insira o seguinte exemplo de código no arquivo Program.cs do seu aplicativo:

using Azure;
using Azure.AI.Translation.Document;
using System;
using System.Threading;
using System.Text;

class Program {

  // create variables for your custom endpoint and resource key
  private static readonly string endpoint = "<your-document-translation-endpoint>";
  private static readonly string key = "<your-key>";

  static async Task Main(string[] args) {

    // create variables for your sourceUrl, targetUrl, and targetLanguageCode
    Uri sourceUri = new Uri("<sourceUrl>");
    Uri targetUri = new Uri("<targetUrl>");
    string targetLanguage = "<targetLanguageCode>"

    // initialize a new instance  of the DocumentTranslationClient object to interact with the Document Translation feature
    DocumentTranslationClient client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(key));

    // initialize a new instance of the `DocumentTranslationInput` object to provide the location of input for the translation operation
    DocumentTranslationInput input = new DocumentTranslationInput(sourceUri, targetUri, targetLanguage);

    // initialize a new instance of the DocumentTranslationOperation class to track the status of the translation operation
    DocumentTranslationOperation operation = await client.StartTranslationAsync(input);

    await operation.WaitForCompletionAsync();

    Console.WriteLine($"  Status: {operation.Status}");
    Console.WriteLine($"  Created on: {operation.CreatedOn}");
    Console.WriteLine($"  Last modified: {operation.LastModified}");
    Console.WriteLine($"  Total documents: {operation.DocumentsTotal}");
    Console.WriteLine($"    Succeeded: {operation.DocumentsSucceeded}");
    Console.WriteLine($"    Failed: {operation.DocumentsFailed}");
    Console.WriteLine($"    In Progress: {operation.DocumentsInProgress}");
    Console.WriteLine($"    Not started: {operation.DocumentsNotStarted}");

    await foreach(DocumentStatusResult document in operation.Value) {
      Console.WriteLine($"Document with Id: {document.Id}");
      Console.WriteLine($"  Status:{document.Status}");
      if (document.Status == DocumentTranslationStatus.Succeeded) {
        Console.WriteLine($"  Translated Document Uri: {document.TranslatedDocumentUri}");
        Console.WriteLine($"  Translated to language: {document.TranslatedToLanguageCode}.");
        Console.WriteLine($"  Document source Uri: {document.SourceDocumentUri}");
      } else {
        Console.WriteLine($"  Error Code: {document.Error.Code}");
        Console.WriteLine($"  Message: {document.Error.Message}");
      }
    }
  }
}

Executar a aplicação

Depois de adicionar o exemplo de código ao seu aplicativo, execute seu aplicativo a partir do diretório do projeto digitando o seguinte comando no terminal:

  dotnet run

Aqui está um trecho da saída esperada:

Exemplo de código de tradução síncrona

Você pode baixar nosso documento de exemplo de tradução de documentos para este guia de início rápido. A língua de partida é o inglês.

using Azure;
using Azure.AI.Translation.Document;
using System;
using System.Threading;
using System.Text;

class Program {

  string endpoint = "{your-document-translation-endpoint}";
  string apiKey = "{your-api-key}";
  SingleDocumentTranslationClient client = new SingleDocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));

  try
  {
    string filePath = @"C:\{folder}\document.txt"
    using Stream fileStream = File.OpenRead(filePath);

    // MultipartFormFileData (string name, System.IO.Stream content, string contentType);
    var sourceDocument = new MultipartFormFileData(Path.GetFileName(filePath), fileStream, "application/vnd.openxmlformats-officedocument.wordprocessingml.document");

    DocumentTranslateContent content = new DocumentTranslateContent(sourceDocument);

    // DocumentTranslate (string targetLanguage, Azure.AI.Translation.Document.DocumentTranslateContent documentTranslateContent, string sourceLanguage = default, string category = default, bool? allowFallback = default, System.Threading.CancellationToken cancellationToken = default);
    var response = client.DocumentTranslate("de", content);

    Console.WriteLine($"Request string for translation: {requestString}");
    Console.WriteLine($"Response string after translation: {responseString}");
  }
    catch (RequestFailedException exception) {
    Console.WriteLine($"Error Code: {exception.ErrorCode}");
    Console.WriteLine($"Message: {exception.Message}");
  }
}

Configurar seu ambiente C#/.NET

Para este início rápido, usamos a versão mais recente do IDE do Visual Studio para criar e executar o aplicativo.

1. Inicie o Visual Studio.

2. Na página Introdução, escolha Criar um novo projeto.

   

3. Na página Criar um novo projeto, insira console na caixa de pesquisa. Escolha o modelo Aplicativo de Console e, em seguida, escolha Avançar.

   

4. Na janela de diálogo Configurar seu novo projeto, digite asynchronous-sdk na caixa Nome do projeto. Em seguida, escolha Avançar.

   

5. Na janela de diálogo Informações adicionais, selecione .NET 6.0 (Suporte de longo prazo) e, em seguida, selecione Criar.

   

Instalar a biblioteca de cliente com o NuGet

1. Clique com o botão direito do mouse em seu projeto Translator-text-sdk e selecione Gerenciar pacotes NuGet...

2. Selecione a guia Procurar e digite Azure.AI.Translation.Document.

   

3. Selecione e instale o pacote em seu projeto.

   

Crie seu aplicativo C#

1. Abra o arquivo Program.cs .

2. Exclua o código pré-existente, incluindo a linha Console.WriteLine("Hello World!").

3. No Program.cs do aplicativo , crie variáveis para sua chave e ponto de extremidade personalizado. Para obter mais informações, consulte Recuperar sua chave e ponto de extremidade de domínio personalizado.

private static readonly string endpoint = "<your-document-translation-endpoint>";
private static readonly string key = "<your-key>";

1. Para iniciar uma operação de tradução para um ou mais documentos em um único contêiner de blob, chame o StartTranslationAsync método.

2. Para chamar StartTranslationAsynco , você precisa inicializar um DocumentTranslationInput objeto que contenha os sourceUri parâmetros e targetUri :

   • Para autorização de Identidade Gerenciada, crie estas variáveis:

     • fonteUri. A URL do contêiner de origem que contém os documentos a serem traduzidos.

     • targetUri A URL do contêiner de destino no qual os documentos traduzidos são gravados.

     • targetLanguageCode. O código do idioma para os documentos traduzidos. Você pode encontrar códigos de idioma em nossa página de suporte de idiomas .

       Para localizar suas URLs de origem e de destino, navegue até sua conta de armazenamento no portal do Azure. Na barra lateral esquerda, em Armazenamento de dados , selecione Contêineres e siga estas etapas para recuperar seus documentos de origem e contêiner URLSde destino.

       Origem	Destino
       1. Marque a caixa de seleção ao lado do contêiner de origem	1. Marque a caixa de seleção ao lado do contêiner de destino.
       2. Na área da janela principal, selecione um arquivo ou documentos para tradução.	2. Selecione as reticências localizadas à direita e, em seguida, escolha Propriedades.
       3. O URL de origem está localizado na parte superior da lista de Propriedades.	3. O URL de destino está localizado no topo da lista de Propriedades.

   • Para autorização SAS (Assinatura de Acesso Compartilhado), crie estas variáveis:

     • fonteUri. O URI SAS, com um token SAS anexado como uma cadeia de caracteres de consulta, para o contêiner de origem que contém documentos a serem traduzidos.
     • targetUri O URI SAS, com um token SAS anexado como uma cadeia de caracteres de consulta, para o contêiner de destino no qual os documentos traduzidos são gravados.
     • targetLanguageCode. O código do idioma para os documentos traduzidos. Você pode encontrar códigos de idioma em nossa página de suporte de idiomas .

Exemplo de código de tradução assíncrona

Insira o seguinte exemplo de código no arquivo Program.cs do seu aplicativo:

using Azure;
using Azure.AI.Translation.Document;

class Program {

  // create variables for your custom endpoint and resource key
  private static readonly string endpoint = "<your-document-translation-endpoint>";
  private static readonly string key = "<your-key>";

  static async Task Main(string[] args) {

    // create variables for your sourceUrl, targetUrl, and targetLanguageCode
    Uri sourceUri = new Uri("<sourceUrl>");
    Uri targetUri = new Uri("<targetUrl>");
    string targetLanguage = "<targetLanguageCode>";

    // initialize a new instance  of the DocumentTranslationClient object to interact with the Document Translation feature
    DocumentTranslationClient client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(key));

    // initialize a new instance of the `DocumentTranslationInput` object to provide source and target locations and target language for the translation operation
    DocumentTranslationInput input = new DocumentTranslationInput(sourceUri, targetUri, targetLanguage);

    // initialize a new instance of the DocumentTranslationOperation class to track the status of the translation operation
    DocumentTranslationOperation operation = await client.StartTranslationAsync(input);

    await operation.WaitForCompletionAsync();

    Console.WriteLine($"  Status: {operation.Status}");
    Console.WriteLine($"  Created on: {operation.CreatedOn}");
    Console.WriteLine($"  Last modified: {operation.LastModified}");
    Console.WriteLine($"  Total documents: {operation.DocumentsTotal}");
    Console.WriteLine($"    Succeeded: {operation.DocumentsSucceeded}");
    Console.WriteLine($"    Failed: {operation.DocumentsFailed}");
    Console.WriteLine($"    In Progress: {operation.DocumentsInProgress}");
    Console.WriteLine($"    Not started: {operation.DocumentsNotStarted}");

    await foreach(DocumentStatusResult document in operation.Value) {
      Console.WriteLine($"Document with Id: {document.Id}");
      Console.WriteLine($"  Status:{document.Status}");
      if (document.Status == DocumentTranslationStatus.Succeeded) {
        Console.WriteLine($"  Translated Document Uri: {document.TranslatedDocumentUri}");
        Console.WriteLine($"  Translated to language: {document.TranslatedToLanguageCode}.");
        Console.WriteLine($"  Document source Uri: {document.SourceDocumentUri}");
      } else {
        Console.WriteLine($"  Error Code: {document.Error.Code}");
        Console.WriteLine($"  Message: {document.Error.Message}");
      }
    }
  }
}

Executar a aplicação

Depois de adicionar o exemplo de código ao seu aplicativo, escolha o botão verde Iniciar ao lado de formRecognizer_quickstart para criar e executar o programa ou pressione F5.

Aqui está um trecho da saída esperada:

Exemplo de código de tradução síncrona

Você pode baixar nosso documento de exemplo de tradução de documentos para este guia de início rápido. A língua de partida é o inglês.

using Azure;
using Azure.AI.Translation.Document;
using System;
using System.Threading;
using System.Text;

class Program {

  string endpoint = "{your-document-translation-endpoint}";
  string apiKey = "{your-api-key}";
  SingleDocumentTranslationClient client = new SingleDocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));

  try
  {
    string filePath = @"C:\{folder}\document-translation-sample.docx"
    using Stream fileStream = File.OpenRead(filePath);

    // MultipartFormFileData (string name, System.IO.Stream content, string contentType);
    var sourceDocument = new MultipartFormFileData(Path.GetFileName(filePath), fileStream, "application/vnd.openxmlformats-officedocument.wordprocessingml.document");

    DocumentTranslateContent content = new DocumentTranslateContent(sourceDocument);

    // DocumentTranslate (string targetLanguage, Azure.AI.Translation.Document.DocumentTranslateContent documentTranslateContent, string sourceLanguage = default, string category = default, bool? allowFallback = default, System.Threading.CancellationToken cancellationToken = default);
    var response = client.DocumentTranslate("de", content);

    Console.WriteLine($"Request string for translation: {requestString}");
    Console.WriteLine($"Response string after translation: {responseString}");
  }
    catch (RequestFailedException exception) {
    Console.WriteLine($"Error Code: {exception.ErrorCode}");
    Console.WriteLine($"Message: {exception.Message}");
  }
}