The Image Analyzer Extension for Microsoft Dynamics 365 Business edition

The Image Analyzer extension uses powerful image analytics provided by the Computer Vision API for Microsoft Cognitive Services to detect attributes in the images that you import for items and contact persons, so you can easily review and assign them. For items, attributes could be whether the item is a table or a car, and whether it is red or blue. For contact persons, attributes can be gender or age.

Image Analyzer suggests attributes based on tags that the Computer Vision API finds, and a confidence level. By default, it suggests attributes only if it is at least 80% sure that the attribute is correct. You can set another confidence level, if needed. To learn more about how the tags and confidence level are determined, see Computer Vision API.

Image Analyzer is free in Dynamics 365, but there is a limit to the number of items that you can analyze during a certain period of time. By default, you can analyze 100 images per month.

After you enable the extension, Image Analyzer runs each time you import an image to an item or contact person. You will see the attributes, confidence level, and details right away, and can decide what to do with each attribute. If you imported images before you enabled the Image Analyzer extension, you must go to the item or contact cards and choose the Analyze Picture action.

Note

By enabling this extension you agree that Microsoft may store your data and use it to improve Microsoft services, such as making the Computer Vision API better. To help protect your privacy, we take steps to make your data anonymous and keep it secure. We will not publish your data or let other people use it. You can remove the image from the item in Dynamics 365, however, the Computer Vision API will still have the image in its de-identified form. For more information, see Microsoft Trust Center.

Requirements

There are a few requirements for the images:

  • Image formats: JPEG, PNG, GIF, BMP
  • Maximum file size: Less than 4 MB
  • Image dimensions: Greater than 50 x 50 pixels

Blacklisting suggested attributes

If the analysis suggests an attribute that you do not want to see you can blacklist the attribute. Use caution, however. Blacklisted attributes are not suggested for other items or contact persons either. If you regret blacklisting an attribute, you can choose Blacklisted Attributes, and then delete the attribute from the list.

To enable Image Analyzer

The Image Analyzer extension is built-in to Dynamics 365. You just need to turn it on.

Note

To enable the Image Analyzer extension, you must be an administrator. Make sure that you are assigned the SUPER user permission set.

  1. To enable the Image Analyzer extension, do one of the following:
  • Open an item or contact card. In the notification bar, choose Analyze Images, and then follow the steps in the assisted setup guide.
  • Choose the Search for Page or Report icon, enter Service Connections, and then choose Image Analysis Setup. Choose the Enable Image Analyzer check box, and then complete the steps in the assisted setup guide.

Tip

The Image Analysis Setup page is also where you can change the degree of confidence for attribute suggestions. For example, if you want to require a greater degree of confidence, you can enter a higher percentage.

To analyze an image of an item

The following steps describe how to analyze an image that was imported before you enabled the Image Analyzer extension.

  1. Choose the Search for Page or Report icon, enter Items, and then choose the related link.
  2. Choose the item, and then choose the Analyze Picture action.
  3. The Image Analyzer Attributes page displays the detected attributes, the confidence level, and other details about the attribute. Use the Action to perform options to specify what to do with the attribute.

Tip

You can add the name of the attribute to the item description by choosing Add to item description. For example, this can be useful for quickly adding detail.

To analyze a picture of a contact person

The following steps describe how to analyze an image that was imported before you enabled the Image Analyzer extension.

  1. Choose the Search for Page or Report icon, enter Contacts, and then choose the related link.
  2. Choose the contact person, and then choose the Analyze Picture action.
  3. On the Profile Questionnaire FastTab, review the suggestions, and make corrections if needed.

To use your own account for the Computer Vision API

You can also use your own account for the Computer Vision API, for example, if you want to analyze more images than we allow.

  1. Choose the Search for Page or Report icon, enter Image Analyzer Setup, and then choose the related link.
  2. Enter the API URI and API Key that you received for Computer Vision API.

Note

You must add /analyze at the end of the API URI, if it isn't already there. For example: https://cronus.api.cognitive.microsoft.com/vision/v1.0/analyze.

To see how many analyses you have left in the current period

You can view the number of analyses you've done, and how many you can still do, in the current period.

  1. Choose the Search for Page or Report icon, enter Image Analyzer Setup, and then choose the related link.
  2. The Limit type, Limit value, and Analyzes performed provide the usage information.

To stop using the Image Analyzer extension

  1. Choose the Search for Page or Report icon, enter Service Connections, and then choose Image Analyzer Setup.
  2. Clear the Enable Image Analyzer check box.

See Also

How to: Work with Item Attributes
Customizing Dynamics 365 Using Extensions
Welcome to Dynamics 365 for Finance and Operations, Business edition