Microsoft Face Recognition

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 Workflow 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 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. is used to create connections for Microsoft Face Recognition actions A tool for building the processes, logic, and direction within workflows..

The following actions are available:

Use Microsoft Face Recognition actions to manage people's face images and details, and to identify people in images.

Create a Microsoft Face Recognition connection

You can create connections from the Automate or Designer page.

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.

  • 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.

  1. On the top navigation bar, click Automate, and then select Connections from the left navigation.

  2. On the Connections page, click Add new.

  3. In the Add a new connection section that opens, fill in the following.

    In this field

    Select or enter the following
    Connector Microsoft Face Recognition

  4. Click Connect.

  5. In the Configure a connection window, fill in 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.

  6. Click Connect.

  7. If prompted, enter credentials and grant access to Nintex Workflow Cloud.

  8. In the permissions dialog, you can do one of the following:
    • Edit the Owners or Users permissions according to data source usage requirements and click Save permissions.

      • Tip: You can assign connection owners or users permissions according to your access requirements. For more information, see Permissions.

Your new connection appears on the Connections page.

    • On the top navigation bar, click Automate > Workflows, and then select the required workflow.

      • (Or)

    • On the top navigation bar, click Automate > Create workflow.
  2. Click the Microsoft Face Recognition action you want to add the connection to, or drag a Microsoft Face Recognition action into the workflow and select it.

  3. In the drop-down list for Connection, select Add new connection.

  4. In the Connection window, fill in 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.

  5. Click Connect.

  6. If prompted, enter credentials and grant access to Nintex Workflow Cloud.

  7. In the permissions dialog, you can do one of the following:
    • Edit the Owners or Users permissions according to data source usage requirements and click Save permissions.

      • Tip: You can assign connection owners or users permissions according to your access requirements. For more information, see Permissions.

Your new connection appears in the Connection field of your action.

Permissions

Permissions enable you to manage access for other users to use, edit, and delete connections.

  Use

Edit

 Delete

Assign
permissions

Owners
Users

Note: By default, users with administrator role will have the same rights as a Connection owner.

Follow these steps to assign permissions from the Connections page:

  1. On the Connections page, click for the required connection.
  2. From the menu, select Permissions.

    3. The corresponding permissions window is displayed.

  3. To assign permissions:
    • In the Owners field, type the name of the user, and select from the list.
    • In the Users field, type the name of the user, and select from the list.
  1. Click Save permissions.

Action flow

When using Microsoft Face Recognition, you must configure actions in a particular order, as some actions are dependent on data from others. This image shows the required action flow:

 

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.

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 control uses a Microsoft Face Recognition - Get people data source to list the people available from the person group in the drop-down.

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.

Each data source is configured for a specific user. You can create as many data sources as you need.

To add a Microsoft Face Recognition drop-down list to your form:

  1. Create your Microsoft Face Recognition data source.

    2. See Data sources.

  2. Add a data lookup form control to your form and configure it to use your new data source.

Assign data source permissions

Permissions enable you to manage access for other users to use, edit, and delete data sources.

  Use

Edit

 Delete

Assign
permissions

Connection owners

 ✔ ✔ ✔ ✔

Data source editors

 ✔ ✔ ✔ ✘
Data source users ✔ ✘ ✘ ✘

Note: By default, users with administrator role will have the same rights as a Connection owner.

Follow these steps to assign data source permissions from the Data sources page:

  1. On the Data sources page, click for the required data source.
  2. From the menu, select Permissions.

    3. The corresponding data source permissions window is displayed.

  3. To assign permissions:
    • In the Data source editors field, type the name of the user, and select from the list.
    • In the Data source users field, type the name of the user, and select from the list.
  1. Click Save Permissions.

Microsoft Face Recognition data source fields

When you create a Microsoft Face Recognition data source, you can configure some additional fields to specify which tables, views, and stored procedures the data source should retrieve.

Section

Field or selection

Description
Add new data source Operation Displays the operations available for the selected Connector. Depending on the selection the following fields are displayed:
  • Microsoft Face Recognition - Get people
    • 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.