Using ​ValidMind for
Risk Management

Administrator Fundamentals — Module 3 of 4

Click to start

Learning objectives

“As an administrator who has set up user access to the ValidMind Platform and prepared our model inventory for tracking models, I want to maximize the potential of ​ValidMind as a centralized hub for risk management oversight by configuring workflows, regulations and policies, and attestations in accordance with our organization’s requirements.”


This third module is part of a four-part series:

Administrator Fundamentals

Module 3 — Contents

  1. ​ValidMind for risk management
  2. Set up & manage custom workflows
  3. Manage regulations & policies
  4. Configure attestations

First, let’s make sure you can log in to ​ValidMind.

Training is interactive — you explore ​ValidMind live. Try it!

→ , ↓ , SPACE , N — next slide     ← , ↑ , P , H — previous slide     ? — all keyboard shortcuts

Before you begin

To continue, you need to have been onboarded onto ValidMind Academy with the Customer Admin role and completed the first two modules of this course:

Onboarding Your Organization

Customizing Your Model Inventory

Already logged in and refreshed this module? Click to continue.

  1. Log in to check your access:

Log in to ​ValidMind

Be sure to return to this page afterwards.

  1. After you successfully log in, refresh the page to connect this training module up to the ValidMind Platform:

ValidMind for
risk management

Welcome back to the ValidMind Platform

The ValidMind Platform is more than just a model inventory where your model development and model validation teams collaborate seamlessly and more efficiently — it’s also an indispensable tool for model risk management oversight:

  • Configure workflows to match your organizational needs for every part of your model lifecycles.
  • Set up attestations to support compliance and governance processes.
  • Customize reporting to provide insights tailored to your use cases.

Can’t load the ValidMind Platform?

Make sure you’re logged in and have refreshed the page in a Chromium-based browser.

Let’s continue our journey by learning how to set up workflows for your use case on the next pages.

Set up & manage workflows

Workflow elements

(Scroll down for the full instructions.)

Learn more …


Learn how to manage record stages on the next page.

Configure workflows to match your organizational needs for overseeing development, validation, implementation, ongoing monitoring, auditing, or other risk management activities.

  • Records in your inventory transition through your organization’s custom record lifecycles via record stages, which are in turn manipulated via workflows.
  • Workflows are comprised of workflow steps, and have their own workflow states discrete from record stages.
  • Some step types allow you to define conditional requirements, providing flexible customization.

A workflow is comprised of an interplay of these elements:

Inventory Record Stage Change

Transitions a record into another stage.

Workflow State Change

Transitions the workflow into another workflow state.

User Action

Creates a button that performs an action on behalf of the user.

Approval

Display a preconfigured message users in the selected approval group.

Broadcast

Send email notifications to users in selected groups.

Condition Branch

Allows diverging paths based on conditional requirements.

Wait

Creates a time condition for displaying next available action.

Run Workflow

Triggers another workflow indicated by select workflow to run, allowing you to chain workflows.

Webhook

When a workflow reaches a webhook step, the workflow will pause. Listen for a POST request to resume the workflow.

HTTP Request

Send a HTTP request.

End

Designates the end of your workflow.

Configure conditional requirements for the following step types:

  • Inventory Record Stage Change optional

  • User Action optional

  • Approval required

  • Broadcast required

  • Condition Branch required

  • Wait required

  • HTTP Request optional

Workflow states are statuses unique to a specific workflow, discrete from record stages.

Add workflow states by either while configuring a Workflow State Change step, or via the Settings page.

Manage record stages

(Scroll down for the full instructions.)

Learn more …


Try it live on the next page.

Record stages are manipulated via workflow transitions and are used to track the progress of records through your organization’s record lifecycles.

Add record stages

  1. In the left sidebar, click Settings.

  2. Under Inventory, select Inventory Record Stages.

  3. Click on the inventory record type you want to add stages for.

  4. Click Add Stage.

  5. Provide a stage name and a stage description, then assign a color to the stage.

  6. When you are done, click Save to apply your changes.

Add a model stage

  1. Select the Model inventory record type.
  2. Click Add Stage.
  3. Provide a stage name and a stage description, then assign a color to the stage.
  4. When you are done, click Save to apply your changes.

When you’re done, click to continue.

Configure custom workflows

(Scroll down for the full instructions.)

Learn more …


Try it live on the next pages.

For more assistance configuring workflows, refer to our Workflow configuration examples.

Set up workflows to match your organizational needs. Workflows can be as simple or as complex as required, with multiple and discrete workflows supported for unique triggers and scenarios.

