performancebridgepractice v1.4 · printedcopiesareuncontrolled. d000275688 rev. d csiplevel0-basic...

Copyright © 2019 Koninklijke Philips N.V. All Rights Reserved. CSIP Level 0 - Basic

Printedco

pies

areun

controlle

d.

Proprietary Notice:This document and the information contained in it is proprietary and confidential information of Philips and may not be reproduced, copied in whole or in part, adapted, modified, disclosed to others, or disseminatedwithout the prior written permission of the Philips Legal Department. Use of this document and the information contained in it is strictly reserved for current Philips personnel and Philips customers who have a currentand valid license from Philips for use by the customer’s designated in-house service employee on equipment located at the customer’s designated site. Use of this document by unauthorized persons is strictlyprohibited. Report violation of these requirements to the Philips Legal Department. This document must be returned to Philips when the user is no longer licensed and in any event upon Philips’ first written request.

Warranty Disclaimer:Philips provides this DOCUMENT without warranty of any kind, implied or expressed, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose.

Limitations of Liability:Philips has taken care to ensure the accuracy of this document. However, Philips assumes no liability for errors or omissions and reserves the right to make changes without further notice to any products herein toimprove reliability, function, or design. Philips may make improvements or changes in the product(s) or program(s) described in this document at any time.

CSIP Level 0:This document or digital media and the information contained in it is proprietary and confidential information of Philips and may not be reproduced, copied in whole or in part, adapted, modified, disclosedto others, or disseminated without the prior written permission of the Philips Legal Department. This document or digital media is intended to be (a.) used by customers and is licensed to them as part of their Philipsequipment purchase or (b.) used to meet regulatory commitments as required by the FDA under 21 CFR 1020.30 (and any amendments to it) and other local regulatory requirements. Use of this document or digitalmedia by unauthorized persons is strictly prohibited.

D000275688 Revision D

PerformanceBridge Practicev1.4.0Administrative Guide

Printedco

pies

areun

controlle

d.

D000275688 Rev. D CSIP Level 0 - Basic 2Copyright © 2019 Koninklijke Philips N.V. All Rights Reserved.

ATTENTION: THIS PAGE CONTAINS COPYRIGHTED MATERIALS THAT ARE CONFIDENTIAL AND/OR PROPRIETARY. ANY RELEASE OR DISTRIBUTION OF THIS MATERIAL,WITHOUT PERMISSION, IS A VIOLATION OF LAW.

1 Product InformationPhilips Medical Systems3000 Minuteman RoadAndover, MA 01810

Administrative Guide Administrative Guide

Printedco

pies

areun

controlle

d.



TABLE OF CONTENTS

1 Product Information ................................................................................................... 22 Publication History ..................................................................................................... 53 Introduction ................................................................................................................ 6

3.1 About PerformanceBridge............................................................................... 63.2 Purpose and Intended Use of This Document ................................................ 63.3 Browser Compatibility..................................................................................... 63.4 Malware Folder Exclusion ............................................................................... 7

4 Administrator Instructions for Use ............................................................................ 84.1 Overview.......................................................................................................... 84.2 Portal Page ...................................................................................................... 84.3 Logging in to PerformanceBridge Practice.................................................... 114.4 Benchmarking Data ....................................................................................... 134.5 Synchronizing Time Interval for Cube Building............................................. 134.6 Using the Auto Log Off Functionality............................................................ 154.7 Updating the Orientation for PDF Report View............................................ 174.8 Data Security ................................................................................................. 18

4.8.1 Securing Visible Data......................................................................... 184.8.2 Adding Groups from Active Directory............................................... 194.8.3 Adding Locally Managed Users to PerformanceBridge

Practice ...................................................................................... 224.8.4 Adding Users from Active Directory.................................................. 234.8.5 Setting Group Permissions ................................................................ 244.8.6 Changing User Passwords ................................................................. 31

4.8.6.1 Changing Password for Windows 2012 Server ..................... 314.8.6.2 Changing Password for Customer SMTP Server Used for

Sisense ........................................................................... 334.8.6.3 Changing Password for PerformanceBridge Practice

