Configuring portal

Owned by Kostas Karkaletsis
Last updated: Apr 08, 2016 by Joao Cunha
2 min read

The portal comes with the following preconfigured roles: Doctor, Pharmacist, Patient, Nurse, Administrator. All except Administrator are defined in portal-ext.properties (Administrator comes preconfigured within Liferay).

The following users need to be configured (Administrator user is predefined, you only need to define the others):

UsernamePasswordRole
testtestAdministrator
doctortestDoctor
pharmacisttestPharmacist
nursetest

Nurse

patienttestPatient

In order to create the new users, you should log in as administrator, go to Control Panel > Users and Organizations > Add User, fill the user data and select the adequate Role.

Specifically for the pharmacist user, you should (as administrator) set his surname and phone number (to be used for filling eDispensation information).

Portlet Configuration

The appropriate configuration has been moved (https://openncp.atlassian.net/browse/GPB-15) from portlet.properties to epsos configuration database. Following is the example of Malta Configuration Parameters:

'PORTAL_ADMIN_PERMISSIONS', 'PRD-006,PRD-003,PRD-004,PRD-005,PRD-010,PRD-016,PPD-032,PPD-033'
'PORTAL_CHECK_PERMISSIONS', 'false'
'PORTAL_CLIENT_CONNECTOR_URL', 'http://localhost/epsos-client-connector-3.1.1.1/services/ClientConnectorService'
'PORTAL_CONSENT_OID', '2.16.470.1.100.1.1.1000.990.1'
'PORTAL_CUSTODIAN_NAME', 'Malta Custodian Name'
'PORTAL_CUSTODIAN_OID', '2.16.470.1.100.1.1.1000.990.1'
'PORTAL_DISPENSATION_COUNTRY', 'MT'
'PORTAL_DISPENSATION_OID', '2.16.470.1.100.1.1.1000.990.1'
'PORTAL_DOCTOR_OID', '2.16.470.1.100.1.1.1000.990.1'
'PORTAL_DOCTOR_PERMISSIONS', 'PRD-006,PRD-003,PRD-004,PRD-005,PRD-010,PRD-016,PPD-032,PPD-033'
'PORTAL_ENTRY_OID', '2.16.470.1.100.1.1.1000.990.1'
'PORTAL_HOSPITAL_OID', '2.16.470.1.100.1.1.1000.990.1'
'PORTAL_LEGAL_AUTHENTICATOR_CITY', 'Valetta'
'PORTAL_LEGAL_AUTHENTICATOR_FIRSTNAME', 'Malta'
'PORTAL_LEGAL_AUTHENTICATOR_LASTNAME', 'Organisation'
'PORTAL_LEGAL_AUTHENTICATOR_ORG_OID', '2.16.470.1.100.1.1.1000.990.1'
'PORTAL_LEGAL_AUTHENTICATOR_PERSON_OID', '2.16.470.1.100.1.1.1000.990.1'
'PORTAL_LEGAL_AUTHENTICATOR_POSTALCODE', 'N/A'
'PORTAL_NURSE_PERMISSIONS', 'PRD-006,PRD-004,PRD-010'
'PORTAL_ORDER_OID', '2.16.470.1.100.1.1.1000.990.1'
'PORTAL_PATIENTS_OID', '2.16.470.1.100.1.1.1000.990.1'
'PORTAL_PATIENT_PERMISSIONS', 'PRD-006,PRD-003,PRD-004,PRD-005,PRD-010,PRD-016,PPD-032,PPD-033'
'PORTAL_PHARMACIES_OID', '2.16.470.1.100.1.1.1000.990.1'
'PORTAL_PHARMACIST_OID', '2.16.470.1.100.1.1.1000.990.1'
'PORTAL_PHARMACIST_PERMISSIONS', 'PRD-006,PRD-004,PRD-010,PPD-046'
'PORTAL_PROPERTIES_UPDATED', 'TRUE'
'PORTAL_TEST_ASSERTIONS', 'false'
'PORTAL_CONSENT_ENABLED', 'true'

The SQL Script for updating the config database is: 

INSERT INTO PROPERTY (NAME,VALUE) VALUES ('PORTAL_ADMIN_PERMISSIONS', 'PRD-006,PRD-003,PRD-004,PRD-005,PRD-010,PRD-016,PPD-032,PPD-033');
INSERT INTO PROPERTY (NAME,VALUE) VALUES ('PORTAL_CHECK_PERMISSIONS', 'false');
INSERT INTO PROPERTY (NAME,VALUE) VALUES ('PORTAL_CLIENT_CONNECTOR_URL', 'http://localhost:9090/epsos-client-connector-3.1.1/services/ClientConnectorService');
INSERT INTO PROPERTY (NAME,VALUE) VALUES ('PORTAL_CONSENT_OID', '2.16.470.1.100.1.1.1000.990.1');
INSERT INTO PROPERTY (NAME,VALUE) VALUES ('PORTAL_CUSTODIAN_NAME', 'Malta Custodian Name');
INSERT INTO PROPERTY (NAME,VALUE) VALUES ('PORTAL_CUSTODIAN_OID', '2.16.470.1.100.1.1.1000.990.1');
INSERT INTO PROPERTY (NAME,VALUE) VALUES ('PORTAL_DISPENSATION_COUNTRY', 'MT');
INSERT INTO PROPERTY (NAME,VALUE) VALUES ('PORTAL_DISPENSATION_OID', '2.16.470.1.100.1.1.1000.990.1');
INSERT INTO PROPERTY (NAME,VALUE) VALUES ('PORTAL_DOCTOR_OID', '2.16.470.1.100.1.1.1000.990.1');
INSERT INTO PROPERTY (NAME,VALUE) VALUES ('PORTAL_DOCTOR_PERMISSIONS', 'PRD-006,PRD-003,PRD-004,PRD-005,PRD-010,PRD-016,PPD-032,PPD-033');
INSERT INTO PROPERTY (NAME,VALUE) VALUES ('PORTAL_ENTRY_OID', '2.16.470.1.100.1.1.1000.990.1');
INSERT INTO PROPERTY (NAME,VALUE) VALUES ('PORTAL_HOSPITAL_OID', '2.16.470.1.100.1.1.1000.990.1');
INSERT INTO PROPERTY (NAME,VALUE) VALUES ('PORTAL_LEGAL_AUTHENTICATOR_CITY', 'Valetta');
INSERT INTO PROPERTY (NAME,VALUE) VALUES ('PORTAL_LEGAL_AUTHENTICATOR_FIRSTNAME', 'Malta');
INSERT INTO PROPERTY (NAME,VALUE) VALUES ('PORTAL_LEGAL_AUTHENTICATOR_LASTNAME', 'Organisation');
INSERT INTO PROPERTY (NAME,VALUE) VALUES ('PORTAL_LEGAL_AUTHENTICATOR_ORG_OID', '2.16.470.1.100.1.1.1000.990.1');
INSERT INTO PROPERTY (NAME,VALUE) VALUES ('PORTAL_LEGAL_AUTHENTICATOR_PERSON_OID', '2.16.470.1.100.1.1.1000.990.1');
INSERT INTO PROPERTY (NAME,VALUE) VALUES ('PORTAL_LEGAL_AUTHENTICATOR_POSTALCODE', 'N/A');
INSERT INTO PROPERTY (NAME,VALUE) VALUES ('PORTAL_NURSE_PERMISSIONS', 'PRD-006,PRD-004,PRD-010');
INSERT INTO PROPERTY (NAME,VALUE) VALUES ('PORTAL_ORDER_OID', '2.16.470.1.100.1.1.1000.990.1');
INSERT INTO PROPERTY (NAME,VALUE) VALUES ('PORTAL_PATIENTS_OID', '2.16.470.1.100.1.1.1000.990.1');
INSERT INTO PROPERTY (NAME,VALUE) VALUES ('PORTAL_PATIENT_PERMISSIONS', 'PRD-006,PRD-003,PRD-004,PRD-005,PRD-010,PRD-016,PPD-032,PPD-033');
INSERT INTO PROPERTY (NAME,VALUE) VALUES ('PORTAL_PHARMACIES_OID', '2.16.470.1.100.1.1.1000.990.1');
INSERT INTO PROPERTY (NAME,VALUE) VALUES ('PORTAL_PHARMACIST_OID', '2.16.470.1.100.1.1.1000.990.1');
INSERT INTO PROPERTY (NAME,VALUE) VALUES ('PORTAL_PHARMACIST_PERMISSIONS', 'PRD-006,PRD-004,PRD-010,PPD-046');
INSERT INTO PROPERTY (NAME,VALUE) VALUES ('PORTAL_PROPERTIES_UPDATED', 'TRUE');
INSERT INTO PROPERTY (NAME,VALUE) VALUES ('PORTAL_TEST_ASSERTIONS', 'false');
INSERT INTO PROPERTY (NAME,VALUE) VALUES ('PORTAL_CONSENT_ENABLED','true');
  • You should check the correct OID for your scenario in EPSOS_PROPS_PATH/pn-oid.xml
  • PORTAL_CLIENT_CONNECTOR_URL is the URL of the web service exposed by epsos-client-connector to allow communication with the Portal. It should point to the Tomcat instance (hostname and port) where epsos-client-connector is running. We configured this artifact to not expose its version in its web services, so the URL should follow the structure: http://<hostname>:<port>/epsos-client-connector/services/ClientConnectorService
  • Note that table name might be case-sensitive in MySQL
  • You'll need to restart Liferay for the changes to make effect.