ZeeMee Integration
- 28 Nov 2023
- 4 minute read
- Print
- DarkLight
- PDF
ZeeMee Integration
- Updated 28 Nov 2023
- 4 minute read
- Print
- DarkLight
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
ZeeMee provides a community for students to engage with other students and participate in live virtual events. Utilizing student behavior on their social platform, ZeeMee provides colleges with actionable insights to help colleges predict and impact outcomes from recruitment through graduation.
Slate can integrate bidirectionally with ZeeMee. Once configured, your institution can send specific data to ZeeMee through the use of a query, and ZeeMee can send data to Slate through a source format.
Further Reading
Steps to integrating ZeeMee with Slate
This article covers the four steps that are required to set up a bidirectional integration between ZeeMee and Slate:
Contact ZeeMee and follow their instructions.
In Slate, create a ZeeMee service account.
Create a ZeeMee data export query.
Create a ZeeMee source format.
Step One: Contact ZeeMee
ZeeMee will help your institution configure the integration so that it meets their requirements. Contact Garvel Kindrick ([email protected]) to get started.
ZeeMee will request the endpoints to the Slate query and source format resources, which are described in the sections below.
Step Two: Create a ZeeMee service account in Slate
This user account lets ZeeMee send files to your Slate database. To create the account:
Your title goes here
Your content goes here
From the main navigation, select Database.
Under Configurations, select Slate Template Library.
In the Search Library bar, enter "ZeeMee Service Account."
Scroll down to the Users section. To the right of the item ZeeMee Service Account, click Add. A popup appears.
Click Add. Do not make changes to this user account.
Note
If you do not see the ZeeMee Service Account, click the refresh the Slate Template Library link at the top of the page.
Step Three: Create the ZeeMee data export query in Slate
This query allows you to send data to ZeeMee. Since many items are custom, it will require some additional configurations.
To add the data export query to your database:
From the main navigation, select Database.
Under Configurations, select Slate Template Library.
In the Search Library bar, enter "ZeeMee Data Export."
Scroll down to the Queries section. To the right of the item ZeeMee Data Export (Person - Configurable Joins), click Add. A popup appears.
Click Add.
Note
If you do not see the ZeeMee data export query, click the refresh the Slate Template Library link at the top of the page.
To configure the ZeeMee data export query:
From the main navigation, select Queries / Reports.
Use the Search Queries bar to find and select the ZeeMee Data Export query.
Click Edit Query.
Before making any changes, click Copy. A popup appears. Saving a copy lets you view the original configurations, or start over if necessary.
In the Copy Query popup, enter a name, then click Save. You are redirected to the copy's query overview page.
Return to the original query.
Click Edit Query.
Click Edit Permissions. A popup appears.
Select Add Grantee. In the next window, enter the following configurations:
Active: Active
Type: Username
Name: Enter an internally recognizable name for this token; for example, "ZeeMee"
Username and Password: Enter a username and password for the grantee.
You will need to provide these credentials to ZeeMee.Token: A token is generated automatically
Permissions: Select Web Service
Click Save.
Using the specifications provided to you by ZeeMee, update the copied query to meet your needs. Many of the standard exports are pre-configured, and placeholder literal exports have been added to help guide you.
Add any necessary filters to limit the data sent to ZeeMee (for example, you may wish to limit the query results to just records with particular prospective entry term values.)
Once the query is configured, select Edit Web Service. A popup appears.
In the Edit Web Service popup, enter the following configurations:
Service Type: JSON
Include NULLs: Include NULL Values
Click Save. A Web Service item appears in the query details summary.
Click the JSON link next to the Web Service item.
Select the Service Account created in step 9.
The URL is generated. Copy it and provide it to ZeeMee along with the username and password.
Step Four: Create the ZeeMee source format in Slate
This source format is used to import the ZeeMee data.
Select Database on the top navigation bar and select Source Format Library.
Add the ZeeMee (CSV) source format.
On the ZeeMee source format landing page, select the View link under Web Services to capture the endpoint to provide to ZeeMee. The endpoint is located on the Certificate-Based Authentication tab.
Configure the Remap settings once a file has been uploaded. Standard items that can be used for matching purposes are pre-mapped. As always, feel free to customize how the data will be imported.
Note: The Student.Id.PartnerCSV source field is mapped to the Slate GUID Matching Only destination. It is recommended that you send the Slate Person Record GUID to ZeeMee when configuring the query (this value is pre-configured in the ZeeMee Data Export query described above). If you are sending a different field to ZeeMee, then update this mapping to reflect the field that ZeeMee has in their system.Set the Remap Active flag to Active on the source format once you are finished mapping the Source Format. This will run the import using the Remap settings configured in the step above for all files uploaded on or after the Remap As Of Date value.
Was this article helpful?
