Se connecter à Microsoft Translator à partir de PowerAppsConnect to Microsoft Translator from PowerApps

Microsoft Translator

Ajoutez le connecteur Microsoft Translator pour afficher le texte traduit dans un contrôle Label de votre application.Add the Microsoft Translator connector to display translated text in a Label control in your app. Par exemple, vous pouvez créer une zone de saisie qui invite l’utilisateur à entrer du texte à traduire.For example, you can create an input text box that asks the user to enter some text to translate. Dans une autre étiquette, vous pouvez afficher le texte traduit.In another label, you can display the translated text.

Cette rubrique explique comment créer la connexion Microsoft Translator et l’utiliser dans une application, et répertorie les fonctions disponibles.This topic shows you how to create the Microsoft Translator connection, use the Microsoft Translator connection in an app, and lists the available functions.

Remarque : ce connecteur est limité à 150 appels par utilisateur et par jour.Note: This connector is limited to 150 calls per user per day.

 

What you need to get started

Connexion à Microsoft TranslatorConnect to Microsoft Translator

  1. Ouvrez PowerApps, sélectionnez New (Nouveau), puis créez une application vide.Open PowerApps, select New, and then create a Blank app. Choisissez le mode téléphone ou tablette.Choose phone or tablet layout. Le mode tablette offre un espace de travail plus important :Tablet layout gives you more workspace:

    Ouvrir une application vide

  2. Dans le volet de droite, cliquez ou appuyez sur l’onglet Données, puis sur Ajouter une source de données.In the right-hand pane, click or tap Data tab, and then click or tap Add data source.
  3. Sélectionnez Nouvelle connexion, puis Microsoft Translator :Select New connection, and then select Microsoft Translator:

    Connexion à Microsoft Translator

    Connexion à Microsoft Translator

  4. Sélectionnez Connect (Se connecter).Select Connect. Votre connexion apparaît sous Data sources (Sources de données) :Your connection appears under Data sources:

    Connexion à Microsoft Translator

Utiliser la connexion Microsoft Translator dans votre applicationUse the Microsoft Translator connection in your app

Traduire du texteTranslate text

  1. Dans le menu Insérer, sélectionnez Texte, puis Saisie de texte.On the Insert menu, select Text, and then select Text input. Affectez au contrôle de saisie de texte le nom Source :Rename the text input control to Source:

    Renommer

  2. Ajoutez une liste déroulante via le menu Insert > Controls (Insertion > Contrôles), renommez-la TargetLang, et déplacez-la sous Source.Add a Drop down list (Insert menu > Controls), rename it to TargetLang, and move it below Source.
  3. Définissez la propriété Items de TargetLang sur la formule suivante :Set the Items property of TargetLang to the following formula:

    MicrosoftTranslator.Languages()

  4. Ajoutez une étiquette, déplacez-la sous TargetLang, et définissez sa propriété Text sur la formule suivante :Add a label, move it below TargetLang, and set its Text property to the following formula:

    MicrosoftTranslator.Translate(Source.Text, TargetLang.Selected.Value)

  5. Tapez du texte dans Source, puis sélectionnez une langue dans TargetLang.Type some text into Source, and select a language in TargetLang. L’étiquette affiche le texte saisi dans la langue que vous avez choisie :The label shows the text that you entered in the language you chose:

    Traduire du texte de l’anglais vers l’espagnol

Restituer oralement du texte traduitSpeak translated text

Si vous ne l’avez pas encore fait, suivez les étapes décrites dans la section précédente pour traduire du texte.If you haven't already, follow the steps in the previous section to translate some text. Les étapes suivantes utilisent les mêmes contrôles.These next steps use the same controls.

  1. Définissez la propriété Items de la liste déroulante TargetLang sur la formule suivante :Set the Items property of the TargetLang drop-down list to the following formula:

    MicrosoftTranslator.SpeechLanguages()

  2. Renommez la deuxième étiquette (pas la zone Source) en Target.Rename the second label (not the Source box) to Target.
  3. Ajoutez un contrôle Audio via le menu Insert > Media (Insertion > Média), puis définissez sa propriété Media sur la formule suivante :Add an Audio control (Insert menu > Media), and set its Media property to the following formula:

    MicrosoftTranslator.TextToSpeech(Target.Text, TargetLang.Selected.Value)

  4. Appuyez sur F5 ou cliquez sur le bouton d’aperçu ().Press F5, or select the Preview button (). Tapez du texte dans Source, sélectionnez la langue dans TargetLang, puis sélectionnez le bouton de lecture dans le contrôle audio.Type some text into Source, select a language in TargetLang, and then select the play button in the audio control.

    L’application lit une version audio du texte saisi dans la langue que vous avez choisie.The app plays an audio version of the text that you entered in the language you chose.

  5. Appuyez sur Échap pour revenir à l’espace de travail par défaut.Press Esc to return to the default workspace.

