Creating a panel that allows multiple entries

Multi-instance panels allow users to enter multiple items for a single property. For example, you could allow your users to enter more than one degree in an Education panel. Multi-instance panels are also created in order to use Activity types.

Building a multi-instance panel with an activity type

Do the following to create a new panel with an activity type:

1. Go to RiSE > Panel Designer > Panel definitions.
2. Select Add panel definition.
3. Enter a Panel name and Panel description.
4. From the Parent type drop-down, select Contact.
5. Select Multi-instance as the Panel type.
6. Select the drop-down arrow for the desired activity type from the left column.
7. Drag-and-drop the activity properties to the white space. The properties will appear in the Add window in the order you arrange them in here.

   📘

   Note

   If Allow users to add is enabled on the Panel Editor, the Add window is displayed when you click to Add an item on your panel.

8. Click Save & Continue.
9. (optional) Continue creating panels for activity types.
10. Navigate to the RiSE page to which you want to add the activity data.
11. Open the content record for edit.
12. Click Add content.
13. Open the Content gallery, then do one of the following:
    1. If you have one panel you want to add to the content record, select the Panel Editor content item. From the Panel drop-down, select the panel you just created.
    2. If you have two or more panels you want to add in a tabbed format to the content record, select the Panel Collection Editor content item. Choose the desired activity-type panels from the Panel field. The activity types will appear in a tabbed format.
14. (optional) Enable Multi-instance panel options:

    • First column sort order - Select how you want to sort the initial column in your panel. Options include Ascending or Descending.

    • Limit grid size - Select this checkbox to set a height and width for a multi-instance panel. If the panel exceeds the set dimensions, scrolling is enabled.

      • Grid width - Enter the width in pixels.
      • Grid height - Enter the height in pixels.

    • Enable scrolling for cells - Select this checkbox to enable a vertical scrollbar for cells whose values are greater than 100 characters.

    • (Panel Editor only) Allow users to add - When enabled, users can manually add data to the panel.

    • Allow users to delete - When enabled, users can delete entire rows of data from the panel.

    • Allow users to edit - When enabled, users can edit the panel data. For Panel Collection Editor, enabling this option allows users to edit and add data to the panel.

      • (Panel Collection Editor only) Open single-instance panels in edit mode by default - Select this checkbox to always display a single-instance panel in edit mode for website users who have permission to edit the panel data.

        • (available when Open single-instance panels in edit mode by default selected only) Save buttons – You can select where you want Save buttons to be displayed in your panel. Options include Use page-level buttons (bottom of the page) and Include in panel.

      • (Panel Collection Editor only) Commit sequence - Allows you to explicitly define the execution order of multiple content items in a content record. The number in this field indicates the processing order for this content item, relative to the other content items in the same content record. The value must be 0 or greater. You can leave the default value of 0 if the execution order of content items is not a concern. Content items with a value of 0 are processed after any other content items with a non-zero Commit sequence value that are on the same content record.

        📘

        Note

        This option is not available if Include in panel is selected.

      • Edit window width - Enter the default width, in pixels, of the pop-up edit window for a multi-instance panel. If your panel contains multiple columns, consider increasing the width for better visibility.

      • Edit window height - Enter the default height, in pixels, of the pop-up edit window for a multi-instance panel.

      📘

      Note

      When Allow users to add (Panel Editor only), Allow users to edit, or Allow users to delete are enabled, the content record must be configured so that users must be logged in to access the page.

15. Click OK.
16. Click Save & Publish.

Building a multi-instance contact panel

This example details how to build a multi-instance contact panel from a new panel source.

Do the following to build a Training table:

1. Go to RiSE > Panel Designer > Panel definitions.
2. Select Add panel definition.
3. Enter a Panel name and Panel description. For this example, name the panel Training.
4. From the Parent type drop-down, select Contact.
5. Select Multi-instance as the Panel type.
6. Click Create source and enter a unique Source name.
7. For this example, create five properties. These properties are the Training panel rows:
   • Class
   • Date
   • Hours
   • Certificate
   • Notes
8. Click Add property. For each property you want to add, use the following values, then OK:
   • Property name = Class and Property type = Text.
   • Property name = Date and Property type = Date.
   • Property name = Hours and Property type = Text.
   • Property name = Certificate and Property type = File upload.
   • Property name = Notes and Property type = File upload.
9. Drag the properties you created into the table. The first property is the first row in the panel.
10. Click Save & Exit.
11. Navigate to any content record and add the Panel Editor content item to the page.
12. From the Panel drop-down, select the Training panel.
13. Select Allow users to add, Allow users to edit, and any other content item configuration options you want to enable, then click OK.
14. Click Save & Publish.

Adding attachments to a multi-instance panel with an activity type

This example details how to add attachments to an activity multi-instance panel. Users can add up to fifty attachments to a panel.

Adding the Attachment property to a panel

Do the following to enable adding attachments: