Once you have installed the CardioLog Analytics SaaS add-in for SharePoint from the Microsoft Office Store, you will then be directed to a configuration screen.
The configuration contains a few simple steps that walk you through setting up data collection and connecting to Power BI reports.
CardioLog SaaS Configuration Screen
In this step you can select which site collections you would like to see data for. Sites are only tracked once the tracking code is deployed for them in the "Add the CardioLog Tracking Code to your Sites" step.
You can go back and add more sites or remove sites from your selection at any point.
Please note that the import process for large site collections may take a few hours up to a few weeks, depending on the environment size.
CardioLog SaaS Configuration Screen: Step 1
Using the search bar, enter the name of any property you would like to find and include.
Select the button next to each user property you would like to include in your usage reports.
In case Personal Identifiable Information (PII) Concealment is enabled, click on the eye icon next to each user property you would like to conceal in your usage reports.
Click Save to confirm your selection.
Properties may be added or removed at any time to accommodate your needs.
CardioLog SaaS Configuration Screen: Step 2
CardioLog SaaS Configuration Screen: Step 2 - Choose User Attributes with PII Concealment
This step allows you to add the JavaScript tracking code to each of your sites.
You can add the tracking code to specific sites or deploy it on all selected site collections and their subsites automatically.
CardioLog SaaS Configuration Screen: Step 4
For classic sites, execute the following shell command:
Set-SPOsite <SiteURL> -DenyAddAndCustomizePages 0 |
#Parameters $TenantAdminURL= "https://company-admin.sharepoint.com" $SiteURL= "https://company.sharepoint.com/sites/site" #Connect to Tenant Admin Connect-PnPOnline $TenantAdminURL -UseWebLogin #Get the Tenant Site Object $Site = Get-PnPTenantSite -Url $SiteURL #Enable Custom Scripting by turning OFF Deny Flag $Site.DenyAddAndCustomizePages = "Disabled" $Site.Update() $Site.Context.ExecuteQuery() |
Once the solution is installed, return to the CardioLog Analytics configuration screen and click Copy to copy the JavaScript tracking code.
Browse to CardioLog Analytics Integration solution configuration page. The page should be found at the following address (replace the site collection root URL https://company.sharepoint.com/sites/site with yours): https://company.sharepoint.com/sites/site/CardioLogAnalytics/Configuration.2.0.8.0.aspx
Paste the tracking code copied from the "Add the CardioLog Tracking Code to your Sites" step and click OK.
To enable support for tracking SharePoint Online modern sites and pages, install the Tracking Agent App:
Upload the CardioLogTrackingAgentAddin.sppkg app which can be found in the deployment package to the SharePoint Admin apps > App Catalog > Apps for SharePoint > New.
Click Deploy (do NOT select "Make this Solution available to all sites in the organization")
Add the App to your site collection and to all of its subsites under Site Contents > New App
Click on Apps from your organization and click CardioLog Tracking Agent (it will be installed automatically)
Note: The tracking code contains links to the Events Listener web application in Azure.
In this step, you can connect to Power BI to gain access to your CardioLog Analytics reports.
The Tenant Level View feature allows administrators to view and customize Power BI reports for all selected site collections.
Note: The reports dataset size is limited based on your Power BI license. In case the limit is reached, upgrade your Power BI license or contact us to upgrade your subscription plan (to scale resources using Azure Analysis Services) or switch to the Site Level View feature.
Click Connect to Power BI and enter the Username and Password of a user with Power BI Pro or Power BI Premium Per User (PPU) license and click Save. This user will be the owner of the CardioLog Analytics SaaS app workspace in Power BI and will be able to share it with others in the organization.
CardioLog SaaS Configuration Screen: Step 5
Go to the Power BI interface.
Login with the credentials you entered in the "Connect to Power BI" step.
Create a Power BI app workspace for the CardioLog Analytics reports. Learn more about Power BI app workspaces.
Select Workspaces > Create a workspace
Enter the following details:
Name - CardioLog Analytics
Privacy - Private - Only approved members can see what's inside
Permissions - Members can edit Power BI content
Add email addresses of people you want to have access to the workspace, and select Add. Note that you can't add group aliases, just individuals.
Decide whether each person is a member or an admin (admins can edit the workspace itself, including adding other members, members can edit the content in the workspace) and click Save.
CardioLog Analytics reports will be available in your app workspace within a few business days. You will receive an email notification as soon as all the data has been processed and your reports are ready to use.
The Site Level View feature allows site owners to view and customize Power BI reports for their own sites only.
Note: The reports dataset size is limited based on your Power BI license. In case the limit is reached, upgrade your Power BI license or contact us to upgrade your subscription plan (to scale resources using Azure Analysis Services) or split the reports.
Click Connect to Power BI and enter the Username and Password of your personal user (requires Power BI Pro or Power BI Premium Per User (PPU) license) and click Save. This user will be the owner of the CardioLog Analytics SaaS reports and will be able to share it with others in the organization.
CardioLog SaaS Configuration Screen: Connect to Power BI
Click Accept in the Permissions Requested screen to allow CardioLog Analytics SaaS publish the reports to your personal workspace.
Your request will be reviewed and approved/denied by your system administrator. The full list of site owners and the sites they are allowed to see reports for (in CSV format) can be downloaded/uploaded via the configuration page.
CardioLog SaaS Configuration Screen: Publish Power BI Reports to Site Owners
Once approved, CardioLog Analytics SaaS reports will be available in your personal workspace within a few business days. You will receive an email notification as soon as all the data has been processed and your reports are ready to use.
When the reports are ready, go to the Power BI interface.
Login with the credentials you entered in the "Connect to Power BI" step.
Select My Workspace > Reports > CardioLog Analytics SaaS
In this step you can connect to your Azure Active Directory in order to import user information from Azure AD.
Using the search bar, enter the name of any attribute you would like to find and include.
Select the button next to each user property you would like to include in your usage reports.
Click Save to confirm your selection.
User attributes may be added or removed at any time to accommodate your needs.
In this step you can select which user group you would like to opt-out of data collection.
The user group information will be taken from Azure Active Directory. It may take up to 24 hours for changes to take effect.
Browse to the configuration page hosted in Azure (URL provided by Intlock).
The configuration contains a few simple steps that walk you through setting up data collection and connecting to Power BI reports.
CardioLog SaaS Configuration Screen
In this step you can select which site collections you would like to see data for. Site collections are only tracked once they are selected and the tracking code is deployed for them in the "Add the CardioLog Tracking Code to your Sites" step.
You can go back and add more sites or remove sites from your selection at any point.
Please note that the import process for large site collections may take a few hours up to a few days, depending on the environment size.
CardioLog SaaS Configuration Screen: Step 2
Using the search bar, enter the name of any property you would like to find and include.
Select the button next to each user property you would like to include in your usage reports.
In case Personal Identifiable Information (PII) Concealment is enabled, click on the eye icon next to each user property you would like to conceal in your usage reports.
Click Save to confirm your selection.
Properties may be added or removed at any time to accommodate your needs.
CardioLog SaaS Configuration Screen: Step 3
CardioLog SaaS Configuration Screen: Step 3 - Choose User Attributes with PII Concealment
CardioLog SaaS Configuration Screen: Step 4
This step allows you to add the JavaScript tracking code to each of your sites.
You can add the tracking code to specific sites or deploy it on all selected site collections and their subsites automatically.
CardioLog SaaS Configuration Screen: Step 5
Execute the Run_Script.ps1 script in Windows PowerShell on the SharePoint central admin server (do not use Windows PowerShell ISE version). Make sure to close all browser windows on your machine before executing the script.
Note: SharePoint farm administrator and a local administrator on the SharePoint central admin server and WFEs is required. If deploying the tracking code on modern sites in SharePoint 2019, the user account must be a member of the sites Owners group and Full Control permissions on the App Catalog.
Execute the following commands from command prompt in order to add and deploy the solution to the SharePoint farm:
cd C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\1X\BIN stsadm.exe -o addsolution -filename "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\1X\BIN\CardioLogTrackingAgentFeature.wsp" stsadm.exe -o deploysolution -name CardioLogTrackingAgentFeature.wsp -immediate -allowgacdeployment stsadm.exe -o activatefeature -name CardioLogAnalytics -force |
In this step, you can connect to Power BI to gain access to your CardioLog Analytics reports.
The Farm Level View feature allows administrators to view and customize Power BI reports for all selected site collections.
Note: The reports dataset size is limited based on your Power BI license. In case the limit is reached, upgrade your Power BI license or contact us to upgrade your subscription plan (to scale resources using Azure Analysis Services) or switch to the Site Level View feature.
Click Connect to Power BI and enter the Username and Password of a user with Power BI Pro or Power BI Premium Per User (PPU) license and click Save. This user will be the owner of the CardioLog Analytics SaaS app workspace in Power BI and will be able to share it with others in the organization.
CardioLog SaaS Configuration Screen: Step 6
Go to the Power BI interface.
Login with the credentials you entered in the "Connect to Power BI" step.
Create a Power BI app workspace for the CardioLog Analytics reports. Learn more about Power BI app workspaces.
Select Workspaces > Create a workspace
Enter the following details:
Name - CardioLog Analytics
Privacy - Private - Only approved members can see what's inside
Permissions - Members can edit Power BI content
Add email addresses of people you want to have access to the workspace, and select Add. Note that you can't add group aliases, just individuals.
Decide whether each person is a member or an admin (admins can edit the workspace itself, including adding other members, members can edit the content in the workspace) and click Save.
CardioLog Analytics reports will be available in your app workspace within a few business days. You will receive an email notification as soon as all the data has been processed and your reports are ready to use.
The Site Level View feature allows site owners to view and customize Power BI reports for their own sites only.
Note: The reports dataset size is limited based on your Power BI license. In case the limit is reached, upgrade your Power BI license or contact us to upgrade your subscription plan (to scale resources using Azure Analysis Services) or split the reports.
Click Accept in the Permissions Requested screen to allow CardioLog Analytics SaaS publish the reports to your personal workspace.
Your request will be reviewed and approved/denied by your system administrator. The full list of site owners and the sites they are allowed to see reports for (in CSV format) can be downloaded/uploaded via the configuration page.
CardioLog SaaS Configuration Screen: Publish Power BI Reports to Site Owners
Once approved, CardioLog Analytics SaaS reports will be available in your personal workspace within a few business days. You will receive an email notification as soon as all the data has been processed and your reports are ready to use.
When the reports are ready, go to the Power BI interface.
Login with the credentials you entered in the "Connect to Power BI" step.
Select My Workspace > Reports > CardioLog Analytics SaaS
In this step you can connect to your Active Directory in order to import user information from AD.
CardioLog SaaS Configuration Screen: Step 7
Please note that port 389 (LDAP)/port 636 (SLDAP) and the AD domain controller IP and FQDN should be available.
Select all user attributes that you would like to filter and report on. This information will be taken from Active Directory user attributes. If you have created custom user attributes you can also use them. It is recommended to select the following basic attributes - department, office, country, manager, title.
Using the search bar, enter the name of any attribute you would like to find and include.
Select the button next to each user property you would like to include in your usage reports.
Click Save to confirm your selection.
User attributes may be added or removed at any time to accommodate your needs.
Note: if you have already imported user information from SharePoint user profiles in step 3, there is no need to perform this step.
In this step you can select which user group you would like to opt-out of data collection.
The user group information will be taken from Active Directory. It may take up to 24 hours for changes to take effect.
Go to the Yammer Apps Directory and search for CardioLog Analytics SaaS, then click Try it.
Click Allow in the Connect to CardioLog Analytics SaaS screen to allow CardioLog Analytics SaaS to retrieve data from your Yammer network, then you will be redirected to the configuration page.
Connect to your Yammer network with a dedicated service account that is a Verified Admin in your Yammer network.
In this step, you can connect to Power BI to gain access to your CardioLog Analytics reports.
Click Connect to Power BI and enter the Username and Password of a user with Power BI Pro or Power BI Premium Per User (PPU) license and click Save. This user will be the owner of the CardioLog Analytics SaaS app workspace in Power BI and will be able to share it with others in the organization.
Go to the Power BI interface.
Login with the credentials you entered in the "Connect to Power BI" step.
Create a Power BI app workspace for the CardioLog Analytics reports. Learn more about Power BI app workspaces.
Select Workspaces > Create app workspace
Enter the following details:
Name - CardioLog Analytics
Privacy - Private - Only approved members can see what's inside
Permissions - Members can edit Power BI content
Add email addresses of people you want to have access to the workspace, and select Add. Note that you can't add group aliases, just individuals.
Decide whether each person is a member or an admin (admins can edit the workspace itself, including adding other members, members can edit the content in the workspace) and click Save.
CardioLog Analytics reports will be available in your app workspace within a few business days. You will receive an email notification as soon as all the data has been processed and your reports are ready to use.
When the reports are ready, share them with your colleagues:
Once you have installed the CardioLog Analytics SaaS add-in from the Microsoft Office Store, you will then be directed to a configuration screen.
The configuration contains a few simple steps that walk you through setting up data collection and connecting to Power BI reports.
CardioLog SaaS Configuration Screen
In this step, you can connect to Power BI to gain access to your CardioLog Analytics reports.
Click Connect to Power BI and enter the Username and Password of a user with Power BI Pro or Power BI Premium Per User (PPU) license and click Save. This user will be the owner of the CardioLog Analytics SaaS app workspace in Power BI and will be able to share it with others in the organization.
Go to the Power BI interface.
Login with the credentials you entered in the "Connect to Power BI" step.
Create a Power BI app workspace for the CardioLog Analytics reports. Learn more about Power BI app workspaces.
Select Workspaces > Create app workspace
Enter the following details:
Name - CardioLog Analytics
Privacy - Private - Only approved members can see what's inside
Permissions - Members can edit Power BI content
Add email addresses of people you want to have access to the workspace, and select Add. Note that you can't add group aliases, just individuals.
Decide whether each person is a member or an admin (admins can edit the workspace itself, including adding other members, members can edit the content in the workspace) and click Save.
CardioLog Analytics reports will be available in your app workspace within a few business days. You will receive an email notification as soon as all the data has been processed and your reports are ready to use.
When the reports are ready, share them with your colleagues:
In this step you can select which Teams you would like to see data for in reports.