We are excited to announce that Topliners is moving to Cloud Customer Connect! The migration will be complete in July, at which time you can access Oracle Marketing discussions, knowledge and events via Cloud Customer Connect. There will be no changes to your login/profile, content you've authored, nor bookmarks in your followed categories. Redirect links will ensure you quickly and easily find your way to product categories you follow. In addition, you will have access to other Oracle CX-related content.

Please note Topliners will be read only beginning July 25, 2 PM PDT to July 27 9 AM PDT.

Discussions

Interactive Dashboards: Scheduling Reports by Email (4/5)

Helen Lillard-Oracle
Helen Lillard-Oracle Posts: 75 Employee
edited May 2, 2022 6:10AM in Responsys

This is the fourth of five posts I'll be making this month on Interactive Dashboards and Interactive Dashboards Plus. I know that it's important for your teams to be comfortable in the new tool as Insight begins sun-setting, so please follow me to be updated every time I post. And I will be monitoring the comment sections, so if you have questions please feel free to post them! I'll do my best to reply.

UPDATE: You can find a recording of my presentation on Interactive Dashboards on Oracle University

The Catalog

You can open the catalog from the top right hand menu – Catalog. It provides the folder structure within Interactive Dashboards. You’ll spend most of your time in the Shared Folders, where you can see folders for each of the communication channels you have active on your account. And for each channel, there is a subfolder of Reports. Everything else in here is a system folder that you can ignore. But in Reports, you can find a list of all the standard analyses – these are the individual tables, charts or graphs that you see on the Dashboards.

You can open each analysis from the catalog but take note that you won’t have the smart prompts to filter the data and there is no gear icon in the top right corner, so while you can do a lot of the same adjustments – add and rearrange columns, drill and sort – you can’t save or apply a customized view. You can only use customized views if you are looking at the analysis on the dashboard.

Schedule from Catalog.jpg

In the “More” menu for each analysis there is an option to “Schedule” – but please DO NOT use it until further notice. Scheduling from the Catalog will apply a feature that isn’t active yet. Instead, go to the “New” menu in the top right and create an Actionable Intelligence Agent.

New Agent.jpg

Not-So-Secret Agents

I like to think of Agents like James Bond sneaking into the villain’s study, breaking into their computer and forwarding the valuable data to his contacts back at MI6. Whatever helps you remember – Agents are the tools that trigger a report to be run.

The Agents tool is an example of how Interactive Dashboards has a strong roadmap ahead to add functionality. About half of the tabs here are features still being developed and fine-tuned. I’ve indicated in this image which areas you should be concerned with – ignore the rest for now.

Agent Overview.jpg

Schedule (When)

On this tab, you’ll set up when you want the report to run. First select the frequency – as with most scheduling tools in Responsys, you have a lot of flexibility in scheduling options. You can set it to run just once, or on a daily, weekly or monthly basis.

Agent Schedule Frequency.jpg

You select your start day and time, and you can even set a time zone different from your account’s default. Or you don’t have to set a schedule at all – you can leave the Frequency as Never, and just run the agent manually from within the tool.

Agent Schedule Start.jpg

You can also set an End Date for the Agent.

Agent Schedule End date.jpg

The Re-run Agent settings should be left alone, as should the whole Condition tab. Conditions is a feature that is still in development – it will allow for a report to be sent or not in certain pre-selected situations – for instance if there is no activity in the date range you selected then you won’t be sent an empty report. This is why you shouldn't schedule from the catalog, because it automatically adds a condition to the agent, and conditions are live yet, so the agent wouldn’t work.

Delivery Content (What)

The Delivery Content tab is where you tell the agent which analysis to send. You set the subject line of the email you’ll receive, and for now an Analysis is the only option you can choose to send, but in the future you can send a whole dashboard.

Agent Content Overview.jpg

Browse the catalog to find the analysis you want.

Agent Content Browse.jpg

You’ll then have the option to customize that analysis using prompts – just like you can on Dashboards. You should at least set a relative or custom date range – otherwise you’ll get everything from the last two years in your report!

Agent Content Customize.jpg

Also note – there is an Event Date range here, which is not included on the Dashboard prompts. If instead of seeing all the activity for campaigns launched in March, you want to see all the activity in March – even clicks on campaigns that were sent earlier, and excluding any conversions that happened in April – then use the Event Date prompt and the “is between” operator to set your activity window.

To set a filter, click the pencil icon next for that row. Drop down the Operator menu and select “is equal to / is in”. There are a lot of operators to select from, but “is equal to / is in” and “between” are really the most useful ones.

Agent Content Customize operator.jpg

Once you have set the operator, you’ll get a value text box. Click the magnifying glass icon, which will give you a searchable list of values.

