public async Task DocumentStatusAsync()
{
string endpoint = TestEnvironment.Endpoint;
string apiKey = TestEnvironment.ApiKey;
Uri sourceUri = new Uri("");
Uri targetUri = new Uri("");
var client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));
var input = new DocumentTranslationInput(sourceUri, targetUri, "es");
DocumentTranslationOperation operation = await client.StartTranslationAsync(input);
var documentscompleted = new HashSet <string>();
while (!operation.HasCompleted)
{
await operation.UpdateStatusAsync();
AsyncPageable <DocumentStatusResult> documentsStatus = operation.GetAllDocumentStatusesAsync();
await foreach (DocumentStatusResult docStatus in documentsStatus)
{
if (documentscompleted.Contains(docStatus.DocumentId))
{
continue;
}
if (docStatus.Status == TranslationStatus.Succeeded || docStatus.Status == TranslationStatus.Failed)
{
documentscompleted.Add(docStatus.DocumentId);
Console.WriteLine($"Document {docStatus.TranslatedDocumentUri} completed with status ${docStatus.Status}");
}
}
}
}
public void OperationsHistory()
{
#if SNIPPET
string endpoint = "<Document Translator Resource Endpoint>";
string apiKey = "<Document Translator Resource API Key>";
#else
string endpoint = TestEnvironment.Endpoint;
string apiKey = TestEnvironment.ApiKey;
#endif
var client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));
int operationsCount = 0;
int totalDocs = 0;
int docsCanceled = 0;
int docsSucceeded = 0;
int docsFailed = 0;
TimeSpan pollingInterval = new(1000);
DateTimeOffset lastWeekTimestamp = DateTimeOffset.Now.AddDays(-7);
var options = new GetTranslationStatusesOptions
{
CreatedAfter = lastWeekTimestamp
};
foreach (TranslationStatusResult translationStatus in client.GetTranslationStatuses(options))
{
if (translationStatus.Status == DocumentTranslationStatus.NotStarted ||
translationStatus.Status == DocumentTranslationStatus.Running)
{
DocumentTranslationOperation operation = new DocumentTranslationOperation(translationStatus.Id, client);
operation.UpdateStatus();
while (!operation.HasCompleted)
{
if (operation.GetRawResponse().Headers.TryGetValue("Retry-After", out string value))
{
pollingInterval = TimeSpan.FromSeconds(Convert.ToInt32(value));
}
Thread.Sleep(pollingInterval);
operation.UpdateStatus();
}
}
operationsCount++;
totalDocs += translationStatus.DocumentsTotal;
docsCanceled += translationStatus.DocumentsCanceled;
docsSucceeded += translationStatus.DocumentsSucceeded;
docsFailed += translationStatus.DocumentsFailed;
}
Console.WriteLine($"# of operations: {operationsCount}");
Console.WriteLine($"Total Documents: {totalDocs}");
Console.WriteLine($"Succeeded Document: {docsSucceeded}");
Console.WriteLine($"Failed Document: {docsFailed}");
Console.WriteLine($"Cancelled Documents: {docsCanceled}");
}
public async Task SingleSourceSingleTargetListDocumentsTest()
{
Uri sourceUri = await CreateSourceContainerAsync(oneTestDocuments);
Uri targetUri = await CreateTargetContainerAsync();
string translateTo = "fr";
DocumentTranslationClient client = GetClient();
var input = new DocumentTranslationInput(sourceUri, targetUri, translateTo);
DocumentTranslationOperation operation = await client.StartTranslationAsync(input);
AsyncPageable <DocumentStatus> documentsFromOperation = await operation.WaitForCompletionAsync();
List <DocumentStatus> documentsFromOperationList = await documentsFromOperation.ToEnumerableAsync();
Assert.AreEqual(1, documentsFromOperationList.Count);
CheckDocumentStatus(documentsFromOperationList[0], translateTo);
AsyncPageable <DocumentStatus> documentsFromGetAll = operation.GetAllDocumentStatusesAsync();
List <DocumentStatus> documentsFromGetAllList = await documentsFromGetAll.ToEnumerableAsync();
Assert.AreEqual(documentsFromOperationList[0].Status, documentsFromGetAllList[0].Status);
Assert.AreEqual(documentsFromOperationList[0].Id, documentsFromGetAllList[0].Id);
Assert.AreEqual(documentsFromOperationList[0].SourceDocumentUri, documentsFromGetAllList[0].SourceDocumentUri);
Assert.AreEqual(documentsFromOperationList[0].TranslatedDocumentUri, documentsFromGetAllList[0].TranslatedDocumentUri);
Assert.AreEqual(documentsFromOperationList[0].TranslationProgressPercentage, documentsFromGetAllList[0].TranslationProgressPercentage);
Assert.AreEqual(documentsFromOperationList[0].TranslatedTo, documentsFromGetAllList[0].TranslatedTo);
Assert.AreEqual(documentsFromOperationList[0].CreatedOn, documentsFromGetAllList[0].CreatedOn);
Assert.AreEqual(documentsFromOperationList[0].LastModified, documentsFromGetAllList[0].LastModified);
}
public async Task GetDocumentStatusTest()
{
Uri sourceUri = await CreateSourceContainerAsync(oneTestDocuments);
Uri targetUri = await CreateTargetContainerAsync();
string translateTo = "fr";
DocumentTranslationClient client = GetClient();
var input = new DocumentTranslationInput(sourceUri, targetUri, translateTo);
DocumentTranslationOperation operation = await client.StartTranslationAsync(input);
await operation.WaitForCompletionAsync();
AsyncPageable <DocumentStatus> documents = operation.GetAllDocumentStatusesAsync();
List <DocumentStatus> documentsList = await documents.ToEnumerableAsync();
Assert.AreEqual(1, documentsList.Count);
DocumentStatus document = await operation.GetDocumentStatusAsync(documentsList[0].Id);
CheckDocumentStatus(document, translateTo);
}
public async Task SingleSourceSingleTargetTest(bool usetokenCredential)
{
Uri source = await CreateSourceContainerAsync(oneTestDocuments);
Uri target = await CreateTargetContainerAsync();
DocumentTranslationClient client = GetClient(useTokenCredential: usetokenCredential);
var input = new DocumentTranslationInput(source, target, "fr");
DocumentTranslationOperation operation = await client.StartTranslationAsync(input);
await operation.WaitForCompletionAsync();
if (operation.DocumentsSucceeded < 1)
{
await PrintNotSucceededDocumentsAsync(operation);
}
Assert.IsTrue(operation.HasCompleted);
Assert.IsTrue(operation.HasValue);
Assert.AreEqual(1, operation.DocumentsTotal);
Assert.AreEqual(1, operation.DocumentsSucceeded);
Assert.AreEqual(0, operation.DocumentsFailed);
Assert.AreEqual(0, operation.DocumentsCancelled);
Assert.AreEqual(0, operation.DocumentsInProgress);
Assert.AreEqual(0, operation.DocumentsNotStarted);
}
public void BadRequestSnippet()
{
#if SNIPPET
string endpoint = "<Document Translator Resource Endpoint>";
string apiKey = "<Document Translator Resource API Key>";
#else
string endpoint = TestEnvironment.Endpoint;
string apiKey = TestEnvironment.ApiKey;
#endif
var credentials = new AzureKeyCredential(apiKey);
var client = new DocumentTranslationClient(new Uri(endpoint), credentials);
#region Snippet:BadRequest
var invalidInput = new DocumentTranslationInput(new TranslationSource(new Uri(endpoint)), new List <TranslationTarget>());
try
{
DocumentTranslationOperation operation = client.StartTranslation(invalidInput);
}
catch (RequestFailedException e)
{
Console.WriteLine(e.ToString());
}
#endregion
}
public async Task ContainerWithSupportedAndUnsupportedFiles()
{
var documentsList = new List <TestDocument>
{
new TestDocument("Document1.txt", "First english test document"),
new TestDocument("File2.jpg", "jpg"),
};
Uri source = await CreateSourceContainerAsync(documentsList);
Uri target = await CreateTargetContainerAsync();
DocumentTranslationClient client = GetClient();
var input = new DocumentTranslationInput(source, target, "fr");
DocumentTranslationOperation operation = await client.StartTranslationAsync(input);
await operation.WaitForCompletionAsync();
if (operation.DocumentsSucceeded < 1)
{
await PrintNotSucceededDocumentsAsync(operation);
}
Assert.IsTrue(operation.HasCompleted);
Assert.IsTrue(operation.HasValue);
Assert.AreEqual(1, operation.DocumentsTotal);
Assert.AreEqual(1, operation.DocumentsSucceeded);
Assert.AreEqual(0, operation.DocumentsFailed);
Assert.AreEqual(0, operation.DocumentsCancelled);
Assert.AreEqual(0, operation.DocumentsInProgress);
Assert.AreEqual(0, operation.DocumentsNotStarted);
}
public async Task SingleSourceSingleTargetListDocumentsTest()
{
Uri sourceUri = await CreateSourceContainerAsync(oneTestDocuments);
Uri targetUri = await CreateTargetContainerAsync();
string translateTo = "fr";
DocumentTranslationClient client = GetClient();
var input = new DocumentTranslationInput(sourceUri, targetUri, translateTo);
DocumentTranslationOperation operation = await client.StartTranslationAsync(input);
AsyncPageable <DocumentStatusResult> documentsFromOperation = await operation.WaitForCompletionAsync(PollingInterval);
List <DocumentStatusResult> documentsFromOperationList = await documentsFromOperation.ToEnumerableAsync();
Assert.AreEqual(1, documentsFromOperationList.Count);
CheckDocumentStatusResult(documentsFromOperationList[0], translateTo);
AsyncPageable <DocumentStatusResult> documentsFromGetAll = operation.GetAllDocumentStatusesAsync();
List <DocumentStatusResult> documentsFromGetAllList = await documentsFromGetAll.ToEnumerableAsync();
Assert.AreEqual(documentsFromOperationList[0].Status, documentsFromGetAllList[0].Status);
Assert.AreEqual(documentsFromOperationList[0].HasCompleted, documentsFromGetAllList[0].HasCompleted);
Assert.AreEqual(documentsFromOperationList[0].DocumentId, documentsFromGetAllList[0].DocumentId);
Assert.AreEqual(documentsFromOperationList[0].SourceDocumentUri, documentsFromGetAllList[0].SourceDocumentUri);
Assert.AreEqual(documentsFromOperationList[0].TranslatedDocumentUri, documentsFromGetAllList[0].TranslatedDocumentUri);
Assert.AreEqual(documentsFromOperationList[0].TranslationProgressPercentage, documentsFromGetAllList[0].TranslationProgressPercentage);
Assert.AreEqual(documentsFromOperationList[0].TranslateTo, documentsFromGetAllList[0].TranslateTo);
Assert.AreEqual(documentsFromOperationList[0].CreatedOn, documentsFromGetAllList[0].CreatedOn);
// Ignore because of flaky behavior. Service issue has been created.
// https://github.com/Azure/azure-sdk-for-net/issues/20116
// Assert.AreEqual(documentsFromOperationList[0].LastModified, documentsFromGetAllList[0].LastModified);
}
public async Task ExistingFileInTargetContainer()
{
Uri source = await CreateSourceContainerAsync(oneTestDocuments);
Uri target = await CreateTargetContainerAsync(oneTestDocuments);
DocumentTranslationClient client = GetClient();
var input = new DocumentTranslationInput(source, target, "fr");
DocumentTranslationOperation operation = await client.StartTranslationAsync(input);
AsyncPageable <DocumentStatus> documents = await operation.WaitForCompletionAsync();
Assert.IsTrue(operation.HasCompleted);
Assert.IsTrue(operation.HasValue);
Assert.AreEqual(DocumentTranslationStatus.Failed, operation.Status);
Assert.AreEqual(1, operation.DocumentsTotal);
Assert.AreEqual(0, operation.DocumentsSucceeded);
Assert.AreEqual(1, operation.DocumentsFailed);
Assert.AreEqual(0, operation.DocumentsCancelled);
Assert.AreEqual(0, operation.DocumentsInProgress);
Assert.AreEqual(0, operation.DocumentsNotStarted);
List <DocumentStatus> documentsList = await documents.ToEnumerableAsync();
Assert.AreEqual(1, documentsList.Count);
Assert.AreEqual(DocumentTranslationStatus.Failed, documentsList[0].Status);
Assert.AreEqual(new DocumentTranslationErrorCode("TargetFileAlreadyExists"), documentsList[0].Error.ErrorCode);
}
public async Task WrongDocumentEncoding()
{
var document = new List <TestDocument>
{
new TestDocument("Document1.txt", string.Empty),
};
Uri source = await CreateSourceContainerAsync(document);
Uri target = await CreateTargetContainerAsync();
DocumentTranslationClient client = GetClient();
var input = new DocumentTranslationInput(source, target, "fr");
DocumentTranslationOperation operation = await client.StartTranslationAsync(input);
AsyncPageable <DocumentStatus> documents = await operation.WaitForCompletionAsync();
Assert.IsTrue(operation.HasCompleted);
Assert.IsTrue(operation.HasValue);
Assert.AreEqual(DocumentTranslationStatus.Failed, operation.Status);
Assert.AreEqual(1, operation.DocumentsTotal);
Assert.AreEqual(0, operation.DocumentsSucceeded);
Assert.AreEqual(1, operation.DocumentsFailed);
Assert.AreEqual(0, operation.DocumentsCancelled);
Assert.AreEqual(0, operation.DocumentsInProgress);
Assert.AreEqual(0, operation.DocumentsNotStarted);
List <DocumentStatus> documentsList = await documents.ToEnumerableAsync();
Assert.AreEqual(1, documentsList.Count);
Assert.AreEqual(DocumentTranslationStatus.Failed, documentsList[0].Status);
Assert.AreEqual(new DocumentTranslationErrorCode("WrongDocumentEncoding"), documentsList[0].Error.ErrorCode);
}
public async Task SingleSourceMultipleTargetsTest()
{
Uri source = await CreateSourceContainerAsync(oneTestDocuments);
Uri targetFrench = await CreateTargetContainerAsync();
Uri targetSpanish = await CreateTargetContainerAsync();
Uri targetArabic = await CreateTargetContainerAsync();
DocumentTranslationClient client = GetClient();
var input = new DocumentTranslationInput(source, targetFrench, "fr");
input.AddTarget(targetSpanish, "es");
input.AddTarget(targetArabic, "ar");
DocumentTranslationOperation operation = await client.StartTranslationAsync(input);
await operation.WaitForCompletionAsync();
if (operation.DocumentsSucceeded < 3)
{
await PrintNotSucceededDocumentsAsync(operation);
}
Assert.IsTrue(operation.HasCompleted);
Assert.IsTrue(operation.HasValue);
Assert.AreEqual(3, operation.DocumentsTotal);
Assert.AreEqual(3, operation.DocumentsSucceeded);
Assert.AreEqual(0, operation.DocumentsFailed);
Assert.AreEqual(0, operation.DocumentsCancelled);
Assert.AreEqual(0, operation.DocumentsInProgress);
Assert.AreEqual(0, operation.DocumentsNotStarted);
}
public async Task MultipleInputsAsync()
{
string endpoint = TestEnvironment.Endpoint;
string apiKey = TestEnvironment.ApiKey;
var client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));
Uri source1SasUriUri = new Uri("<source1 SAS URI>");
Uri source2SasUri = new Uri("<source2 SAS URI>");
Uri frenchTargetSasUri = new Uri("<french target SAS URI>");
Uri arabicTargetSasUri = new Uri("<arabic target SAS URI>");
Uri spanishTargetSasUri = new Uri("<spanish target SAS URI>");
Uri frenchGlossarySasUri = new Uri("<french glossary SAS URI>");
#region Snippet:MultipleInputsAsync
//@@ Uri source1SasUriUri = <source1 SAS URI>;
//@@ Uri source2SasUri = <source2 SAS URI>;
//@@ Uri frenchTargetSasUri = <french target SAS URI>;
//@@ Uri arabicTargetSasUri = <arabic target SAS URI>;
//@@ Uri spanishTargetSasUri = <spanish target SAS URI>;
//@@ Uri frenchGlossarySasUri = <french glossary SAS URI>;
var glossaryFormat = "TSV";
var input1 = new DocumentTranslationInput(source1SasUriUri, frenchTargetSasUri, "fr", new TranslationGlossary(frenchGlossarySasUri, glossaryFormat));
input1.AddTarget(spanishTargetSasUri, "es");
var input2 = new DocumentTranslationInput(source2SasUri, arabicTargetSasUri, "ar");
input2.AddTarget(frenchTargetSasUri, "fr", new TranslationGlossary(frenchGlossarySasUri, glossaryFormat));
var inputs = new List <DocumentTranslationInput>()
{
input1,
input2
};
DocumentTranslationOperation operation = await client.StartTranslationAsync(inputs);
await operation.WaitForCompletionAsync();
await foreach (DocumentStatusResult document in operation.GetValuesAsync())
{
Console.WriteLine($"Document with Id: {document.DocumentId}");
Console.WriteLine($" Status:{document.Status}");
if (document.Status == TranslationStatus.Succeeded)
{
Console.WriteLine($" Translated Document Uri: {document.TranslatedDocumentUri}");
Console.WriteLine($" Translated to language: {document.TranslateTo}.");
Console.WriteLine($" Document source Uri: {document.SourceDocumentUri}");
}
else
{
Console.WriteLine($" Document source Uri: {document.SourceDocumentUri}");
Console.WriteLine($" Error Code: {document.Error.ErrorCode}");
Console.WriteLine($" Message: {document.Error.Message}");
}
}
#endregion
}
public async Task SingleSourceSingleTargetWithSuffixTest()
{
Uri sourceUri = await CreateSourceContainerAsync(twoTestDocuments);
Uri targetUri = await CreateTargetContainerAsync();
DocumentTranslationClient client = GetClient();
var source = new TranslationSource(sourceUri)
{
Suffix = "1.txt"
};
var targets = new List <TranslationTarget> {
new TranslationTarget(targetUri, "fr")
};
var input = new DocumentTranslationInput(source, targets);
DocumentTranslationOperation operation = await client.StartTranslationAsync(input);
await operation.WaitForCompletionAsync();
if (operation.DocumentsSucceeded < 1)
{
await PrintNotSucceededDocumentsAsync(operation);
}
Assert.IsTrue(operation.HasCompleted);
Assert.IsTrue(operation.HasValue);
Assert.AreEqual(1, operation.DocumentsTotal);
Assert.AreEqual(1, operation.DocumentsSucceeded);
Assert.AreEqual(0, operation.DocumentsFailed);
Assert.AreEqual(0, operation.DocumentsCancelled);
Assert.AreEqual(0, operation.DocumentsInProgress);
Assert.AreEqual(0, operation.DocumentsNotStarted);
}
public void DocumentStatus()
{
#if SNIPPET
string endpoint = "<Document Translator Resource Endpoint>";
string apiKey = "<Document Translator Resource API Key>";
#else
string endpoint = TestEnvironment.Endpoint;
string apiKey = TestEnvironment.ApiKey;
#endif
var client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));
#if SNIPPET
Uri sourceUri = new Uri("<source SAS URI>");
Uri targetUri = new Uri("<target SAS URI>")
#else
Uri sourceUri = CreateSourceContainer(oneTestDocuments);
Uri targetUri = CreateTargetContainer();
#endif
var input = new DocumentTranslationInput(sourceUri, targetUri, "es");
DocumentTranslationOperation operation = client.StartTranslation(input);
TimeSpan pollingInterval = new(1000);
var documentscompleted = new HashSet <string>();
while (true)
{
operation.UpdateStatus();
Pageable <DocumentStatusResult> documentsStatus = operation.GetDocumentStatuses();
foreach (DocumentStatusResult docStatus in documentsStatus)
{
if (documentscompleted.Contains(docStatus.Id))
{
continue;
}
if (docStatus.Status == DocumentTranslationStatus.Succeeded || docStatus.Status == DocumentTranslationStatus.Failed)
{
documentscompleted.Add(docStatus.Id);
Console.WriteLine($"Document {docStatus.TranslatedDocumentUri} completed with status {docStatus.Status}");
}
}
if (operation.HasCompleted)
{
break;
}
else
{
if (operation.GetRawResponse().Headers.TryGetValue("Retry-After", out string value))
{
pollingInterval = TimeSpan.FromSeconds(Convert.ToInt32(value));
}
Thread.Sleep(pollingInterval);
}
}
}
public async Task PollIndividualDocumentsAsync()
{
string endpoint = TestEnvironment.Endpoint;
string apiKey = TestEnvironment.ApiKey;
var client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));
Uri sourceUri = new Uri("<source SAS URI>");
Uri targetUri = new Uri("<target SAS URI>");
#region Snippet:PollIndividualDocumentsAsync
//@@ Uri sourceUri = <source SAS URI>;
//@@ Uri targetUri = <target SAS URI>;
var input = new DocumentTranslationInput(sourceUri, targetUri, "es");
DocumentTranslationOperation operation = await client.StartTranslationAsync(input);
TimeSpan pollingInterval = new(1000);
AsyncPageable <DocumentStatusResult> documents = operation.GetAllDocumentStatusesAsync();
await foreach (DocumentStatusResult document in documents)
{
Console.WriteLine($"Polling Status for document{document.TranslatedDocumentUri}");
Response <DocumentStatusResult> status = await operation.GetDocumentStatusAsync(document.DocumentId);
while (!status.Value.HasCompleted)
{
if (operation.GetRawResponse().Headers.TryGetValue("Retry-After", out string value))
{
pollingInterval = TimeSpan.FromSeconds(Convert.ToInt32(value));
}
await Task.Delay(pollingInterval);
status = await operation.GetDocumentStatusAsync(document.DocumentId);
}
if (status.Value.Status == TranslationStatus.Succeeded)
{
Console.WriteLine($" Translated Document Uri: {document.TranslatedDocumentUri}");
Console.WriteLine($" Translated to language: {document.TranslateTo}.");
Console.WriteLine($" Document source Uri: {document.SourceDocumentUri}");
}
else
{
Console.WriteLine($" Document source Uri: {document.SourceDocumentUri}");
Console.WriteLine($" Error Code: {document.Error.ErrorCode}");
Console.WriteLine($" Message: {document.Error.Message}");
}
}
#endregion
}
public void StartTranslation()
{
string endpoint = TestEnvironment.Endpoint;
string apiKey = TestEnvironment.ApiKey;
var client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));
Uri sourceUri = new Uri("<source SAS URI>");
Uri targetUri = new Uri("<target SAS URI>");
#region Snippet:StartTranslation
//@@ Uri sourceUri = <source SAS URI>;
//@@ Uri targetUri = <target SAS URI>;
var input = new DocumentTranslationInput(sourceUri, targetUri, "es");
DocumentTranslationOperation operation = client.StartTranslation(input);
TimeSpan pollingInterval = new TimeSpan(1000);
while (!operation.HasCompleted)
{
Thread.Sleep(pollingInterval);
operation.UpdateStatus();
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}");
}
foreach (DocumentStatusResult document in operation.GetValues())
{
Console.WriteLine($"Document with Id: {document.DocumentId}");
Console.WriteLine($" Status:{document.Status}");
if (document.Status == TranslationStatus.Succeeded)
{
Console.WriteLine($" Translated Document Uri: {document.TranslatedDocumentUri}");
Console.WriteLine($" Translated to language: {document.TranslateTo}.");
Console.WriteLine($" Document source Uri: {document.SourceDocumentUri}");
}
else
{
Console.WriteLine($" Document source Uri: {document.SourceDocumentUri}");
Console.WriteLine($" Error Code: {document.Error.ErrorCode}");
Console.WriteLine($" Message: {document.Error.Message}");
}
}
#endregion
}
public async Task StartTranslationAsync()
{
#if SNIPPET
string endpoint = "<Document Translator Resource Endpoint>";
string apiKey = "<Document Translator Resource API Key>";
#else
string endpoint = TestEnvironment.Endpoint;
string apiKey = TestEnvironment.ApiKey;
#endif
var client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));
#region Snippet:StartTranslationAsync
#if SNIPPET
Uri sourceUri = new Uri("<source SAS URI>");
Uri targetUri = new Uri("<target SAS URI>");
#else
Uri sourceUri = await CreateSourceContainerAsync(oneTestDocuments);
Uri targetUri = await CreateTargetContainerAsync();
#endif
var input = new DocumentTranslationInput(sourceUri, targetUri, "es");
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 code: {document.TranslatedToLanguageCode}.");
Console.WriteLine($" Document source Uri: {document.SourceDocumentUri}");
}
else
{
Console.WriteLine($" Error Code: {document.Error.ErrorCode}");
Console.WriteLine($" Message: {document.Error.Message}");
}
}
#endregion
}
public void PollIndividualDocuments()
{
#if SNIPPET
string endpoint = "<Document Translator Resource Endpoint>";
string apiKey = "<Document Translator Resource API Key>";
#else
string endpoint = TestEnvironment.Endpoint;
string apiKey = TestEnvironment.ApiKey;
#endif
var client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));
#if SNIPPET
Uri sourceUri = new Uri("<source SAS URI>");
Uri targetUri = new Uri("<target SAS URI>");
#else
Uri sourceUri = CreateSourceContainer(oneTestDocuments);
Uri targetUri = CreateTargetContainer();
#endif
var input = new DocumentTranslationInput(sourceUri, targetUri, "es");
DocumentTranslationOperation operation = client.StartTranslation(input);
TimeSpan pollingInterval = new(1000);
foreach (DocumentStatusResult document in operation.GetDocumentStatuses())
{
Console.WriteLine($"Polling Status for document{document.SourceDocumentUri}");
Response <DocumentStatusResult> responseDocumentStatus = operation.GetDocumentStatus(document.Id);
while (responseDocumentStatus.Value.Status != DocumentTranslationStatus.Failed &&
responseDocumentStatus.Value.Status != DocumentTranslationStatus.Succeeded)
{
if (responseDocumentStatus.GetRawResponse().Headers.TryGetValue("Retry-After", out string value))
{
pollingInterval = TimeSpan.FromSeconds(Convert.ToInt32(value));
}
Thread.Sleep(pollingInterval);
responseDocumentStatus = operation.GetDocumentStatus(document.Id);
}
if (responseDocumentStatus.Value.Status == DocumentTranslationStatus.Succeeded)
{
Console.WriteLine($" Translated Document Uri: {document.TranslatedDocumentUri}");
Console.WriteLine($" Translated to language code: {document.TranslatedToLanguageCode}.");
Console.WriteLine($" Document source Uri: {document.SourceDocumentUri}");
}
else
{
Console.WriteLine($" Document source Uri: {document.SourceDocumentUri}");
Console.WriteLine($" Error Code: {document.Error.ErrorCode}");
Console.WriteLine($" Message: {document.Error.Message}");
}
}
}
private async Task PrintNotSucceededDocumentsAsync(DocumentTranslationOperation operation)
{
await foreach (var document in operation.GetValuesAsync())
{
if (document.Status != TranslationStatus.Succeeded)
{
Console.WriteLine($"Document: {document.DocumentId}");
Console.WriteLine($" Status: {document.Status}");
Console.WriteLine($" ErrorCode: {document.Error.ErrorCode}");
Console.WriteLine($" Message: {document.Error.Message}");
}
}
}
public async Task OperationsHistoryAsync()
{
#if SNIPPET
string endpoint = "<Document Translator Resource Endpoint>";
string apiKey = "<Document Translator Resource API Key>";
#else
string endpoint = TestEnvironment.Endpoint;
string apiKey = TestEnvironment.ApiKey;
#endif
var client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));
#region Snippet:OperationsHistoryAsync
int operationsCount = 0;
int totalDocs = 0;
int docsCanceled = 0;
int docsSucceeded = 0;
int docsFailed = 0;
DateTimeOffset lastWeekTimestamp = DateTimeOffset.Now.AddDays(-7);
var options = new GetTranslationStatusesOptions
{
CreatedAfter = lastWeekTimestamp
};
await foreach (TranslationStatusResult translationStatus in client.GetTranslationStatusesAsync(options))
{
if (translationStatus.Status == DocumentTranslationStatus.NotStarted ||
translationStatus.Status == DocumentTranslationStatus.Running)
{
DocumentTranslationOperation operation = new DocumentTranslationOperation(translationStatus.Id, client);
await operation.WaitForCompletionAsync();
}
operationsCount++;
totalDocs += translationStatus.DocumentsTotal;
docsCanceled += translationStatus.DocumentsCanceled;
docsSucceeded += translationStatus.DocumentsSucceeded;
docsFailed += translationStatus.DocumentsFailed;
}
Console.WriteLine($"# of operations: {operationsCount}");
Console.WriteLine($"Total Documents: {totalDocs}");
Console.WriteLine($"Succeeded Document: {docsSucceeded}");
Console.WriteLine($"Failed Document: {docsFailed}");
Console.WriteLine($"Canceled Documents: {docsCanceled}");
#endregion
}
public void OperationsHistory()
{
string endpoint = TestEnvironment.Endpoint;
string apiKey = TestEnvironment.ApiKey;
var client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));
#region Snippet:OperationsHistory
int operationsCount = 0;
int totalDocs = 0;
int docsCancelled = 0;
int docsSucceeded = 0;
int docsFailed = 0;
TimeSpan pollingInterval = new(1000);
foreach (TranslationStatus translationStatus in client.GetAllTranslationStatuses())
{
if (translationStatus.Status != DocumentTranslationStatus.Failed &&
translationStatus.Status != DocumentTranslationStatus.Succeeded)
{
DocumentTranslationOperation operation = new DocumentTranslationOperation(translationStatus.Id, client);
while (!operation.HasCompleted)
{
if (operation.GetRawResponse().Headers.TryGetValue("Retry-After", out string value))
{
pollingInterval = TimeSpan.FromSeconds(Convert.ToInt32(value));
}
Thread.Sleep(pollingInterval);
operation.UpdateStatus();
}
}
operationsCount++;
totalDocs += translationStatus.DocumentsTotal;
docsCancelled += translationStatus.DocumentsCancelled;
docsSucceeded += translationStatus.DocumentsSucceeded;
docsFailed += translationStatus.DocumentsFailed;
}
Console.WriteLine($"# of operations: {operationsCount}");
Console.WriteLine($"Total Documents: {totalDocs}");
Console.WriteLine($"Succeeded Document: {docsSucceeded}");
Console.WriteLine($"Failed Document: {docsFailed}");
Console.WriteLine($"Cancelled Documents: {docsCancelled}");
#endregion
}
public void PollIndividualDocuments()
{
string endpoint = TestEnvironment.Endpoint;
string apiKey = TestEnvironment.ApiKey;
var client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));
Uri sourceUri = new Uri("<source SAS URI>");
Uri targetUri = new Uri("<target SAS URI>");
#region Snippet:PollIndividualDocuments
//@@ Uri sourceUri = <source SAS URI>;
//@@ Uri targetUri = <target SAS URI>;
var input = new DocumentTranslationInput(sourceUri, targetUri, "es");
DocumentTranslationOperation operation = client.StartTranslation(input);
TimeSpan pollingInterval = new TimeSpan(1000);
Pageable <DocumentStatusResult> documents = operation.GetAllDocumentStatuses();
foreach (DocumentStatusResult document in documents)
{
Console.WriteLine($"Polling Status for document{document.TranslatedDocumentUri}");
Response <DocumentStatusResult> status = operation.GetDocumentStatus(document.DocumentId);
while (!status.Value.HasCompleted)
{
Thread.Sleep(pollingInterval);
status = operation.GetDocumentStatus(document.DocumentId);
}
if (status.Value.Status == TranslationStatus.Succeeded)
{
Console.WriteLine($" Translated Document Uri: {document.TranslatedDocumentUri}");
Console.WriteLine($" Translated to language: {document.TranslateTo}.");
Console.WriteLine($" Document source Uri: {document.SourceDocumentUri}");
}
else
{
Console.WriteLine($" Document source Uri: {document.SourceDocumentUri}");
Console.WriteLine($" Error Code: {document.Error.ErrorCode}");
Console.WriteLine($" Message: {document.Error.Message}");
}
}
#endregion
}
public void PollIndividualDocuments()
{
string endpoint = TestEnvironment.Endpoint;
string apiKey = TestEnvironment.ApiKey;
var client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));
#region Snippet:PollIndividualDocuments
Uri sourceUri = new Uri("<source SAS URI>");
Uri targetUri = new Uri("<target SAS URI>");
var input = new DocumentTranslationInput(sourceUri, targetUri, "es");
DocumentTranslationOperation operation = client.StartTranslation(input);
TimeSpan pollingInterval = new(1000);
foreach (DocumentStatusResult document in operation.GetAllDocumentStatuses())
{
Console.WriteLine($"Polling Status for document{document.SourceDocumentUri}");
Response <DocumentStatusResult> responseDocumentStatus = operation.GetDocumentStatus(document.DocumentId);
while (!responseDocumentStatus.Value.HasCompleted)
{
if (responseDocumentStatus.GetRawResponse().Headers.TryGetValue("Retry-After", out string value))
{
pollingInterval = TimeSpan.FromSeconds(Convert.ToInt32(value));
}
Thread.Sleep(pollingInterval);
responseDocumentStatus = operation.GetDocumentStatus(document.DocumentId);
}
if (responseDocumentStatus.Value.Status == TranslationStatus.Succeeded)
{
Console.WriteLine($" Translated Document Uri: {document.TranslatedDocumentUri}");
Console.WriteLine($" Translated to language: {document.TranslatedTo}.");
Console.WriteLine($" Document source Uri: {document.SourceDocumentUri}");
}
else
{
Console.WriteLine($" Document source Uri: {document.SourceDocumentUri}");
Console.WriteLine($" Error Code: {document.Error.ErrorCode}");
Console.WriteLine($" Message: {document.Error.Message}");
}
}
#endregion
}
public async Task DocumentStatusAsync()
{
string endpoint = TestEnvironment.Endpoint;
string apiKey = TestEnvironment.ApiKey;
var client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));
Uri sourceUri = new Uri("<source SAS URI>");
Uri targetUri = new Uri("<target SAS URI>");
var input = new DocumentTranslationInput(sourceUri, targetUri, "es");
DocumentTranslationOperation operation = await client.StartTranslationAsync(input);
TimeSpan pollingInterval = new(1000);
var documentscompleted = new HashSet <string>();
while (true)
{
await operation.UpdateStatusAsync();
AsyncPageable <DocumentStatus> documentsStatus = operation.GetAllDocumentStatusesAsync();
await foreach (DocumentStatus docStatus in documentsStatus)
{
if (documentscompleted.Contains(docStatus.Id))
{
continue;
}
if (docStatus.Status == DocumentTranslationStatus.Succeeded || docStatus.Status == DocumentTranslationStatus.Failed)
{
documentscompleted.Add(docStatus.Id);
Console.WriteLine($"Document {docStatus.TranslatedDocumentUri} completed with status {docStatus.Status}");
}
}
if (operation.HasCompleted)
{
break;
}
else
{
if (operation.GetRawResponse().Headers.TryGetValue("Retry-After", out string value))
{
pollingInterval = TimeSpan.FromSeconds(Convert.ToInt32(value));
}
await Task.Delay(pollingInterval);
}
}
}
public async Task StartTranslationAsync()
{
string endpoint = TestEnvironment.Endpoint;
string apiKey = TestEnvironment.ApiKey;
var client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));
Uri sourceUri = new Uri("<source SAS URI>");
Uri targetUri = new Uri("<target SAS URI>");
#region Snippet:StartTranslationAsync
//@@ Uri sourceUri = <source SAS URI>;
//@@ Uri targetUri = <target SAS URI>;
var input = new DocumentTranslationInput(sourceUri, targetUri, "es");
DocumentTranslationOperation operation = await client.StartTranslationAsync(input);
Response <AsyncPageable <DocumentStatusResult> > operationResult = 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 operationResult.Value)
{
Console.WriteLine($"Document with Id: {document.DocumentId}");
Console.WriteLine($" Status:{document.Status}");
if (document.Status == TranslationStatus.Succeeded)
{
Console.WriteLine($" Translated Document Uri: {document.TranslatedDocumentUri}");
Console.WriteLine($" Translated to language: {document.TranslateTo}.");
Console.WriteLine($" Document source Uri: {document.SourceDocumentUri}");
}
else
{
Console.WriteLine($" Error Code: {document.Error.ErrorCode}");
Console.WriteLine($" Message: {document.Error.Message}");
}
}
#endregion
}
public void OperationsHistory()
{
string endpoint = TestEnvironment.Endpoint;
string apiKey = TestEnvironment.ApiKey;
var client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));
#region Snippet:OperationsHistory
int operationsCount = 0;
int totalDocs = 0;
int docsCancelled = 0;
int docsSucceeded = 0;
int docsFailed = 0;
TimeSpan pollingInterval = new TimeSpan(1000);
foreach (TranslationStatusResult translationStatus in client.GetTranslations())
{
if (!translationStatus.HasCompleted)
{
DocumentTranslationOperation operation = new DocumentTranslationOperation(translationStatus.TranslationId, client);
while (!operation.HasCompleted)
{
Thread.Sleep(pollingInterval);
operation.UpdateStatus();
}
}
operationsCount++;
totalDocs += translationStatus.DocumentsTotal;
docsCancelled += translationStatus.DocumentsCancelled;
docsSucceeded += translationStatus.DocumentsSucceeded;
docsFailed += translationStatus.DocumentsFailed;
}
Console.WriteLine($"# of operations: {operationsCount}");
Console.WriteLine($"Total Documents: {totalDocs}");
Console.WriteLine($"Succeeded Document: {docsSucceeded}");
Console.WriteLine($"Failed Document: {docsFailed}");
Console.WriteLine($"Cancelled Documents: {docsCancelled}");
#endregion
}
public async Task WrongSourceRightTarget()
{
Uri source = new("https://idont.ex.ist");
Uri target = await CreateTargetContainerAsync();
DocumentTranslationClient client = GetClient();
var input = new DocumentTranslationInput(source, target, "fr");
DocumentTranslationOperation operation = await client.StartTranslationAsync(input);
RequestFailedException ex = Assert.ThrowsAsync <RequestFailedException>(async() => await operation.UpdateStatusAsync());
Assert.AreEqual("InvalidDocumentAccessLevel", ex.ErrorCode);
Assert.IsTrue(operation.HasCompleted);
Assert.IsFalse(operation.HasValue);
Assert.AreEqual(TranslationStatus.ValidationFailed, operation.Status);
}
public void DocumentStatus()
{
string endpoint = TestEnvironment.Endpoint;
string apiKey = TestEnvironment.ApiKey;
Uri sourceUri = new Uri("");
Uri targetUri = new Uri("");
var client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));
var input = new DocumentTranslationInput(sourceUri, targetUri, "es");
DocumentTranslationOperation operation = client.StartTranslation(input);
TimeSpan pollingInterval = new(1000);
var documentscompleted = new HashSet <string>();
while (!operation.HasCompleted)
{
if (operation.GetRawResponse().Headers.TryGetValue("Retry-After", out string value))
{
pollingInterval = TimeSpan.FromSeconds(Convert.ToInt32(value));
}
Thread.Sleep(pollingInterval);
operation.UpdateStatus();
Pageable <DocumentStatusResult> documentsStatus = operation.GetAllDocumentStatuses();
foreach (DocumentStatusResult docStatus in documentsStatus)
{
if (documentscompleted.Contains(docStatus.DocumentId))
{
continue;
}
if (docStatus.Status == TranslationStatus.Succeeded || docStatus.Status == TranslationStatus.Failed)
{
documentscompleted.Add(docStatus.DocumentId);
Console.WriteLine($"Document {docStatus.TranslatedDocumentUri} completed with status ${docStatus.Status}");
}
}
}
}
public async Task DocumentTranslationWithGlossary()
{
Uri source = await CreateSourceContainerAsync(oneTestDocuments);
var targetUriAndClient = await CreateTargetContainerWithClientAsync();
Uri target = targetUriAndClient.Item1;
//We will need this client later for reading the output translated document
BlobContainerClient targetContainerClient = targetUriAndClient.Item2;
//Constructing and uploading glossary on the fly
string glossaryName = "validGlossary.csv";
//changing the word First --> glossaryFirst and test --> glossaryTest
string glossaryContent = "First, glossaryFirst\ntest, glossaryTest\n";
var glossarySasUri = await CreateGlossaryAsync(new TestDocument (glossaryName, glossaryContent));
//Perform Translation Process
DocumentTranslationClient client = GetClient();
var input = new DocumentTranslationInput(source, target, "es", new TranslationGlossary(glossarySasUri, "csv"));
DocumentTranslationOperation operation = await client.StartTranslationAsync(input);
await operation.WaitForCompletionAsync();
//stream translated text into string
var blobClient = targetContainerClient.GetBlobClient(oneTestDocuments[0].Name);
var translatedResultStream = await blobClient.OpenReadAsync();
StreamReader streamReader = new StreamReader(translatedResultStream);
string translatedText = streamReader.ReadToEnd();
//Assert glossary has taken effect
var translatedTextSplitBySpaces = translatedText.Split(' ');
CollectionAssert.Contains(translatedTextSplitBySpaces, "glossaryFirst");
CollectionAssert.Contains(translatedTextSplitBySpaces, "glossaryTest");
}
public async Task OperationsHistoryAsync()
{
string endpoint = TestEnvironment.Endpoint;
string apiKey = TestEnvironment.ApiKey;
var client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));
#region Snippet:OperationsHistoryAsync
int operationsCount = 0;
int totalDocs = 0;
int docsCancelled = 0;
int docsSucceeded = 0;
int docsFailed = 0;
await foreach (TranslationStatus translationStatus in client.GetAllTranslationStatusesAsync())
{
if (translationStatus.Status == DocumentTranslationStatus.NotStarted ||
translationStatus.Status == DocumentTranslationStatus.Running)
{
DocumentTranslationOperation operation = new DocumentTranslationOperation(translationStatus.Id, client);
await operation.WaitForCompletionAsync();
}
operationsCount++;
totalDocs += translationStatus.DocumentsTotal;
docsCancelled += translationStatus.DocumentsCancelled;
docsSucceeded += translationStatus.DocumentsSucceeded;
docsFailed += translationStatus.DocumentsFailed;
}
Console.WriteLine($"# of operations: {operationsCount}");
Console.WriteLine($"Total Documents: {totalDocs}");
Console.WriteLine($"Succeeded Document: {docsSucceeded}");
Console.WriteLine($"Failed Document: {docsFailed}");
Console.WriteLine($"Cancelled Documents: {docsCancelled}");
#endregion
}
