Table of Contents
Cisco Patient Connect Content Management Guide
Post CPC CMS Installation Steps
Verifying the imported subject data in CPC CMS VM
Creating Swank (Movies on Demand) Folder Structure
Customize the Patient View App
View and Upload Food Category Images for the Food Ordering System
Customize the Care Team View App
Uploading and Publishing Custom Videos
Creating a Section for Publishing
Uploading, Tagging, and Mapping a Video
Overview
This guide provides instructions on how to store and serve custom content such as videos, logos, and icons for the Cisco Patient Connect solution. This document is designed for installers who may configure the user interface and initial library of videos as well as administrators who will add and update content.
The topics in this chapter include the following:
– Importing the export.zip file
– Verifying the imported subject data in CPC CMS VM
– Creating Swank (Movies on Demand) Folder Structure
– View and Upload Food Category Images for the Food Ordering System
– Creating a Section for Publishing
Content Management System
Cisco Patient Connect has a content management system (CMS) to manage custom hospital content in the Patient view app including:
Setting up the CMS for CPC
Follow the steps below to set up and configure the Content Management System (CMS) for Cisco Patient Connect (CPC):
Step 1 Install IEP base ISO as explained in the Cisco Patient Connect Installation Guide.
Step 2 Connect to the VM as administrator.
Step 3 Enter the following steps manually to clean up the RHEL 6.8 ISO:
a. Enter the service ntpd stop command to stop the ntpd service.
b. Enter the ntpdate ntp.esl.cisco.com command.
c. Enter the service ntpd start command to start the ntpd service.
Step 5 Change TimeZone as follows:
b. Choose the Time Configuration from the list, and click the Run Tool button.
c. Choose your time zone and click the Ok button in the Timezone Selection dialog box.
d. Click the Quit button in the Choose a dialog box.
Step 6 Create the release repo file as follows:
a. Go to the /etc/yum.repos.d folder.
b. Copy and paste the following entries:
baseurl=http://pme-repo-1.cisco.com/repo/pme_release/Cisco/rpms/
Step 7 Update the /etc/hosts file to include the correct dbhost entries as follows:
Step 8 Enter the yum install nuxeo-7.3-XXX command to install the CPC CMS.
After a few seconds, the system lists the CPC CMS components and prompts you to confirm the installation. Enter the Y command and press the Enter key to install CMS.
URL and Credentials
Follow these steps to log into the CMS:
Step 1 Open a browser and enter the following URL: http://<host>:<port>/nuxeo/. For example, http://10.109.174.16:8080/nuxeo/.
Note Contact your Cisco representative for the host address and port.
Step 2 Enter your credentials. The default credentials are:
default username = Administrator
default password = Administrator
Creating a new User
Follow these steps to create a new user in CPC CMS:
Step 1 Open the CPC CMS application on a Web browser.
Step 2 Login as Administrator.
Step 3 Click the ADMIN tab to go to the Admin page.
Step 4 Click the Users & Groups menu in the left pane.
Step 5 Click the Users tab and then click the create a new user button.
Step 6 Enter the new user details in the respective fields.
Step 7 When you choose Yes for Set user password Password field appears.
Step 8 Provide password and verify the same in the respective fields.
Step 9 Click the Create button.
Changing the Password
Follow these steps to change the password:
Step 1 Open the CPC CMS application on a Web browser.
Step 2 Login as Administrator.
Step 3 Click the ADMIN tab to go to the Admin page.
Step 4 Click the Users & Groups menu in the left pane.
Step 5 Click the Users tab, enter the user name in the search field (for example, Administrator), and click the Search button.
The username displays on the page (for example, Administrator).
Step 6 Click the username and click the Change Password tab.
Step 7 Enter the password and verify the same in the respective fields.
Post CPC CMS Installation Steps
Importing the export.zip file
You need to import the subject data from the CPC VM to the default path of the CPC CMS VM to start the process of publishing images to the CPC solution.
Follow these steps to import the export.zip file that has been provided to you:
Step 1 Connect to the CPC CMS VM.
Step 2 Login with your installer credentials. For example, username: installer and password: cisco!123.
Step 3 Enter the d command to open Server Administration menu.
The Server Administration screen appears.
Step 4 Enter the i command to import subject data to CPC CMS.
Step 5 A screen opens to enter the following details:
a. Port number used by the CPC CMS. For example, 8080.
b. Administrative user name for CPC CMS login. For example, Administrator.
c. The corresponding CPC CMS password.
Step 6 Enter the Y command to import the subject data from the CPC VM to the default path of the CMS VM.
Verifying the imported subject data in CPC CMS VM
To verify that you have imported the subject data, follow these steps:
Step 1 Open the CPC CMS application on a web browser (URL: http://<host>:<port>/nuxeo/. For example, http://10.109.174.16:8080/nuxeo/).
Step 2 Login as Administrator.
Step 3 Click the ADMIN tab to go to the Admin page.
Step 4 Click the Vocabularies menu in the left pane.
Step 5 Select the I10nsubjects option from the Select Vocabulary drop down list on top of the page.
The imported subject data is displayed in the below table on the page.
Note The subjects are associated with the images in the image library that you will import. These subjects also enable to display appropriate images for the TV Application.
Publishing the Assets
Follow these steps to publish the assets:
Step 1 Open the CPC CMS application on a web browser.
Step 2 Login as administrator.
Step 3 Click the Workspace tab to go to the workspace page.
Step 4 Click the Sections node in the left pane.
Step 5 Click the create a new section button.
The Create a new document Section page appears.
Step 6 Enter ImageLibrary for the Title field and click the Create button.
The ImageLibrary section is created under the Sections in the left pane.
Step 7 Choose the ImageLibrary section in the left pane.
The ImageLibrary page appears.
Step 8 Click the New button to create a subsection under ImageLibrary.
A dialog box appears with Available document types.
The Create a new document Section page appears.
Step 10 Enter Default for the Title field and click the Create button.
Step 11 Click the New button to create folders under Default.
A dialog box appears with Available document types.
The Create a new document Section page appears.
Step 13 Enter en_US for the Title field and click the Create button.
Step 14 Create es_US as explained in Step 11 and Step 13 above.
Step 15 Create the Kids subsection under the ImageLibrary section as explained from Step 7 and Step 14 above.
Step 16 Create the Textured subsection under the ImageLibrary section as explained from Step 7 and Step 14 above.
Step 17 Create the FlatDarkDefault subsection under the ImageLibrary section as explained from Step 7 and Step 14 above.
Step 18 Create the FlatDarkKids subsection under the ImageLibrary section as explained from Step 7 and Step 14 above.
Step 19 Create the FlatLightDefault subsection under the ImageLibrary section as explained from Step 7 and Step 14 above.
Step 20 Create the FlatLightKids subsection under the ImageLibrary section as explained from Step 7 and Step 14 above.
Step 21 Click the Workspaces node in the left pane.
Step 22 Click the Import button in the top left pane to import the export.zip file.
The application imports all the subject data from the CPC application to the CPC CMS application. The system also creates the ImageLibrary folder and the Default, Kids, Textured, FlatDarkDefault, FlatLightDefault, FlatLightKids, and FlatDarkKids subfolders under it automatically.
Note You can also import the export.zip file through Textual User Interface as explained in the Importing the export.zip file section.
Step 23 Click the Publish tab.
Step 24 Choose the required options from the Sections and Publish a rendition from the drop down lists.
Step 25 Expand the Sections node at the bottom of the page.
All the sections and subsections that you created appears along with the Publish here link.
Step 26 Click the Publish here link available with a section or subsection where you want to publish the file.
Configuring Themes
When you import all the subject data from the CPC application to the CMS application, the system automatically creates the ImageLibrary folder and the Default, Kids, Textured, FlatDarkDefault, FlatLightDefault, FlatLightKids, and FlatDarkKids subfolders.
You can configure the TV App appearance theme as flat-dark or flat-light. Follow these steps to configure the theme:
Step 2 Go to the /opt/cisco/apache/tomcat-app/webapps/modular-tv-guide/app/config folder.
Step 3 Update the app-properties.tv.json file with your preferred theme.
For example, if you want to have the flat-light theme for the TV App appearance, update the app-properties.tv.json file as follows:
Step 4 To take effect of the updated theme, the cms sytem property has to be configured as follows:
a. Open the CPC application on a web browser.
c. Click the System Properties tab under the System Configuration menu in the left pane.
d. Search for the cms.image.library.theme.default property.
e. Click the Edit icon available for this property in the Action column.
f. Change the property value to FlatLightDefault.
g. Click the Save icon available for this property in the Action column.
Creating Swank (Movies on Demand) Folder Structure
Movies on Demand folder structure needs to be created to show the movies properly on TV App.
Note This folder structure needs to be created only if the facility has subscribed to Swank.
Follow these steps to create the Movies on Demand folder structure:
Step 1 Open the CPC CMS application on a web browser.
Step 2 Login as administrator.
Step 3 Click the Sections tab to go to the Sections page.
Step 4 Click the create a new section button.
The Create a new document Section page appears.
Step 5 Enter SwankVOD for the Title field and click the Create button.
The SwankVOD section is created under the Sections in the left pane.
Step 6 Choose the SwankVOD section in the left pane.
Step 7 Click the New button to create a subsection under SwankVOD.
A dialog box appears with Available document types.
The Create a new document Section page appears.
Step 9 Enter en_US for the Title field and click the Create button.
Step 10 Create es_US as explained in Step 7 and Step 9 above.
Customize the Patient View App
Add the Hospital’s Logo
The hospital’s logo will appear in the upper left corner of the Patient view app screen. Follow the steps below to add it:
Step 1 In the left menu of the CMS, open the Default folder: Default Domain > Workspaces > ImageLibrary > Default, FlatDarkDefault, or FlatLightDefault based on the requirements.
For example, if you need to add the hospital logo for the flat-light theme, choose the FlatLightDefault folder.
Step 2 Click the DefaultCustomerLogo.
You will see the Francisco placeholder logo.
Step 4 On the Edit tab, select the Delete radio button to delete the placeholder logo.
Step 5 Click the Save button at the bottom of the Edit tab.
Step 6 Click the Publish tab at the top of the page.
Step 7 Expand the Sections menu to find ImageLibrary > Default, FlatDarkDefault, or FlatLightDefault> en_US.
Now you will add the customer’s logo.
Step 8 Go back to the Edit tab of the DefaultCustomerLogo in the CMS.
Step 9 Upload the customer’s logo.
Step 11 On the Publish tab, expand the Sections menu and click the blue Publish here link next to the en_US entry to publish the new logo.
Step 12 Go to the Admin view app and clear the Image Library cache.
Step 13 Refresh the Patient view app screen. The customer’s logo will appear in the upper left corner of the screen.
Replace the Supplier’s Logo
The default supplier logo is the Cisco logo, which appears in the lower right corner of the Patient view app. Cisco partners can replace the Cisco logo with their own.
Step 1 In the left menu of the CMS, open the Default folder: Default Domain > Workspaces > ImageLibrary > Default, FlatDarkDefault, or FlatLightDefault based on the requirements.
For example, if you need to add the hospital logo for the flat-light theme, choose the FlatLightDefault folder.
Step 2 Click the SupplierLogo.
Step 4 On the Edit tab, select the Delete radio button to delete the Cisco logo.
Step 5 Click the Save button at the bottom of the Edit tab.
Step 6 Click the Publish tab at the top of the page.
Step 7 Expand the Sections menu to find ImageLibrary > Default, FlatDarkDefault, or FlatLightDefault> en_US.
Note If no supplier logo is desired, ignore the remaining steps.
Now you will add the partner’s logo.
Step 8 Go back to the Edit tab of the SupplierLogo.
Step 9 Upload the partner’s logo.
Step 11 On the Publish tab, expand the Sections menu and click the blue Publish here link next to the en_US entry to publish the new logo.
Step 12 Go to the Admin view app and clear the Image Library cache.
Step 13 Refresh the Patient view app screen to see that the partner’s logo appears in the lower right corner of the screen.
View and Upload Food Category Images for the Food Ordering System
Images used to represent the CBORD or COMPUTRITION food ordering categories in the Food Menu feature of the Patient view app are uploaded into the CMS, and then the titles of the images are mapped to CBORD or COMPUTRITION food menu items (i.e. meal names, servicecourses names) in the iepdb.resourcebundle table using the Admin view app. See the Cisco Patient Connect Admin View Guide for instructions on how to map the images.
To view existing CBORD or COMPUTRITION meal category images for food ordering, follow the steps below:
Step 1 In the left pane of the CMS user interface, open Default Domain > Sections > ImageLibrary > Default, FlatDarkDefault, or FlatLightDefault menu.
Step 2 Open the en_US folder to view all the uploaded images for the English language category.
Note If Spanish language images are available, open the en_es folder instead if you want to view the images that appear on the Patient view app of patients whose chosen language is Spanish.
Step 3 Click an image link, such as Breakfast.
Step 4 View the existing uploaded image and review its details.
If you want to upload new meal category images, follow these steps:
Step 1 In the left pane of the CMS user interface, open Default Domain > Workspaces > ImageLibrary > Default, FlatDarkDefault, or FlatLightDefault menu.
Step 2 Open either the en_US for English images or the en_es folder for Spanish images.
Step 4 In the Available document types dialog box, choose Picture within the Document category.
Step 5 On the Create a new document Picture screen, enter a title of the image in the Title field.
Note Avoid using symbols such as ‘&’, ‘#’, and ‘/’ in the titles.
Step 6 Choose the Upload radio button within the Content section.
Step 7 Click the Choose File button.
Step 8 Find the file and click the Open button. The file name will appear next to the Choose File button.
Step 9 Click the Create button. The new image is created; you will see the image in the Summary tab.
Step 10 Map the new CBORD meal category images to Cisco Patient Connect. See the Cisco Patient Connect Admin View Guide for instructions.
Replace Default Icons
The default icons for the Patient view app features (e.g. Notifications, Schedule, Phone, etc.) as well as those for the Speed dial numbers, TV Guide, and Request items can be replaced with customized icons.
Follow the steps below to upload and publish custom icons.
Step 1 In the left menu of the CMS, open the Default Domain> Workspaces > ImageLibrary folder.
Step 2 Choose the sub folder (Default, FlatDarkDefault, or FlatLightDefault) for the icons that you want to replace.
Step 3 View the current image.
Step 5 On the Edit tab, select the Delete radio button to delete the current icon.
Step 6 Click the Save button at the bottom of the Edit tab.
Step 7 On the Publish tab, expand the Sections menu and click the blue Publish here link next to the en_US entry of the folder to delete the old icon.
Step 8 Go back to the Edit tab.
Step 11 On the Publish tab, expand the Sections menu and click the blue Publish here link next to the en_US entry of the folder to publish the new icon.
Step 12 Go to the Admin view app and clear the TV app cache.
Step 13 Refresh the Patient view app screen to view the custom icon.
Step 14 Repeat the above steps to replace all default icons.
Customize the Care Team View App
Replace the Supplier’s Logo
The default supplier logo on the Care Team View app is the Cisco logo. Cisco partners can replace the Cisco logo with their own.
Step 1 In the left menu of the CMS, open the Default Domain > Workspaces > ImageLibrary > Default folder.
Step 2 Click the DefaultCustomerLogo-NDB entry.
Step 4 On the Edit tab, select the Delete radio button to delete the Cisco logo.
Step 5 Click the Save button at the bottom of the Edit tab.
Step 6 Click the Publish tab at the top of the page.
Step 7 Expand the Sections menu to find ImageLibrary > Logos > en_US.
Note If no supplier logo is desired, ignore the remaining steps.
Now you will add the partner’s logo.
Step 9 Upload the partner’s logo.
Step 11 On the Publish tab, expand the Sections menu and click the blue Publish here link next to the en_US entry to publish the new logo.
Step 12 Refresh the Care team view app screen.
Uploading and Publishing Custom Videos
To upload and publish videos on Cisco Patient Connect, you have to perform the following tasks which are described in detail below.
2. Create at least one section in order to publish the videos
4. Upload videos to the media folder, tag and map the videos
5. Publish videos to the sections
Creating a Workspace
When you import the export.zip file, the workspace folder gets created automatically with ImageLibrary and Media subfolders.
To create a workspace, perform the following steps.
Step 1 Click the default domain in the navigation pane on the left of the page.
Step 2 Under the default domain, click Workspaces.
The Workspaces content appears. By default, the Content tab is selected.
Step 3 Click Create a New Workspace.
The Create a New Document Workspace form appears.
Step 4 Enter the title and description.
Note Avoid using symbols such as ‘&’, ‘#’, and ‘/’ in the titles.
A new workspace is created and it appears under Workspaces in the navigation pane.
Creating a Section for Publishing
The custom videos should be organized based on their departments or their functions. For example, all the videos related to medications or pharmacy procedures should be grouped under “Pharmacy”. Similarly, hospital orientation videos should be grouped under a section named “Orientation”.
Before you publish a video, the ‘Media’ folder must be in the ‘Sections’ folder in the left navigation pane under the default domain.
Caution Since ‘Media’ is the root section for all custom video categories, it is important that there is ONLY one ‘Media’ section under the root ‘Sections’. Do not create more than one ‘Media’ section.
Within the media folder, there must be at lease one section, for example: Pharmacy, Orientation, Surgery, and so on).
To create a section, perform the following steps.
Step 1 Click the default domain in the navigation pane on the left of the page.
Step 2 Under the default domain, click Sections.
The Sections content appears. By default, the Content tab is selected.
Step 3 If the ’Media’ folder exists under Sections, skip to the next step. Otherwise, create the ‘Media’ folder by performing the following steps:
a. Click Create a New Section.
The Create a New Section form appears.
b. Enter ‘Media’ in the title text box.
A new section named ‘Media’ is created.
Step 4 Under Sections, click Media.
The Media content appears. By default, the Content tab is selected.
Step 5 Click New under the Content tab.
Step 6 Click Section in the Available Document Types dialog box.
The Create a New Document Section form appears.
Step 7 Enter the title and description.
Note Avoid using symbols such as ‘&’, ‘#’, and ‘/’ in the titles.
A new section is created and is available to publish content.
Note Multiple sections can be created under Media.
Creating a Custom Video Id
To create a custom video id, perform the following steps.
Note A custom video id must be created before uploading a video.
Step 1 Click Admin in the top menu of the CMS home page.
Step 2 Click Vocabularies in the navigation pane on the left of the page.
Step 3 From the Select a Vocabulary drop-down list, choose |10nsubjects.
Step 4 Click Add a New Vocabulary Entry.
The Entry Details form appears.
a. Enter the custom video id in the ID text box.
Note The custom video id must begin with the letters ‘CUST’ followed by other characters. CUST is not case sensitive. For example, CustTestVideo1 and custvideo2 are valid custom video ids.
b. Enter the label in the English and French Label text boxes respectively.
A new custom video id is created and can be used to map it to a custom video.
Uploading, Tagging, and Mapping a Video
To upload, tag, and map a video, perform the following steps.
Tip Place the video files on your desktop for easy uploading.
Step 1 Click Workspace in the top menu of the CMS home page.
Step 2 Click the default domain in the navigation pane on the left of the page.
Step 3 Under the default domain, click Workspaces.
The Workspaces content appears. By default, the Content tab is selected.
Step 4 Under Workspaces, click Media.
Step 5 Click New under the Content tab.
Step 6 In the Available Document Types dialog box, click Video.
The Create a New Document Video form appears.
Tip If a video is available in multiple languages, the title entered should be the same for both videos. You will enter the localized title of the video in the Description field.
Note Avoid using symbols such as ‘&’, ‘#’, and ‘/’ in the titles.
Step 8 Enter the description. If the video is a localized version of another video, enter the translation of the title in this field.
Step 9 To upload the video file, click the Upload radio button.
Note Only videos with MP4 format are supported on Cisco Patient Connect.
Step 11 Navigate and select the video, and click Open.
The video is uploaded and the file name appears next to the Choose File button.
This will create a video entry within the workspace and upload the video onto the CMS.
Two attributes need to be set for each uploaded video: Tags and Language.
Step 13 Scroll to the bottom right of the page and enter the tags in the Tags field as follows.
a. Enter one of the following gender tags into the tag field: “gender:male”, “gender:female”, or “gender:any”.
The gender tag appears in the field.
c. Enter one of the following age restriction tags into the tag field: “g”, “pg”, “pg-13”, “r”, or “nc-17”. Press the Enter key.
– g = Contains no strong language, nudity, sex, or drug usage. Violence is minimal.
– pg = May not be suitable for younger children because there is some profanity, some violence, or brief nudity.
– pg-13 = Some material may be inappropriate for children under 13.
– r = Requires a parent or adult guardian to be present in order to view the film. May include adult themes, adult activity, hard language, intense or persistent violence, sexually-oriented nudity, and drug abuse.
– nc-17 = No one under the age of 17 is permitted to watch this video as it contains violence, sex, aberrational behavior, drug abuse or any other element that most parents would consider too strong.
Step 14 Scroll to the top of the page and click the Edit tab.
Step 15 Go to the Subjects field and enter the custom video id created in the “Creating a Custom Video Id” section.
Step 16 Enter the language in the Language field. For example, English, Spanish, Arabic and so on.
Step 17 Scroll to the bottom of the page and click Save.
The video is now ready for publishing.
Publishing Videos
After the video is uploaded, tagged, and mapped, you can publish them. To publish the video, perform the following steps.
Step 1 Navigate to the video that you want to publish (Workspaces > Media).
Step 3 Expand the Sections tree below the Publish a Rendition drop-down list.
Step 4 Click the Publish Here link next to the desired section.
’Video published’ success message appears.
Step 5 Verify that the video has been published by navigating to the section in the left pane.(Sections > Media > Entertainment). Your video should appear under the Content tab.
Note Any changes made to the video after it has been published such as its title, language, or tags, it is necessary to re-publish the video,
Modifying Video Attributes
If the video attributes need to be changed, such as its title or tag, you must re-publish the video.
Step 1 Navigate to the video that you want to re-publish (Workspaces > Media).
Step 4 Under the Update Versions radio buttons at the bottom of the Edit page, click either the Increment minor version or Increment major version radio button.
Step 7 Click Republish at the bottom of the Publish screen.
A ’Video published’ success message appears.
Deleting a Video
To delete a video, perform the following steps.
Step 1 Navigate to the Media folder (Workspaces > Media).
Step 2 Click the check box placed before the video title you wish to delete.
Option buttons appear at the bottom of the screen.
Step 4 Click OK in the confirmation dialog box.
Step 8 Click OK in the confirmation dialog box to delete the video permanently.