eShipGlobal Setup

To begin the process to configure the integration with eShipGlobal, send an email to [email protected] with the subject Attn: Janani Murali to request your department ID.

You must also provide Janani with the Web service endpoint (generated in the Slate Configurations - Receiving Data from eShipGlobal steps below).

Slate Configurations - Sending Applicants to eShipGlobal

Instructions for applicants to request shipments from your institution must include a personalized link constructed in the method provided below. This link can be featured within any place merge fields can be used, including within an applicant status portal or a Deliver mailing.

Generating the URL as a Merge Field

International students who need documents shipped to them should be provided with a personalized link to request documents within UEMS. This link contains your institution's department ID that links the request to your account, the student's application GUID that enables matching the appropriate record in Slate, and the email address used to generate their UEMS account.

The URL can be generated as a merge field within a Configurable Joins query with the type Applications using the steps below.

1. Add a Subquery export.

   

2. Enter a name for the export (for example, "eShipGlobalLink").
   Note: This name will be used as the merge field, so it should not include any spaces.

3. Select Concatenate as the output. This creates one string of each of the exports added to this subquery part, in the order they are listed.

4. Add the following exports. These different pieces will contain both string literals, such as the domain, as well as values from exports.

   • Add a Literal export

     

     1. Enter a Name for this export. For clarity, you may wish to enter the same value as the literal value (below).

     2. Enter the Literal value: https://study.eshipglobal.com/slate?did=YOURDEPARTMENTID&e=
        Note: The department ID is provided by eShipGlobal. If your institution has multiple departments, refer to the section below on using Export Values or Translation Values to pull in the appropriate department ID.
        

     3. Select Save.

        

   • Add an Export

     

     1. Select the Email export under the Application / Person join.
        Note: If your query does not already have this join added, the Person exports will be listed under Extended Exports. When prompted after selecting Continue in the next step, select the Application / Person join.

     2. Select Continue.

   • Add a Literal export

     

     1. Enter a Name for this export.

     2. Enter the Literal value: &id=
        

     3. Select Save.

        

   • Add an Export

     

     1. Select the GUID Export under the Application Direct Export.

     2. Select Continue.

        

        Slate combines these values in the order they appear, so keep the exports in this order.

5. Select Save.

For Institutions with Multiple Department IDs

If your institution has more than one department from eShipGlobal, the Literal value that includes the department ID must instead use an export value with the data that determines the department ID to send. For example, if your institution has a department ID for graduate admissions and one for undergraduate admissions, the application round might determine which ID to send. Alternatively, there might be a field, such as application major, that would determine the department ID. Once the data behind the selection of the department ID has been determined, use either Export Values or create a set of translation keys to handle sending the department ID. This changes the subquery described in Step 4 of the previous section slightly:

• Add a Literal export

  

  1. Enter a Name for this export.

  2. Enter the Literal value: https://study.eshipglobal.com/slate?did=

  3. Select Save.

     

• Add an Export

  

  1. Select the export that will contain the department ID. For example, if Export 4 on your application major prompts contains the relevant department ID, select the export for the application major field.

  2. Edit this new export to update the Export Value selection to the location that stores the department ID. For example, "Export 4 Value."

     

  3. Select Save.

• Add a Literal export

  

  1. Enter a Name for this export.

  2. Enter the Literal value: &e=

• Follow the steps in the previous section to add the Person Email export, &id= literal export, and the Application GUID export.

  

  Slate combines these values in the order they appear, so keep the exports in this order.

Using the URL Merge Field

The merge field generated in the previous steps contains the entire URL from the domain to the query string parameters. This merge field can be added as a link using the WYSIWYG HTML editor for the resource where you would like to add the link.

1. Insert a link.

   

2. Enter the desired Display Text (such as "Order Documents").

3. Change the Protocol to .

4. Enter the merge field created in the query within curly brackets (for example, {{eShipGlobalLink}}).
   Note: The merge field name is the name of the export created in the previous step.

   

5. Optional: To force the link to open in a new window or tab, select the Targettab, then select New Window (_blank) as the Target.

   

6. Select OK.