Quickstart - Add Face

Overview

The purpose of this guide is to help you create a working sample of the Add Face activity. This working sample enables you to quickly verify the connection to your AWS account and get familiar with the activity's input/output datatypes.

By completing the steps in this guide, you'll have an automation sequence that does the following:

1. Establishes a connection to your AWS account and Amazon Rekognition services via the Amazon Scope activity.
2. Creates a new collection to store information about faces detected in an image via the Create Collection activity.
3. Detects faces in an image and adds them to your specified collection via the Add Face activity.
4. Tests the Amazon Rekognition activities' input/output properties via the For Each and Write Line activities.

Prerequisites

Before you begin:

1. Complete the Amazon Rekognition Setup steps.
2. Create a new automation project.
   1. Open UiPath Studio.
   2. Under New Project, click Process (this opens a New Blank Process window).
   3. Enter a project Name, Location, and Description.
   4. Click Create.
   
   

   

   
   
3. Install the UiPath.Amazon.Scope.Activities and UiPath.Amazon.Rekognition.Activities packages.
   1. 1. In the Design ribbon, click Manage Packages (this opens the Manage Packages window).
      2. Under All Packages, click Go!
      3. In the Search bar, enter Amazon.
      4. Click, install and accept the license for both the UiPath.Amazon.Scope.Activities and UiPath.Amazon.Rekognition.Activities.

         For more information about Uipath Studio packages, see Managing Packages in the Studio Guide.

   
   

   

   
   

Steps

Build Your project

1. Add the Amazon Scope activity to your project.
2. If you don't have an existing collection to store the faces you want to add, add the Create Collection activity after the Amazon Scope activity, otherwise, proceed to step 3.
3. Add the Add Face activity after the Create Collection activity (if applicable).
4. Enter the CollectionName that you want to use to store your faces.
   • Recommendation: use the same String variable for both the Create Collection and Add Faces activities to ensure consistency.
5. Enter the ImagePath or ImageURL of the image that contains the faces you want to add to your collection.
   • Recommendation: create a String variable for your image location so that you can reuse it in other activites (e.g., Identify Faces, Compare Faces).
6. Enter an ImageID that you want to assign to the image when its stored in the collection.
   • Example: if your image has only one face, your ImageID could be the person's name (e.g., "Peter"). If your image has multiple faces, the ImageID is applied to all faces in the image. In this instance, your value should reflect how you want to identify the group of faces (e.g., "Peter.Paul.Mary").
7. Create and enter a Face[] variable for your Face value.
   • When creating your variable, select the UiPath.Amazon.Rekognition.Models.Face[] variable type.

Test Your Project

1. To test the Add Face activity, add a For Each with a Write Line activity.
2. In the TypeArgument property, select UiPath.Amazon.Rekognition.Models.Face.
3. In the Values property, enter the Face property Face[] variable you created in step 2 above.
4. In the Text property, enter the ImageID property String variable you created in step 3 above.
5. Click Run and verify the Output window includes the face detail values you entered in the Write Line activity.

You're done!

When you're ready, try the other Quickstart guides to get more familiar with the different Amazon Rekognition activities.

To learn more about the other Amazon Rekognition activities, see the Activities page for a complete activity list and links to the activity detail pages.