Microsoft Face Recognition
Important: This connector and its actions have been removed from Nintex Automation Cloud and can now be found in Nintex Gallery.
Microsoft Face Recognition provides AI algorithms that detect, recognize, and analyze human faces in images. Facial recognition software is important in many different scenarios, such as identity verification, touchless access control, and face blurring for privacy. For more information on Microsoft Face Recognition see the company website.
In the context of Nintex Automation Cloud, Microsoft Face Recognition is a connector Service used to define a connection required for associated actions and start events. Examples include Salesforce and Box. Method of integration to cloud services, business applications and content stores.. The Microsoft Face Recognition connector is used to create connections for Microsoft Face Recognition actions A tool for building the processes, logic, and direction within workflows.. Use Microsoft Face Recognition actions to manage people's face images and details, and to identify people in images.
Jump to:
Create a Microsoft Face Recognition connection
Note: Your browser-stored credentials are accessed to create connections. Either clear credentials from browser memory or make sure the stored credentials are for the intended environment.
Create a connection from the connections page or from the action configuration panel when configuring the action. For information about creating connections and assigning permissions, see Manage connections.
In the Add a new connection section, complete the fields as follows:
In this field |
Select or enter the following |
---|---|
Connection name | A name for your new connection |
API Key | Your Microsoft Azure Cognitive Service API key. In the Azure portal, access your API key and location value on your Cognitive Service > Keys and Endpoint page. |
Location | Get you location entry on your Cognitive Service > Keys and Endpoint page. |
Microsoft Face Recognition account requirements
- You must have an Azure account with a Cognitive Service subscription and have the Face service configured to use this connector's actions. For more information see Microsoft Azure Face.
-
You must use your Microsoft Azure Cognitive Service API key and location entry to create a connection. In the Azure portal, access your API key and location entry on your Cognitive Service > Keys and Endpoint page.
Action flow
When using Microsoft Face Recognition, you must configure actions in a particular order, as some actions are dependent on data from others. The required action flow is shown below:
Create a Microsoft Face Recognition data source
Use the Microsoft Face Recognition data source to retrieve a list of person groups, and to retrieve a list of people from a person group. Each data source is configured for a specific user. You can create as many data sources as you need.
For example, to allow users to select a specific person in a form, add a drop-down list of people from a person group to the form using a Data lookup control A form control that allows users to select from a drop-down list of values that have been fetched from a third-party service.. The Data lookup form control uses a Microsoft Face Recognition - Get people data source to list the people available from the person group in the drop-down. For more information on creating a data source and assigning permissions to it, see Data sources.
You can create a data source to:
- Get people: List people defined within a person group from your Microsoft Face Recognition account.
- Get person group: List the person groups available from your Microsoft Face Recognition account.
Microsoft Face Recognition data source fields
To access the data source fields, in the Add data source section, select Microsoft Face Recognition in the Connector field and then select the Operation.
Operation |
Field or selection |
Description |
---|---|---|
Get people | Connection |
The connection to use for the data source. |
Person group ID | The person group that contains the list of people. You can use the output of the Get person groups data source to provide the Person group ID. | |
Get person groups | Connection |
The connection to use for the data source. |