Manage artifact fields

Manage the fields that appear on all artifact types logged on your models. Choose from an array of field types with different properties and use cases.

Prerequisites

• You are logged in to ValidMind.
• You are a Customer Admin or assigned another role with sufficient permissions to perform the tasks in this guide.¹

¹ Manage permissions

View, search, and filter artifacts fields

1. In the left sidebar, click Settings.

2. Under Artifacts, select Artifact Fields.

   Displayed in groups² as lists are the artifacts fields available to artifacts in your organization with a quick view of:³

   • Number of workflows that field is used in⁴
   • The field key
   • The field type⁵
   • Field description
   • Whether or not the field is required when creating artifacts
   • Quick actions you can take on the artifact field

3. Narrow down existing artifacts fields available to your artifacts by searching or filtering for results:

² Add artifact field groups

³ 

NoneMissing column headers?

Click, hold, and drag to the right to reveal additional columns.

⁴ Working with workflows

⁵ Artifact field types

Search fields

1. Click Search to search by keywords within an artifacts field.

2. Select whether to search in the Title or Description.

3. Click Search to narrow down your results by your entered keywords.

   Expand any inventory field group to see more fields.

Filter fields

1. Click Filter to filter fields by any of the following criteria:

   • artifact types — The types of artifacts that use this field.
   • required on creation — Whether or not the field was set up as required on artifact creation.
   • types — What type of field it is.
   • workflow triggered by field — What workflows are initiated when this field is edited.⁶
   • write permissions — Which model stakeholder types have permissions to edit this field.⁷

2. Click Apply Filters to narrow down your results by your configured criteria.

   Expand any inventory field group to see more fields.

⁶ Configure workflows

⁷ Manage model stakeholder types

NoneNote that searching and filtering of fields stack.

For example, if you first search by keyword for Regression under Title without clearing that search, any additional filters applied will only apply to the results returned by that initial search.

Add or edit artifact fields

1. In the left sidebar, click Settings.

2. Under Artifacts, select Artifact Fields.

   Here you can edit existing artifact fields, or add a new one:

Add artifact fields

To add a new artifact field, click Add Field:

1. Artifact fields require a type,⁸ a name, and a artifact type.⁹

   • (Optional) Enter a description to indicate the purpose of the field.
   • (Optional) You can also choose to indicate that a field is required when creating artifacts.
   • (Optional) You can also assign a field to a group.¹⁰
   • Assign write permissions to allow granular access to editing this field gated by model stakeholder types or user roles. Leave this field blank for default permissions where only the Customer Admin role has write access.¹¹

2. When you are satisfied with the setup of your artifact field, click Save.

⁸ Artifact field types

⁹ Manage artifact types

¹⁰ Add artifact field groups

¹¹ 

NoneAll other users will have read-only access unless specified under the write permissions.

• Model Stakeholders — Write permissions on a per model basis.
• Application Roles — Write permissions on a per field basis across all artifacts.

Edit artifact fields

To edit an existing artifact field:

1. Click on the artifact field you would like to edit.

   Expand any inventory field group to see more fields.¹²

2. Make your desired changes to your artifact field, then click Save.

¹² Add artifact field groups

Artifact field types

Single Line Text

Simple text value.

Attachments

Upload supporting files for your model.¹³ Files must be less than 50 MB each in size.

¹³ Manage supporting documentation

Long Text

Toggle Enable rich text formatting to create a template using the rich text editor.

Single Select

Click Add Option to define a list of options.

Multiple Select

Click Add Option to define a list of options.

Checkbox

A true/false value set by a toggle.

Number

Text value in valid number format. Number display (comma, fullstop, etc.) is determined by your browser’s locale. Select a number type:

• Simple — Define the decimal places that the number should be displayed up to and any large number abbreviations.
• Currency — Define the currency you would like the field to display in, as well as the decimal places that the number should be displayed up to and any large number abbreviations.

Simple number field type

Currency number field type

URL

Text value in valid URL format.

Date

• Date value in yyyy-mm-dd format.
• Selection is in the current user’s timezone; other users viewing this field will see the value automatically in their timezone.
• Set the date format for date fields under your profile.¹⁴

¹⁴ Manage your profile

Date Time

• Date value in yyyy-mm-dd, 24hr format.
• Selection is in the current user’s timezone; other users viewing this field will see the value automatically in their timezone.
• Set the date format for date time fields under your profile.¹⁵

¹⁵ Manage your profile

Email

Text value in valid email (user@domain.com) format.

User

• Select list pre-populated with users from your User Directory.¹⁶
• Toggle allow linking to multiple records on to allow multi-selection of users.

¹⁶ Manage users

Calculation

Define a formula(params) function that automatically calculates and returns a value based on the params dictionary, which includes selected custom field keys retrieved from your other inventory model fields.

1. Click in front of the inventory field to allow your formula access to the field’s values.
2. Replace the demonstration formula with your own in the code box provided.
3. Enter in sample values in the testing area then click Test Calculation to validate your formula.

NoneUse artifact types¹⁷ in your formulas to create dynamic calculations.

Use simple dot notation to include artifact types:

• finding_type.tag — Technical tag: VALIDATION_ISSUE
• finding_type.name — Human-readable name: Validation Issue

¹⁷ Manage artifact types

Example use cases:

• Calculate different risk scores based on artifact type.
• Generate dynamic titles and descriptions.
• Set different due dates or priorities by artifact category.
• Create type-specific business logic in formulas.

Severity calculation

# Calculate different severity scores based on artifact type

if finding_type.tag == "VALIDATION_ISSUE":
    return severity_score * 2.5
elif finding_type.tag == "POLICY_EXCEPTION":
    return severity_score * 1.0
else:
    return severity_score * 1.8

Due date calculation

# Dynamically calculate due dates based on artifact type

base_days = 30
if finding_type.tag == "VALIDATION_ISSUE":
    urgency_multiplier = 0.5  # 15 days
elif finding_type.tag == "MODEL_LIMITATION":
    urgency_multiplier = 2.0  # 60 days
else:
    urgency_multiplier = 1.0  # 30 days

return base_days * urgency_multiplier

Custom fields & parent model data

# Combine artifact types with custom fields and parent model data

risk_factor = custom_field_risk_score or 1.0
model_criticality = params.model.get("criticality_level", "medium")

if finding_type.tag == "VALIDATION_ISSUE" and model_criticality == "high":
    return risk_factor * 3.0
else:
    return risk_factor * 1.5

Add artifact field groups

To group artifact fields, first create an artifact field group:

1. In the left sidebar, click Settings.

2. Under Artifacts, select Artifact Fields.

3. Click Add Group and enter in a name and a description for the group.

4. Click Create Group to add the new group.

5. Assign the desired fields to the group.¹⁸

¹⁸ Add or edit artifact fields

Delete artifact fields

1. In the left sidebar, click Settings.

2. Under Artifacts, select Artifact Fields.

3. Hover over the field you would like to delete.

4. When the appears under the Actions column, click on it and select Delete Field.

5. After you confirm, the field will be removed.