eSPACE Integration
==================

You can link TouchPoint Involvements to eSPACE events so that future event dates/times
will sync to TouchPoint, creating future meetings for the Involvements. To enable this
integration, follow the steps below:

Step 1 - Create a User Account with eSPACE
------------------------------------------

If you do not already have an account with eSPACE, create one for your church on the
eSPACE website. Click `here to go to the eSPACE website <https://app.espace.cool/account/register?>`_.
Once you have an account, you will enter the username and password in TouchPoint settings.

.. figure:: https://c4265878.ssl.cf2.rackcdn.com/mike.2002252152.createaccount.jpg
			:target: #

Step 2 - Enable the Integration on TouchPoint
---------------------------------------------

To enable the integration, you will need to configure a few administration settings on your
TouchPoint database. All these settings can be found on the Integrations tab, in the eSPACE
section.

- Enter your eSPACE user name in the **eSPACE User Name** setting.
- Enter your eSPACE password in the **eSPACE Password** setting.
- Toggle the **eSPACE Enabled** setting to `True`.
- Toggle the **eSPACE Enable FullSync** setting to `True`.
- Enter the Division ID in the **Set Division ID** setting. This Division will be assigned to all Involvements created from the eSPACE sync.
- Optionally, set the **eSPACE Days To Sync** setting. This determines the number of days into the future to search for events in eSPACE to sync to meetings in TouchPoint. If you leave this setting blank, it will default to 60 days.

.. important::

    The eSPACE credentials you enter in the **eSPACE User Name** and **eSPACE Password** settings
    should be for an account *with admin rights*. These credentials are used to access eSPACE to
    retrieve a list of upcoming events, so the account information you use in these settings must
    be for an account that has access to all the events you plan to link to TouchPoint Involvements.
    TouchPoint users who link Involvements to eSPACE events will not necessarily need an eSPACE
    account since the credentials stored in the settings provide the access to the list of upcoming
    eSPACE events.

    If the **Enable FullSync** setting (Admin > Advanced > Settings > Integrations > eSPACE) is set to `True` and the **Set Division ID** field is populated, the nightly sync will create Involvements for any occurrences of eSPACE events that are in a category of **Sync-to-TouchPoint** and where the **eSPACEID** (chosen in the Involvement > Settings > General > eSpace Event field) does not exist on any Involvement in TouchPoint. (Note that you will need to create this category in eSpace and assign desired events to it.) If the occurrence is marked **isFinalApproved=TRUE** in eSPACE, the Involvement will be marked as Approved in eSpace in Registrations/Mobile/Sites. Lastly, eSpace Categories will sync to Registrations/Mobile/Sites so long as the category names in eSPACE and TouchPoint match.

Step 3 - Link TouchPoint Involvements to eSPACE Events
------------------------------------------------------

To sync meetings from eSPACE events to a TouchPoint Involvement, create a link between the two.
This is done on the Involvement's **eSPACE Event** field in the Advanced Setup section on the
Settings > General tab. To select the eSPACE event to link to, click the horizontal ellipsis
(the three horizontal dots) and select from the list of available eSPACE events. An Involvement
can only be linked to one eSPACE event. Once linked, future meetings from the eSPACE event will
sync to the Involvement.

.. figure:: https://c4265878.ssl.cf2.rackcdn.com/mike.2003021108.linktoevent.jpg
    :target: #

Should you ever need to remove the link, simply click on the red `x` on the right hand side of the
**eSPACE Event** field.

.. figure:: https://c4265878.ssl.cf2.rackcdn.com/mike.2003021109.removelink.jpg
    :target: #

When an eSPACE event has been linked to an Involvement, the event name displayed in the
**eSPACE Event** field in the Advanced Setup section on the Settings > General tab will be a
link to the event. Clicking on the link will bring up the event in eSPACE. The user who clicked on
the link will need to log into eSPACE (if they have not already) before they can view and manage
the event.

Additionally, future meetings that have been created by the linking of the eSPACE event to the
Involvement will contain an **eSPACE_ID** extra value that will also serve as a click-able link
to take the user to the eSPACE event.

If you need to update the meetings on an Involvement, go to the Meetings tab and click on the
**Import From eSPACE** button. Future meetings within the timeframe defined by the **eSPACEDaysToSync**
setting will be imported to the Involvement. If event dates/times or locations have changed since the
previous import, the changes will be be made to the meetings on the Involvement.

|
|

+--------------------+------------------+
| **Latest Update**  | **12/13/2023**   |
+--------------------+------------------+

Added new settings and updated Important box