Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

SharePoint Online

Once you have installed the The CardioLog Analytics SaaS add-in for SharePoint from the Microsoft Office Store, you will then be directed to a configuration screen.The configuration configuration page contains a few simple steps that walk you through setting up data collection and connecting to Power BI reports.

Image RemovedImage Added
CardioLog Analytics SaaS Configuration Screen

Anchor
online_choose_sites
online_choose_sites
Step 1: Choose Sites To Track

In this step you can select which site collections you would like to see data for. Sites are only tracked once they are selected.the tracking code is deployed for them in the "Add the CardioLog Tracking Code to your Sites" step.

  1. Click Connect.
    Note: A global administrator account is required in order to consent to the permissions required to read items from all site collections and read users' full profiles. 

    Image Added

  2. Click Accept to approve the required permissions.
    Note: An App will be created in your Azure Active Directory. It may take up to 24 hours for changes to take effect.

    Image Added

  3. With this section expanded, you should see all of your available SharePoint Online site collections .Select and select all the sites you would like to begin monitoring monitor using CardioLog Analytics.

    Image Added

  4. You can also search for site collections by typing in their name in the search bar.
  5. Select the button next to each site you would like to monitor.
  6. In order to stop monitoring a site, unselect it. Click Confirm to acknowledge that this operation will remove the site from usage reports. Note that you will have to remove the tracking agent components from it manually.

    Image Added

  7. In order to stop monitoring a site, but keep history data for it in usage reports, click on the folder icon Image Addednext to it in order to archive it. 

  8. Click Save to confirm your selection.

You can go back and add more sites or remove sites from your selection at any point.

 

Image Removed

CardioLog SaaS Configuration Screen: Step 1


Important Notes

  1. The number of site collections available for selection in your subscription is limited.
  2. The initial import process for large site collections may take a few hours up to a few weeks, depending on the environment size.
  3. The import process for new content in existing imported site collections may take a few days, depending on the time needed to import the new content, process the data, and refresh the data in Power BI reports. Since Power BI reports are refreshed once a day, the timing of these updates is also a contributing factor.

Anchor
online_choose_user_profiles
online_choose_user_profiles
Step 2: Choose User Properties To Report On

In this section you can select all user profile properties that you would like to filter and report on. This information will be taken from SharePoint user profiles. If you have created custom profile properties you can also use them.
It For reporting purposes in CardioLog Analytics, it is recommended to select the following basic attributes - department, office, country, manager, title, picture URL. segmented fields like Department, Office, Country, and Job Title. These attributes protect individual privacy and comply with data regulations, while still providing valuable insights into organizational trends and demographics.

Note: Make sure that the default privacy setting for the selected property is set to Everyone (and not "Only Me") in SharePoint Central Administration > User Profiles > Manage User Properties > Policy Settings.

Image Added

(question) What are SharePoint Profiles?

  1. Using the search bar, enter the name of any property you would like to find and include.

  2. Select the button next to each user property you would like to include in your usage reports.

    Image Added
    CardioLog SaaS Configuration Screen: Step 2 - Choose User Attributes

  3. In case Personal Identifiable Information (PII) Concealment is enabled, hover over the user property you would like to conceal in your usage reports and click the gear icon. 

    Image Added
    Step 2 - Choose User Attributes - Configure PII Concealment 

    You will have the following options to choose from:

    • Unconcealed: Data for user profile attribute values is visible in the reports.
    • Concealed: Data for user profile attribute values is concealed for enhanced security.
    • Partially Concealed: Data for user profile attribute values is concealed only for groups with a size below the selected threshold. Partial concealment allows analysis and reporting on broader trends without compromising the privacy of individuals within smaller, potentially identifiable groups.

    Image Added
    Step 2 - Choose User Attributes - PII Concealment Options


  4. Click Apply after selecting the concealment option.

  5. Click Save to confirm your selection.

Properties may be added or removed at any time to accommodate your needs.

Image Removed

Anchor
online_choose_metadata
online_choose_metadata
Step 3: Choose Content Metadata Fields to Report On

In this section you can select all content metadata fields that you would like to filter and report on. Metadata fields information will be taken from your SharePoint list items and documents.
It is recommended to select metadata fields that are segmented fields, such as managed metadata columns and lookup fields.
Metadata fields may be added or removed at any time to accommodate your needs.
Note: The number of content metadata fields available for selection in your subscription is limited (50 by default).

Image Added
CardioLog SaaS Configuration Screen: Step
2Step 3
3

Make sure that the selected metadata field name is identical to the Column name as seen in the SharePoint Library settings, under Columns, click to edit the column:
Image Added 

Anchor
online_add_tracking_code
online_add_tracking_code
Step 4: Add The CardioLog Tracking Code To Your Sites

This step allows you to add the JavaScript tracking code to each of your sites. 

You can Select one of the following options to add the tracking code to specific sites or deploy it on all selected site collections and their subsites automatically.

Image Removed

CardioLog SaaS Configuration Screen: Step 3

