/ Oracle CRM On Demand Dashboards / Michael D. Lairson / 174 534-3  Oracle CRM On Demand Dashboards / Oracle CRM On Demand Dashboards / Michael D. Lairson / 174 534-3 Chapter 5: Dashboard Objects  Once you have located the correct URL and have copied it to your Clipboard, you can go back to your Dashboard Editor screen and add the Link or Image object to your layout and paste in the URL. Be sure to provide a caption in the Caption field and select the New Window target.  One thing that you will inevitably notice, and will wonder how to change, is the border that always appears around the link or image on the dashboard. Unfortunately, there seems to be no way to remove this border as of this writing. Even with the column and section borders removed, the border around the Link or Image object remains. There are no options offered for formatting the border within the Link or Image properties, so it would seem that we must learn to live with this border for now. The only option that I have found here is to add a background color to the section containing the Link or Image object, but this is probably less desirable than the border.  Click the Rename button on the Link or Image object on your dashboard layout to open the Rename window. This Rename window, shown in Figure 5-15, is different from the Rename window on the Section object. Notice that there is no option here to display the heading on the dashboard. In fact, renaming the Link or Image object only changes the object name shown on the Dashboard Editor screen. The name does not appear anywhere else.  The final option on the Link or Image Object window is the Delete button. If you click the Delete button on the Link or Image object, the object is immediately removed from the dashboard layout. You do not receive a confirmation dialog, so take care that you do not accidentally delete your Link or Image object with a stray click.  Rename window (Link or Image object) Please purchase PDF Split-Merge on www.verypdf.com to remove this watermark. / Oracle CRM On Demand Dashboards / Michael D. Lairson / 174 534-3  Oracle CRM On Demand Dashboards / Oracle CRM On Demand Dashboards / Michael D. Lairson / 174 534-3 Chapter 5: Dashboard Objects   There is nothing surprising about the Text object. It is as simple as you would expect it to be, but is a useful object nonetheless. Any time you are building out a dashboard and want to offer some instructions to the users, provide some information about the contents of the dashboard, or just put some boilerplate text on the dashboard, the Text object is just what you need. Add the Text object to the dashboard in the same way you would add any other object: drag it from the Dashboard Objects list to a section on the dashboard layout.  Click the Properties button on the text object to open the Text Properties window shown in Figure 5-16. Enter your text into the top portion of this window. This text field is not an HTML text field—HTML tags are not recognized here. If you desire bold, italic, or underlined text, you must use the tags provided by the buttons above the text field. The formatting buttons above the text field allow you to add formatting tags to your text. The B button inserts the start and end tags for bold text. These tags are similar to, but are not standard, HTML tags. The formatting tags work like HTML tags in that there is a start tag and an end tag, and any text between the tags is formatted according to the tag type. The exception to this is the Line Break tag, which does not require an opening tag. Table 5-1 shows the available text-formatting tags.  Text Properties window Please purchase PDF Split-Merge on www.verypdf.com to remove this watermark. / Oracle CRM On Demand Dashboards / Michael D. Lairson / 174 534-3  Oracle CRM On Demand Dashboards / Oracle CRM On Demand Dashboards / Michael D. Lairson / 174 534-3 Chapter 5: Dashboard Objects  There are two ways to enter these format tags into the text field. You can type them in directly, or use the buttons. If you use the buttons, you should first highlight the text you want to format, and then click the button to add the tags. The opening tag will be inserted before the highlighted text, and the closing tag will be inserted after the highlighted text. You can apply multiple tags and nested tags to format text that is bold and italic; bold and underlined; italic and underlined; bold and underlined; or bold, italic, and underlined. Consider the example shown in Figure 5-17 where all of the tags are being used. Compare the text entry field with the preview below it.    Bold [b] [/b] Italic [i] [/i] Underline [u] [/u] Line Break [br/]  Text Object Format Tags  Sample Text object formatting Please purchase PDF Split-Merge on www.verypdf.com to remove this watermark. / Oracle CRM On Demand Dashboards / Michael D. Lairson / 174 534-3  Oracle CRM On Demand Dashboards / Oracle CRM On Demand Dashboards / Michael D. Lairson / 174 534-3 Chapter 5: Dashboard Objects   Click the Rename button on the Text object on your dashboard layout to open the Rename window. This Rename window, shown in Figure 5-18, is different from the Rename window on the Section object, and exactly like the Rename window on the Link or Image object. There is no option here to display the heading on the dashboard; renaming the Text object only changes the object name shown on the Dashboard Editor screen. The name does not appear anywhere else.  The Delete button on the Text object, like the Delete buttons on the other objects we have examined, immediately and without confirmation, removes the Text object from your dashboard layout. You do not receive a confirmation dialog, so take care that you do not accidentally delete your Text object unintentionally.  The Folder object lets you place a report folder on your dashboard, providing access to all of the reports in that folder from the dashboard. Users do not need to navigate to the Reports tab to access reports. With a Folder object on your dashboard, you can embed some or all of the reports from the CRM On Demand report library into your dashboard as links. The reports are presented in folders that may be opened and closed on the dashboard screen. Add the Folder object to your dashboard by dragging it from the Dashboard Objects list to a section on the Dashboard Editor screen.  The Folder Properties window (see Figure 5-19) that opens when you click the Properties button on the Folder object is quite simple. To set up a folder link on your dashboard, you first need to identify the report folder that you are interested in displaying. Do this by clicking the Browse button to open the Choose Folder window. This window displays the Shared Folders, which includes the Company Wide Shared Folder and the Pre-Built Analysis Folder. You can select one of these top-level folders or drill down deeper into the folder structure and select a subfolder. You will not find individual reports listed here, only the folders, and you must select a folder in order to display anything in the Folder object on the dashboard.  Rename window (Text object) Please purchase PDF Split-Merge on www.verypdf.com to remove this watermark. / Oracle CRM On Demand Dashboards / Michael D. Lairson / 174 534-3  Oracle CRM On Demand Dashboards / Oracle CRM On Demand Dashboards / Michael D. Lairson / 174 534-3 Chapter 5: Dashboard Objects  The folder you select to display on your dashboard will include all subfolders and reports in the folder. If you select a folder that contains no subfolders, then only reports appear in the folder on the dashboard, just as you would expect. When you click a folder displayed in the dashboard, the section expands so you can see the subfolders and reports within that folder. You can continue to drill down into folders, and the section will continue to expand. You can choose to present the report folder collapsed (the default) or already expanded in the dashboard. Make this selection using the Expand check box on the Folder Properties window.  If you add multiple Folder objects to the same section of the dashboard, the folders appear stacked on top of one another in a single cohesive folder structure. This permits you to present a custom order of the folders if you like, or have a series of report folders, some expanded by default and others collapsed by default. One interesting thing that I have discovered with Folder objects is that the Arrange Horizontally option on the Section object does not have any effect when a Folder object is included in the section. If you want to include objects in your dashboard that appear beside a Folder object, you will need to split the column and use separate sections in multiple columns.  Click the Rename button on the Folder object on your dashboard layout to open the Rename window. This Rename window, shown in Figure 5-20, is different from the  Folder Properties window  Rename window (Folder object) Please purchase PDF Split-Merge on www.verypdf.com to remove this watermark. / Oracle CRM On Demand Dashboards / Michael D. Lairson / 174 534-3  Oracle CRM On Demand Dashboards / Oracle CRM On Demand Dashboards / Michael D. Lairson / 174 534-3 Chapter 5: Dashboard Objects  Rename window on the Section object. Notice that there is no option here to display the heading on the dashboard. In fact, renaming the Folder object only changes the object name shown on the Dashboard Editor screen. The name does not appear anywhere else.  The final option on the Folder object is the Delete button. If you click the Delete button on the Folder object, the object is immediately removed from the dashboard layout. This does not affect the actual report folders—it only affects the dashboard. You do not receive a confirmation dialog, so take care that you do not accidentally delete your Folder object with a stray click.  Similar to the Guided Navigation property, Guided Navigation links add a bit of logic to the dashboard by controlling whether or not a hyperlink appears on the layout. This is implemented in exactly the same way as the section property in that a report request is used to determine if a link appears or does not appear on the dashboard. Begin by adding the Guided Navigation Link object to the layout by dragging it from the Dashboard Objects list to a section on the dashboard.  In Figure 5-21 you see the Guided Navigation Link Properties window that opens when you click the Properties button on the Guided Navigation Link object. The instruction at the top of this window indicates that you should “specify a Source Request to create a conditional Guided Navigation link. The link will always appear if no Source Request is referenced.” This means that if you just fill out the Link Properties section of this screen, it is no different from using the Link or Image object to create the navigation link. The first field on this window is a radio button selector indicating if a source request should or should not be referenced. The default setting here is No. That means any link identified further down this window will always appear in the dashboard, as it is not referencing another source request. If this is what you want, you probably would have selected the Link or Image object rather than the Guided Navigation Link object. If a source request is referenced by the Guided Navigation link, the link will only display if the specified criteria are met. Select a source request in the Source Request field by clicking the Browse button and selecting a report from the Shared Folders. Next, determine when the navigation link should appear on the dashboard. Your choice is to make it appear either when the source request returns rows or when the source request returns nothing. Please purchase PDF Split-Merge on www.verypdf.com to remove this watermark. / Oracle CRM On Demand Dashboards / Michael D. Lairson / 174 534-3  Oracle CRM On Demand Dashboards / Oracle CRM On Demand Dashboards / Michael D. Lairson / 174 534-3 Chapter 5: Dashboard Objects  So when would you use something like a Guided Navigation link? Perhaps you have a Sales Performance dashboard that includes a link to a report of active opportunities that are due for follow-up when opportunities exist with past due activities. If there are no past due activities on opportunities, the link accesses a list of new leads ready for attention. Essentially, with something like this, you are helping direct users to the type of activity that they should be doing. If they have past due activities, those should be addressed before they pick up new leads. Setting up the Guided Navigation link requires a simple report that will return rows or not return rows based on the filters that you set up in the report. This report does not need to be designed for viewing if its only purpose is to drive the result of a Guided Navigation link decision. This report can be a simple report that includes only a single column and the necessary filters. Look back to Figure 5-3 for an example of this type of simple analysis. In that example, I am determining if large open opportunities exist, so I have added the # of Opportunities metric column and two filters. One filter eliminates all opportunities that are closed, and the other filter eliminates all opportunities that are less than one million dollars in revenue. The result is either no results or a single row with the number of open opportunities with more than one million in revenue.  Guided Navigation Link Properties window Please purchase PDF Split-Merge on www.verypdf.com to remove this watermark. / Oracle CRM On Demand Dashboards / Michael D. Lairson / 174 534-3  Oracle CRM On Demand Dashboards / Oracle CRM On Demand Dashboards / Michael D. Lairson / 174 534-3 Chapter 5: Dashboard Objects  On the Guided Navigation Links Properties window, select the Source Request report that performs the check for records meeting your criteria. If you want the link to appear when the source report returns rows, you will select the If Request Returns Rows radio button. If you want the link to appear when the source report returns no rows, you will select the If Request Returns Nothing radio button. Next, you need to provide the link that will display, or not display, based on the source request results. In the Link Properties section of the Guided Navigation Links Properties window, you have two radio buttons. These are used to identify the type of destination that your link is going to take dashboard users to when they click it. Your first option is Request. This is referring to a report request in Oracle CRM On Demand. Select the Request radio button and rather than enter a URL in the field to the right of the button, you will browse for the desired report. Click the Browse button, and the Choose Request window opens with the Company Wide Shared Folder and Pre-built Analysis Folder listed. Drill down into the folders and select a report. Notice that your personal report folder is not an available option. When you click OK, the URL for the selected report appears in the field. The second option is URL. This option allows you to access any webpage as long as you know the URL for it. For instance, if you want to provide a link to your company home page from the dashboard, you would select the URL option and enter the full URL in the field. The http:// portion of the URL is required. For a link to the Oracle website, for instance, as demonstrated in an earlier section, you would select URL and enter  in the URL field. You can also use a mailto URL here to create a link that initiates a new e-mail message. Enter a URL, such as mailto:mike@email.net?subject=Dashboard, and the resulting hyperlink in the dashboard, when clicked, will open the user’s default e-mail application and create a new message addressed to mike@email.net with a subject of Dashboard. As mentioned previously, if you are familiar with JavaScript, you could also enter some inline JavaScript here. Next, we need to indicate what text should appear as our link in the dashboard. If you select another report as the target, the report name will appear as hyperlinked text by default, with the full URL. You can change this by clicking the Use Dashboard Object Name As Link Text check box. With this check box selected, the text that appears in the dashboard as your link will be the name of the Guided Navigation Link object. You might assume that the Caption field content will appear as the link text, but unlike the Link or Image object, this Caption field is used to display some static text above the link. This gives you the ability to offer some instruction or explanation for the link. There is no real practical limit to how much text you can include as your caption. I have never hit a hard limit here either, but it would be rather unusual to include much more than a sentence or two. Please purchase PDF Split-Merge on www.verypdf.com to remove this watermark. / Oracle CRM On Demand Dashboards / Michael D. Lairson / 174 534-3  Oracle CRM On Demand Dashboards / Oracle CRM On Demand Dashboards / Michael D. Lairson / 174 534-3 Chapter 5: Dashboard Objects  Also different from the Link or Image object is the lack of an ability to specify a target for your link. The results of your link will always be opened in the current window, replacing the dashboard. If your destination is a report request, a hyperlink is positioned at the bottom of the resulting window that returns you to the dashboard. Click the Return link, and you are taken back to the previous dashboard. A Return link is not provided for the results of links from the dashboard to a URL. Click OK to close the Guided Navigation Link Properties window and return to the Dashboard Editor screen.  If you want to provide a link to a report, you can use the Request option and browse for the report to select the correct link. There is no browse function for selecting a dashboard, so if you want to provide a Guided Navigation link to another dashboard, you will need to use the URL option and provide the link to the dashboard. To locate the link for the target dashboard, open the desired dashboard on the Dashboard tab. It is important that you open the dashboard on the Dashboard tab and not the preview window that appears when you save the dashboard. Once the dashboard is loaded on the Dashboard tab, and before you click anything else, right-click the blue bar below the Select Dashboard field. Refer back to Figure 5-14 for an example of where to right-click the dashboard to open the menu. If your dashboard contains multiple pages, right-click the blue bar to the right of the tabs. Do not navigate to any of the other pages in the dashboard before right-clicking the blue bar on the dashboard page. When you right-click the dashboard, the context menu appears. Select Properties if you are using Internet Explorer; select This Frame and then View Frame Info if you are using Firefox. On the resulting window, highlight and copy the contents of the Address field to your Clipboard. This is the address for the dashboard content inside the dashboard frame, and is the link you will add to your dashboard to break it out of the frame and open it in a new browser window. Be sure that the address URL is similar to the following example, and don’t let the URL encoding confuse you. Some characters may be URL-encoded, so a / may be represented as %2f: https://secure-ausomxdsa.crmondemand.com/OnDemand/user/analytics/saw .dll?Dashboard&PortalPath=/shared/Company_123456-1ABC2_Shared_Folder/ _portal/Marketing+Quarterly+Initiatives. Once you have located the correct URL and have copied it to your Clipboard, you can go back to the Dashboard Editor screen for the dashboard you are adding the link to and add the Guided Navigation Link object to your layout and paste in the URL. If you want to display the link based on the result of another request, complete the top half of the screen. If you do not base the link on a source request, it will always appear on the dashboard. Please purchase PDF Split-Merge on www.verypdf.com to remove this watermark. / Oracle CRM On Demand Dashboards / Michael D. Lairson / 174 534-3  Oracle CRM On Demand Dashboards / Oracle CRM On Demand Dashboards / Michael D. Lairson / 174 534-3 Chapter 5: Dashboard Objects   By using Guided Navigation links that use the same report as the Source Request report and the link target, if the link appears, you can quite effectively build a report menu that only includes reports that return results. This is useful if you have a number of reports that will often show no results. Unfortunately, as you can see in Figure 5-22, there will be borders around each link. There are no formatting options on the Guided Navigation Link object to remove or change the format of the links. Additional formatting capabilities may be introduced in future releases of Oracle CRM On Demand, but as of this writing, we must live with the default formats on our links. The risk of using Guided Navigation links on your dashboard is that your users might naturally conclude that the dashboard is not functioning properly because links appear and disappear from time to time. I recommend including some explanatory text in a section that will always appear on the dashboard using the Text object.  Click the Rename button on the Guided Navigation Link object on your dashboard layout to open the Rename window. This Rename window is exactly like the Rename window on the Link or Image object. There is no option here to display the heading on the dashboard, but if you have selected the Use Dashboard Object Name As Link Text check box on the Guided Navigation Links Properties window, then the name that you provide here on the Rename window will be the text displayed as the link for the Guided Navigation link on the dashboard.  The Delete button on the Guided Navigation Link object, like the Delete buttons on the other objects we have examined, immediately and without confirmation, removes the Guided Navigation Link object from your dashboard layout. You do not receive a confirmation dialog, so take care that you do not accidentally delete your Guided Navigation Link unintentionally.  Multiple Guided Navigation links on a dashboard Please purchase PDF Split-Merge on www.verypdf.com to remove this watermark. [...]... included in the Saved Content section Personal reports are not permitted on dashboards The concept of a personal dashboard does not exist in Oracle CRM On Demand Any dashboard is available to all users with dashboard access, so exposing a personal report on a public dashboard would only cause an error, if it were possible If you have a personal report that you want to include on your dashboard, you... describing the basics of Answers On Demand and providing some thoughts on particular report configuration options that are most important for the dashboard developer Of course, if you need a more in-depth study of Answers On Demand, my earlier book, Oracle CRM On Demand Reporting (McGraw-Hill, 2008), is a great resource and covers the topic in great detail Rename The Rename button on the Report object in the... dashboard in Oracle CRM On Demand Please purchase PDF Split-Merge on www.verypdf.com to remove this watermark 87 This page intentionally left blank Please purchase PDF Split-Merge on www.verypdf.com to remove this watermark 4 534-3 / Blind folio: 00 Chapter 6 Displaying Reports on the Dashboard 89 Please purchase PDF Split-Merge on www.verypdf.com to remove this watermark 90   Oracle CRM On Demand Dashboards... reports per page Every report object on the dashboard layout has three buttons in the upper-right corner The Properties button, the Rename button, and the Delete button are used to configure the report on the dashboard Next I describe each of the configuration options in detail We will start with the Properties menu When you click Properties you are presented with four options: Display Results, Report Links,... Answers On Demand and save it into a shared folder It is possible to include reports that are in a shared folder, even if that folder has access controls associated with it to block its content to all but certain roles in Oracle CRM On Demand If a user opens a dashboard that contains a report that he or she does not have access to due to report folder access controls, the report will simply not appear on. .. from the report in Excel since the report is outside of Oracle CRM On Demand and Please purchase PDF Split-Merge on www.verypdf.com to remove this watermark D Lairson / 174 534-3 Chapter 6:  Displaying Reports on the Dashboard   maintaining links back into a secure CRM system in a hosted environment would be difficult There are two Download Data options as well Download Data (.csv) and Download Data (.txt)... PDF Split-Merge on www.verypdf.com to remove this watermark 95 96   Oracle CRM On Demand Dashboards dashboard exactly as it would if you ran the report from the Reports tab Because all reports have a Title view and Table view by default, the Show View menu also will always contain the Title 1 and Table 1 options in addition to the Default Compound View In addition, the Show View menu contains all of... shown in Figure 6-2 Embedded In Section For a report embedded in the dashboard section, click the Properties button on the Report object and open the Display Results submenu The Embedded In Section option is likely already selected, as this is the default If it is not selected, click Embedded In Section to select that display option If you make no additional adjustments on the Properties menu, as described... Delete options are presented in their own buttons, and are also described next Figure 6-1 shows the Properties menu opened on a Report object in the Dashboard Editor screen Figure 6-1.  Report Object Properties menu Please purchase PDF Split-Merge on www.verypdf.com to remove this watermark 91 92   Oracle CRM On Demand Dashboards Figure 6-2.  Display Results submenu Display Results The first option in the... chapter can be replicated using the report properties, perhaps with a few more desirable options Also in this chapter is a brief look at Answers On Demand, the report development tool used to create your reports This will certainly not be as complete a look at Answers On Demand as you will find in my book Oracle CRM On Demand Reports (McGraw-Hill, 2008), but it will offer enough of an overview for the developer . / Oracle CRM On Demand Dashboards / Michael D. Lairson / 174 534-3  Oracle CRM On Demand Dashboards / Oracle CRM On Demand Dashboards. watermark. / Oracle CRM On Demand Dashboards / Michael D. Lairson / 174 534-3  Oracle CRM On Demand Dashboards / Oracle CRM On Demand Dashboards