Agent Content Customize Select Values.jpg

Take note – this might seem obvious, but when it comes to date ranges, only select one. If you select more than one date range, the report will total up the number of events for each range. So a campaign that you sent yesterday with 5 opens will be counted once for yesterday range, another time for Last 7 Days, another time for Last 14 Days, etc. So if you select all three ranges, you’ll have a report with 15 opens. Same issue if you set both a relative date range AND a custom date range.

These settings are only for this agent to use – you’re not changing the bones underlying the Analysis. You could set up two different agents sending the same analysis, but customized with different prompts, resulting in completely different reports being delivered. For instance, you can send yourself a monthly Campaign Performance report with just data from the last month of your Winback strategy, and send your manager a weekly Campaign Performance report with 7 days of data on all the promotional campaigns. Two agents, customizing the same report.

Once you’ve completed customizing the delivery content, you choose what format you want the report sent in. For HTML and Plain text, you can choose to have the report either embedded in the email, or as an attachment. With CSV, PDF, Excel and other formats they can only be sent as attachments. And as with the Dashboard, if you send HTML, Excel or PDF, what you see is what you get. But if you send your self the raw data, as a CSV or txt document, you get all the hidden data of the report. This is a new feature, as you couldn’t email yourself raw data reports in classic Insight.

Agent Content Format.jpg

You can add a note for the body of the email if you’d like. And of course, ignore the Conditional part for now.

Agent Content Attach.jpg

Recipients (Who)

In the Recipients tab, add who you want to receive the email. We recommend using the envelope icon with the green plus sign, so you’re adding actual email addresses, not just Responsys user accounts. This way, you can send to people who may not have a Responsys login. You can also remove people from the list using the ‘X’ button.

Agent Recipient Emails.jpg

And don’t worry about the Publish for Subscription and Use Analysis sections here, or the Destinations or Actions tabs.

Use the buttons in the top right to save your Agent – you can save it in My Folders, where only you can access it, or if you have authorization, in Company Shared / Shared Folders so everyone can see it.

Agent Save.jpg

Setting up an Agent can be intimidating at first, but once you’ve built one or two, you’ll get the hang of it.

Agents Can’t Send Customized Views (for now)

Remember how you could rearrange, add or exclude columns, sort and drill down on the Dashboard and save the final result as a customized view? You can export that with the Export button on the Dashboard, but for now you cannot select it to be emailed using an Agent. You can only email the standard Analysis, customized only by using the prompts in the Agent. For most users, this is just fine. The Agent will send the standard report, you will see the data you need to see and not worry about the exact order of the columns.

If the precise layout is important to you, you can export the raw data of an analysis and then set up some macros in your workbook application to recreate the formatting you want.

Or, you can get into building custom analyses in Interactive Dashboards Plus…!

Previous Post: Saving Customized Views

Next Post: Custom Reports

Post edited by OIT Integration User on
Tagged:

