Suitcase
  • 25 Apr 2024
  • 3 minute read
  • Dark
    Light
  • PDF

Suitcase

  • Dark
    Light
  • PDF

Article summary

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. 

mceclip0.png

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 Mailing

  • Message Templates

  • Portals

  • Queries

  • Reports

  • Rules

  • Slate Scholar Classroom Courses

  • Source Formats

  • Trips

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

Think about your use case

If you’re intending to share this Suitcase with other databases, keep in mind that the base of your Query or Report must exist in the target instance. Form-Specific Form Response bases are instance-specific, so we recommend using the “All forms and events” setting for Form Response bases instead.

Review dependencies

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.

🔔 Important!

The order in which items are added to your Suitcase matters. If adding an Event and a Template to your Suitcase; make sure to add the Template before you add the associated event.

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?