Skip to main content
waffle.svg
Domo Knowledge Base

Adding a Notebook Card

Version 17

 

Intro

You can create a Notebook Card in Domo. Notebook cards 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.

Note: When you paste text certain formatting may be preserved, including bold, italics, lists, tables, font size, and headings. The formatting that is preserved varies, depending on the source. Typically, formatting associated with basic HTML tags is preserved, although styles may differ. Pasted images are stripped out. If you want to add images, use the Image Uploader.

Video - Notebook Cards

 

Adding Notebook Content

To add a Notebook Card to Domo,

  1. Navigate to the page where you want the Notebook Card to appear.

  2. Click add_pages_icon.png> Create new card.

    A dialog appears with a number of card creation options to choose from.

  3. Tip: You can also open this dialog from anywhere in Domo by selecting in the app toolbar and selecting Card.
  4. Click Notebook.
    The Notebook create view appears.

  5. (Optional) To change the default title, click the title field and replace the text with your desired title text.

  6. Enter your text in the blank field.

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

    notebook_card_styling_new.png

    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

    notebook_card_bullet_list_new.png

    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

    notebook_card_numbered_list_new.png

    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

    notebook_card_horizontal_alignment.png

    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

    notebook_card_vertical_alignment.png

    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

    notebook_card_table_new.png

    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:

    notebook_table_grid_new.png

    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 iconnotebook_card_table_options.pngappears. 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

    notebook_card_summary_number.png

    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

    notebook_card_image_new.png

    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

    notebook_card_hyperlink_new.png

    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.

     

     

  8. 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,

  1. Open the Notebook Card and go into the editor by clicking Edit in the upper right corner. 

  2. Click notebook_card_hyperlink_new.png in the editor toolbar. 

  3. In Section 1, select the Link to anything in Domo radio button.

  4. In Section 2, click the Select Content button. 

  5. Locate the content you want to open when this card is clicked.

  6. Click Save.

  7. (Optional) If you want the link to display with custom text, enter the desired text in the Display as field.

  8. (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.

  9. Click Save again.

To configure an external web page to open when a card is clicked,

  1. Open the Notebook Card and go into the editor by clicking Edit in the upper right corner. 

  2. Click notebook_card_hyperlink_new.png in the editor toolbar. 

  3. In Section 1, select the Link to external web page radio button.

  4. In Section 2, in the Web page address field, enter the URL of the page you want to open when the card is clicked.

  5. (Optional) If you want the URL to open with a custom name, enter the name in the Display as field.

  6. (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.

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

  1. Open the Notebook Card and go into the editor by clicking Edit in the upper right corner. 

  2. Click notebook_card_summary_number.png in the editor toolbar.
    This opens the Create Summary Number dialog, in which you set all of the options for your Summary Number.

  3. In Section 1, do the following:

    1. In the DataSet field, select the DataSet containing the column you want to derive your Summary Number from.

    2. (Optional) In the Label field, enter a description that will appear when a user hovers over the Summary Number. 

    3. In the Data to summarize menu, select the DataSet column you want to derive your Summary Number from.

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

    5. (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,

        notebook_summary_number_series_filter.png

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

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

        3. Click Apply.

      • (Conditional) If the selected column contains amount data,

        notebook_summary_number_amount_filter.png

        1. Do one of the following:

          • If you want to filter amounts based on a range... 

            1. Leave the dropdown menu in the upper right corner set to Range.

            2. Select a condition statement from the menu.
              One or more fields may appear, depending on the condition statement.

            3. (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...

            1. Select Selection in the dropdown menu in the upper right corner.

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

        2. Click Apply.

      • (Conditional) If the selected column contains date data,

        notebook_summary_number_date_filter.png

        1. Do one of the following:

          • If you want to filter dates based on a range... 

            1. Leave the dropdown menu in the upper right corner set to Range.

            2. Select a condition statement from the menu.
              One or more fields may appear, depending on the condition statement.

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

            1. Select Selection in the dropdown menu in the upper right corner.

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

        2. Click Apply.

  4. In Section 2, do the following:

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

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

        1. Select the desired currency symbol in the first dropdown menu.

        2. Select the desired number of decimals in the Decimals menu 

    3. (Optional) If you want to abbreviate the number (e.g. "200,000" becomes "2K"), check the Abbreviate box.

    4. (Optional) If you want to use commas to separate thousands in the number, check the Use thousands separator box.

    5. Click Save

Editing Notebook Cards

See Editing a Notebook Card.