Calendar administration

Holiday calendar

The holiday calendar is used to setup recurring holidays that your agency observes. These holidays show on calendars in eProsecutor Online, and aid you in scheduling.

A calendar with holidays showing on the user dashboard

You can get to the Holiday Calendar by going to Left navigation pane  System Administration  Calendar Admin  Holiday Calendar.

The screen for configuring holidays in eProsecutor Online

After clicking the Holiday Calendar link, Holidays Administration page shows.

The screen for configuring holidays in eProsecutor Online

This screen list all the holidays that are currently configured in the system. If you would like to add more holidays, there are two ways: manually or using import.

Manual addition and editing

To add a new holiday, click Add New Holiday at the bottom of the screen. To edit an existing holiday, click the holiday name:

Edit holiday screen with numbers 1 through 8 labeling different controls
  1. Config Code: System code used to identify the holiday.

  2. Name: The name used for the holiday that shows on the calendars.

  3. Date: The date the holiday occurs this year.

  4. Type: There are three options: Date, Cycle, and Cycle Last.

    • Date: The holiday occurs on the day entered in the date field (example: Christmas is on December 25 every year).

    • Cycle: The holiday occurs every year on the same weekday from the start of the month (example: Labor day is the first Monday of September).

    • Cycle Last: The holiday occurs every year on the last occurrence of a weekday in a month (example: Thanksgiving is the last Thursday of November).

  5. Recurrence: Set it to This Year for the holiday to only occur once. Set is to Every Year for the holiday to show every year.

  6. Save & Back: Saves the current settings and returns you to the Holidays Administration page.

  7. Save: Saves the current settings, but keeps you on the Holiday Settings page.

  8. Cancel: Discards the changes and returns you to the Holidays Administration page.

Import holidays

On the Holidays Administration page, you can import holidays from an Excel XLS file by clicking Import XLS at the bottom of the page.

Import XLS dialog showing with an arrow pointing to the Import XLS button and numbers 1 through 4 labeling controls on the dialog
  1. File: Choose an Excel XLS file in the proper format that has holiday data you want to import into eProsecutor Online.

  2. Sample: Download a sample Excel XLS file that has the expected format and a few samples.

  3. Import: Import the holidays from the file into eProsecutor Online.

  4. Close: Close the Import dialog.

Example XLS file with columns for Date

After clicking Import, the new holidays show up in the list.

Holiday schedule

You can view what upcoming holidays there are by clicking Holiday Schedule button at the bottom of the Holidays Administration page.

A red arrow pointing to the Holiday Schedule button and the Holiday Schedule dialog is open

You can enter a date range and discover the existing holidays based on your configured holidays.

Calendar sync

The calendar sync function allows events to be synchronized from eProsecutor Online to calendars.

Users must be assigned to events so the calendar sync can send the event to their email account.

General settings

General settings screen

In this tab, you can:

  1. Use the Events to Sync dropdown to select one or more events types to sync.

  2. Use the Set reminder minutes before start field to configure when a reminder should be sent before the calendar sync starts.

  3. Use the Set reminder for events to send a notification before the calendar sync starts.

Microsoft Exchange

Azure setup

  1. Go to the Azure App registrations page.

  2. Click New Registration.

    The Register an application screen shows:

    Azure Register Application
  3. In the Name field, enter an app name.

  4. In the Supported account types field, select Accounts in this organizational directory only (Journal Technologies only - Single tenant).

  5. Click Register.

    The app overview shows.

  6. Record the two values from the Essentials area:

    The Essentials area on the Azure app Overview screen
    1. The value of the Application (client) ID field.

    2. The value of the Directory (tenant) ID field.

    Do not use the example values in the screenshot.
  7. Click API permissions in the left menu.

    The API permissions screen shows:

    Azure API permission page
  8. Verify that you have the permissions and admin consent shown in the screenshot.

    Must have Admin Consent and the permissions in the Type column must be set to Application.
  9. Click Certificates & secrets in the left menu.

  10. Click New client secret.

  11. In the Description field, enter a description.

  12. In the Expires field, select an expiration interval.

  13. Click Add.

    Azure client secret page
  14. Record the client secret.

eProsecutor Online setup

  1. In the Search For field, enter calendar.sync.enable.oauth.2.

  2. Click the calendar.sync.enable.oauth.2 link.

    The Edit: calendar.sync.enable.oauth.2 dialog shows:

    Microsoft Exchange setup
  3. Navigate to Left navigation  System Administration  Calendar  Calendar Sync.

  4. Click the Exchange Calendar Sync tab.

  5. In the Application Name field, enter a name.

In the Client Id field, enter the Application (client) ID value from the Azure setup.

In the Tenant Id field, enter the Directory (tenant) ID value from the Azure setup.

  1. In the Application Code field, enter an identifying code.

  2. In the Client Secret field, enter the client secret from the Azure setup.

  3. Select Enable Microsoft Exchange Calendar Sync.

  4. Click Submit.

Google

Create a project

  1. Visit Create Google Cloud project and follow the procedure.

  2. Go to the Google Cloud Console.

  3. Select your project.

    Google Project Screen
  4. Navigate to Hamburger menu, APIs & Services.

    The Google API Manager screen shows:

    Google API Manager
  5. In the left menu, click Enabled APIs & services.

  6. Click + Enable APIs and Services, OAuth client ID.

  7. In the search bar, search for Google Calendar API.

  8. Click the Google Calendar API search result.

  9. Click Enable.

  10. In the left menu, click Credentials.

  11. Click + Create Credentials, OAuth client ID.

  12. In the Application type* dropdown, select Web application.

  13. Edit the Name field.

  14. Add the Authorized JavaScript origins and Authorized redirect URIs.

    The redirect URIs should be in the format of: <eCourtPath>/ecms/userprofile?dispatch=onGetAccessToken.
    Google API Credentials Setup

    You must include the full path, for example: https://example.com/path/to/oauth/url.

  15. Click Save.

To edit an existing credential, click its link under OAuth 2.0 Client IDs on the Credentials page.

Google API Credentials

eProsecutor Online setup

Google setup
  1. Navigate to Left Navigation  System Administration  Calendar Admin  Calendar Sync.

  2. Open the Google project, created in the previous section, in a new browser tab.

  3. Click the Credentials created in the previous section.

  4. In the Client Id field, enter the Client ID value from the Google project.

  5. In the Client Secret field, enter the Client secret value from the Google project.

  6. Click Submit.

The Google Calendar Sync uses the Directory Person email. Ensure that Directory Person emails are correct.

Test the configuration

  1. Setup Calendar sync for a user.

  2. Open a case or Create a new one.

  3. Create an event.

  4. Open your Microsoft Exchange or Google calendar that you set up in the first step. A new event should show in the calendar.

Calendar sync test

The Calendar Sync Test page is used for testing how events sync to a person calendar. Google Mail and Microsoft Exchange servers are supported.

Calendar Sync Test web page

To test how and event syncs to a calendar, you need to fill in the fields with the appropriate data.

  • Type: Choose Exchange or Google depending on which type of calendar you want to sync to.

  • Server: Enter the server URL for the Google or Exchange server.

  • Username: This is the email address for the calendar you want to sync to.

  • Event ID: Enter an event id from eProsecutor Online that you want to try syncing to the calendar.