Yellowfin Stories gives you the power to include multiple types of content to your story. This includes text narratives, reports, images and videos. You can add, edit, or delete content in this builder much like any other word processing tool. Stories use the same editing concepts and styles are other web-based tools, such as Medium or Wordpress.
Once you have created a new story in Yellowfin, you're ready to add content.
Add text to provide context to your story:
You can format your text by using a formatting menu, as well as with a combination of your keyboard keys.
Icon | Type | Description | Key combination PC/Mac |
Heading 1 | Converts the entire line of text into a heading. | — | |
Heading 2 | Converts the entire line of text into the sub-heading. | — | |
Quote | Converts the entire line of text into a quote. | — | |
Bold | Makes only the selected text bold. | Ctrl B/Command B | |
Italic | Makes only the selected text italicized. | Ctrl i/Command i | |
Link | Converts the selected text into a link. | — | |
— | Numbered list | Creates a numbered/ordered list. See below for more details. | 1.<space> |
— | Bullet point list | Creates a bullet list. See below for more details. | -<space> or *<space> |
To initiate a numbered list, follow the steps below:
The steps to create or edit a bullet point list are the same as above. However, the keyword combination to activate an unordered list could either be the hyphen key and then the space key, or the asterisk key and space.
You can copy text from your story into another section of the same story. Any formatting on text copied from a story is pasted with the text. However, text copied from an external source will not keep any of its original formatting.
There are three types of report content to stories:
Report data type | Description | Example |
---|---|---|
Live reports | When embedded in a story, a live report is automatically updated with the latest data. If a report has any default filters set, the embedded report is displayed with the same filter settings. You can interact with reports embedded in stories (with or without user prompt filters), including tooltips, drilling, keeping/excluding filtering, brushing and annotation. | Last week's global sales. |
Filtered live reports | From Yellowfin 9.6, some embedded reports can be filtered directly within the story. The embedded reports that can be filtered are those with user prompt filters enabled. That means you can set a report's user prompt filters while editing a story so that your published story displays the filtered report results. The filter details are saved as soon as you click on the Apply button or when you publish a story. Once published, the story, along with any filtered reports embedded within it, is readable only. The user prompt filter controls will no longer be visible and therefore not adjustable. Any filters applied to an embedded report at the time story publishing will be used to display the report data in the published story. Even if the original report is subsequently edited to change those filter values, the published story will not reflect those changes. If you edit a published story, the user prompt filter controls for embedded reports will return. Remember, a report must have at least one user prompt filter enabled for this functionality to be available. See the diagram below the table for further information. | Last week's sales for a particular region. |
Bookmarks | Before Yellowfin 9.6, bookmarks provided a means of filtering live report data. Bookmarks are still available, but live reports with user prompt filters provide the same results with fewer steps. | Last week's sales for a particular region. |
Snapshots | Snapshots are perfect for including report data that cannot be altered in any way. Taking a snapshot is like taking a photo of the existing data — a snapshot in time. | A specific event in your data that you wish to highlight. |
You can add a report, bookmark or snapshot to a story through a pop-up screen while editing your story.
When you add a report, you can choose which item to display for that report:
The elements of this screen are described in the table below.
Element | Description |
---|---|
Select the type of report content you wish to embed. Choose between reports, snapshots and bookmarks, which are described elsewhere on this page. | |
If you know the name of the content you wish to embed, use the search bar to type any part of the name, then click on the magnifying glass to search for matching content. | |
Sort the display of reports by most recent, oldest, alphabetically ascending or alphabetically descending. | |
Change the display of reports between tiles and a list. | |
To the right of the sorting and display options, the screen will show you a count of the total number of items available to embed. | |
These icons may appear under some of the reports shown in the list. It indicates how many charts, snapshots and bookmarks exist with a report. The item displayed in this preview window will only reflect one item available within each report. The steps below explain how to select a different item, such as a different chart from a report with five charts. | |
If you realise you need a new report while editing a story, you can click on the Create new report button to go directly to a new report, saving navigation time. | |
This button will be activated as soon as you have selected an item (a report, a snapshot or a bookmark) from the list of available options. You can select multiple items first, then click on this button to insert them all at the same time (in the order you selected them) |
When you're ready to embed some report content, follow the steps below.
If you wish to change the display of your embedded report, follow the steps below.
Hovering over a report will display a pop-up menu. From the menu, you can resize the report's display size, switch between report views to display in the story, (chart, table or canvas, depending on what content is available), open any available user prompt filters to adjust the content of the report, and view the report in the Report Builder. The toolbar typically looks like this, although some options may alter depending on the content of your report.
For paired buttons such as the display width or type, the active option is dark. Clicking on a gray button activates its functionality and deactivates the paired functionality. For example, clicking on the first gray button shown above would reduce the size of the report, darken the button, and lighten the button next to it. See the table below for further information on the tools available.
Button | Name | Description |
---|---|---|
Original size | This button resizes the report to a smaller size. You can switch between the small or big size of the report. | |
Fit size | This button increases the displayed size of the report (enabled by default). | |
Display chart | This button displays only the report chart. In the case of multiple charts, a popup will appear allowing you to select from the available charts to be displayed. Click here for more details. | |
Display table | This button displays the report table. Fits to the size of the placeholder, and can be scrolled horizontally and vertically if required. | |
Display canvas | This button displays the report canvas (disabled by default, and only available if the added report has a canvas). Size limit: 700 pixels wide x 600 pixels long. | |
Filters | If your report contains user prompt filters, you can create filtered reports directly from your story with this button. Read more about these reports in the content earlier on this page. | |
Maximize | This button redirects you to the report output page, where you can edit the report and re-publish it, if required. The changes will be reflected in a live report added to the story. You can also use this to replace the report with a snapshot or bookmark, or add another item from the same report to your story. Closing the report output page takes you back to editing your story. Learn more here. |
Most of the buttons above are easy to use and don't require steps. However, the last few are described in more detail.
Prior to Yellowfin 9.6, a bookmark was the best way to embed report data with certain filter values always set. Yellowfin 9.6 introduced embedded reports with the option of updating user prompt filters directly from your story, as described earlier on this page.
To use this functionality, your report have must at least one user prompt filter activated. Reports with one or more user prompt filters will display the Filters button in the pop-up menu for embedded reports.
Even if you change the default filter values in the original report, the display of the report embedded in your story will retain the values of any filters you have already set using these steps.
Report items, such as live reports, snapshots and bookmarks can be replaced within a story at any time.
If your report includes more than one chart, you can change which one is displayed when embedded in a story.
The story content will update to display the chart you selected instead.
You can change back to the report table by clicking on the the Display Table tool. |
Sharing hidden content
If you add a secure report that is inaccessible to all your readers, the the story will display a placeholder instead of the report, with a message notifying them of the reason they can't view the report content. See the example below:
Creating a new report
You can create a new report directly from stories by using the Create new report button. If you opt to do this, the live report will be automatically added to the story when you publish it. You can then navigate back to your story by clicking on the Return to Story button at the bottom right corner of the Report Builder page.
Note: while this report is being created, and until it is activated, story author and collaborators would see a placeholder in place of this report. To get back to the report while editing your story, click on the Maximise button for this placeholder.
You can incorporate reports from other reporting tools, such as Tableau, PowerBI, or Qlik, into your Yellowfin story. All you need is the report URL to embed the report. The URL must match the reporting tool and must be valid to display the report.
Before you begin, ensure that you have a proper Yellowfin license that supports the Stories tool and the external content add-on. Users who wish to embed external reports also require an additional user role function, External Content, to be enabled. |
Follow the steps below to add a report from external BI tools.
Click on the plus button at the start of a new line (if you don't see this button, click on a new line: the button will only appear if no text is entered)
Select the Reporting tools button from the pop-up menu
This provides you with a selection of available reporting tool choices
Select a report type from the list that matches the content you'd like to embed in your story (if you select the wrong one, an error will occur when you try to insert the link in the next step)
A popup menu will appear
Paste the shareable link to your external report here — and make sure you have provide the correct link for this to work: if you accidentally provide a link to a PowerBI report while choosing the Tableau option, an error will occur
Click on the Insert button
Once the report appears on the screen, you can resize it, if necessary
To resize the report, hover overit, and when the resize option appears in the bottom right corner, click and drag it to change the size of the embedded report
If you wish to add a caption, click directly under the report to update the grey text
Other story content
Besides text and reports, you can include additional content such as images, videos and even dividers into a story.
Use the Image Manager to locate, manage and add images to your story. See the table at the end of this section for a full description.
Icon | Size option | Description |
---|---|---|
Original | Displays the image in its actual size. This option is only available if the original image width is less than 700 pixels. | |
Fit | Displays the image to fit the story size, which is 700 pixels (that is, the image width will be stretched to 700 px while maintaining the aspect ratio). The image is displayed in this size by default. | |
Wide | The maximum size an image can be displayed in. (This option will stretch the width to 900 pixels, while maintaining the aspect ratio.) |
The Image Manager provides a range of tools for fast and easy management of image files within Yellowfin. See the table below for more details of each of its features.
Feature | Description |
---|---|
Click on the Upload a new image button to upload a new image. Only valid image formats such as JPEG, PNG and GIF can be uploaded. | |
Click on All Images to see all images, and Recent Images to see the most recently used images. Click on My Images to see images you have uploaded. Other users cannot see your images listed in their Image Manager. Click on Corporate Images to see the current pool of corporate images. By default, the Corporate Images folder is read-only for all user roles. To make it accessible to users, system administrators need to edit the relevant user role, expand the Administration section and click on the checkbox for Save Corporate Images. | |
Use the search bar to refine the list of images — useful for anyone who has built a substantial library of images and knows what they're looking for. Type some text and use your Enter key to see the results of your search. | |
Hover over the top right corner of any existing image and click on the blue circle to see an enlarged version of the image. | |
Change the sort order between alphabetic and newest/oldest by clicking on this dropdown. | |
Change the display of images between thumbnail view and list view. |
The Image Manager contains a variety of tools that you might like to take advantage of, including storing images in the Corporate Images area and globally updating images. See our Dashboard Images page for more info. |
You can embed Youtube or Vimeo videos into your story. Here's a simple procedure that explains how to do this:
Note: Although the video image will be displayed in a story while in draft mode, it can only be played when the story is published.
Include a divider in your story to display a horizontal line that's used to divide your story content.
Add data to your Story with the help of NLQ.
3. Select the data you want to use
Once you have added content, such as text, reports, images, or videos, you can drag it to another part of the story. This gives you freedom to restructure your story content after adding it (even highlighted text), saving you the trouble of redoing your story.
A drop indicator will show you the exact location you’re dropping the content to.
You can delete any attached content, such as a report, image, video, etc, by selecting the item and pressing the backspace or delete key.