Comments

  • Malcolm Aldridge
    Malcolm Aldridge Posts: 30 Red Ribbon

    Thanks Helen

    I was disappointed with the new Interactive Dashboards and preferred the classic version but after watching your webinar I now know how to replicate the bits I liked from the old reports and can see so much more potential with the new dashboards. Good job.

    Two point:

    • I just raised a Dream It request
    • You showed that we can add conditional formatting when X happens "Unsubscribe rate greater then 0.5" - I missed how you did this and have watched that bit a few time, I had a look but can't see how to do it. Is it only available with Interactive Dashboard Plus?

    Thanks

    Malcolm

  • Thanks Helen

    I was disappointed with the new Interactive Dashboards and preferred the classic version but after watching your webinar I now know how to replicate the bits I liked from the old reports and can see so much more potential with the new dashboards. Good job.

    Two point:

    • I just raised a Dream It request
    • You showed that we can add conditional formatting when X happens "Unsubscribe rate greater then 0.5" - I missed how you did this and have watched that bit a few time, I had a look but can't see how to do it. Is it only available with Interactive Dashboard Plus?

    Thanks

    Malcolm

    Thank you so much for your kind words! I hope you continue to gain confidence in the tool!

    Yes, the conditional formatting is in Interactive Dashboard Plus. I'll be sure to include the step-by-step instructions in my final blog installment (coming today!).

    - Helen Lillard

  • Christina X.
    Christina X. Posts: 7 Red Ribbon

    @Helen Lillard-Oracle

    I've been using Interactive Dashboard Plus since 10/2016 and have created several agents for daily emailed reports since 2/2017.  These agents have been running fine until 5/20 (5/19 was last date reports were delivered).  I've checked the "more details" section from each agent to find last run date and if the run was successful.  All existing agents indicate the runs were successful and show today's date as last run date.

    Based on everything I've reviewed, I can't find a reason why reports aren't being emailed as they once did before.  Were there updates made to the reporting tool that could have caused issues with existing agents?

    Would like to hear your thoughts about this.

    Thanks!

    Christina

  • @Helen Lillard-Oracle

    I've been using Interactive Dashboard Plus since 10/2016 and have created several agents for daily emailed reports since 2/2017.  These agents have been running fine until 5/20 (5/19 was last date reports were delivered).  I've checked the "more details" section from each agent to find last run date and if the run was successful.  All existing agents indicate the runs were successful and show today's date as last run date.

    Based on everything I've reviewed, I can't find a reason why reports aren't being emailed as they once did before.  Were there updates made to the reporting tool that could have caused issues with existing agents?

    Would like to hear your thoughts about this.

    Thanks!

    Christina

    I'm send you a private message, but without seeing the Agents myself, I would first check:

    - Try running the Agent manually to see what happens

    - Check that there are no Conditions on the Agents (Conditions aren't enabled yet)

    - Use email addresses instead of usernames for Recipients

    - Try assigning a report format (instead of default)

    - Try rebuilding the Agent (just do this with one of them) to see if it works when recreated

    Hope something here helps, otherwise respond to my PM and we'll see what we can do!

    -Helen Lillard

    Expert Services

  • Christina X.
    Christina X. Posts: 7 Red Ribbon

    I'm send you a private message, but without seeing the Agents myself, I would first check:

    - Try running the Agent manually to see what happens

    - Check that there are no Conditions on the Agents (Conditions aren't enabled yet)

    - Use email addresses instead of usernames for Recipients

    - Try assigning a report format (instead of default)

    - Try rebuilding the Agent (just do this with one of them) to see if it works when recreated

    Hope something here helps, otherwise respond to my PM and we'll see what we can do!

    -Helen Lillard

    Expert Services

    Very helpful, thank you Helen.  Turns out this is an internal network issue.  I'm consulting our companies IT Help Desk.

  • Christina X.
    Christina X. Posts: 7 Red Ribbon

    Very helpful, thank you Helen.  Turns out this is an internal network issue.  I'm consulting our companies IT Help Desk.

    company's*

  • John Karbaf
    John Karbaf Posts: 9 Blue Ribbon

    Hi Helen -- I've had a user come and ask me if there's a way to add columns to reports that are emailed out via agent. She had put together some customized reports but was disappointed to learn she couldn't schedule those to be sent. Upon creating an automated report (via email using Agent) she couldn't include the additional column she wanted in the report. Is there any way for her to accomplish this? Thanks!

  • Hi Helen -- I've had a user come and ask me if there's a way to add columns to reports that are emailed out via agent. She had put together some customized reports but was disappointed to learn she couldn't schedule those to be sent. Upon creating an automated report (via email using Agent) she couldn't include the additional column she wanted in the report. Is there any way for her to accomplish this? Thanks!

    John,

    Your user created customized views of standard reports, right? Added columns by right clicking and "Including" columns? It is true that a customized view cannot be sent by agent, but you can set an agent to export ALL data in the report (hidden columns included!) by selecting a CSV or other raw data format.

    Otherwise she needs to create a true custom report (with Analytics Author role in Interactive Dashboards Plus) and using an Agent to export that.

    This is something that we have asked Product about addressing in the future - the ability to use agents to send customized views.

    Helen Lillard

    Expert Services

  • Piotr Sito
    Piotr Sito Posts: 78 Red Ribbon

    Hello,

    I was hoping to use a "Re-run Agent Every" feature to change the frequency and make the agent run on a hourly basis but I can't seem to find that checkbox anywhere. Is this feature no longer available or am I missing something?


    Thanks,

    Piotr

  • Hi Piotr,

    Are you not seeing it in the Schedule tab? Can you post a pic of what you're seeing?

    However, to my knowledge, the "Re-run Agent Every" feature was never enabled (or at least never supported) in Interactive Dashboards. And running a report hourly seems a bit much - what is the use-case you're trying to solve for?



  • Piotr Sito
    Piotr Sito Posts: 78 Red Ribbon

    Hello @Helen Lillard-Oracle

    Thanks for reaching out. Here's how the Schedule tab looks like on my end:


    I assume this feature is no longer available (or never was). The idea was to run an automated report on Contact Shared List Members - we wanted to trigger a report every time a new contact enters the Shared List on a Campaign Canvas but since this seems not possible I wanted to set the minimal Frequency so the report is deliverd every hour (if the Row Count is greater than 0).

    Is there a way to get this feature enabled? Or any suggested workaround?

    Thank you!

    Piotr