Adding a Notebook Card
Intro
You can create a Notebook Card in Domo. Notebook car
ds are Cards containing text you enter. You can type or paste text in a Notebook Card. You can format text using bold, italics, strikethrough, and numbered and bulleted lists by selecting options in the toolbar. You can also add images, hyperlinks, tables, and dynamic Summary Numbers to Notebook Cards.Video - Notebook Cards
Adding Notebook Content
To add a Notebook Card to Domo,
-
Navigate to the page where you want the Notebook Card to appear.
-
Click
> Create new card.
A dialog appears with a number of card creation options to choose from. -
Tip: You can also open this dialog from anywhere in Domo by selecting
in the app toolbar and selecting Card.
-
Click Notebook.
The Notebook create view appears. -
(Optional) To change the default title, click the title field and replace the text with your desired title text.
-
Enter your text in the blank field.
-
Apply formatting and add tables, hyperlinks, images, and dynamic Summary Numbers as desired.
The following table describes the available toolbar options:
Option
Description
Font Size Picker
Lets you change the font size of selected text. Three sizes are available—Title (largest), Subtitle (second-largest), and Text (smallest).
Styling Options
Lets you change the styling of selected text.
-
Click
to apply bold style to the selected text.
-
Click
to apply italic style to the selected text.
-
Click
to apply strikethrough style to the selected text.
-
Click
to open the color picker for the selected text.
Bulleted List
Adds a bulleted list to the card. When you add a bulleted list, a new bullet item is added each time you hit Enter. To turn off the list, hit Enter or click the icon a second time.
Numbered List
Adds a numbered list to the card. When you add a numbered list, a new list item is added each time you hit Enter. To turn off the list, hit Enter or click the icon a second time.
Horizontal Alignment
Lets you change the horizontal alignment on the page of the line of text that currently contains the cursor. Note that this option is used to change the alignment of just one line, while the Vertical Alignment option changes the alignment of all text on the page. Vertical Alignment
Lets you change the vertical alignment of all the text on the page. Note that this option is used to change the alignment of all text on the page, while the Horizontal Alignment option changes the alignment of just one line. Table
Lets you add a table to the card. When you click this icon, a grid image appears; you can mouse over this image to select the desired number of rows and columns in the table then click the bottom-rightmost square to add the table. In the following example, the user wants a 3x3 table, so he mouses over the grid as shown here:
The user then clicks on the square in the bottom right to add the table.
Tables in Notebook Cards size columns automatically depending on the amount of text entered. You can change column width manually by clicking and dragging on the column borders.
When you click in a table cell, an options icon
appears. Click on this to open an options menu for the table. These options are as follows:
Add column left
Adds a column to the left of the selected row.
Add column right
Adds a column to the right of the selected row.
Delete column
Deletes the selected column.
Add row above
Adds a row above the row with the cursor.
Add row below
Adds a row below the row with the cursor.
Delete row
Deletes the selected row.
Delete table
Deletes the entire table.
Summary Number
Lets you add a dynamically changing Summary Number to this card, similar to those that appear in most cards with charts. You choose the DataSet with data you want to summarize, along with the column and the desired aggregation type. You can also configure display options. Once you have added a Summary Number to your Notebook Card, it will update automatically anytime the data updates. The process for adding Summary Numbers to Notebook Cards is discussed in more detail later in this article. Image Uploader
Opens the Image Uploader tool, which lets you select and upload an image from your computer. JPEGs, PNGs, and GIFs are all supported.
You can delete an image by either selecting it or moving the cursor to the right of it then pressing Backspace/Delete.
Hyperlink
Lets you add a hyperlink to the card. When you add a hyperlink, you can define the action that takes place when a user clicks on it. These actions include either opening a specified web page or opening other content in Domo, either in the same browser tab or in a different tab. This is discussed in more detail later in this article.
-
-
Click Save & Finish when you are finished.
You can close without creating a Notebook Card by clicking the "x" in the top right corner.
After you click Save & Finish, a Notebook Card containing your text is added to Domo.
Defining Hyperlink Actions
When adding a hyperlink to a Notebook Card, you can define the action that occurs when a user clicks on it. These actions may be either of the following:
-
Opening other content in Domo, either in the same browser tab or in a different tab
-
Opening a specified web page
To configure specified Domo content to open when the link is clicked,
-
Open the Notebook Card and go into the editor by clicking Edit in the upper right corner.
-
Click
in the editor toolbar.
-
In Section 1, select the Link to anything in Domo radio button.
-
In Section 2, click the Select Content button.
-
Locate the content you want to open when this card is clicked.
-
Click Save.
-
(Optional) If you want the link to display with custom text, enter the desired text in the Display as field.
-
(Optional) If you want the new content to open in a new browser tab when the card is clicked, check the Open link in a new tab box.
-
Click Save again.
To configure an external web page to open when a card is clicked,
-
Open the Notebook Card and go into the editor by clicking Edit in the upper right corner.
-
Click
in the editor toolbar.
-
In Section 1, select the Link to external web page radio button.
-
In Section 2, in the Web page address field, enter the URL of the page you want to open when the card is clicked.
-
(Optional) If you want the URL to open with a custom name, enter the name in the Display as field.
-
(Optional) If you want the new content to open in a new browser tab when the card is clicked, check the Open link in a new tab box.
-
Click Save again.
Adding Summary Numbers
You can add a Summary Number to your Notebook Card referencing a given DataSet column. Thereafter, anytime the underlying data changes, the Summary Number will change automatically. To add a Summary Number, you choose the DataSet with data you want to summarize, along with the column and the desired aggregation type. If you want, you can filter your selected column as well as configure display options. Once you have added a Summary Number to your Notebook Card, it will update automatically anytime the underlying data updates.
Personalized Data Permissions (PDP) are respected when adding Summary Numbers to Notebook Cards. For more information about PDP, see Personalized Data Permissions (PDP).
To add a Summary Number to a Notebook Card,
-
Open the Notebook Card and go into the editor by clicking Edit in the upper right corner.
-
Click
in the editor toolbar.
This opens the Create Summary Number dialog, in which you set all of the options for your Summary Number. -
In Section 1, do the following:
-
In the DataSet field, select the DataSet containing the column you want to derive your Summary Number from.
-
(Optional) In the Label field, enter a description that will appear when a user hovers over the Summary Number.
-
In the Data to summarize menu, select the DataSet column you want to derive your Summary Number from.
-
In the Displayed by field, select how you want the data to be aggregated.
For example, if your Summary Number is to reflect a monetary value, you would probably want to select Sum or Average. -
(Optional) If you want to filter the values in the column, click Add Filter, choose the column you want to filter on, then configure your filters.
Filter options differ depending on the type of data you're filtering.-
(Conditional) If the selected column contains series data,
-
Select the checkboxes for each series you want to pass your filters.
You can select all of the checkboxes by clicking All or deselect all of the checkboxes by clicking None.
You can filter the series that appear in the list by entering a keyword or a string of characters found in a keyword in the Filter by field. -
Specify whether the items you have checked appear or do not appear in your chart by selecting In or Not In from the menu in the top right.
-
Click Apply.
-
-
(Conditional) If the selected column contains amount data,
-
Do one of the following:
-
If you want to filter amounts based on a range...
-
Leave the dropdown menu in the upper right corner set to Range.
-
Select a condition statement from the menu.
One or more fields may appear, depending on the condition statement. -
(Conditional) If one or more fields appeared when you selected a condition statement, enter the desired amounts in the fields.
For example, if you wanted your Summary Number to reflect amounts between 200,000 and 300,000, you would select is between from the menu, enter "200,000" in the first field, and enter "300,000" in the second field.
-
-
If you want to filter amounts based on specific values from your DataSet...
-
Select Selection in the dropdown menu in the upper right corner.
-
Check the boxes for all of the values you want to filter on.
You can select all of the checkboxes by clicking All or deselect all of the checkboxes by clicking None. Or you can filter the values that appear in the list by entering a string of numbers in the Filter by field. Finally, you can specify whether the items you have checked appear or do not appear in your chart by selecting In or Not In from the menu in the top right.
-
-
-
Click Apply.
-
-
(Conditional) If the selected column contains date data,
-
Do one of the following:
-
If you want to filter dates based on a range...
-
Leave the dropdown menu in the upper right corner set to Range.
-
Select a condition statement from the menu.
One or more fields may appear, depending on the condition statement. -
Enter the desired dates in the fields as necessary.
For example, if you wanted your Summary Number to reflect dates between 1-31-2014 and 4-30-2015, you would select is between from the menu, select January 1, 2014 in the first field, and select April 30, 2015 in the second field.
-
-
If you want to filter dates based on specific dates from your DataSet...
-
Select Selection in the dropdown menu in the upper right corner.
-
Check the boxes for all of the dates you want to filter on.
You can select all of the checkboxes by clicking All or deselect all of the checkboxes by clicking None. Or you can filter the dates that appear in the list by entering a filter string in the Filter by field. (For example, if you wanted to filter down to dates from 2010, you would enter "2010" into this field.) Finally, you can specify whether the dates you have checked appear or do not appear in your chart by selecting In or Not In from the menu in the top right.
-
-
-
Click Apply.
-
-
-
-
In Section 2, do the following:
-
In the Display as field, select the desired number format for the Summary Number.
If you select Number, no special format is applied to the number. If you select Currency, a currency symbol will be appended to the number. If you select Percentage, a percent symbol will be appended. -
Do one of the following:
-
If you selected Number or Percentage in the previous step, choose the desired number of decimals in the Decimals menu.
-
If you selected Currency in the previous step...
-
Select the desired currency symbol in the first dropdown menu.
-
Select the desired number of decimals in the Decimals menu
-
-
-
(Optional) If you want to abbreviate the number (e.g. "200,000" becomes "2K"), check the Abbreviate box.
-
(Optional) If you want to use commas to separate thousands in the number, check the Use thousands separator box.
-
Click Save.
-