Suitcase

mceclip0.png

 

  Summit 2022 Feature

Suitcase lets you share multiple items between different Slate databases simultaneously. With this functionality, Suitcase allows you to compile and transfer all the functional elements of an entire process in one complete package. This article provides an overview of the tool and the best practices for using it efficiently. 

With Suitcase, you can transfer the following items between databases:

    • Application Configuration
    • Application Logic
    • Bots
    • Components
    • Deliver Mailings
    • Files
    • Forms, including:
      • Form Communications
      • Form Logic
      • Form Rules
    • Message Templates
    • Portals
    • Queries
    • Reports
    • Slate Scholar Classroom Courses
    • Source Formats
    • Trips

 

Enabling Suitcase within the Database

Suitcase is available in test and production environments as an Early Access feature. To enable it:

  1. From the top navigation, select Database.
  2. From the Configurations section, choose Configuration Keys.
  3. From the Database Configuration section, select Early Access Features.
  1. Select Suitcase, then click Save.

    As with all configuration changes, the effect can take up to 15 minutes to be reflected across all web nodes.

Early_Access_Feature.png

A link to access the Suitcase appears in the Import and Data Processing section of Database.

Suitcase_Link_in_Database.png

 

Creating a New Suitcase

  Required Role

Administrator (All Access)

To create a new Suitcase:

  1. Select Database from the main navigation, then select Suitcase under Import and Data Processing.
  2. Click New Suitcase.
  3. Enter a name. The author is set automatically to the current user logged into Slate.

 

Adding Items to a Suitcase

Click Add Item. A pop-up appears with two tabs, Choose Item to Add and Review Dependencies to Include. Within Choose Item to Add, the Select Item Type menu lets you select from a list. Selecting an item type generates a list of available options. Select your item directly from the list, or use the search bar to filter your results.

Choose_Item_to_Add.png

 

Selecting an item moves you automatically to the Review Dependencies to Include tab, which breaks the item you selected into its constituent parts (in this example, a form, and a follow-up communication).

Review_Dependencies_to_Include_-_Top_Level_Items.png

 

Expanding the form in this example, we see the form fields and the form message that follows submission. Deselect any items you wish to exclude from the Suitcase.

Selecting_Items_to_Include_in_Suitcase.png

Click Add Item at the bottom to add the item to Suitcase; it appears as a new item in the Items tab. Click the arrow next to its name to view the nested types contained in.

 

Fields and Prompts

The Fields and Prompts tabs include any field IDs and prompt names contained in the added items. Clicking the different column headings in the Fields tab toggles the sort between ascending and descending alphabetical order.

In the Prompts tab, clicking the arrow next to each prompt key displays its associated values. Click the prompt's name to open the Edit Prompt Value window, which lets you deselect any prompt items to exclude from your Suitcase.

Prompt_Items.png

 

Editing Suitcase Properties

Click the Edit button at the upper right, and a pop-up appears. In this pop-up, you can: 

    • Change the Suitcase's internal name;
    • By selecting Is Shared, generate a Suitcase ID to share the Suitcase with specific individuals as needed;
    • Set an Expiration Date that determines the length of time the Suitcase ID remains active; and
    • Add comments

Edit_Suitcase.png

 

Sharing a Suitcase

To share a Suitcase:

  1. Click the Edit button in the upper right corner. 
  2. Select the Is Shared option in the pop-up.
  3. This will generate the Suitcase ID. 
  4. Copy the Suitcase ID by clicking on the copy icon. 
  5. Share the copy of the Suitcase ID with specific individuals as needed. 

  Important!

The generated Suitcase ID references items contained within as they existed, either at the time they were added to the Suitcase, or the last time that the Suitcase content was updated using the Update Content button. This date is reflected in the As Of column.

 

Importing a Suitcase/Briefcase

To import a shared Suitcase/Briefcase:

  1. Select Database from the main navigation. 
  2. From the section Import and Data Processing, select Suitcase.
  3. Click Import. A pop-up appears.
  4. In the text field, paste the Suitcase ID or Briefcase ID of the shared Suitcase/Briefcase item.
  5. Click Retrieve. 

The imported items are added to the relevant Slate area based on the type. For example, a form item will be added to the form builder, a report in report builder, etc.

If the database where the Suitcase/Briefcase items are imported does not have a folder of the same name in the relevant tool, Slate creates a folder with that name. If necessary, the items can be refiled once imported.

 

Was this article helpful?
2 out of 5 found this helpful