Add the Tracking Code to a Site Collection Manually

  • Browse to your SharePoint Online site Solution Gallery. The gallery should be found at this address by replacing the website root URL with yours: <https://company.sharepoint.com]/_catalogs/solutions/forms/allitems.aspx>
  • From your Solution Gallery, click Upload Solution > Choose File. Then select CardioLog Analytics Integration.wsp and click Activate.
  • If you are presented with a request for access, go to the Admin Center, found under the Office 365 Admin menu.
  • From the SharePoint Admin Center select Settings.
  • Choose Custom Script.
  • Select Allow for both options. (Allow users to run custom script on personal sites & Allow users to run custom script on self-service created sites)
  • The preference change may take up to 24 hours.
  • In order to force the change to take place immediately, you may download and run the SharePoint Management Shell.
  • Follow Microsoft's instructions for connecting it to your SharePoint Online tenant
  • Run the following shell command:
    Set-SPOsite <SiteURL> -DenyAddAndCustomizePages 0
     

    Note: If you would like to host the tracking code on a private CDN, please fill out the CDN details in the Advanced Settings before you proceed with adding the tracking code using one of the following options.

    Anchor
    online_add_tracking_app
    online_add_tracking_app
    Install the tracking code automatically using an App

    Select this option to add the tracking code to all selected sites (in "Choose Sites to Track" step) automatically using an App:

    1. Microsoft Entra ID App (recommended)
    2. SharePoint App (deprecated)

    Note: Use this method for installing the tracking code on all selected site collections, including automatically enabling it for newly created subsites under the selected site collections. 

    Anchor
    online_create_tracking_entra_id_app
    online_create_tracking_entra_id_app
    Using a Microsoft Entra ID App 
    Image Added
    1. Click Connect to consent to the required permissions to install all tracking components on your sites.

      Image Added

    2. Select Automatically track all subsites including newly created ones in order to automatically enable tracking for newly created subsites under the selected site collections (in "Choose Sites to Track" step).

    3. Click Save.
    4. Click Install Tracking to install the tracking code on all selected site collections and their subsites.
      Note: This step may take a while to complete, depending on the amount of selected sites. Follow the installation progress on the screen:

      Image Added

    5. Click View installation report to view a detailed report of the installation progress. Click the top left down arrow icon to export the report to CSV.

      Image Added
    Anchor
    online_create_tracking_deployment_app
    online_create_tracking_deployment_app
    Using a SharePoint App 

    Image Added
    Note: SharePoint Apps (Add-Ins) have been deprecated by Microsoft and will soon stop functioning. We strongly recommend using a Microsoft Entra ID App.

    1. Login to SharePoint with the Global Administrator account.
    2. Navigate to https://<Admin Center>/_layouts/15/AppRegNew.aspx (e.g. https://company-admin.sharepoint.com/_layouts/15/AppRegNew.aspx).
    3. Create a 'full-trust' app with the following details:
      1. Client ID and Secret - click Generate to automatically create a client ID and secret and copy these values.
      2. Title - CardioLog Analytics Tracking Deployment
      3. App Domain - localhost
      4. Redirect URI - https://localhost
    4. Navigate to https://<Admin Center>/_layouts/15/AppInv.aspx (e.g. https://company-admin.sharepoint.com/_layouts/15/AppInv.aspx).
    5. Paste the client ID into the App Id field. Click Lookup. The existing values for Title, App Domain and Redirect URL should appear.

    6. Enter the following XML into the App's Permission Request XML field to specify required permissions. Then click Create.

      Code Block
      <AppPermissionRequests AllowAppOnlyPolicy="true">
          <AppPermissionRequest Scope="http://sharepoint/content/tenant" Right="FullControl" />
          <AppPermissionRequest Scope="http://sharepoint/content/sitecollection" Right="FullControl" />
          <AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web" Right="FullControl" />
      </AppPermissionRequests>
    7. You will be prompted to approve permissions for the app. Click Trust It.

    8. Once the App is created, return to the CardioLog Analytics configuration screen and enter the details of the Client ID and Client Secret in the "Add the CardioLog Tracking Code to your Sites" step.

    9. Select Automatically track all subsites including newly created ones in order to automatically enable tracking for newly created subsites under the selected site collections (in "Choose Sites to Track" step).

    10. Select Notify me when client secret expires or is not working in order to receive an email alert to the specified email address. Follow these steps in order to renew the SharePoint App client secret if needed.
    11. Click Save.
    12. Click Install Tracking to install the tracking code on all selected site collections and their subsites.
      Note: This step may take a while to complete, depending on the amount of selected sites. Follow the installation progress on the screen:

      Image Added

    13. Click View installation report to view a detailed report of the installation progress. Click the top left down arrow icon to export the report to CSV.

      Image Added

    Anchor
    online_renew_app_client_secret
    online_renew_app_client_secret
    Renew SharePoint App Client Secret
    1. Execute the following PowerShell commands with the SharePoint Online Global Administrator account. 

    2. Edit the "Client ID" and use the Client ID value from the CardioLog Analytics configuration screen in "Add the CardioLog Tracking Code to your Sites" step. 

      Code Block
      Connect-MsolService
      $clientId = "Client ID"
      $keys = Get-MsolServicePrincipalCredential -AppPrincipalId $clientId -ReturnKeyValues $false
      $keys
      Remove-MsolServicePrincipalCredential -KeyIds $keys.KeyId -AppPrincipalId $clientId
    3. In the same PowerShell window, execute the following PowerShell commands in order to generate a new client secret.

      Code Block
      $bytes = New-Object Byte[] 32
      $rand = [System.Security.Cryptography.RandomNumberGenerator]::Create()
      $rand.GetBytes($bytes)
      $rand.Dispose()
      $newClientSecret = [System.Convert]::ToBase64String($bytes)
      $dtStart = [System.DateTime]::Now
      $dtEnd = $dtStart.AddYears(1)
      New-MsolServicePrincipalCredential -AppPrincipalId $clientId -Type Symmetric -Usage Sign -Value $newClientSecret -StartDate $dtStart -EndDate $dtEnd
      New-MsolServicePrincipalCredential -AppPrincipalId $clientId -Type Symmetric -Usage Verify -Value $newClientSecret -StartDate $dtStart -EndDate $dtEnd
      New-MsolServicePrincipalCredential -AppPrincipalId $clientId -Type Password -Usage Verify -Value $newClientSecret -StartDate $dtStart -EndDate $dtEnd
      $newClientSecret
    4. Copy the new client secret value and update it in the CardioLog Analytics configuration screen in the "Add the CardioLog Tracking Code to your Sites" step and click Save.

    Anchor
    online_add_tracking_ps
    online_add_tracking_ps
    Install the tracking code automatically using a PowerShell script 

    Select this option to add the tracking code to all selected site collections (in "Choose Sites to Track" step) automatically using a PowerShell script.
    Note: It is required to execute the PowerShell script every time you create new sites under the selected site collections in order to enable tracking for them.

    Image Added

    1. Click CardioLog Analytics Tracking Deployment package to download the deployment package from the "Add the CardioLog Tracking Code to your Sites" step in the Configuration page.
      The package includes a PowerShell script that deploys the tracking agent wsp solution, modern sites integration app and the Java Script tracking code on all selected site collections.
    2. Right click the downloaded package zip file, select Properties > General and click on "Unblock" before unzipping it.
    3. Execute the Run_Script.ps1 script in Windows PowerShell (do not use Windows PowerShell ISE version). Make sure to close all browser windows on your machine before executing the script.
      Note: You must have the MS Online module installed and the credentials of the SharePoint Online global administrator.

    Install the tracking code manually

    Select this option to add the tracking code to specific sites manually.

    Image Added

    Step 4
    1. Click CardioLog Analytics Tracking solution to download the deployment package from the "Add the CardioLog Tracking Code to your Sites" step in the Configuration page.
    2. Right click the downloaded package zip file, select Properties > General and click on "Unblock" before unzipping it.
    3. Temporarily allow custom scripts during the installation in order to add the JavaScript tracking code and Tracking Agent application (sppkg for modern sites, wsp solution for classic sites) to your app catalog and all of the site collections you wish to monitor.
      Execute the following commands in the SharePoint Online Management Shell (edit your SharePoint admin center and site collection URLs). 
      1. Connect to SharePoint Online Admin Center with the SharePoint Online Global Administrator account:

        Code Block
        Connect-SPOService -Url https://company-admin.sharepoint.com
      2. Get the current value of the Custom Scripts setting DenyAddAndCustomizePages for each site collection you wish to monitor and for your App Catalog:

        Code Block
        Get-SPOsite https://company.sharepoint.com | Select DenyAddAndCustomizePages
      3. If the current value of DenyAddAndCustomizePages is Enabled, set it to Disabled:

        Code Block
        Set-SPOsite https://company.sharepoint.com -DenyAddAndCustomizePages 0
        
      4. Disconnect from SharePoint Online: 
        Code Block
        Disconnect-SPOService
        
    4. Browse to your SharePoint Online site collection Solution Gallery. The gallery 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/_catalogs/solutions/forms/allitems.aspx
    5. From your Solution Gallery, click Upload Solution > Choose File. Then select the CAI.wsp  solution file which can be found in the deployment package and click Activate.
    6. If you are presented with a request for access, make sure you have temporarily allowed custom scripts for your site collection and app catalog.
    7. Once the solution is installed, return to the CardioLog Analytics configuration screen and click Copy script to copy the JavaScript tracking code.

    8. Browse to CardioLog Analytics Integration solution configuration page. The page should be found at this address by replacing the website root URL with yours: <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>

    9. Insert Paste the tracking code copied from Step 3 the "Add the CardioLog Tracking Code to your Sites" step and click OK.Paste the tracking code to the Head script text box of the Web Analytics Integration plug-in and click Save.
      Note: The tracking code contains links to the Events Listener web application in Azure. 

    Deploying the Tracking Code to all Selected Site Collections Automatically

    1. Download the automatic deployment Package from Step 3 in the Configuration page.
      The package includes a PowerShell script that deploys the tracking agent wsp solution, modern sites integration app and the Java Script tracking code on all selected site collections.
    2. Execute the Run_Script.ps1 script in PowerShell (you must have the MS Online module installed and the credentials of the SharePoint Online global administrator).
    1. In order to track SharePoint Online modern sites and pages, install the Tracking Agent App:

      1. Click CardioLog Analytics Tracking Agent App for modern sites to download the Tracking Agent App.

      2. Upload the CardioLogTrackingAgentAddin.sppkg app to the SharePoint Admin apps > App Catalog > Apps for SharePoint > New.

      3. Click Deploy (do NOT select "Make this Solution available to all sites in the organization")

      4. Add the App to your site collection and to all of its subsites under Site Contents > New App

      5. Click on Apps from your organization and click CardioLog Tracking Agent (it will be installed automatically)

    2. After the installation is complete, revert the changes performed in step 3 (if any) and disable custom scripts.

      Code Block
      Connect-SPOService -Url https://company-admin.sharepoint.com
      Set-SPOsite https://company.sharepoint.com -DenyAddAndCustomizePages 1
      Disconnect-SPOService
      

      Note: If you would like to edit the tracking code via the CardioLog Analytics Integration solution configuration page (https://company.sharepoint.com/sites/site/CardioLogAnalytics/Configuration.2.0.8.0.aspx), you will have to temporarily enable custom scripts again.

    Inject the tracking code to all site pages yourself

    Select this option to inject the tracking code manually to your site pages.

    Image Added

    1. Click Copy script to copy the JavaScript tracking code to the clipboard.
    2. Paste the tracking code into the <head> section of each site page you would like to track.

    Advanced Settings

    Anchor
    online_cdn
    online_cdn
    Host the tracking code on a private CDN

    By default the tracking code resources are hosted on Microsoft Azure. Select this option if you would like to host the tracking code resources on a private CDN for increased security.
    Note: It is required to perform this step before adding the tracking code to selected sites.

    Image Added

    1. Expand the Advanced Settings section in the "Add the CardioLog Tracking Code to your Sites" step.
    2. Switch on the Host the tracking code on a private CDN toggle.
    3. Enter the CDN Address and click Save.
    4. Click Download CDN resources Here to download the latest version of the tracking code resources and host them on your private CDN.
    Anchor
    online_add_site_statistics
    online_add_site_statistics
    Enable access to Power BI Reports via the Site Statistics option in SharePoint

    Select this option if you would like to use the Site Level View feature to allow site owners to view and customize Power BI reports for their own sites only. 
    Note: It is required to perform this step before adding the tracking code to selected sites.

    Image Added

    1. Expand the Advanced Settings section in the "Add the CardioLog Tracking Code to your Sites" step.
    2. Switch on the Enable access to Power BI Reports via the Site Statistics option in SharePoint toggle.
    3. Select the Permission level in SharePoint you would like to grant access to. Users with this permission level will have access to Power BI reports via the Site Statistics option under Site Actions in SharePoint.

    Anchor
    online_connect_to_pbi
    online_connect_to_pbi
    Step 5: Connect to Power BI

    In this step, you can connect to Power BI to gain access to your CardioLog Analytics reports.

    Tenant Level View

    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.

    1. Click Connect to Power BI and enter the Username and Password of a user with Power BI Pro user 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. 

      Image RemovedImage Added
      CardioLog SaaS Configuration Screen: Step 45

    2. Go to the Power BI interface. 

      1. Login with the credentials you entered in Step 1the "Connect to Power BI" step.

      2. Create a Power BI app workspace for the CardioLog Analytics reports. Learn more about Power BI app workspaces.

        1. Select Workspaces Create app a workspace

        2. Enter the following details:
          Name - CardioLog Analytics
          Privacy - Private - Only approved members can see what's inside
          Permissions - Members can edit Power BI content

        3. 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.

        4. 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.

    3. 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.

    4. When the reports are ready, share them with your colleagues:
      1. Sign in to Power BI with the credentials you entered in Step 1the "Connect to Power BI" step.
      2. Select Worksaces Workspaces > CardioLog Analytics > select the Publish Create app button in the upper right to start the process of sharing all the content in that workspace.
      3. First, on DetailsSetup tab, enter the following details:
        App name - CardioLog Analytics
        Description - Analytics for SharePoint and Yammer
        Background color - Gray
        Office 365
      4. Next, on ContentNavigationyou see the content reports that's going to be published as part of the app . Select Specific content in the App landing pageand organize the navigation pane.
      5. Last, on AccessPermissions, decide who has access to the app: either everyone in your organization, or specific people or email distribution lists and click Finish.
    Step 5
      1. Publish app.
    Anchor
    online_slv
    online_slv
    Site Level View

    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.

    1. Each site owner should browse to the configuration page hosted in Azure (URL provided by Intlock) in order to to connect to Power BI, or request access to reports for specific sites via the Site Statistics option in SharePoint.
      Note: To enable the Site Statistics option in SharePoint, switch on the Enable access to Power BI Reports via the Site Statistics option in SharePoint toggle in Advanced Settings in the "Add the CardioLog tracking code to your sites" step.
    2. 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. 

      Image Added
      CardioLog SaaS Configuration Screen: Connect to Power BI

    3. Click Accept in the Permissions Requested screen to allow CardioLog Analytics SaaS publish the reports to your personal workspace.

      Image Added

    4. 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.

      Image Added
      CardioLog SaaS Configuration Screen: Publish Power BI Reports to Site Owners

    5. 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.

    6. When the reports are ready, go to the Power BI interface. 

      1. Login with the credentials you entered in the "Connect to Power BI" step.

      2. Select My Workspace > Reports > CardioLog Analytics SaaS

    Anchor
    online_connect_to_ad
    online_connect_to_ad
    Step 6: Connect to Active Directory

    In this step you can connect to your Azure Active Directory in order to import the number of active users in your organization.user information from Azure AD.

    1. Login to SharePoint with the credentials of a global admin account that has permissions to sign in to Azure AD and read directory data (users' full profiles and groups). 
    2. Click Connect to Active Directory to connect to your Azure Active Directory with the current logged on user and click Save.
      Image Removed

    SharePoint 2013/2016


    1. Image Added
      CardioLog SaaS Configuration Screen: Step 6

    2.  Select all user attributes that you would like to filter and report on. This information will be taken from Active Directory user attributes. It is recommended to select attributes such as department, office, country, job title etc.
      1. Using the search bar, enter the name of any attribute you would like to find and include.

      2. Select the button next to each user property you would like to include in your usage reports.

      3. 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 the "Choose User Properties to Report On" step, there is no need to perform this step.

      Image Added
      CardioLog SaaS Configuration Screen: Step 6

    Anchor
    online_choose_group_to_opt_out
    online_choose_group_to_opt_out
    Step 7: Choose User Groups to Opt-out

    In this step you can select which user groups 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.

    1. Connect to Azure Active Directory with an account that is a global administrator in your Office 365 tenant. This account will be used in order to approve the required permissions for CardioLog Analytics SaaS to connect to Azure Active Directory.

      Image Added

    2.  Click Accept to approve the required permissions.

      Image Added

    3.  Select the user groups you would like to opt-out of data collection and click Save.

      Image Added
       
    4. Click Confirm to acknowledge that:
      1. Data for opted out users, including user profile information and usage data, will be: 
        1. Permanently deleted 
        2. No longer collected
        3. No longer available in reports
      2. Data for opted in users, including user profile information and usage data, will be collected and available in reports, however any data that was deleted/not collected during the time period they were opted out will not be recovered.
      3. Using this functionality may result in data discrepancies in some reports.

        Image Added

    Anchor
    online_choose_content_to_opt_out
    online_choose_content_to_opt_out
    Step 8: Choose Subsites or Lists to Exclude

    In this step you can select which content (subsites and lists) you would like to opt-out of data collection. You can always go back and select additional subsites/lists or remove subsites/lists from your selection.

    The subsites and lists available for selection are taken from the list of site collections selected in step 1. 

    Note: It may take up to 24 hours for changes to take effect.

    Image Added
    Choose Subsites or Lists to Exclude Step

    1. Select the subsites or lists you would like to opt-out of data collection. The selected subsites and lists will be added to the List of exclude content section.

      Image Added

    2. Using the Search subsite bar, enter the name of any subsite you would like to find and exclude.

      Image Added

    3. To exclude a specific list, find the subsite that the list resides on, expand it and select your desired list.

      Image Added 

    4. Click Save. It may take up to 24 hours for changes to take effect.
    5. Click Confirm to acknowledge that:
      1. Data for opted out content, including content metadata information and usage data, will be: 
        1. Permanently deleted 
        2. No longer collected
        3. No longer available in reports
      2. Data for opted in content, including content metadata information and usage data, will be collected and available in reports, however any data that was deleted/not collected during the time period they were opted out will not be recovered.
      3. Using this functionality may result in data discrepancies in some reports.

        Image Added

    Anchor
    online_assign_permissions_to_pbi_reports
    online_assign_permissions_to_pbi_reports
    Step 9: Assign Permissions to Power BI Reports

    In this step you can select the users and groups you would like to grant report permissions to and select the specific sites that they should see reports for.
    The user information will be taken from Azure Active Directory. It may take up to 24 hours for changes to take effect.

    1. Connect to Azure Active Directory with an account that is a global administrator in your Office 365 tenant. This account will be used in order to approve the required permissions for CardioLog Analytics SaaS to connect to Azure Active Directory.

      Image Added

    2. Click Accept to approve the required permissions.

      Image Added

    3. Select the users and groups you would like to grant report permissions to. You can always go back and select additional users or groups or remove users or groups from your selection by clicking on - Remove user or group from list.

      1. Using the Search for a user or group bar, enter the name of any user or group you would like to find and assign permissions to. 

        Note: Selected users should have a Power BI Pro or Premium per User (PPU) license assigned to them.

        Image Added

      2. For each user or group, click Custom to select the specific sites the user or group is allowed to see reports for, or click Access to all sites to select all sites.

        Image Added

      3. Click Save to confirm your selections.

      4. Share the CardioLog Analytics SaaS reports in Power BI service with the selected users and groups.
        Note: Permissions are applied using Power BI Row Level Security (RLS). Since RLS does not apply to users and groups with edit permissions on the dataset, make sure to grant site analysts the 'Build' permissions for the CardioLog Analytics SaaS dataset to enable them to create customized reports if needed.

      5. Add the 'Site Analyst' role in Power BI service to users and groups who have access to specific sites: 
        CardioLog Analytics SaaS Dataset > More options > Security > Select the 'Site Analyst' role > Add each user or group as a member.

      6. Add the 'Global Analyst (View All Sites)' role in Power BI service to users and groups who have access to all sites:
        CardioLog Analytics SaaS Dataset > More options > Security > Select the 'Global Analyst (View All Sites)' role > Add each user or group as a member.
        Note: Since roles are reset in Power BI on every version update, it is highly recommended to create user groups for managing users roles (one for site analysts and one for global analysts) so it would be easier to maintain.

    SharePoint On-Premise

    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.

    Image RemovedImage Added
    CardioLog Analytics SaaS Configuration ScreenScreen 

    Anchor
    op_connect_to_sp
    op_connect_to_sp
    Step 1: Connect to SharePoint

    1. Enter the SharePoint farm administrator user name and password and the SharePoint farm Admin Center URL and click Save.

       Image RemovedImage Added
      CardioLog SaaS Configuration Screen: Step 1

    Anchor
    op_choose_sites
    op_choose_sites
    Step 2: Choose Sites To Track

    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.

    1. With this section expanded, you should see all of your available SharePoint web applications.
    2. Expand each web application to select all the site collections you would like to begin monitoring using CardioLog.
    3. You can also search for site collections by typing in their name in the search bar.
    4. Select the button next to each site collection you would like to monitor.
    5. In order to stop monitoring a site, unselect it. Note that this operation will remove the site from usage reports, but you will have to remove the tracking code from it manually.

    6. In order to stop monitoring a site, but keep history data for it in usage reports, click on the folder icon Image Addednext to it in order to archive it. 

    7. Click Save to confirm your selection.

    You can go back and add more sites or remove sites from your selection at any point.

    Image Removed


    Important Notes

    1. The number of site collections available for selection in your subscription is limited.
    2. The initial import process for large site collections may take a few hours up to a few weeks, depending on the environment size.
    3. The import process for new content in existing imported site collections may take a few days, depending on the time needed to import the new content, process the data, and refresh the data in Power BI reports. Since Power BI reports are refreshed once a day, the timing of these updates is also a contributing factor.

    Image Added 
    CardioLog SaaS Configuration Screen: Step 2

    Anchor
    op_choose_user_profiles
    op_choose_user_profiles
    Step 3: Choose User Properties To Report On
     

    In this section you can select all user profile properties that you would like to filter and report on. This information will be taken from SharePoint user profiles. If you have created custom profile properties you can also use them. 
    It  For reporting purposes in CardioLog Analytics, it is recommended to select the following basic attributes - department, office, country, manager, title, picture URL. segmented fields like Department, Office, Country, and Job Title. These attributes protect individual privacy and comply with data regulations, while still providing valuable insights into organizational trends and demographics.

    Note: Make sure that the default privacy setting for the selected property is set to Everyone (and not "Only Me") in SharePoint Central Administration > User Profiles > Manage User Properties > Policy Settings.

    Image Added

    (question) What are SharePoint Profiles?

    1. Using the search bar, enter the name of any property you would like to find and include.

    2. Select the button next to each user property you would like to include in your usage reports.

      Image Added
      CardioLog SaaS Configuration Screen: Step 3 - Choose User Attributes

    3. In case Personal Identifiable Information (PII) Concealment is enabled, hover over the user property you would like to conceal in your usage reports and click the gear icon. 

      Image Added
      Step 3 - Choose User Attributes - Configure PII Concealment 

      You will have the following options to choose from:

      • Unconcealed: Data for user profile attribute values is visible in the reports.
      • Concealed: Data for user profile attribute values is concealed for enhanced security.
      • Partially Concealed: Data for user profile attribute values is concealed only for groups with a size below the selected threshold. Partial concealment allows analysis and reporting on broader trends without compromising the privacy of individuals within smaller, potentially identifiable groups.

      Image Added
      Step 3 - Choose User Attributes - PII Concealment Options


    4. Click Apply after selecting the concealment option.

    5. Click Save to confirm your selection.

    Properties may be added or removed at any time to accommodate your needs.Image Removed 

    Anchor
    op_choose_metadata
    op_choose_metadata
    Step 4: Choose Content Metadata Fields to Report On

    In this section you can select all content metadata fields that you would like to filter and report on. Metadata fields information will be taken from your SharePoint list items and documents.
    It is recommended to select metadata fields that are segmented fields, such as managed metadata columns and lookup fields.
    Metadata fields may be added or removed at any time to accommodate your needs.
     Note: The number of content metadata fields available for selection in your subscription is limited (50 by default).

    Image Added
    CardioLog SaaS Configuration Screen: Step 3

    Step 4

    4

    Make sure that the selected metadata field name is identical to the Column name as seen in the SharePoint Library settings, under Columns, click to edit the column:
    Image Added 

    Anchor
    op_add_tracking_code
    op_add_tracking_code
    Step 5: Add The Tracking Code To Your Sites

    This step allows you to add the JavaScript tracking code to each of your sites. 

    Select one of the following options to add the tracking code to specific sites or deploy it on all selected site collections and their subsites automatically.

    Note: If you would like to host the tracking code on a private CDN, please fill out the CDN details in the Advanced Settings before you proceed with adding the tracking code using one of the following options.

    Install the tracking code automatically using a PowerShell script 

    Select this option to add the tracking code to all selected site collections (in "Choose Sites to Track" step) automatically using a PowerShell script.
    Note: It is required to execute the PowerShell script every time you create new sites under the selected site collections in order to enable tracking for them.

    Image Added

    1. Click CardioLog Analytics Tracking Deployment package to download the deployment package from the "Add the CardioLog Tracking Code to your Sites" step in the Configuration page.
      The package includes a PowerShell script that deploys the tracking agent wsp solution, modern sites integration app and the Java Script tracking code on all selected site collections.
    2. Right click the downloaded package zip file, select Properties > General and click on "Unblock" before unzipping it.
    3. 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.

    Install the tracking code manually

    Select this option to add the tracking code to specific sites manually.

    Image Added

    Step 5
    1. Click CardioLog Analytics Tracking solution to download the deployment package from the "Add the CardioLog Tracking Code to your Sites" step in the Configuration page.
    2. Right click the downloaded package zip file, select Properties > General and click on "Unblock" before unzipping it.
    3. Create a CardioLogAgent folder on all SharePoint WFE servers in the following location: C:\Program Files\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS\CardioLogAgent (do not convert it to application in IIS).

    4. Create a CardioLogAgent.js file in the CardioLogAgent folder with the customer's JavaScript tracking code (provided by Intlock).. Click Copy script in the "Add the CardioLog Tracking Code to your Sites" step to copy the JavaScript tracking code.
    5. Copy the CardioLog Analytics Tracking solution file "cardiologtrackingagentfeature.wsp" to your SharePoint application server to C:\Program Files\Common Files\Microsoft Shared\web server extensions\1X\BIN folder (1X - 15 for SharePoint 2013, 16 for SharePoint 2016 and SharePoint 2019)
    6. Execute the following commands from command prompt in order to add and deploy the solution to the your SharePoint farm:

      Infocode
      cd C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\
      1X
      1X\BIN
      
      stsadm.exe -o addsolution -filename "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\
      1X
      1X\BIN\CardioLogTrackingAgentFeature.wsp"
       stsadm
      
      stsadm.exe -o deploysolution -name CardioLogTrackingAgentFeature.wsp -immediate -allowgacdeployment
       stsadm
      
      stsadm.exe -o activatefeature -name CardioLogAnalytics -force

    Image Removed
    CardioLog SaaS Configuration Screen: Step 4

    1. In order to track SharePoint 2019 modern sites, install the CardioLog Tracking Agent App:
      1. Click CardioLog Analytics Tracking Agent App for SharePoint 2019 modern sites to download the CardioLog Tracking Agent App.
      2. Upload the CardioLogTrackingAgentAddin.sppkg app to the SharePoint App Catalog > Apps for SharePoint > New.

      3. Click Deploy

      4. Add the App to your site collection and to all of its subsites under Site Contents > New App

      5. Click on Apps from your organization and click CardioLog Tracking Agent (it will be installed automatically)

      6. Once the CardioLog Tracking Agent app is installed, it is automatically activated and data is being collected. To view the installed app, go to the monitored site > Site Contents > CardioLog Tracking Agent.

    Inject the tracking code to all site pages yourself

    Select this option to inject the tracking code manually to your site pages.

    Image Added

    1. Click Copy script to copy the JavaScript tracking code to the clipboard.
    2. Paste the tracking code into the <head> section of each site page you would like to track.

    Advanced Settings

    Anchor
    op_cdn
    op_cdn
    Host the tracking code on a private CDN

    By default the tracking code resources are hosted on Microsoft Azure. Select this option if you would like to host the tracking code resources on a private CDN for increased security.
    Note: It is required to perform this step before adding the tracking code to selected sites.

    Image Added

    1. Expand the Advanced Settings section in the "Add the CardioLog Tracking Code to your Sites" step.
    2. Switch on the Host the tracking code on a private CDN toggle.
    3. Enter the CDN Address and click Save.
    4. Click Download CDN resources Here to download the latest version of the tracking code resources and host them on your private CDN.
    Anchor
    op_add_site_statistics
    op_add_site_statistics
    Enable access to Power BI Reports via the Site Statistics option in SharePoint

    Select this option if you would like to use the Site Level View feature to allow site owners to view and customize Power BI reports for their own sites only. 
    Note: It is required to perform this step before adding the tracking code to selected sites.

    Image Added

    1. Expand the Advanced Settings section in the "Add the CardioLog Tracking Code to your Sites" step.
    2. Switch on the Enable access to Power BI Reports via the Site Statistics option in SharePoint toggle.
    3. Select the Permission level in SharePoint you would like to grant access to. Users with this permission level will have access to Power BI reports via the Site Statistics option under Site Actions in SharePoint.

    Anchor
    op_connect_to_pbi
    op_connect_to_pbi
    Step 6: Connect to Power BI

    In this step, you can connect to Power BI to gain access to your CardioLog Analytics reports.

    Farm Level View

    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.

    1. Click Connect to Power BI and enter the Username and Password of a user with Power BI Pro user and 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.

      Image RemovedImage Added
      CardioLog SaaS Configuration Screen: Step 56

    2. Go to the Power BI interface.

      1. Login with the credentials you entered in Step 1the "Connect to Power BI" step.

      2. Create a Power BI app workspace for the CardioLog Analytics reports. Learn more about Power BI app workspaces.

        1. Select Workspaces Create app a workspace

        2. Enter the following details:
          Name - CardioLog Analytics
          Privacy - Private - Only approved members can see what's inside
          Permissions - Members can edit Power BI content

        3. 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.

        4. 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.

    3. 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.

    4. When the reports are ready, share them with your colleagues:
      1. Sign in to Power BI with the credentials you entered in Step 1the "Connect to Power BI" step.
      2. Select Worksaces Workspaces > CardioLog Analytics > select the Publish Create app button in the upper right to start the process of sharing all the content in that workspace.
      3. First, on DetailsSetup tab, enter the following details:
        App name - CardioLog Analytics
        Description - Analytics for SharePoint and Yammer
        Background color - Gray
        Office 365
      4. Next, on ContentNavigationyou see the content reports that's going to be published as part of the app . Select Specific content in the App landing pageand organize the navigation pane.
      5. Last, on AccessPermissions, decide who has access to the app: either everyone in your organization, or specific people or email distribution lists and click Finish.
    Step 6
      1. Publish app.
    Anchor
    op_slv
    op_slv
    Site Level View

    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.

    1. Each site owner should browse to the configuration page hosted in Azure (URL provided by Intlock) in order to to connect to Power BI, or request access to reports for specific sites via the Site Statistics option in SharePoint.
      Note: To enable the Site Statistics option in SharePoint, switch on the Enable access to Power BI Reports via the Site Statistics option in SharePoint toggle in Advanced Settings in the "Add the CardioLog tracking code to your sites" step.
    2. 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.

      Image Added
      CardioLog SaaS Configuration Screen: Connect to Power BI

    3. Click Accept in the Permissions Requested screen to allow CardioLog Analytics SaaS publish the reports to your personal workspace.

      Image Added

    4. 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.

      Image Added
      CardioLog SaaS Configuration Screen: Publish Power BI Reports to Site Owners

    5. 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.

    6. When the reports are ready, go to the Power BI interface. 

      1. Login with the credentials you entered in the "Connect to Power BI" step.

      2. Select My Workspace > Reports > CardioLog Analytics SaaS

    Anchor
    op_connect_to_ad
    op_connect_to_ad
    Step 7: Connect to Active Directory

    In this step you can connect to your Active Directory in order to import the number of active users in your organizationuser information from AD.

    1. Enter the username and password for the credentials of an account that has read access to Active Directory and the Active Directory domain controller name (FQDN) and click Save.
    Image Removed
    1. Image Added
      CardioLog SaaS Configuration Screen: Step

    6
    1. 7

      Please note that port 389 (LDAP)/port 636 (SLDAP) and the AD domain controller IP and FQDN should be available.

    2. Select all user attributes that you would like to filter and report on. This information will be taken from Active Directory user attributes. It is recommended to select attributes such as department, office, country, job title etc..

    • 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 the "Choose User Properties to Report On", there is no need to perform this step.


    Image Added
    CardioLog SaaS Configuration Screen: Step 7

    Anchor
    op_choose_group_to_opt_out
    op_choose_group_to_opt_out
    Step 8: Choose User Groups to Opt-out 

    In this step you can select which user groups 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.

    1. Enter the credentials of an account that has read access to Active Directory and the Active Directory host (FQDN) and click Connect.

      Image Added

      Please note that port 389 (LDAP)/port 636 (SLDAP) and the AD domain controller IP and FQDN should be available.

    2. Select the user groups you would like to opt-out of data collection and click Save.

      Image Added
       
    3. Click Confirm to acknowledge that:
      1. Data for opted out users, including user profile information and usage data, will be: 
        1. Permanently deleted 
        2. No longer collected
        3. No longer available in reports
      2. Data for opted in users, including user profile information and usage data, will be collected and available in reports, however any data that was deleted/not collected during the time period they were opted out will not be recovered.
      3. Using this functionality may result in data discrepancies in some reports.

        Image Added

    Yammer

    Step 1 : Add the CardioLog Analytics SaaS App from the Yammer's App Directory

    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.

     

    Anchor
    yammer_connect_to_yammer
    yammer_connect_to_yammer
    Step 2: Connect to Yammer

    Connect to your Yammer network with a dedicated service account that is a Verified Admin in your Yammer network.

    Image Added

    Anchor
    yammer_connect_to_graph_api
    yammer_connect_to_graph_api
    Step 3: Connect to Microsoft Graph API

    Connect to Microsoft Graph API with an account that is a global administrator in your Office 365 tenant to gather analytics data for Yammer. 
    Note: This account will be used in order to approve the required permissions for CardioLog Analytics SaaS to connect to Microsoft Graph API (User.Read and Reports.Read.All).

    Image Added

    Anchor
    yammer_choose_user_profiles
    yammer_choose_user_profiles
    Step 4: Choose User Attributes

    In this step you can select all user attributes that you would like to filter and report on. This information will be taken from the Yammer user profiles. 

    1. Select the button next to each user property you would like to include in your usage reports.

    2. 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. 

    3. Click Save to confirm your selection.

    Properties may be added or removed at any time to accommodate your needs.

    Image Added

    Anchor
    yammer_connect_to_pbi
    yammer_connect_to_pbi
    Step 5: Connect to Power BI

    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.

    Image Added

    Go to the Power BI interface.

    1. Login with the credentials you entered in the "Connect to Power BI" step.

    2. Create a Power BI app workspace for the CardioLog Analytics reports. Learn more about Power BI app workspaces.

      1. Select Workspaces Create app workspace

      2. Enter the following details:
        Name - CardioLog Analytics
        Privacy - Private - Only approved members can see what's inside
        Permissions - Members can edit Power BI content

      3. 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.

      4. 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:

    1. Sign in to Power BI with the credentials you entered in the "Connect to Power BI" step.
    2. Select Worksaces > CardioLog Analytics > select the Publish app button in the upper right to start the process of sharing all the content in that workspace.
    3. First, on Details, enter the following details:
      Description - Analytics for SharePoint and Yammer
      Background color - Gray
    4. Next, on Content, you see the content that's going to be published as part of the app. Select Specific content in the App landing page
    5. Last, on Access, decide who has access to the app: either everyone in your organization, or specific people or email distribution lists and click Finish.

    Microsoft Teams

    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.

    Image Added

    CardioLog SaaS Configuration Screen

    Step 1: Connect to Power BI

    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.

    Image Added

    Go to the Power BI interface.

    1. Login with the credentials you entered in the "Connect to Power BI" step.

    2. Create a Power BI app workspace for the CardioLog Analytics reports. Learn more about Power BI app workspaces.

      1. Select Workspaces Create app workspace

      2. Enter the following details:
        Name - CardioLog Analytics
        Privacy - Private - Only approved members can see what's inside
        Permissions - Members can edit Power BI content

      3. 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.

      4. 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:

    1. Sign in to Power BI with the credentials you entered in the "Connect to Power BI" step.
    2. Select Worksaces > CardioLog Analytics > select the Publish app button in the upper right to start the process of sharing all the content in that workspace.
    3. First, on Details, enter the following details:
      Description - Analytics for SharePoint and Yammer
      Background color - Gray
    4. Next, on Content, you see the content that's going to be published as part of the app. Select Specific content in the App landing page
    5. Last, on Access, decide who has access to the app: either everyone in your organization, or specific people or email distribution lists and click Finish.

    Anchor
    teams_connect_to_teams
    teams_connect_to_teams
    Step 2: Connect to Teams

    1. Connect to Teams with an account that is a global administrator in your Office 365 tenant. This account will be used in order to approve the required permissions for CardioLog Analytics SaaS to connect to Teams.

      Image Added

    2. Click Accept to approve the required permissions.

      Image Added

    3. In order to collect data about the contents of channel messages for selected teams click Report on channel conversations.

      Image Added

    4. Follow the steps to download and install the CardioLog Analytics Teams Connector App in order to be able to report on the contents of channel messages in the selected Teams (selected in step 3). 
      Click Test App Connection to confirm the installation is successful.

      Image Added

    5. In order to allow storing and displaying user profile images in reports, click Import user profile images.

    Anchor
    teams_choose_teams
    teams_choose_teams
    Step 3: Choose Teams To Track

    In this step you can select which Teams you would like to see data for in reports.

    1. In order to track all of your Teams, including new ones that will be created in the future, click Track all teams.

      Image Added

    2. In order to track specific teams, click Track specific teamsWith this section expanded, you should see all of your available Teams.
      Select all the Teams you would like to monitor using CardioLog. You can also search for Teams by typing in their name in the search bar. Select the button next to each Team you would like to monitor and click Save to confirm your selection. You can go back and add more Teams or remove Teams from your selection at any point.

      Image Added

      Please note that the import process for large Teams may take a few hours up to a few days, depending on the environment size.

    OneDrive for Business

    Anchor
    onedrive_connect_to_onedrive
    onedrive_connect_to_onedrive
    Step 1: Connect to OneDrive for Business

    1. Connect to OneDrive for Business with an account that is a global administrator in your Office 365 tenant. This account will be used in order to approve the required permissions for CardioLog Analytics SaaS to connect to OneDrive for Business.

      Image Added

    2. Click Accept to approve the required permissions.

      Image Added

    Exchange Online

    Anchor
    exchange_connect_to_exchange
    exchange_connect_to_exchange
    Step 1: Connect to Exchange Online

    1. Connect to Exchange Online with an account that is a global administrator in your Office 365 tenant. This account will be used in order to approve the required permissions for CardioLog Analytics SaaS to connect to Exchange Online.

      Image Added

    2. Click Accept to approve the required permissions.

      Image Added