Add Face

UiPath.AmazonRekognition.Activities.AddFace

Vue d'ensemble (Overview)

L'activité Ajouter un visage ( Add Face ) utilise l'API IndexFaces d'Amazon Rekognition pour détecter d'abord les visages dans l'image d'entrée (ImagePath ou ImageURL), puis les ajouter à la collection spécifiée (CollectionName). Pour chaque visage détecté, l'activité renvoie un tableau des visages (Faces) qui ont été ajoutés à la collection.

Résumé

Dépendances

Dépendance	Détails (Details)
Paquets	UiPath.Amazon.Rekognition.Activities
Activités (Activities)	Amazon Scope Créer une collection (sauf si une collection existe déjà)

Attributs

Attribut	Détails (Details)
Entrées (variables)	String S'applique à la propriété : CheminImage,ImageURL et CollectionName
Sorties (variables)	Faces[] S'applique à la propriété : Faces
API utilisée	Amazon Rekognition - IndexFaces
Exemples	Démarrage rapide

Propriétés

Les valeurs des propriétés suivantes sont spécifiées lors de l'ajout de cette activité à votre projet dans UiPath Studio.

Commun

DisplayName

Le nom complet de l’activité.

Attributs	Détails (Details)
Saisie de texte	String
Requis	Oui (Yes)
Valeur par défaut	Add Faces
Valeurs autorisées	Saisissez une variable String ou String .
Remarques	S/O

Entrée

CollectionName

Le nom ou l'ID d'une collection existante à laquelle vous souhaitez ajouter des visages détectés.

Attributs	Détails (Details)
Saisie de texte	String
Requis	Oui (Yes)
Valeur par défaut	Vide
Valeurs autorisées	Saisissez une variable String ou String .
Remarques	Si vous avez une collection existante que vous souhaitez utiliser, entrez son nom de collection exact. Il n'existe pas d'activité permettant de récupérer une liste de vos noms de collection, mais vous pouvez appeler l'API ListCollections directement à l'aide de l' AWS CLI ou de l' API AWS SDK.

CheminImage

Le chemin d'accès à une image locale que vous souhaitez analyser.

Attributs	Détails (Details)
Saisie de texte	String
Requis	Oui (si ImageURL est vide)
Valeur par défaut	Vide
Valeurs autorisées	Saisissez une variable String ou String .
Remarques	La propriété CheminImage ou URLImage est requise. Si vous entrez des valeurs pour CheminImage et URLImage, la valeur Chemin d'accès à l'image est utilisée.

URLImage

L'URL d'une image que vous souhaitez analyser.

Attributs	Détails (Details)
Saisie de texte	String
Requis	Oui (si ImagePath est vide)
Valeur par défaut	Vide
Valeurs autorisées	Saisissez une variable String ou String .
Remarques	La propriété CheminImage ou URLImage est requise. Si vous entrez des valeurs pour CheminImage et URLImage, la valeur Chemin d'accès à l'image est utilisée.

Divers

Private

Si elles sont sélectionnées, les valeurs des variables et des arguments ne sont plus enregistrées au niveau détaillé.

Attributs	Détails (Details)
Saisie de texte	Case à cocher
Requis	Non (No)
Valeur par défaut	non sélectionné
Valeurs autorisées	Sélectionné ou Non sélectionné
Remarques	S/O

Options

ImageID

Un identificateur unique que vous souhaitez attribuer au(x) visage(s) de l'image d'entrée.

Attributs	Détails (Details)
Saisie de texte	String
Requis	Non (No)
Valeur par défaut	Vide
Valeurs autorisées	Saisissez une variable String ou String .
Remarques	Exemple : si votre image n'a qu'un seul visage, votre IDImage peut être le nom de la personne (par exemple, "Peter"). Si votre image comporte plusieurs visages, IDImage est appliqué à tous les visages de l'image. Dans ce cas, votre valeur doit refléter la façon dont vous souhaitez identifier le groupe de visages (par exemple, "Peter.Paul.Mary"). L'utilisation de la propriété IDImage est utile si vous prévoyez d'utiliser l'activité Identifier le visage ( Identify Face ). L'activité Identifier le visage ( Identify Face ) renvoie un tableau de visages (via la propriété de sortie Visages ) qui correspond à ceux trouvés dans l'image d'entrée. Si vous aviez précédemment attribué un ImageID à une image, cette valeur était renvoyée dans le tableau.

Sortie

Visages

Tableau du ou des visages ajoutés à la collection spécifiée dans CollectionName.

Attributs	Détails (Details)
Saisie de texte	Face[] UiPath.Amazon.Rekognition.Models.Face[]
Requis	Non (recommandé si vous prévoyez d'utiliser les données de sortie dans des activités ultérieures)
Valeur par défaut	Vide
Valeurs autorisées	Saisissez une variable Face[] .
Remarques	Chaque visage identifié dans l'image se voit attribuer un ensemble unique de propriétés de visage à l'aide du type de données Visage , qui comprend FaceID et BoundingBox. Si vous prévoyez d'utiliser l'activité For Each pour traiter la sortie du tableau, sélectionnez UiPath.Amazon.Rekognition.Models.Face comme TypeArgument.