Détection de la langue sourceDetect the source language

Ces étapes utilisent la même zone de saisie Source et les mêmes contrôles de texte Target.These next steps use the same Source text input and Target text controls. Vous pouvez créer de nouveaux contrôles si vous le souhaitez. Il vous suffit simplement de mettre à jour les noms dans la formule.You can create new controls if you prefer, just update the names in the formula.

  1. Sélectionnez le contrôle de texte Target et définissez la propriété Text sur la formule suivante :Select the Target text control, and set the Text property to the following formula:

    MicrosoftTranslator.Detect(Source.Text).Name

  2. Tapez du texte dans Source.Type some text into Source.

    L’étiquette affiche la langue du texte que vous avez saisi.The label shows you the language of the text that you typed. Par exemple, l’étiquette affiche Français si vous tapez bonjour, ou italien si vous tapez ciao.For example, the label shows French if you type bonjour, or Italian if you type ciao.

Afficher les fonctions disponiblesView the available functions

Cette connexion comprend les fonctions suivantes :This connection includes the following functions:

Nom de la fonctionFunction Name DescriptionDescription
LanguesLanguages Récupère toutes les langues prises en charge par Microsoft TranslatorRetrieves all languages that Microsoft Translator supports
TraduireTranslate Traduit le texte dans une langue spécifique à l’aide de Microsoft TranslatorTranslates text to a specified language using Microsoft Translator
DétecterDetect Détecte la langue source du texteDetects source language of given text
SpeechLanguagesSpeechLanguages Récupère les langues disponibles pour la synthèse vocaleRetrieves the languages available for speech synthesis
TextToSpeechTextToSpeech Convertit un texte donné en flux audio au format waveConverts a given text into speech as an audio stream in wave format

LanguesLanguages

Get languages : récupère toutes les langues prises en charge par Microsoft TranslatorGet languages: Retrieves all languages that Microsoft Translator supports

Propriétés d’entréeInput properties

Aucune.None.

Propriétés de sortieOutput properties

Nom de la propriétéProperty Name Type de donnéesData Type ObligatoireRequired DescriptionDescription
CodeCode chaînestring NonNo
NomName chaînestring NonNo

TraduireTranslate

Translate text : traduit le texte dans une langue spécifique à l’aide de Microsoft TranslatorTranslate text: Translates text to a specified language using Microsoft Translator

Propriétés d’entréeInput properties

NomName Type de donnéesData Type ObligatoireRequired DescriptionDescription
queryquery chaînestring ouiyes Texte à traduireText to translate
languageTolanguageTo chaînestring ouiyes Code de la langue cible (exemple : « fr »)Target language code (example: 'fr')
languageFromlanguageFrom chaînestring nonno Langue source (si elle n’est pas spécifiée, Microsoft Translator essaiera de la détecter automatiquement) (exemple : « en »)Source language (if not provided, Microsoft Translator will try to auto-detect) (example: en)
catégoriecategory chaînestring nonno Catégorie de traduction (par défaut : « général »)Translation category (default: 'general')

Propriétés de sortieOutput properties

Aucune.None.

DétecterDetect

Detect language : détecte la langue source du texteDetect language: Detects source language of given text

Propriétés d’entréeInput properties

NomName Type de donnéesData Type ObligatoireRequired DescriptionDescription
queryquery chaînestring ouiyes Texte dont la langue est identifiéeText whose language will be identified

Propriétés de sortieOutput properties

Nom de la propriétéProperty Name Type de donnéesData Type ObligatoireRequired DescriptionDescription
CodeCode chaînestring NonNo
NomName chaînestring NonNo

SpeechLanguagesSpeechLanguages

Get speech languages : récupère les langues disponibles pour la synthèse vocaleGet speech languages: Retrieves the languages available for speech synthesis

Propriétés d’entréeInput properties

Aucune.None.

Propriétés de sortieOutput properties

Nom de la propriétéProperty Name Type de donnéesData Type ObligatoireRequired DescriptionDescription
CodeCode chaînestring NonNo
NomName chaînestring NonNo

TextToSpeechTextToSpeech

Text to speech : convertit un texte donné en flux audio au format waveText to speech: Converts a given text into speech as an audio stream in wave format

Propriétés d’entréeInput properties

NomName Type de donnéesData Type ObligatoireRequired DescriptionDescription
queryquery chaînestring ouiyes Texte à convertirText to convert
languagelanguage chaînestring ouiyes Code de langue utilisé pour la synthèse vocale (exemple : « en-us »)Language code to generate speech (example: 'en-us')

Propriétés de sortieOutput properties

Aucune.None.

Consultez toutes les connexions disponibles.See all the available connections.
Découvrez comment ajouter des connexions dans vos applications.Learn how to add connections to your apps.