Microsoft Exchange Online setup for Journey Accelerator

  • Release version: Xanadu
  • Updated August 1, 2024
  • 2 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Microsoft Exchange Online setup for Journey Accelerator

    The Microsoft Exchange Online integration with Journey Accelerator allows users to schedule plans and to-do tasks directly with Microsoft Office 365 calendars. This functionality requires the installation and configuration of related Microsoft plugins and integrations prior to Journey Accelerator setup.

    Show full answer Show less

    Key Features

    • Embedded Scheduling: Users can create calendar events from Journey Accelerator plans and to-do tasks.
    • Active Directory Integration: The Microsoft AD spoke manages users, groups, and computers.
    • Azure AD Integration: Ensures appropriate management of users and security groups.
    • Exchange Online Spoke: Allows for calendar event and mail management in Microsoft Exchange Online.
    • Retry Handler Framework: Automatically retries failed HTTP requests due to API rate limits.

    Key Outcomes

    To utilize the scheduling feature, complete the following:

    • Install and configure necessary Microsoft plugins and integrations before Journey Accelerator installation.
    • Set specific Journey Accelerator system properties after spoke setup, including options for calendar provider and service accounts.
    • Ensure compatibility with the Retry Handler Framework when using the Microsoft Exchange Online spoke.

    By following these steps, users can effectively manage calendar events and tasks within Journey Accelerator, enhancing productivity and task organization.

    By integrating the Journey Accelerator scheduling feature with the Microsoft Office 365 calendar function, users can schedule plans and to-do tasks.

    Note:
    If an administrator intends to use the Microsoft Office 365 scheduling capabilities with Journey Accelerator, the administrator must install and configure the related Microsoft plugins and integrations before installing Journey Accelerator.
    The Journey Accelerator scheduling feature enables users to schedule Microsoft Office 365 calendar events directly from Journey Accelerator plans and to-do tasks.

    If you plan to use the scheduling feature, you must install and configure these plugins and integrations before you install Journey Accelerator. The embedded scheduling feature includes all plugins, integration APIs, and actions.

    Some integrations and related plugins require activation by ServiceNow® personnel. Journey Accelerator uses an embedded Microsoft Exchange Online spoke with limitations for use with Journey Accelerator. The use beyond these embedded limitations may require that you get additional licensing or subscriptions.

    Journey Accelerator v2

    Microsoft AD Spoke [com.sn.ad.spoke]
    Provides communication between Journey Accelerator and Microsoft Active Directory to manage objects such as users, groups, and computers.
    Microsoft Azure AD spoke [com.sn.azure_ad.spoke]
    Provides security requirements to Journey Accelerator so that users, security groups, and office groups are appropriately managed.
    Microsoft Exchange Online spoke v2.0.1 [sn_ex_online_spke]
    The Microsoft Exchange Online spoke enables creation and management of calendar events and mail in Microsoft Exchange Online.

    Journey Accelerator v3 and later

    Microsoft Exchange Online Spoke V3.0.0
    The Microsoft Exchange Online spoke enables creation and management of calendar events and mail in Microsoft Exchange Online.
    Retry Handler Framework
    Framework that retries a failed HTTP request when the API rate limits are exceeded and the 429 Too Many Requests status code is returned. The retry-after time HTTP header is used to retry the request again after that specified retry-after time.

    Set these Journey Accelerator system properties

    Follow the instructions for setting up the spokes respective to your Journey Accelerator version. After spoke setup is complete, navigate to sys_properties.list in ServiceNow and set up the following properties for the Journey Accelerator app.
    • sn_ja.calendar_provider_option: Select exchangeOnline
    • sn_ja.ex_online_dummy_account_id: Insert <outlook dummy account for querying meeting times>
    • sn_ja.ex_online_service_account_id: Insert <outlook service account or delegator for calendar management>
    • sn_ja.ex_online_notification_url: Insert <webhook URL from Microsoft Exchange Online Spoke>
    Note:
    When using Microsoft Exchange Online spoke v.2.0.2 with Retry Handler Framework, the scripted rest API for the retry handler framework is used as the webhook URL.

    For detailed steps, see Update system properties for Microsoft Exchange Online in the Journey Accelerator app