Connexion à Microsoft Translator depuis Power Apps

Ajoutez le connecteur Microsoft Translator pour afficher le texte traduit dans un contrôle Étiquette de votre application. Par exemple, vous pouvez créer une zone de saisie qui invite l’utilisateur à entrer du texte à traduire. Dans une autre Étiquette, vous pouvez afficher le texte traduit.

Cette rubrique explique comment créer la connexion Microsoft Translator et l’utiliser dans une application, et répertorie les fonctions disponibles.

Conditions préalables

• Accéder à Power Apps
• Ajouter la connexion
• Créer une application à partir d'un modèle, de données ou de zéro

Connexion à Microsoft Translator

1. Créez une application canevas vide.

2. Dans le volet de gauche, cliquez sur l’onglet Données, puis sur Ajouter une source de données.

3. Sélectionnez Nouvelle connexion, puis Microsoft Translator :

   

4. Cliquez sur Se connecter. Votre connexion apparaît sous Sources de données :

   

Utiliser la connexion Microsoft Translator dans votre application

Traduire du texte

1. Dans la Vue arborescente sur le côté gauche de l’écran, sélectionnez Insérer, puis choisissez le contrôle Texte Input. Renommez le contrôle Texte input en Source.

2. Ajoutez une liste déroulante via le menu Insertion > Contrôles, renommez-la TargetLang, et déplacez-la sous Source.

3. Définissez la propriété Items de TargetLang sur la formule suivante :

   MicrosoftTranslator.Languages()

4. Ajoutez une Étiquette, déplacez-la sous TargetLang, et définissez sa propriété Texte sur la formule suivante :

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

5. Tapez du texte dans Source, puis sélectionnez une langue dans TargetLang. L’Étiquette affiche le texte saisi dans la langue que vous avez choisie :

   

Restituer oralement du texte traduit

Si vous ne l’avez pas encore fait, suivez les étapes décrites dans la section précédente pour traduire du texte. Les étapes suivantes utilisent les mêmes contrôles.

1. Définissez la propriété Items de la liste déroulante TargetLang sur la formule suivante :

   MicrosoftTranslator.SpeechLanguages()

2. Renommez la deuxième Étiquette (pas la zone Source) en Target.

3. Ajoutez un contrôle Audio via le menu Insertion > Média, puis définissez sa propriété Média sur la formule suivante :

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

4. Appuyez sur F5 ou sélectionnez le bouton Aperçu (). Tapez du texte dans Source, sélectionnez la langue dans TargetLang, puis sélectionnez le bouton de lecture dans le contrôle audio.

   L’application lit une version audio du texte saisi dans la langue que vous avez choisie.

5. Appuyez sur Échap pour revenir à l’espace de travail par défaut.

Détection de la langue source

Ces étapes utilisent la même zone de saisie Source et les mêmes contrôles de texte Target. Vous pouvez créer de nouveaux contrôles si vous le souhaitez. Il vous suffit simplement de mettre à jour les noms dans la formule.

1. Sélectionnez le contrôle de texte Target et définissez la propriété Texte sur la formule suivante :

   MicrosoftTranslator.Detect(Source.Text).Name

2. Tapez du texte dans Source.

   L’Étiquette affiche la langue du texte que vous avez saisi. Par exemple, l’étiquette affiche Français si vous tapez bonjour, ou italien si vous tapez ciao.

Afficher les fonctions disponibles

Cette connexion comprend les fonctions suivantes :

Nom de la fonction	Description
Langues	Récupère toutes les langues prises en charge par Microsoft Translator
Traduire	Traduit le texte dans une langue spécifique à l’aide de Microsoft Translator
Détecter	Détecte la langue source du texte
SpeechLanguages	Récupère les langues disponibles pour la synthèse vocale
TextToSpeech	Convertit un texte donné en flux audio au format wave

Langues

Get languages : récupère toutes les langues prises en charge par Microsoft Translator

Propriétés d’entrée

Aucune.

Propriétés de sortie

Nom de propriété	Type de données	Nécessaire	Description
Code	string	Non
Nom	string	Non

Traduire

Translate Texte : traduit le texte dans une langue spécifique à l’aide de Microsoft Translator

Propriétés d’entrée

Nom	Type de données	Nécessaire	Description
query	string	oui	Texte à traduire
languageTo	string	oui	Code de la langue cible (exemple : « fr »)
languageFrom	string	non	Langue source (si elle n’est pas spécifiée, Microsoft Translator essaiera de la détecter automatiquement) (exemple : « en »)
catégorie	string	non	Catégorie de traduction (par défaut : « général »)

Propriétés de sortie

Aucune.

Détecter

Detect language : détecte la langue source du texte

Propriétés d’entrée

Nom	Type de données	Nécessaire	Description
query	string	oui	Texte dont la langue est identifiée

Propriétés de sortie

Nom de propriété	Type de données	Nécessaire	Description
Code	string	Non
Nom	string	Non

SpeechLanguages

Get speech languages : récupère les langues disponibles pour la synthèse vocale

Propriétés d’entrée

Aucune.

Propriétés de sortie

Nom de propriété	Type de données	Nécessaire	Description
Code	string	Non
Nom	string	Non

TextToSpeech

Texte to speech : convertit un texte donné en flux audio au format wave

Propriétés d’entrée

Nom	Type de données	Nécessaire	Description
query	string	oui	Texte à convertir
langue	string	oui	Code de langue utilisé pour la synthèse vocale (exemple : « en-us »)

Propriétés de sortie

Aucune.

Liens utiles

Consultez toutes les connexions disponibles.
Découvrez comment ajouter des connexions dans vos applications.

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).