Viewing Articulate 360 Content in SharePoint Online
May 20, 2022
Enabling Custom Scripts in SharePoint Online
Custom scripts are now disabled in SharePoint Online for security reasons by default. As a result, Articulate content with the story.html file renamed to story.aspx in the published output that previously worked with SharePoint Online might not work anymore.
If you don't need to track learners' progress or results, check out these free or low-cost options for web hosting.
If you need to use SharePoint Online, your SharePoint admin may be able to resolve this issue by following the steps below, depending on whether or not you need access immediately. (Note that we don't provide support for either workaround.)
Enabling Custom Script via the SharePoint Admin Center
If you don't need instant access, follow these steps.
- Go to the SharePoint admin center and sign in with your credentials.
- In the sidebar to the left of the page, click Settings. (If you're using the Modern admin center, click the classic settings page hyperlink at the bottom of the Settings page.)
- Scroll to the Custom Script section, then select the options to Allow users to run custom script on personal sites and Allow users to run custom script on self-service created sites.
- Click OK to save your changes. Note that this change may take up to 24 hours to appear.
Enabling Custom Script in SharePoint Online via PowerShell
For instant access, follow these steps.
- Open Windows PowerShell with admin privileges, then run Install-Module -Name PnP.PowerShell
- Run this command: Connect-PnPOnline -Url <url> -PnPManagementShell (replace <url> with your SharePoint URL, which will then generate a code for you to insert in your SharePoint admin center.)
- Run these commands in PowerShell: (replace the URL after -Url in the first command with the link to your static site collection, such as https://companyabc.sharepoint.com/sites/StaticSite).
(If you need help creating a SharePoint site, refer to this article from Microsoft.)
- Connect-PnPOnline -Url https://yourorg.sharepoint.com/sites/StaticSite
- $site = Get-PnPSite
- Set-PnPSite -Identity $site.URL -NoScriptSite $false
Your SharePoint site is almost ready to host HTML files! We just need to prepare the Articulate published output for upload. Here's how.
- In SharePoint, choose where you will locate this project. You can create a new folder or use the Documents location created by default with all SharePoint sites.
- Rename all the files with an .html extension in your unzipped published output folder to .aspx (keep the same file name). To do this, right-click the file and choose Rename and then replace .html with .aspx. (Most projects only need to have both the analytics-frame.html and story.html files renamed.)
- Upload the published output to your SharePoint site, then click story.aspx to launch your Articulate course. This change should take effect immediately.
40 Replies
Thank you for taking the time to respond.
Yes, we will be using LMS as well. This was actually for a person who does not have LMS or our LXP access.
It seems we are using Sharepoint.com
https://ORGNAME.sharepoint.com/sites/USFieldMedicalExcellenceCapabilitiesLD/Learning%20An.....
I am looking into this with a system admin today and will keep you posted. Feeling comfortable until this issue is resolved.
Hi everyone, I've been experimenting with getting Storyline interactions added to a Rise course to work on SharePoint. The steps I took to make it work are here:
https://community.articulate.com/discussions/rise-360/rise-publish-to-sharepoint-365-web?page=2#reply-846280
Great documentation, Bob! These are the kinds of things that aren't always available in official documentation. I'm always grateful with how Articulate users truly act like a community and share.
Jenn Brown
True, Thank You.
Hello guys,
could anyone explain to me how to do this step:
2. Change Story.HTML to Story.ASPX in the output folder
Do I need any additional software for this?
Thank you!
Inga
Hi Teltonika loT Group!
I just wanted to pop in and share that making changes to the published output could have unintended consequences or potential for mistakes, which is why we're unable to offer support for it.
I would defer this inquiry to our knowledgeable community members who may have some suggestions or insight to offer!
Hi Inga,
You would want to do this prior to uploading to SharePoint. I don't believe Sharepoint allows you to change the extension of files, at least from what I've seen. In most cases, it should only be one file.
Any issues with the course itself should be dealt with by Articulate Support prior to renaming this HTML file. Once issues are fixed, renaming that file and uploading to SharePoint should be seamless.
2. Change Story.HTML to Story.ASPX in the output folder
If it's going on SharePoint, any .HTML files will need to be changed to .ASPX file. It is very simple extension change on Windows, simply done in Windows Explorer. I cannot speak for other operating systems.
Viewing the contents of the Output Folder in Windows Explorer:
A: Open up the output folder
B: Slow-click twice to edit file name of a file with .HTML extension
C: Change extension from .HTML to .APSX
D: Click Yes on the warning message "do you want to change it
Note that slow-click just needs a couple seconds, as rapid-click twice will launch the file, versus edit the file.
Agreed; it's done before uploading to SharePoint, in Windows Explorer (how'd you'd normally view files before opening them on your computer). Sorry for any confusion.
Thank You so much, Jennifer.
I did all that and still it does not work. Also, I am conversation with Sharepoint admin. Hoping that they will be able to resolve this issue.
With appreciation,
Best
Indrani
The content of this email and of any files transmitted may contain confidential, proprietary or legally privileged information and is intended solely for the use of the person/s or entity/ies to whom it is addressed. If you have received this email in error you have no permission whatsoever to use, copy, disclose or forward all or any of its contents. Please immediately notify the sender and thereafter delete this email and any attachments.
Hello! I tried renaming the files but it shows up as ".aspx.html". I appreciate any assistance. Thank you!
Sadly, the fix doesn't work for me either, but thank you for sharing what worked for you Jennifer! The .aspx file only downloads and doesn't launch anything...same behavior as the .html. I just really wish Articulate hadn't disabled the ability to embed a course in an iframe using the Share link! I have a Rise "course" that isn't actually a course, it's guidelines for creating training, and I thought I'd create interactive guidelines with videos and dynamic content embedded to underscore the importance of interactivity and demonstrate microlearning, etc., but I have to either host it on our LMS, which I will not do...the guidelines shouldn't feel like I'm tracking the user's progress...or just post a pdf version of the Rise course, which defeats the whole purpose. BOO!! Sharepoint is such a common intranet platform; I really wish Articulate would work with us on a solution that would work in Sharepoint. The iframe "share" embed was such a great solution. I'm very sad Articulate took that ability away. :(
Mary, I'm sorry to hear that.
We know that SharePoint.com can run Rise content by switching the .HTML file extensions to .ASPX. This also works for Storyline 3. So the issue is not with SharePoint.com in general. Current versions, published for web, clean output folders.
So that means something else is going on to prevent playing the content. It may require working with your SharePoint Administration team, and/or your IT security team that determines what kinds of files may run on SharePoint or on websites for your organization.
Are you certain that you are using SharePoint.com and not a legacy version of SharePoint?
I ask because there are many versions of SharePoint. If you do not see SharePoint.com in your SharePoint URLs, then it's 99.9% certain that you are using an On-Premise version of SharePoint, and not SharePoint.com.
If you are using On-Premise SharePoint, it's older, and may not meet current browser standards. For Reasons best known by your SharePoint Admin team, your IT departments, your budgeting folks. It will definitely require your SharePoint Admin team and likely someone from an IT security team that needs to be contacted (possibly "perimeter security"). And in which case, you have my condolences, because it's really hard to get the assistance that you need to resolve the issues because the root causes are not straightforward, and IT teams tend to be highly specialized and don't handle fuzzy issues.
IT support for this kind of issue is not straightforward. My best recommendation is to ask your SharePoint Admin team (not site owners, but the actual admins) to look into it and to work with IT security about what files are allowed to run on your SharePoint. Make them aware of the business needs. Ask them to look at the files in the SharePoint folder so they can identify which files may be causing issues. They may need to adjust something to allow the Rise course to play. But they should be able to resolve it.
Best of luck. I do know how challenging this can all be.
This really comes down to power SP admin users. Most of us with this question will not be able to do this with SP if you aren't a power SP admin, let alone if you ask IT for that admin priviledge or having them do it so many issues that make my head hurt, so...
Solutions I have thought about as workarounds...
- have them view the file in Review360 (just don't have the option to come back to where you left off and why you need an LMS or access to a website with FTP options at admin level, most don't)
- or throw it into Amazon Services (some may not want to do this and I think there is also a cost depending on file storage)
- other option and I really think it's a headache is to hack the Google Drive (it can be done, however, it's a big old headache)/Google Cloud to get it to play just like the steps to see that you don't have those SP level permissions to go into the powershell or let alone setup a file even with changing aspx because it keeps looping to HTML and you never get it to run.
Easiest options - Review360, you want people to be able to come back in and it save where you last left off? Then do it in an LMS.
I tried this process but when i try and rename the story.html file to story.ASPX it does not allow me to change it?
Are you getting an error message? If so, it is likely to be an administrative permissions setting.
Are you attempting to change on SharePoint or your local system? It should be done on your local system first.