To set up a new custom workflow, you’ll need to complete these four steps in sequence:

  1. In the left sidebar, click Settings.

  2. Under Governance, select Workflows.

  3. Click Add Workflow.

  4. Select the workflow target type to add:

    • Inventory Record — Workflows that apply to records in your inventory.
    • Artifact — Workflows that apply to logged artifacts.

Add record workflows

  1. Enter in a title and a description the workflow.

  2. Select the record type this workflow applies to.

  3. Under workflow start, select when the workflow should be initiated:

  • Manually — Start this workflow manually.
  • On Inventory Record Registration — Start this workflow when a record is registered in your inventory.
  • On Field Change — Start this workflow on a change to a specific record inventory field. To configure, select a field under inventory record field to monitor.
  • Via Webhook — Start this workflow when a webhook event is received.

  1. Under workflow expected duration, define the SLA for the workflow based on the start date in days, weeks, months, or years.

  2. Click Save Draft to save your blank workflow, and then configure your workflow steps.

Add artifact workflows

  1. Enter in a title and a description the workflow.

  2. Select the artifact type this workflow applies to.

  3. Under workflow start, select when the workflow should be initiated:

  • Manually — Start this workflow manually.
  • On Artifact Registration — Start this workflow when a artifact is logged on a record.

  1. Select the artifact type

  2. Under workflow expected duration, define the SLA for the workflow based on the start date in days, weeks, months, or years.

  3. Click Save Draft to save your blank workflow, and then configure your workflow steps.

To add or edit workflow steps:

  1. In the left sidebar, click Settings.

  2. Under Governance, select Workflows.

  3. Click on the workflow you’d like to modify, then:

    • For workflows that start when a webhook is received, double-click the Start node to configure the webhook.
    • To add a step, drag and drop a new step onto the canvas.
    • Double-click the new step to open up the configuration modal.

  4. After you’re finished with step configuration, click Update Step to apply your changes.

  5. After you’ve configured a step, you can then link your workflow together.

Start the workflow

To initiate the beginning of your workflow:

  1. Locate the Start of your workflow.

  2. Drag from the at the bottom of Start to the top on the first step of your workflow.

  3. Continue with linking the rest your steps together.

To link subsequent steps together:

  • Click the below or to the right or left of the earlier step and drag it to connect to the top on the subsequent step.
  • You’re also able to link several different steps together at various points in the workflow, including stages that may circle back to previous steps.

End the workflow

When all your workflow steps have been linked together:

  1. Designate the end of your workflow by dragging an End step onto the canvas.

  2. Link relevant previous steps to the End step by clicking on the bottom of those steps, and dragging to the top of the End step.

  3. When you are finished configuring your workflow, click Save to apply your changes.

Once you are satisfied with the setup of your workflow, publish the workflow for use:

  1. In the left sidebar, click Settings.

  2. Under Governance, select Workflows.

  3. Hover over the workflow you want to publish.

  4. Under the actions column, click and select Publish Workflow.

  5. Click Yes, Publish to confirm the publication of the workflow.

Once a workflow is published, it cannot be reverted to draft status.

You can continue to make changes to published workflows by creating new versions of workflows.

Add a model workflow

  1. Click Add Workflow.
  2. Select Inventory Record under workflow target.
  3. Enter in a title and a description the workflow.
  4. Under record type, select Model.
  5. Under workflow start, select Manually.
  6. Under workflow expected duration, define the SLA for the workflow.
  7. Click Save Draft to save your blank workflow.

When you’re done, click to continue.

Configure & link workflow steps

  1. Click on the workflow you added earlier, then:
    • To add a step, drag and drop a new step onto the canvas. For example: User Action
    • Double-click the new step to open up the configuration modal.
  2. After you’re finished with step configuration, click Update Step to apply your changes.
  3. After you’ve configured a step, link your example workflow together:
    • Locate the Start of your workflow.
    • Drag from the at the bottom of Start to the top on the step you added previously.
  4. Designate the end of your workflow by dragging an End step onto the canvas.
  5. Link your previous step to the End step by clicking on the bottom of that step, and dragging to the top of the End step.
  6. Click Save to apply your changes.

When you’re done, click to continue.

Publish workflow

  1. Hover over the workflow you added earlier.
  2. Under the actions column, click and select Publish Workflow.
  3. Click Yes, Publish to confirm the publication of the workflow.

When you’re done, click to continue.

Run workflows manually

Learn more …


Try it live on the next page.

