My Calendar Settings
    • 21 Jul 2022
    • PDF

    My Calendar Settings

    • PDF

    Article summary

    The Calendar Settings page controls which calendar items are synchronized with Exchange/Office 365 and how far back in time the calendar syncs. Syncing exports calendar items from the SysAid calendar and importing them into an administrator's Outlook calendar. Items are not imported from Outlook to the SysAid calendar.

    Ensure that you save any changes you make to this page.

    Important

    All of the settings on this page are per administrator , so any changes made to this page only affect the currently logged in administrator. To change system-wide Exchange settings, navigate to Settings > Integration > Calendar Sync.

    CalendarSettingsfilesCalendarSettingsCalendarSettings.jpg

    • Enable Synchronization with the Exchange server - This controls whether or not SysAid will import calendar items into the Outlook of the currently logged in administrator.
    • Export the following events to your Outlook Calendar - You can choose individually for each type of calendar item if you would like to import to Outlook or not. (SysAid Events include Group Events.)
    • Show Calendar Items starting X Days Ago - This field has two functions:
      • Determines how far back in time data will appear on the SysAid calendar.
      • Determines how far back in time calendar items will be imported into Outlook.

    For example, if the number is 30, then you will not see anything older than 30 days on your SysAid calendar, and any changes to due dates, activities, etc. more than 30 days old will not be imported into your Outlook calendar.
    Show events relating to service records with "Closed" status class: Check this if you would like activities and due dates from SRs with a closed status class to appear on the SysAid Calendar and in your Outlook (requires Exchange sync). Uncheck this if only open status class items should appear.

    Sync the calendar with OAuth 2.0 protocol

    You can set up calendar sync with the OAuth 2.0 protocol with Microsoft 365 or Google.

    EmailFormfilesOAuthServiceProvider.jpg

    Microsoft 365

    To set up calendar sync with the OAuth 2.0 protocol with Microsoft 365

    1. From the Protocol drop-down, select OAuth 2.0.
    2. Select Microsoft 365.
    3. Register your application in Azure:
      1. In your Microsoft 365 account, navigate to Azure Active Directory > App registrations.
      2. Click New registration.
      3. Enter a name for your application.
      4. In the supported account types, select the single tenant option.
      5. (optional) select a platform configuration.
      6. Click Register.
    4. Client secret:
      1. In App registrations, navigate to Certificates & secrets.
      2. Click New Client secret.
      3. Enter a description.
      4. In the Expires area, select Never.
      5. Click Add.
      6. Copy the generated secret from the Value column.
      7. Back in the calendar sync form, paste the secret in the Client secret field.
    5. Setup API permission:
      1. Back in Azure, navigate to API permissions and click Add a permission.
      2. Choose Microsoft Graph.
        EmailFormfilesMocrosoftGraphPermission.jpg
      3. Click Delegated Permissions.
      4. Check the User.Read permission.
        EmailFormfilesUserRead.jpg
      5. Click Add Permissions.
      6. Click Application Permissions.
      7. Check the following permission.
        • Calendars.ReadWrite
        • Mail.ReadWrite
        • Mail.Send
        • User.Read.All
          EmailFormfilesMailPermissions.jpg
      8. Click Application Permissions.
      9. Click Grant admin consent for <domain name>.
      10. Click Yes to confirm.
    6. Copy the Tenant ID and Client ID:
      1. In Azure Active Directory, navigate to App registrations and select the app you just set up.
      2. Copy the Application (client) ID and paste it into the Client id field in the SysAid calendar sync form.
      3. Copy the Directory (tenant) ID and paste it into the Tenant id field in the SysAid calendar sync form.
        EmailFormfilesOAuthCodes.jpg
    7. Follow the instructions above for configuring the rest of the calendar sync form.

    Google

    To set up calendar sync with the OAuth 2.0 protocol with Google

    1. From the Protocol drop-down, select OAuth 2.0.
    2. Select Google.
      EmailFormfilesOAuth2FormGoogle.jpg
    3. Create a project in Google:
      1. Navigate to Google Cloud Platform Console. If you haven't used this Google Cloud Platform Console yet, agree to their terms and conditions.
      2. Click Select a project.
        EmailFormfilesGoogleSelectProject.jpg
      3. Click New Project.
        EmailFormfilesGoogleNewProject.jpg
    4. Add Gmail API and Google Calendar API scopes:
      1. From the Navigation menu, select APIs & Services > Library.
        EmailFormfilesGoogleLibrary.jpg
      2. Search for "Gmail API"and select it from the search results.
      3. Click Enable.
        EmailFormfilesGoogleEnable.jpg
      4. Search for "Google Calendar API"and select it from the search results.
      5. Click Enable.
    5. Create a service account
      1. From the side menu, click Credentials.
        EmailFormfilesGoogleCredentials.jpg
      2. Click Create Credentials.
      3. Click Service Account.
        EmailFormfilesGoogleServiceAccount.jpg
      4. Enter any name for your service account.
      5. Click Create.
        EmailFormfilesGoogleCreateServiceAccount.jpg
    6. In the service account permission page click Project , and select Owner.
      EmailFormfilesGoogleOwner.jpg
    7. Configure the OAuth consent screen:
      1. From the side menu, click OAuth consent screen.
        EmailFormfilesOAuthConsentScreen.jpg
      2. Select Internal.
      3. Click Create.
        EmailFormfilesGoogleInternalCreate.jpg
      4. Enter an application name (e.g SysAid).
      5. Click Add Scope.
        EmailFormfilesGoogleAddScope.jpg
      6. Enter https://mail.google.com/.
      7. Click Add.
      8. Repeat the Add Scope process and add https://www.googleapis.com/auth/calendar.
    8. Generate a JSON credentials file:
      1. Click your new Service account.
      2. Select the check box for Enable G-Suite Domain-wide Delegation.
        EmailFormfilesGoogleDomainWideDelegation.jpg
      3. Click Add Key.
      4. Click Create new key.
        EmailFormfilesGoogleCreateNewKey.jpg
      5. Select JSON.
      6. Click Create.
        EmailFormfilesGoogleJSONCreate.jpg
      7. Save the downloaded JSON file to a location on your PC where you can access it later.
      8. Click Save.
    9. Configure the Google admin console**:**
      1. Navigate to the Google admin console (https://admin.google.com/ ):
      2. Click Security.
      3. Select Advanced settings.
        EmailFormfilesGoogleAdvancedSettings.jpg
      4. Click on Manage Google Services.
        EmailFormfilesGoogleManageGoogleServices.jpg
      5. Make sure Gmail and Calendar are marked as unrestricted.
        EmailFormfilesGoogleUnrestricted.jpg
      6. Return to the Advanced Settings screen and select Manage Third-Party App Access.
        EmailFormfilesGoogleManage3rdParty.jpg
      7. Click Configure new app.
      8. Select OAuth App Name Or Client ID.
        EmailFormfilesGoogleOAuthAppName.jpg
      9. In the search box, enter the value of the 'client_id' parameter from your JSON file.
      10. Select the application you created.
        EmailFormfilesGoogleAppName.jpg
      11. Select both Client ID check boxes and click Continue.
        EmailFormfilesGoogleClientIDSelect.jpg
      12. Under App Access, select Trusted Can Access All Google Services.
      13. Click Configure.
        EmailFormfilesGoogleAppAccessConfigure.jpg
      14. Return to the Advanced Settings screen and select Manage Domain Wide Delegation.
        EmailFormfilesGoogleManageDWD.jpg
      15. Click Add New.
        EmailFormfilesGoogleAPIClientsAddNew.jpg
      16. In client ID field enter value of the 'client_id' parameter from your JSON file.
      17. In the OAuth scopes field, enter https://mail.google.com/ and https://www.googleapis.com/auth/calendar.
      18. Click Authorize.
        EmailFormfilesGoogleClientIDAuthoirize.jpg
    10. Enter the generated values in SysAid:
      1. Open the JSON file you generated.
      2. Copy the value of the "client_id" parameter.
      3. Paste the value into the Service Account field in SysAid.
      4. Copy the value of the "private_key" parameter.
      5. Paste the value into the Private Key field in SysAid.
    11. Follow the instructions above for configuring the rest of the calendar sync form.