Application Users........................................................... 384.9 Assessing Dashboard Performance............................................................... 414.10 Configuring the Report Layout...................................................................... 434.11 Special Characters in Report Names............................................................. 444.12 Email Settings ................................................................................................ 44

4.12.1 Configuring Email Settings Overview ................................................ 444.12.2 Updating Reporting Email Messages ................................................ 45

Printedco

pies

areun

controlle

d.



4.12.3 Updating Dashboard Email Notifications.......................................... 454.12.4 Updating the Contents of Email Templates...................................... 47

4.13 Customizing the Color Palettes for KPIs....................................................... 484.14 Overriding Locale Settings............................................................................. 504.15 Accessing Audit Logs ..................................................................................... 514.16 Enabling Pulse Alerts ..................................................................................... 514.17 Inserting Time-Zone Abbreviations............................................................... 54

Printedco

pies

areun

controlle

d.



2 Publication HistoryTable 1 Publication History

Revision Date Description

A 2019-01-08 Initial releaseB 2019-03-14 Updates to adding users from Active

Directory and product manufacturinginformation

C 2019-03-27 Clerical updates

D 2019-10-01 v1.4.0 release

Administrative Guide Publication History

Printedco

pies

areun

controlle

d.



3 Introduction3.1 About PerformanceBridge

PerformanceBridge Practice is an innovative offering to help our customers unify data and unlock actionable information toenhance operational and clinical decision making that’s centered around the patient.

Intended Medical Indication

IMPORTANT

This product is not for diagnostic, monitoring or therapeutic purposes or in any other manner for regular medical practice.

3.2 Purpose and Intended Use of This DocumentThe procedures in this document capture the detailed sequence of steps needed to configure the PerformanceBridge Practicesolution stack with post installation steps.

NOTE

Software Licensing Statement

Copyrights and all other proprietary rights in any software and related documentation ("Software") made available to you restexclusively with Philips or its licensors. No title or ownership in the Software is conferred to you. Use of the Software is subjectto the end user license conditions as are available on request.

3.3 Browser CompatibilityTo make sure you have the best experience, use one of the following supported browsers versions:

• Chrome (>=42.x)

• Safari (>=8.x)

Validated for use on the Apple iPad using the Safari browser.

• Firefox (>=37.x)

• Internet Explorer (>=9)

Administrative Guide About PerformanceBridge

Printedco

pies

areun

controlle

d.



The system relies on HTML5, CSS3, JavaScript and other web standards. Each web browser may implement part or all of thesestandards. The system has also been tested and validated for use on Apple iPads using the Safari browser.

3.4 Malware Folder ExclusionThe IT Administration needs to exclude the following folders from the PerformanceBridge Practice web UI from any FirewallBlocks or Malware Detection Scans:

• C:\Program Files\Sisense

• C:\ProgramData\Sisense

Administrative Guide Malware Folder Exclusion

Printedco

pies

areun

controlle

d.



4 Administrator Instructions for Use4.1 Overview

Philips PerformanceBridge Practice is a practice management tool that integrates with the Hospital Information System (HIS) orRadiology Information System (RIS), as well as the Picture Archive and Communication System (PACS), and provides visualrepresentation of collected data for analysis and review across the enterprise.

Figure 1: System Architecture

4.2 Portal PageThe PerformanceBridge Portal Page is the access point to all of the PerformanceBridge applications.

Administrative Guide Overview

Printedco

pies

areun

controlle

d.



Figure 2: Portal Page (Representative Image)

The Portal Page also allows users to customize the settings for their individual profile including Display name, Language, andTheme (light or dark).

Administrative Guide Portal Page

Printedco

pies

areun

controlle

d.



Figure 3: User Profile

Administrative Guide Portal Page

Printedco

pies

areun

controlle

d.



4.3 Logging in to PerformanceBridge Practice

Figure 4: PerformanceBridge Practice Login Screen

Users are provided with the site URL and the credentials to log in to the tool by a Philips Representative or Site Administrator.

There are two types of user logins for PerformanceBridge Practice:

• Local users created in the web interface

• Active Directory (AD) users linked to PerformanceBridge Practice

