Manage artifact fields

Manage the fields that appear on all artifact types logged on your records. 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

Artifact field types

Attachments

Upload supporting files for your artifact.² The default maximum upload size is 100 MB per file. The limit shown in ​ValidMind may differ depending on your deployment configuration.

² Manage attachments on artifacts

Calculation

Define a formula(params) function that reads field values from the params dictionary and returns a read-only value. Formulas are written in Starlark³, a small, sandboxed scripting language with a Python-style syntax and a set of built-in helper functions for working with dates, numbers, and lists.

³ Starlark

NoneA note on calculated fields

​ValidMind runs calculated field formulas on the Starlark formula engine. Formulas authored on earlier releases were written in Python and have been migrated to Starlark automatically. When creating or editing formulas, you now must use the Starlark syntax.

1. Select a Result Type for the value your formula returns: Text, Number, Date, or Boolean.⁴
2. Select from the drop-down of Available Artifact Fields and Record Fields Available Via params["model"]** to allow your formula access to the field’s values.⁵
3. Replace the demonstration formula with your own in the code box provided.⁶
4. Click Test Calculation to open the testing area.
5. Enter in sample values in the testing area then click Test Calculation to validate your formula. The result shows the type of value your formula returned and warns you if it does not match the selected result type.

⁴ The result type decides which filter operators and sort order the field offers, and how its values are validated. A formula that returns a value of another type is recorded as a type mismatch on that artifact.

⁵ Fields are grouped by field type.

⁶ Reference fields with dictionary-style access — params["fieldKey"] and params["model"]["fieldKey"] for parent inventory record data — and use the available helpers for date and number work.

⁷ Filter by calculated and aggregation fields

Calculated values are stored on each artifact and refreshed in the background. You can filter the artifact lists by them using the operators for the field’s result type.⁷

NoneExample — Use artifact types in your formulas to create dynamic calculations

The artifact type is exposed under params["finding_type"] so you can branch on it:

• params["finding_type"]["tag"] — Technical tag: VALIDATION_ISSUE
• params["finding_type"]["name"] — Human-readable name: Validation Issue

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

def formula(params):
    if params["finding_type"]["tag"] == "VALIDATION_ISSUE":
        return params["severity_score"] * 2.5
    elif params["finding_type"]["tag"] == "POLICY_EXCEPTION":
        return params["severity_score"] * 1.0
    else:
        return params["severity_score"] * 1.8

Due date calculation

def formula(params):
    base_days = 30
    if params["finding_type"]["tag"] == "VALIDATION_ISSUE":
        urgency_multiplier = 0.5
    elif params["finding_type"]["tag"] == "MODEL_LIMITATION":
        urgency_multiplier = 2.0
    else:
        urgency_multiplier = 1.0
    return base_days * urgency_multiplier

Custom fields & parent record data

def formula(params):
    risk_factor = params["custom_field_risk_score"] or 1.0
    model_criticality = params["model"].get("criticality_level", "medium")
    if params["finding_type"]["tag"] == "VALIDATION_ISSUE" and model_criticality == "high":
        return risk_factor * 3.0
    else:
        return risk_factor * 1.5

Params dictionary

In addition to custom field keys you add from the available fields drop-down, formulas can read built-in keys on the params dictionary:

Param	Applies to	Availability	Description
params["<fieldKey>"]	Inventory records & artifacts	Add the field from the available fields drop-down	Current value of another custom field on the same record or artifact.
params["integrations"]	Inventory records & artifacts	Reference params["integrations"] in the formula source	Linked external integration data keyed by service (for example, params["integrations"]["mlflow"]). Empty when integrations are not configured or not referenced.
params["finding_type"]	Artifacts	Always available on artifact formulas	Artifact type metadata with ["tag"] (technical identifier) and ["name"] (display name).
params["model"]	Artifacts	Always available when the artifact is linked to an inventory record	Parent inventory record custom field values (for example, params["model"]["criticality_level"]).

Available helpers

Reference these helpers in your formulas — they cover the date, number, and list operations the engine does not expose directly:

Helper	Returns	Description
today()	"YYYY-MM-DD"	Current date as an ISO string.
safe_parse_date(value, default=None)	"YYYY-MM-DD" or default	Parses ISO dates/datetimes or millisecond/second epoch timestamps.
to_iso(value)	"YYYY-MM-DD" or None	Alias for safe_parse_date with no default.
add_days(date, n)	"YYYY-MM-DD" or None	Adds n days to an ISO date.
add_months(date, n)	"YYYY-MM-DD" or None	Adds n months to an ISO date.
days_between(a, b)	int or None	Days between two ISO dates (a − b).
days_since(date)	int or None	Days from date to today.
months_between(a, b)	int or None	Full-month difference between two ISO dates.
get_year(date) / get_month(date) / get_day(date)	int or None	Components of an ISO date.
safe_int(value, default=0)	int	Tolerates strings and missing values.
safe_float(value, default=0.0)	float	Tolerates strings and missing values.
list_count(list, value)	int	Number of times value appears in list.
zfill(value, width)	string	Zero-pads value to width characters.

Checkbox

