Note for users transferring their reports from Viya 3.5 to 4: Welcome! You're going to receive an error when you follow these instructions! But worry not; the "Troubleshooting" section at the end outlines the extra steps you'll need to follow to ensure everything works correctly.
SAS Viya for Learners is a full suite of cloud-based analytics software. It’s free for anyone with an academic email, accessible quickly and easily in-browser, and is, in my opinion, the quickest way to get from concepts to hands-on in teaching and learning analytics.
So, what’s the catch?
Without boring you with the software architectural details (which is code for “I don’t actually know the software architectural details”), the way we’re able to have concurrent users from across the globe all connect at the same time is by splitting users across multiple environments.
This is fantastic for stability and accessibility… Not so great when it comes to sharing content.
In a commercial environment, sharing a report in Explore and Visualize (aka SAS Visual Analytics) is as easy as clicking the three-dot menu button next to the save icon and selecting "Share report":
Yup. That easy.
But in Viya for Learners, with users spread out on different environments, sharing just isn’t possible.
So that's it, we're out of luck? We are not. Sharing reports is still doable, just with a little bit of behind-the-scenes ingenuity.
The trick is that every report can be exported as code, and then imported by another user.
Important! Before following these steps, keep in mind that any data being referenced in the report (i.e., the data loaded into memory) must be exactly the same for both the sharer and the recipient, including the name of the data file. This isn’t typically an issue if you're using a pre-loaded dataset like those that are part of our many digital learning courses (shout out to SAS Skill Builder), but if you’re using custom data, just ensure that the recipient has uploaded exactly the same dataset being referenced. If the datasets differ in any way, certain parts of the report may display incorrectly or not at all.
With that out of the way, here are the steps to export your report:
Click the "Save" icon ()and follow the prompt to save the report code as a .txt file to your computer (note that if you haven't changed your browser download settings, it may just default to save in your local "Downloads" folder):
Send that file to the intended recipient.
On the other end, to view the report:
That's it! As long as the datasets are consistent, you'll see the exact same beautiful report.
Troubleshooting:
Issue: When you click "Load" in step 7, you receive an error: "An error was encountered loading the data [Dataset Name]."
Solution: The likeliest explanation is a minor difference in the code that references the location of the dataset, meaning your report is simply trying to pull the data from an invalid location. And for those of you here about transferring reports from Viya 3.5 to 4, this is the error we mentioned at the top. Fortunately, it's an easy fix!
If you run into any other issues, leave a note in the comments below! And if you're an educator and want to learn more about how you can use tools like SAS Viya for Learners in the classroom, drop us a line at academic@sas.com.
Thanks Bryan! Now about that software architecture...;)
Love this! Students sharing their work - either to another collaborator or their professor - has been a challenge in VFL. This could be a great solution. Thanks @bryanmehi!
This is mega cool! And as @LGroves said - a total game changer when it comes to students sharing reports with colleagues or teachers!
Hello, Can someone tell me what would be CTRL+ALT+B on Mac? Many thanks.
@askibins great question - I forgot there's no ALT key on Macs! You can open the diagnostics tool using control + option + B.
Thank you bryanmehi for answering my question. I actually would like to ask if you have a solution how to transfer reports from Student account to the Educator account? The problem that I have is that I cannot use the same machine to login in both accounts because SAS shows an error when I try to do that. When I saved the report on USB to upload it on to my Educator account, even I click CTRL+ALT+B I do not get the diagnostic tool view... so I am a bit lost. Any advice on that would be hugely appreciated. Many thanks.
@askibins Are you in "Explore and Visualize" (Visual Analytics) and have a new report open when you try to open the diagnostic tool on the other account? If so, can you confirm which browser and OS you're using? There aren't any differences between the versions of Viya that you would be accessing through your two accounts (just which tenant you're on), so we'll need to troubleshoot why the diagnostics tool isn't opening. Your solution of saving the code to USB is a good one and should work!
Build your skills. Make connections. Enjoy creative freedom. Maybe change the world. Registration is now open through August 30th. Visit the SAS Hackathon homepage.
Register today!Data Literacy is for all, even absolute beginners. Jump on board with this free e-learning and boost your career prospects.