Both local and AD users must be defined in PerformanceBridge Practice prior to their initial log in to the application. Refer toPerformanceBridge Practice Administrators Guide for instructions on adding users to the system.

User accounts require the use of complex passwords, which includes at least 3 of the following 4 types of characters:

• Uppercase letters

• Lowercase letters

Administrative Guide Logging in to PerformanceBridge Practice

Printedco

pies

areun

controlle

d.



• Numeric characters

• Special characters (#$&*)

To reset the login password, AD users are required to contact the Active Directory Administrator of the site. Using the ForgotPassword button on the login screen does not reset the password.

Non-AD users are to click the Forgot your password? Click here link provided below the Login button. The user is redirected tothe Forgotten Password page and is requested to enter their email address that is linked to their PerformanceBridge Practice.After the user enters their email address and clicks Send, a link is provided via email for the user to reset their password.

Figure 5: PerformanceBridge Practice Reset Password Page

Administrative Guide Logging in to PerformanceBridge Practice

Printedco

pies

areun

controlle

d.



NOTE

The emails received for account creation and dashboard sharing may come with some attachments (notably with G-mailSMTP).

Due to firewall settings, email notifications may not be received for user creation or dashboard sharing in the Philips generalnetwork. Make sure to check the firewall setting at site if a similar issue is noticed.

4.4 Benchmarking DataValidations in benchmark data:

Sync the TAT_Type in the TAT Benchmark table with the TAT_type used in TAT_Phases/HL7 Phases view in the elastic cube. Thiswill enable the ability to dynamically add TATs.

NOTE

Validation will not be performed on this TAT_Type. It is the user’s responsibility to make sure the required validated data is inplace.

Benchmark fields:

Enter all combinations of parameters on which benchmarks/targets are assigned (e.g. If modality benchmark is for site/dept/modality/device/patient class, all valid combinations must be entered). Support is provided if there are unavailable benchmarksin some fields. For a drill down in benchmark graphs, no benchmarks appear, but if a field is not benchmarked in benchmarkmaster data overview table widgets, the corresponding benchmark master data overview table must exclude it from its widgetfilter list (widget level). Do not provide device benchmarks for HL7 only dashboards. Pick the technologist and radiologist namesfor user-specific benchmarking from the drill views (HL7_TAT/DICOM_exams) as they are the only source of staff names/dataavailable.

When benchmarks are being introduced for a new year, make sure that the calendar has been generated as mentioned in MasterData Configuration. DayOfTheWeek benchmarks are aggregated based on the fields for which the benchmarks are provided andbased on date range and field selection in the filters.

4.5 Synchronizing Time Interval for Cube BuildingTo configure the time interval for synchronized cube building on site:

1. Log in to Windows VM with administrator credentials.

2. Open the Sisense Server Console

Administrative Guide Benchmarking Data

Printedco

pies

areun

controlle

d.



3. In the list of available elasticubes (e.g. PMTDM and/or PMTDM_Backfill), select the desired cube for setting thesynchronized cube building interval

4. From the options, select Schedule Synchronization.

Figure 6: Schedule Synchronization

5. Set the schedule for the desired time period/interval (e.g. 30 minutes) and update the applied changes.

Administrative Guide Synchronizing Time Interval for Cube Building

Printedco

pies

areun

controlle

d.



Figure 7: Schedule Sync

6. Click Update.

This will enable cube building after every 30 minutes.

4.6 Using the Auto Log Off FunctionalityThe system has the capability to log off the user if inactive for 600 seconds by default.

The user will be notified by a system idle popup, which will run for 60 seconds before automatically logging off the user.

Administrative Guide Using the Auto Log Off Functionality

Printedco

pies

areun

controlle

d.



Figure 8: System Idle Popup

NOTE

The time mentioned in the configuration file is in seconds.

System idle time and session expiration time values can be configured, but are set to the following default:

• System idle time (time duration user is inactive): 600 seconds

• Log out/session expiration time (time duration user can respond to auto log off popup): 60 seconds

Figure 9: Time Values for Auto Log Off

To configure idle time and log out time values:

1. Log in to the Windows system with administrator credentials.

Administrative Guide Using the Auto Log Off Functionality

Printedco

pies

areun

controlle

d.



2. Navigate to c:\philips\dist\assets\autoLogoffConfig.json

3. In setIdleTime and setTimeoutTime, type the desired time value in seconds.

4. Save the file.NOTE

The minimum values for system idle time and session expiration time are 600 seconds and 60 seconds respectively. If theadministrator sets the values less than the default time durations, the system will follow the default time to log out the userand expire the session. Administrative users can set the time duration for more than the default.

IMPORTANT

There is a delay of 20-25 second in the process for the auto logoff timeout period allowing users to access the application viathe browser history and circumvent the login page. Philips always recommends to use the PerformanceBridge Practice loginpage to access the application.

4.7 Updating the Orientation for PDF Report ViewTo update the orientation for PDF Report View:

1. Navigate to the file assets/ setPdfView.json.

2. Modify the key value pair maintainOrientation:

• If set to true, the selected orientation (portrait or landscape) is maintained.

• If set to false, the report view fits to the page.

Administrative Guide Updating the Orientation for PDF Report View

Printedco

pies

areun

controlle

d.



Figure 10: Key Value Pair

4.8 Data Security4.8.1 Securing Visible Data

The system has the capability of securing the data visibility on the user group level. The steps necessary for application of datasecurity are to be followed in the given sequence:

1. Configuring Active Directory

2. Adding User Groups and Users

3. Building Data Source

4. Enabling Data Security on Data Source

Administrative Guide Securing Visible Data

Printedco

pies

areun

controlle

d.



4.8.2 Adding Groups from Active Directory

NOTE

Adding groups from Active directory pulls all the users from the group into the application. The users belonging to the addedgroup are not displayed under the Users tab.

To add groups from the Active Directory:

1. Navigate to the Groups tag.

2. Click Add Group > Import from Active Directory.

Figure 11: Adding Groups from AD

The following are the sample groups for the reference for sites:

Administrative Guide Adding Groups from Active Directory

Printedco

pies

areun

controlle

d.



Table 2 PerformanceBridge Practice Groups

Group Name Description

Modality Managers (MM) Hospital staff that is in charge of the technologists for aspecific modality; belongs to Radiology Clinical User category.Modality Managers would be specific to a site, department,location and modality (MR, CT, US etc).

Radiology Business Manager (RBM\RA) Hospital staff that is in charge of managing the radiologydepartment and is the most in-depth user of the system;belongs to Radiology. Radiology Business Managers may ormay not be specific to a site. If an RBM is shared acrossmultiple site, they must belong in each site’s AD domain.

Radiology Department Chair (RDC) Hospital Department Chair or Vice Chair who is responsiblefor operational and clinical excellence along with the financialperformance of the department; belongs to Radiology ClinicalUser category. Radiology Department Chairs are in chargeover multiple sites within an IDN.

Radiology Site Manager (RSM) Hospital staff who is responsible for the operations of aspecific site; belongs to Radiology Clinical User category.Radiology Site Managers are specific to a site and need to betied to his\her particular domain.

Solution Advisor Philips team that provides insights on-site and remotely .Solution Advisors support data governance set up, audit,community building, root cause analysis (typically during theinitial engagement with the hospitals), and prototyping foruse case discovery. Solution Advisors will continueengagement with the hospitals for a longer period ascompared to the solution architect. They are also partnerswith Practice management tool clients and help themtroubleshoot issues around operations.


Printedco

pies

areun

controlle

d.



Table 2 PerformanceBridge Practice Groups (continued)

Solution Architect Philips team that provides insights on-site and remotely .Solution Scientists support data governance set up, audit,community building, root cause analysis (typically during theinitial engagement with the hospitals), prototyping for usecase discovery, and technology de-risking. Solution Architectsperform analysis on hospital data and make suggestions toimprove hospital efficiency.

Fulfilment - Installation and Configuration Implementation personnel who configure the Practicemanagement tool software in order to customize it to caterthe needs of the hospital. They need access to PHI to fixexceptional workflow at the customer site.

Customer Service Philips support force for configuration, customization, break/fix issues and installation. Customer Service belongs toAdmin/Service User category. Their primary responsibility is toperform software upgrades, monitor system, debug issues,take crash dump, and debug issue at premise or remotely.They will access to the system in the context of serviceability.They would have read rights to Protected Health Information(PHI) in order to investigate and troubleshoot, but would notneed modify rights on PHI.

R&D Dev Very limited access to the system.

Radiology IT Admininistrators Hospital staff that is responsible for management of entirehospital IT system; belongs to Admin/Service User category.

Hospital staff Responsible for management of entire hospital IT system;belongs to Admin/Service User category.


Printedco

pies

areun

controlle

d.



4.8.3 Adding Locally Managed Users to PerformanceBridge PracticeTo add users managed locally within PerformanceBridge Practice (Non-AD):

1. Navigate to the Users tab.

2. Click Add Users.

3. Define the following user information:

a. Email

b. User Name

c. First Name (optional)

d. Last Name (optional)

e. Roles

f. Groups (optional)

g. Password (optional)

4. Click Save.

Administrative Guide Adding Locally Managed Users to PerformanceBridgePractice

Printedco

pies

areun

controlle

d.



Figure 12: Adding Locally Managed Users

NOTE

PerformanceBridge only utilizes the Viewer, Designer, and Administrator roles. Data Designer and Data Administrator rolesonly have access to the Admin Tab for Elasticube Management. The Data Designer is limited to Start and Stop Service to theElasticube; whereas the Data Administrator has access to create and update an Elasticube. The Administrator role provides theuser with both functionalities.

4.8.4 Adding Users from Active DirectoryTo add users from Active Directory:

1. Navigate to the Users tab.

2. Click Add Users > Import from External Server.

Administrative Guide Adding Users from Active Directory

Printedco

pies

areun

controlle

d.



Figure 13: Adding Users from Active Directory

3. Type the name of the user to import from Active Directory.

4. Select the user from the results.

5. Define the Role and Group (optional).

6. Click Save.

4.8.5 Setting Group PermissionsAppropriate users and groups need to be created and available in the Active Directory before performing this procedure.

To assign permissions to a group:

1. Click ElastiCubes & Datasets and select the cube that has been built (i.e. PMTDM).

2. Click Data Security.

Administrative Guide Setting Group Permissions

Printedco

pies

areun

controlle

d.



Figure 14: Data Security

NOTE

Application of Data Security is only available to users with Administrative Roles

3. Click Add Another Field on the page that appears.


Printedco

pies

areun

controlle

d.



Figure 15: Add Another Field

4. Search for site_description and select site_description from dim_sites.

Figure 16: Site_description

5. Click Add Restriction .


Printedco

pies

areun

controlle

d.



Figure 17: Add Restriction

6. Search for and select the desired group to assign permissions.

Figure 18: Search for Users and Groups

7. Select the desired group.


Printedco

pies

areun

controlle

d.



Figure 19: Select Group

8. Search for and add the values to show the selected group.


Printedco

pies

areun

controlle

d.



Figure 20: Adding Values

Administrators can add multiple values and multiple groups in this section.


Printedco

pies

areun

controlle

d.



Figure 21: Multiple Values and Groups

NOTE

Do not apply any restrictions for Everyone else. Remove the restriction of Nothing by clicking the x to the right of thefield.

9. To add more restrictions, click Add Another Field.


Printedco

pies

areun

controlle

d.



NOTE

Group and User Data Security utilizes a UNION on permissions. If a group has data security more narrow than the user, theuser will may have narrowed visibility to the data. This may also limit the data available for selection in the filters if the fieldsdo not connect to the corresponding tables in the Elastic cube. It is recommended to thoroughly discuss Data Security with aPhilips Solution Advisor during configuration.

NOTE

If adding KPIs like “Technologist by Department”, specify which technologist a particular Modality Manager can see byselecting Operator Name and select the user for which to set the permission and add all the technologist under theirmanagement.

NOTE

For third party vendor like Sisense, it is not required to create groups or users in Active Directory. A customer service usershares the log details with them.

4.8.6 Changing User Passwords4.8.6.1 Changing Password for Windows 2012 Server

To change the password for Windows 2012 server:

1. Log in to the server via Remote Desktop.

2. Open the Windows desktop menu and type Administrative Tools.

3. Click Computer Management to open.

4. Expand Local Users and Groups.

Administrative Guide Changing Password for Windows 2012 Server

Printedco

pies

areun

controlle

d.



Figure 22: Local Users and Groups

5. Click Users.

6. Right click Administrator and select Set Password > Proceed.

Administrative Guide Changing Password for Windows 2012 Server

Printedco

pies

areun

controlle

d.



Figure 23: Set Password

7. Type the new password in both fields and click OK.

4.8.6.2 Changing Password for Customer SMTP Server Used for SisenseTo change the password for the customer SMTP server used for Sisense:

1. Log in to the PerformanceBridge Practice Application as a system administrator.

2. Navigate to the Admin tab.

3. In the left column, click REST API.

Administrative Guide Changing Password for Customer SMTP Server Used forSisense

Printedco

pies

areun

controlle

d.



Figure 24: Rest API

4. Expand the settings tab.


Printedco

pies

areun

controlle

d.



Figure 25: Expand Settings Tab

5. Expand the PATCH option of /settings/email_server API.

6. In the emailServer text field, type the password in the same format illustrated in the image below.


Printedco

pies

areun

controlle

d.



Figure 26:

7. Click Run.

8. In Response Body , make sure the password updated correctly. Also make sure the Response Code is 200 after the runoperation.


Printedco

pies

areun

controlle

d.



Figure 27: Verify Information in Response Body and Response Code

9. Verification can also be done by using the GET option of the settings/email_server API. Click Run and look for the passfiled in the Response Body.


Printedco

pies

areun

controlle

d.



NOTE

The accounts and passwords displayed are only used for demonstrative purposes. Please use the user name and password asper the site requirement.

4.8.6.3 Changing Password for PerformanceBridge Practice Application UsersTo change the password for PerformanceBridge Practice application users from administrative account:

1. Log in to PerformanceBridge Practice with administrative credentials.

2. Click Admin.

3. Click the edit icon.

4. Click Change Password.

5. Type the new password in both fields and click Save.

Administrative Guide Changing Password for PerformanceBridge PracticeApplication Users

Printedco

pies

areun

controlle

d.



Figure 28: Change Password

NOTE

If users are imported from LDAP, PerformanceBridge Practice administrators do not have permission to change the password.

To change the password for PBP application local user using Forgot Password link:

1. Launch the PerformanceBridge Practice login page.

2. Click the Forgot Password link.

3. Type the registered email of the local user and click Send. An email is triggered to the registered email account thatcontains a password reset link.

4. Open the email and click the link Please click here to reset password.


Printedco

pies

areun

controlle

d.



Figure 29: Reset Password Link

5. In the window that appears, type a new password and re-type for confirmation.


Printedco

pies

areun

controlle

d.



Figure 30: Type New Password

4.9 Assessing Dashboard PerformanceThis section lists potential behavior within PerformanceBridge Practice.

1. If the data mappings are not configured appropriately, the following values may display:

• Unknown: Master Data files with missing information about operator/technologist name (DICOM/HL7), manufacturer(DICOM), ordering department / performing department (HL7), radiologist name (HL7), Referring Physician (HL7) mayshow ‘Unknown’ as value in filters.

Administrative Guide Assessing Dashboard Performance

Printedco

pies

areun

controlle

d.



Figure 31: Unknowns in Filters

• Blank: If there is any segment in raw data without any value it displays Blank as a filter value.

2. Red circles in a bar graph indicates the benchmarks set. These benchmarks are dependent upon the graph that is initiallydisplayed and have yearly, monthly, or daily values.

Administrative Guide Assessing Dashboard Performance

Printedco

pies

areun

controlle

d.



Figure 32: Red Circles in Bar Graph

3. If accessing PerformanceBridge Practice in multiple windows of a Chrome browser, refresh the application in order toreflect any changes made in different windows or tabs to synchronize the data.

4. For average calculations on KPIs within Dashboards, records with zero or negative values are not considered and areanomalies.

5. When exporting Dashboards, a “Dashboard Export Success” message appears on the UI, irrespective of whether the userclicks OK or Cancel from the Download Options window.

NOTE

It is suggested that the Solutions Advisor/System Admin reviews Dashboards and widgets to make sure the expected widgets(which are required in the Summary page of the shared user) appear before sharing with other users. The exportedDashboards may have widgets added to the Summary page.

4.10 Configuring the Report LayoutTo configure the report layout to be reflected in generated reports:

1. Log in to the PerformanceBridge Practice application.

2. Navigate to the Tools tab.

Administrative Guide Configuring the Report Layout

Printedco

pies

areun

controlle

d.



3. Click the expand icon, and then select the “+” icon.

4. Enter layout name and then click OK.

5. Fill in template details.

6. Click Show Preview, and then click Save to accept changes.

4.11 Special Characters in Report NamesIt is normally recommended to eliminate the use of special characters in the report name when creating schedules, as thecorresponding reports are not generated. However, the following set of special characters are currently supported and can beused where required:

• Exclamation point: !

• At symbol: @

• Dollar sign: $

• Ampersand: &

• Open parenthesis: (

• Closed parenthesis: )

• Underscore: _

• Hyphen: -

• Equal sign: =

• Tilde: ~

• Comma: ,

4.12 Email Settings4.12.1 Configuring Email Settings Overview

Email notifications are triggered for the following actions:

• Creation of user accounts

• Sharing of Dashboards

• Sharing of Reports

Administrative Guide Special Characters in Report Names

Printedco

pies

areun

controlle

d.



• Schedule reporting with auto approve on/off workflow

• Password reset for local (Non-AD) users

4.12.2 Updating Reporting Email MessagesSystem Administrators can update the Email Body Content that PBP users will receive on a schedule report or while reportsharing.

To update email messages:

1. Navigate to the directory /var/lib/tomcat6/webapps/PBPReportsApp/WEB-INF/classes

2. Open the file reports.properties.

3. Update the following fields for email notifications:

• HospitalName: <Name of the Hospital>

• HospitalAddress: <Address of the Hospital>

• CopyRightInformation: <Add Copyright Information>

4. Update hospital logo:

a. Navigate to the directory/var/lib/tomcat6/webapps/PBPReportsApp/WEB-INF/classes/Images

b. Copy PNG logo of the hospital into the current location.

5. Configure FQDN:

a. Navigate to the directory /var/lib/tomcat6/report_resource/.

b. Update the application.properties file with SISENSE_IP = <FQDN VALUE>.

4.12.3 Updating Dashboard Email NotificationsTo update dashboard email notifications:

1. Navigate to the following location: <Windows VM>\Program Files\Sisense\PrismWeb\vnext\src\features\emails\templates

2. Open the file header.ejs and update the hospital name and hospital address.

Administrative Guide Updating Reporting Email Messages

Printedco

pies

areun

controlle

d.



Figure 33: Update Hospital Name and Address

NOTE

The emails received for account creation and dashboard sharing, such as Gmail SMTP, may contain attachments.

NOTE

In the Philips general network, email notifications may not be received for user creation or dashboard sharing due tofirewall settings. It is recommended to check the firewall settings at the site if you notice this issue.

To update the hospital logo:

1. Copy the desired image and paste to the folder <Windows VM>\Program Files\Sisense\PrismWeb\vnext\src\features\emails\templates\images.

2. Rename the image to logo_black.png.

Limitations

Administrative Guide Updating Dashboard Email Notifications

Printedco

pies

areun

controlle

d.



• Supportive Image format for Reporting application is PNG.

• User has to rename the hospital logo to hospitalLogo.png for reporting related emails.

• User has to rename the hospital logo to logo_black.png for configuring for dashboard related emails.

• In case of IDN structure, Main branch Hospital’s logo, name and address should be given.

• When authenticating an HTTP request, Sisense only supports the basic authentication through the Authorization methodusing plain text.

• No Errors are displayed in the UI.

4.12.4 Updating the Contents of Email TemplatesSystem Admins can edit or modify the default contents (body of the email) for the following templates that are available ashtml.eje files under their respective folders:

• build_alert

• dashboard_errors_report

• dashboard_errors_report_bulk_fail

• dashboard_report

• empty_dashboard_report

• kpi_alert

• new_user_invitation

• password_recovery

• share_elasticube

• share_with

• transfer_ownership

• user_created

• user_created_ad

Administrative Guide Updating the Contents of Email Templates

Printedco

pies

areun

controlle

d.



Figure 34: Edit/Modify Email Contents

4.13 Customizing the Color Palettes for KPIsAdministrators can change the default Philips color themes into customer-specific themes using the Rest API.

To change the default color palettes themes:

1. Log in to the PerformanceBridge Practice management tool as a system administrator.

2. Navigate to the Admin tab.

3. In the left column, click REST API

4. Select palettes > POST /palettes to add a new color palette.

Administrative Guide Customizing the Color Palettes for KPIs

Printedco

pies

areun

controlle

d.



Figure 35: POST /palettes

5. Run the following Json command in the body text box in POST/palettes:

Administrative Guide Customizing the Color Palettes for KPIs

Printedco

pies

areun

controlle

d.



After running, the Philips name appears in the color palettes list.

4.14 Overriding Locale SettingsThis section explains how to use Rest API to override the default locale settings for all users, and how to manually add a localefile not included in the default Sisense installation.

To access Rest API from the Sisense web application:

1. Click Manage > Rest API > Rest API Reference.

2. Open /SETTINGS > POST /settings/globalization.

3. Run the API call: /api/settings/globalization

4. Set autoDetectEnabled to false by using the following command:

5. Click RUN.

Sisense supports the following locale settings:

• United States

• United Kingdom

• Israel

• Canada

• South Africa

• Australia

• Netherlands

Administrative Guide Overriding Locale Settings

Printedco

pies

areun

controlle

d.



• Germany

• Ireland

• Mexico

• France

• China

• Brazil

4.15 Accessing Audit LogsTo access Sisense audit logs in the integrated platform release:

1. Log in to the Service Tools app.

2. Navigate to Logs > App Usage.

NOTE

Handling Biologics hardware: It is VERY IMPORTANT that when shutting down the system, use either the shutdown option inthe software (Setup section), or use the LCD screen. Improper shutdown of the system may cause hard kill of the system,leaving the database in an uncorrectable state.

4.16 Enabling Pulse AlertsSystem Administrators have the ability to enable Pulse Alerts within the PerformanceBridge Practice application. These alertscan be set for Indicator Widgets to allow users to be notified when specific benchmarks are reached.

To enable Pulse Alerts, follow these steps:

1. Access the Admin Page.

2. Navigate to the REST API configurations.

3. Select the features operation.

4. Select the PATCH operation to expand the field for editing.

Administrative Guide Accessing Audit Logs

Printedco

pies

areun

controlle

d.



Figure 36: Features

5. Type alerting in the key field.

Administrative Guide Enabling Pulse Alerts

Printedco

pies

areun

controlle

d.



6. Type the following in the toggleFeature field:{"key": "alerting","active": true,"name": "Alerting","description": "Alerting module that allows users to add alerts and get notifications.","subscriptions": [{"name": "buildSubscription","active": true},{"name": "kpiSubscription","active": true}]}

Administrative Guide Enabling Pulse Alerts

Printedco

pies

areun

controlle

d.



Figure 37: PATCH Operation with Populated Information

7. Click RUN ( ) to toggle the feature ON.

8. Log out of the application, and then log back in to verify the change.

4.17 Inserting Time-Zone AbbreviationsIn some instances, the time zone is pre-configured and may not be accurate.

Follow these steps to enter the appropriate abbreviation for the time zone:

Administrative Guide Inserting Time-Zone Abbreviations

Printedco

pies

areun

controlle

d.



1. Log in to Windows VM with administrator credentials.

2. Open the Sisense Server Console.

3. Navigate to C:\Philips\dist\assets\ .

4. Edit the file time_zones.json.

5. Type the value in the comma separated format: {value='<time zone full name>',abbr='<time zone abbreviation>'}.

NOTE

There may be a difference in time zone abbreviations depending on whether you are using Windows or Mac.

Administrative Guide Inserting Time-Zone Abbreviations

performancebridgepractice v1.4 · printedcopiesareuncontrolled. d000275688 rev. d csiplevel0-basic...

Documents