Concept | Governed items#

The result of adding a governance layer to a Dataiku item is a governed item, or, to be more precise a Govern item. The term “Govern item” refers to capital “G” Govern items, as in objects belonging to the Govern node.

Tip

In general usage, you may see references to governed projects, governed models, etc. When a more technical distinction is helpful, you’ll also see references to capital “G” Govern projects, Govern models, etc. Both sets of terminology refer to the same property: an object with a governance layer that belongs to the Govern node.

Finding governed items#

You can browse governed items in two ways:

  • The Governed projects (Governed projects icon.) page

  • The Model (Model registry icon.), Bundle (Bundle icon.), or GenAI (AI icon with stars.) registry pages — filtered for governed items

The Governed projects page has both matrix and Kanban views:

  • The matrix (Matrix view icon.) view plots governed projects based on adjustable axes, such as risk and value.

  • The Kanban (Kanban icon.) view presents governed projects according to workflow stages.

Dataiku screenshot of the matrix view of the Governed projects page.

Documenting governed items#

Dataiku projects themselves have a number of tools for documentation. In addition to project wikis, most objects inside a Dataiku project include space for descriptions in the Details (Details icon.) tab of the right panel.

The Govern node allows you to document items for a different purpose, for a different audience.

  1. Standard Govern items (such as Govern projects, Govern models, etc.) begin with an Overview section. At a minimum, this overview enables you to provide a full description. Overviews for Govern projects allow you to designate sponsors, upload additional files, define geographic and technical scope, assign reviewers, select qualification ratings, and set a schedule.

  2. Going further, the Attachments panel provides a space to upload external files relevant to the governed item.

  3. The Timeline panel automatically records key events in the item’s history.

Dataiku screenshot of the Overview section of a governed project.

Advancing the status of Govern items through a workflow#

Your organization may have its own convention for communicating the status of a Dataiku project. For example, project builders might apply a specific tag, move a project to a certain folder, or just use the discussion tools to communicate.

Many standard Govern items provide a built-in structure to meet this need through designated workflow steps. A workflow is a sequential series of stages to track the progress of a governed item, such as a project, a bundle, or a model version.

A template defines the steps of a workflow. All users have access to the Dataiku Standard templates. Organizations with advanced licenses have the option to define their own custom items, including custom workflows.

The Dataiku Standard template includes the following workflow steps depending on the type of Govern item:

Govern item

Standard template workflow steps

Business Initiative

Ideation, In Progress, Delivered

Govern project

Exploration, Qualification, In Progress, Validation and Roll-out, Delivered

Govern bundle

Review, Signed-off, Production, Retired

Govern model version

Development, Review, Deployment, Production, Offline

Important

Depending on the template at hand, workflow steps can include a sign-off. You’ll learn more in Concept | Sign-offs in workflows of Govern items.

Tip

Open any Govern item, and browse the fields present in its workflow stages. Explore the remaining sections in the item’s left panel to determine what role they could play in your governance strategy.

Dataiku source items vs. Govern items#

Concept | Surfacing Dataiku items in the Govern node introduces how the Govern node fetches key metadata of items from connected Dataiku nodes. By governing a Dataiku item, you add a governance layer to it. In practical terms, on top of a Dataiku source item’s metadata, you’ve created a capital “G” Govern item.

Although connected, items from these two different spheres remain separate entities. The diagram below suggests that Govern items begin with synced metadata from a Dataiku source item. On top of this base, you apply a governance template, which provides space to enrich the item with additional information such as risk ratings, notes, attachments, workflow steps, reviews, etc.

Slide of the information hierarchy in the Govern node.

Tip

For any Govern item, the Source Objects panel details the associated Dataiku item and any related objects.

Pure Govern items#

Not every Govern item must have a Dataiku source object. In the diagram above, Business Initiative M and Govern Project N don’t have an underlying Dataiku source object. They exist only in the Govern node.

  • Business initiatives, a tool to organize Govern projects, are always purely a Govern item.

  • You can create Govern projects directly in the Govern node without an associated Dataiku source project. For example, you might pre-qualify proposals in a Govern project before starting work in a Dataiku Design node. If the Govern project wins approval, you can then attach a Dataiku project to the validated Govern project.

  • If using an advanced license, you might encounter custom items that are also purely Govern items without Dataiku source items.

Deleting Govern items#

Deleting Govern items is one way to make this concept clearer. As shown in the Add a governance layer to Dataiku items section of the basics tutorial, deleting a Govern project doesn’t have any impact on the underlying Dataiku source project. If you’ve deleted a Govern project, you’ve only deleted the information that lives in the Govern node, which might include:

  • Metadata in the item’s Overview

  • Notes in the item’s Workflow

  • Files uploaded as Attachments

  • The history recorded in the Timeline

The same is true for child items of Govern projects. If you delete a Govern model version or a Govern bundle, the actual Dataiku source item remains. You’ve only lost the additional governance information added in the Govern node.

Next steps#

Having explored the value of governed items, try out this process for yourself in Tutorial | Governance basics.