ARTS - Text Stanzas (Creating and Editing)

Overview

When the ARTS system needs to generate some sort of text, it takes a text stanza of the appropriate type, replaces "tokens" with values based on the event, or the attendee, and displays it.  While there are many different types of text stanzas, most events only use a few of them.  When an event is created, default stanza(s) are copied into place.  

When you select the Text Stanza page, you are presented with a report listing the existing text stanzas. There is a link to edit them, as well as a preview, that will display the stanza with sample data. You should edit these to better match your needs.

Procedures

Create a New Text Stanza

1. Go to the ARTS V2.1 tool at https://apex.cct.rpi.edu/apex/f?p=149
2. From the Home screen, click the "Edit Event" button.
3. Click "Edit Event" to the left of the Event Name.
4. Click the Expand/Collapse navigation button located in the upper left corner of the ARTS tool.
   
   [Expand/Collapse navigation button]
5. Choose "Text Stanzas" under the Edit Event area from the left panel.
6. Select the type of stanza you want from the "New Text Type" selection, and press the "Create New Text Stanza" button. NOTE: There can be only one of each type of stanza in an event.

[Sample of some commonly used Text Stanzas from the report]

Some of the more common text stanzas are:

• Splash - This is the first screen displayed at the start of the check in process.  Typically this includes the name of the event, and instructions to swipe in.
• Accepted - This is displayed when someone badges in (or searched) and is allowed to attend the event based on the ACLs (or when there are no ACLs). These two are the minimum set of text stanzas for an ARTS event. 
• Rejected - If you have any ACLs, there is a chance that a card swipe will be rejected.  In that case, this stanza will be displayed.
• Building Staff, Event Staff, Presenters, VIPs - these are special people who are identified via the ACLs and get different text than rather event attendees. These typically are used in complex events.
• Exit Confirmation - When the event is running with exit processing (typically a second swipe indicates a person exiting), this text is displayed.
• Doors Closed - for events with an End Time, this is displayed when the event has started and admission is closed.
• Not Open Yet - for events with a start time, this is displayed before the event has started. Note that the start and end times can be overridden by ACLs (like letting event staff in before the doors open for the general population).
• Capacity Met - for events with a maximum capacity, this is displayed when the capacity has been reached.
• Duplicate entry - when Allow Reuse us turned off, this will be displayed if a card is swiped a second time (no re-use, re-entry).
• Queued - When the event is running in "Deli Mode", this is displayed on the badge in station when a person swipes in.
• Queue Front Screen - when the queue is being display on the entry screen, this formats each cardholder in the queue.  This is optional.
• Queue Internal - Formats the entry for each person in the queue.  This is seen by the contacts who will select or reject each contact in the queue.
• RSVP Splash - When an RSVP URL is being used, this is displayed when someone first goes to the RSVP page.
• RSVP Exit - this is displayed after a person "badges in" (by pressing the button) on the RSVP page.
• Print Label - When defined, will add a "Print" button to the display tokens that will open a pop up page that can print a label or other documented to the browser printer.

Under the list of existing text stanzas, there are some additional controls for the event as well as some specialized controls.

• For some events, we want to report on group memberships of the attendee.  By selecting one or more groups to be checked for membership.  
• Other events need to know what courses a person is currently taking. The "Subject to Display" allows you to select which departments you want to include in the course list.
  
  
  [Group member list and Subjects of Existing Text Stanzas]

When you edit a text stanza, you can resize this text box, and use the rich text editor that has a set of formatting controls at the top of the box.  In addition there are buttons at the bottom of the region allowing you to Delete, Apply Changes (to save) and Preview the changes (save first) and go back to the list of stanzas.

The use of several "tokens".  These are listed further down the page. The first list, are the tokens currently available for this event, and below that, a complete list of all available tokens, where they come from and how to gain access. Tokens are added to text stanzas using brackets.

NOTE: Some tokens are not generally available and you will need to Submit a request with justification on why you need to access to them.

Example below shows two tokens added to the splash text stanza:

[Text Stanzas: Edit splash Text stanza screen showing two tokens highlighted]

Edit a Text Stanza

1. From the Home screen, click the "Edit Event" button.
2. Click "Edit Event" to the left of the Event Name.
3. Click the Expand/Collapse navigation button located in the upper left corner of the ARTS tool.
   
   [Expand/Collapse navigation button]

4. Choose "Text Stanzas" from the left panel.

5. Click Edit to the left o the Text Stanza you want to edit.

The edit text screen for that Text Stanzas opens showing the text editor above.

To add a token:

1. Place your cursor where you want the token to appear in the stanza box.
2. Review the tokens below and note the name of the token(s) to add, and then type the token using a curly brackets { } at the beginning and the end of the token name.

In the Example below the RIN token was added and will show in a Red font color on the splash Text Stanza: 

3. Repeat Steps 1 and 2 until all tokens have been added.

4. Once all the tokens have been added and are in the order you want them, click "Apply Changes".

5. Click the "Preview" button located in the lower right of the first box area, to see what the screen will look like.

References/Links

 Training Video - ARTS - Editing a Text Stanza

Last Reviewed: 04-Dec-2024