Configuring Custom Entities

Entity Configuration Guide

In the home screen of Entity Catalog, you can see a list of already configured softwares entities. Clicking on Create or Edit will open the configuration screen for creating new custom software entities. Let's understand what these configs mean.

Entity Catalog Screen

Entity Catalog Screen

Create or Edit Entity Screen

Create or Edit Entity Screen

Understanding Key Configurations

TermDefinitionExample
Title (Not editable)Preferred entity name shown to usersZoom, Figma, Loom, Notion, and more
Canonical NameMoveworks IDServiceNow Service Catalog → servicenow_service_catalog

WebAssembly → webassembly

Dolby.com → dolby_com

Canonical name is snake case with spaces converted to ‘_’ underscores
DescriptionA brief description of the entity shown to users“Zoom unifies cloud video conferencing, simple online meetings, and cross platform group chat into one easy-to-use platform.”
Entity Type (Not editable)Classify entities according to different use casesSoftware Applications
AliasesAlternate names for an entityzoom, zoom video, & zoom pro would be the aliases for Zoom, the video conferencing software
Exact matching logicMatches a word or phrase exactlyzoom pro would always match with zoom entity in EC
Fuzzy matching logicMatch a word or phrase to within a certain edit distancezooom (intentional spelling mistake) would try to match with zoom entity in EC.

By default, this option will be selected for aliases
Negative aliasesPrevents matches against a word or phrase that would otherwise matchloom & moom entities would be negative aliases for Zoom video conferencing software since those two are different apps with very similar names

🚧

Important Note

  • Entity Title is also the primary alias. It is not editable once entities are created
  • Currently, Entity Type Software Application is selected by default and is not editable

View Software Entities

  1. Navigate to Moveworks Setup > Core Platform section > Entity Catalog screen to view custom software entities

  2. The screen will display entity information with Entity Name, Canonical Name, and Description, with an Edit button


Search Software Entities

  1. Navigate to Moveworks Setup > Core Platform section > Entity Catalog screen to view custom software entities

  2. Click on search bar and search for entity such as zoom – the search string will get matched on entity name, canonical name or description


Create Software Entities

  1. Search whether the software entity already exists Moveworks Setup > Access Software > Software Catalog > Software/Application Name

  2. If the desired entity is not found, Navigate to Entity Catalog, click on Create New button

  3. Fill in all required the fields

    FieldValue
    TitleZoom
    Short DescriptionZoom unifies cloud video conferencing, simple online meetings, and cross platform group chat into one easy-to-use platform.
    Entity TypeSoftware Application (selected by default)
    Entity Aliaseszoom, zoom video, zoom pro
    Negative Aliasesloom

  4. Click on Submit Button to create the entity

Modify Software Entities

  1. Navigate to Moveworks Setup > Entity Catalog and Click on Edit Button

  2. Edit the fields that you want to modify in Entity Details page

    • Edit Description, or
    • Add, update or remove Aliases, or change their matching logic, or
    • Add, update or remove Negative Aliases
  3. Click on Submit Button

Where to Utilize Software Entities?

  1. Navigate to Moveworks Setup > Access Software > Software Catalog

  2. Search for the entity in the Software/Application Name field

  3. Setup the Software Provisioning for the Software or Application. For more information, read the guide on Provision Management