Tutorial | Custom Pages Designer

Get started

Let’s create a new page in Dataiku Govern using the Custom Pages Designer.

Objectives

In this tutorial, you will:

• Create a new custom page with an artifact table.

• Configure a matrix view for a custom page.

• Make the page visible (Optional).

Prerequisites

To complete this tutorial, you will need:

• Dataiku Govern version 13.3 or later.

• An Advanced Dataiku Govern license.

• A Full Designer or Governance Manager profile.

Important

To create a custom page, you must also be familiar with blueprints and the Blueprint Designer.

Create a page

Let’s start by adding a new page to your instance.

1. From the top navigation bar of the Govern node, go to waffle > Custom Pages Designer.

2. Click Create Page.

3. In the Name field, type Custom Govern Project Page. The Page ID will be automatically populated and can be edited here. Once the page is created, the ID will no longer be editable.

4. Next to Icon, click on New to open a selection of icons. Select any icon.

5. Click Create.

This adds a new, hidden page to your instance.

Tip

After creating a page, you can drag and drop its position in the left menu. This will change the order of pages in the navigation bar.

Configure the artifact table

The Content Display Type will dictate how your page will look! Let’s begin by setting up an artifact table.

1. Next to Content Display Type, keep Artifact table selected.

2. In Table settings under Filters, select the Govern project blueprint.

   Note

   This limits the table to only Govern projects. You can select multiple blueprints in the filter if you want multiple different items to appear on your page.

3. In the Columns section, notice that two columns are set by default. Then, click on + Add Column.

We will keep the new column as a Views column.

Add view and view mapping

In order to display a view in a column, you need to configure a view mapping.

1. Name the new column Business initiative.

2. In the nested Blueprint dropdown, select Govern project (if not already done).

   Note

   Your options are limited to the blueprints you selected before under Filters.

3. In the View dropdown, select Business initiative.

4. Click Save.

Enable row editing

If you want to be able to edit an item directly from the table — in the case, a Govern project — you can add an edit button to the table.

1. Click + Add Column.

2. Change the Column type to Edit row button.

3. Name the column Edit.

4. Click Save.

View your page

In the navigation bar, you will see that your page is grayed out. This is because it is not yet visible to non-admin users! However, we can still preview what the page looks like.

Hint

If you aren’t seeing your new page, click on the dropdown arrow at the far right of the navigation bar.

Add a matrix view

Now we’ll add a matrix view to our custom page.

1. In the Custom Pages Designer, navigate to the Custom Govern Project Page.

2. In the Content Display Type dropdown, choose Artifact table and matrix.

3. Keep the table settings configured previously.

4. Under Matrix settings, leave the Matrix Label blank.

5. Choose Risk score for the X Axis Field and Value score for the Y Axis Field.

6. Under Matrix Zones, select the Risk Matrix theme coloring.

7. Click Save.

Tip

Navigate to the page to view your changes. You can also practice editing table rows in your custom page by clicking the pencil icon in that row.

Activate the page (optional)

If you want to practice activating your page:

1. At the top of the page settings, toggle the Visible option on.

2. Click Save.

Important

Remember, once you make a page visible, anyone on the Dataiku Govern instance can see it! However, you can always hide the page again by turning the Visible setting off, or by hiding the page with the More options menu.

What’s next?

More information is available in the reference documentation on the Blueprint Designer and Custom Pages Designer.