To initiate workflows manually:

  1. In the left sidebar, click Inventory.

  2. Select a record or find your record by applying a filter or searching for it.

  3. On the landing page of your record, locate the Workflows section.

  4. Click See All Workflows.

  5. Select Run Workflow for the workflow you’d like to initiate, then select your desired workflow start option:

    • Run Now — Workflow starts instantly.
    • Scheduled Run — Set a future date to run the workflow.

  6. Click Run Workflow Now to confirm.

  1. On the details page of your artifact, locate the Workflows section.

  2. Click See All Workflows.

  3. Select Run Workflow for the workflow you’d like to initiate, then select your desired workflow start option:

    • Run Now — Workflow starts instantly.
    • Scheduled Run — Set a future date to run the workflow.

  4. Click Run Workflow Now to confirm.

Initiate a model workflow

  1. Select the name of your model you registered for this course to open up the model details page.
  2. On the landing page of your model, locate the Workflows section.
  3. Click See All Workflows.
  4. Select Run Workflow for the workflow you configured earlier, then select Run Now under workflow start.
  5. Click Run Workflow Now to confirm.

When you’re done, click to continue.

Reset & abort workflows

(Scroll down for the full instructions.)

Learn more …


Try it live on the next page.

As an administrator, you may need to reset or abort workflows as required:

To reset a workflow to the beginning:

On records

  1. In the left sidebar, click Inventory.

  2. Select a record or find your record by applying a filter or searching for it.

  3. On the landing page of your record, locate the active workflows section.

  4. Click on the name of the workflow you’d like to reset to open that specific workflow’s details.

  5. On the workflow’s detail modal, click on the in the top-right hand corner and select Abort Workflow.

  6. On the confirmation page, toggle restart workflow after aborting on, then click Yes, Abort Workflow to restart your workflow.

On artifacts

  1. On the details page of your artifact, locate the active workflows section.

  2. Click on the name of the workflow you’d like to reset to open that specific workflow’s details.

  3. On the workflow’s detail modal, click on the in the top-right hand corner and select Abort Workflow.

  4. On the confirmation page, toggle restart workflow after aborting on, then click Yes, Abort Workflow to restart your workflow.

To cancel a run of a workflow:

On records

  1. In the left sidebar, click Inventory.

  2. Select a record or find your record by applying a filter or searching for it.

  3. On the landing page of your record, locate the active workflows section.

  4. Click on the name of the workflow you’d like to abort to open that specific workflow’s details.

  5. On the workflow’s detail modal, click on the in the top-right hand corner and select Abort Workflow.

  6. On the confirmation page, make sure restart workflow after aborting is untoggled, then click Yes, Abort Workflow to abort your workflow.

On artifacts

  1. On the details page of your artifact, locate the active workflows section.

  2. Click on the name of the workflow you’d like to abort to open that specific workflow’s details.

  3. On the workflow’s detail modal, click on the in the top-right hand corner and select Abort Workflow.

  4. On the confirmation page, make sure restart workflow after aborting is untoggled, then click Yes, Abort Workflow to abort your workflow.

Reset a model workflow

  1. Select the name of your model you registered for this course to open up the model details page.
  2. On the landing page of your model, locate the active workflows section.
  3. Click on the name of the workflow you manually initiated earlier to open that workflow’s details.
  4. Click on the in the top-right hand corner and select Abort Workflow.
  5. Toggle restart workflow after aborting on, then click Yes, Abort Workflow to restart your workflow.

When you’re done, click to continue.

Manage regulations & policies

ValidMind Document Checker

Learn more …

The ValidMind Document Checker is a compliance tool that reviews documents against a selected regulatory standard. Use the Document Checker to identify gaps, generate actionable recommendations, and focus your efforts on areas that require attention. The Document Checker uses a structured checklist to:

  • Assess whether required information or evidence is clearly documented or attached
  • Identify missing or weak areas in the document
  • Offer guidance on how to improve clarity, completeness, and compliance
  • Ensure consistency with regulatory expectations for risk and governance


Learn how to customize the regulations and policies available to the Document Checker on the next pages.

Add regulations & policies

(Scroll down for the full instructions.)

Learn more …


Try it live on the next page.

Regulations or policies contain assessments, a set of questions against which your document is checked.

  1. In the left sidebar, click Settings.

  2. Under Governance, select Regulations & Policies.

  1. Click Add Regulation or Policy to create a new regulation or policy.

  2. Provide the details for your regulation or policy:

    • regulation or policy name
    • (Optional) description

  3. Click Add Regulation or Policy to create your regulation or policy.

Add a regulation or policy

  1. Under Governance, select Regulations & Policies.
  2. Click Add Regulation or Policy to create a new regulation or policy.
  3. Provide a regulation or policy name and an optional description.
  4. Click Add Regulation or Policy to create your regulation or policy.