A true/false value set by a toggle.

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.

Long Text

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

Multiple Select

Click Add Option to define a list of options.

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

Single Line Text

Simple text value.

Single Select

Click Add Option to define a list of options.

URL

Text value in valid URL 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

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

   The Default Fields group is always listed first. It shows the fields ​ValidMind provides on every artifact, such as Status, Severity, and Proposed Remediation Plan. For each default field:

   • Artifact Types lists the active artifact types the field is turned on for.¹⁵
   • Required lists the artifact types that require the field when creating an artifact.

   Title and Description apply to all artifact types and are always required. You can configure the other default fields for each artifact type,¹⁶ but default fields can’t be renamed or deleted.

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.

¹³ This count only applies to custom fields.

Working with workflows

¹⁴ Artifact field types

¹⁵ Manage artifact types

¹⁶ Configure default artifact fields

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. In the Default Fields group, this shows the fields turned on for the selected types.
   • 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 inventory record 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 record 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.

Configure default artifact fields

For each default field except Title and Description, choose which artifact types use it and how it behaves when artifacts are created:

1. In the left sidebar, click Settings.

2. Under Artifacts, select Artifact Fields.

3. In the Default Fields group, hover over the field you want to configure.

4. When the menu appears under the Actions column, click on it and select Configure.

5. For each active artifact type, set:

   Enabled

   The field appears on artifacts of this type: on the artifact details page, in artifact filters, and in workflow steps. Turning a field off also turns off the two options below.

   Show on creation

   The field appears when creating an artifact of this type. When off, the field can still be filled in on the artifact details page after the artifact is created.

   Require on creation

   An artifact of this type can’t be created without a value for the field, whether in the ValidMind Platform or through the ​ValidMind API.

6. Click Save Configuration to apply your changes.

   If you turn a field off for an artifact type that a workflow uses the field on, the workflows affected are listed first. Click Yes, Disable followed by the field name to save anyway.

NoneSome default fields have fixed rules.

• Risk Area is always required when it is shown on creation.
• Status, Attachments, and Proposed Remediation Plan can only be turned on or off. New artifacts start in the default status, and attachments and remediation plans are added on the artifact details page after creation.
• Turning a field off hides it but keeps the values already saved on existing artifacts. Those values remain available through the ​ValidMind API and data exports.

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 you to enter a Title (name), select a field Type,¹⁹ and indicate what Artifact Types²⁰ the field is available on.

2. Include optional information for your artifact field:

   • Enter a custom field Key.²¹
   • Enter a Description to indicate the purpose of the field displayed on the list of fields.
   • Enter Help Text to provide guidance to users on how best to fill out that field.
   • Check off whether or not the field should be Required On Artifact Creation.
   • Assign a field to a Group.²²
   • Assign Write Permissions to allow granular access to editing this field gated by inventory record stakeholder types or user roles. Leave this field blank for default permissions where only the Customer Admin role has write access.²³

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

¹⁹ Artifact field types

²⁰ Manage artifact types

²¹ If left blank, a key will be automatically generated in camelCase format.

²² Ungrouped fields will be listed under No Group: Add artifact field groups

²³ 

NoneAll other users will have read-only access unless specified under the Write Permissions.

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

Edit artifact fields

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

²⁴ Add artifact field groups

To edit an existing artifact field:

1. Click on the artifact field you want to edit.

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

   Field keys for artifact fields can be renamed under the Actions column.²⁵

²⁵ Rename artifact field keys

Recalculate calculated fields

Calculation field values are stored on each artifact and refreshed in the background.²⁶ If a field keeps showing a value or an error that should have changed, for example after you fix the data the formula reads, recalculate the field. This updates its stored value on every artifact it applies to without waiting for the next background refresh.

²⁶ Artifact field types

Only Customer Admin users can recalculate fields. To recalculate a Calculation field:

1. Hover over the Actions column on the far-right for the field you want to recalculate.

2. When the menu appears, click on it and select Recalculate Now.

   The recalculation starts right away and runs in the background. It can take a few minutes. A notification shows its progress, and you can’t start another recalculation of the same field until it finishes. If you leave the page, the recalculation keeps running.

3. When the recalculation finishes, the notification shows how many values were recalculated and how many could not be recalculated, if any.

   If the field is already being recalculated, the notification says so. Try again when that recalculation finishes.

Rename artifact field keys

To rename the field keys for artifact fields:

1. Hover over the Actions column on the far-right for the field whose key you want to rename.

2. When the menu appears, click on it and select Rename Key.

3. Enter the New Key and click Check Availability.

4. If the key is not already in use, you’ll be presented with a list of dependencies to review.

   Verify that these dependencies are correct and as expected.

5. Click Rename Key to apply your changes to the key.

   Confirm that the dependencies updated are corrected and as expected.

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

ImportantArtifact field deletion is permanent.

Deleting an artifact field will remove it from all artifacts using that field, even if the field has been populated on an artifact.

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 menu appears under the Actions column, click on it and select Delete Field.

5. Click Yes, Delete Field to confirm permanent deletion. If the field is a Calculation field, the confirmation notes how many artifacts hold a stored value that will be cleared.