When you’re done, click to continue.

Add assessments

Learn more …


Try it live on the next page.

Regulations and policies can contain multiple assessments. Assessments are composed of questions against which your document is checked.

  1. In the left sidebar, click Settings.

  2. Under Governance, select Regulations & Policies.

  3. Select the regulation or policy you want to add an assessment for by clicking on it.

  1. Click Add Assessment to create a new assessment.

  2. Provide the details for your assessment:

    • assessment name
    • assessment type — Development (Development, Monitoring, and custom document types) or Validation (Validation type documents only)
    • document type — Select the document types that this assessment should be available for.
    • (Optional) description

  3. Click Add Assessment to create your assessment.

Add an assessment

  1. Under Governance, select Regulations & Policies.
  2. Select the regulation or policy you added in the previous step by clicking on it.
  3. Click Add Assessment to create a new assessment.
  4. Provide an assessment name, then select the assessment type and document type.
  5. Click Add Assessment to create your assessment.

When you’re done, click to continue.

Add assessment questions

Learn more …


Try it live on the next page.

Select the assessment you want to add questions to by clicking on it:

  1. Click Add Question to create a new question.

  2. Enter in the questions:

    • Each line without a break (enter) is considered one complete question. Empty lines will be ignored.
    • To add a separate question, press enter to start a new line.
    • Questions will be added in the order they appear.

    As you enter questions, the count of questions will update.

  3. Click Add # Question(s) to insert questions into the assessment.

Add an assessment question

  1. Under Governance, select Regulations & Policies.
  2. Select the regulation or policy you added previously by clicking on it.
  3. Select the assessment you added previously by clicking on it.
  4. Click Add Question to create a new question.
  5. Enter in the questions.
  6. Click Add # Question(s) to insert questions into the assessment.

When you’re done, click to continue.

Configure attestations

Work with attestations

(Scroll down for the full instructions.)

Learn more …

Attestation enables submitters, reviewers, and approvers to formally certify, review, and sign off on model attributes at specific points in time, supporting compliance and governance processes.

Attestation periods are typically scheduled quarterly or annually and should be configured to align with regulatory or internal review cycles.

By default, attestations include the model name. Add additional model inventory fields as needed.

Attestation questionnaires should confirm that key controls, governance processes, and documentation requirements have been followed.


Learn how to set up attestations on the next page.

Set up attestations

(Scroll down for the full instructions.)

Learn more …


Try it live on the next page.

  1. In the left sidebar, click Settings.

  2. Under Governance, select Attestation Templates.

  3. Click Add Attestation Template.

  4. Enter a name and description for the attestation template.

  5. Click Add Attestation Template.

  6. Complete the required sections.

Add attestation periods

  1. Click Add Attestation Period.

  2. Enter a name for the attestation period, such as Quarterly attestation.

  3. Set the start date for the attestation period.

  4. Set the end date when the attestation period ends.

  5. Click Add Period.

Assign attestation participants

  1. Under Attestation Participants, select the submitter from the model stakeholders dropdown.

  2. Select the reviewer from the roles dropdown.

  3. Select the approver from the roles dropdown.

  4. Click Save.

Set inventory scope

  1. Under Inventory Scope, click Add Rule to add a filter condition.

  2. Configure your filter rules and groups as needed.

  3. Click Save.

Add attestation fields

  1. Under Relevant Attestation Fields, drag model inventory fields between columns:

    • Model Inventory Fields — Available fields from the model inventory
    • Relevant Attestation Fields — Selected fields to display in model snapshots

  2. Optional: Reorder the fields to change how they display in the attestation.

Add questionnaire fields

  1. Under Questionnaires, click Add Field.

  2. Configure the field type, label, description, help text, and whether it is required.

  3. Click Add Field.

  4. Repeat to add additional fields as needed.

Add an attestation

  1. Click Add Attestation.
  2. Enter a name and description for the attestation.

When you’re done, click to continue.

Configure an attestation

Click on the name of the attestation you added previously to configure it:

  1. Click Add Attestation Period and add a period.
    • Enter in the name, start date, and end date.
    • Click Add Period.
  2. Under Relevant Attestation Fields, drag fields into the Relevant Attestation Fields column to display in model snapshots.
  3. Under Questionnaire Template, click the template area to edit, then click Save to apply your changes.

When you’re done, click to continue.

In summary

​ValidMind for model risk management

In this third module, you learned how to:


Continue your platform administration journey with:

Organizational Oversight & Reporting