Setting Up and Using Activity Templates

This chapter provides an overview of activity templates and discusses how to:

Click to jump to parent topicUnderstanding Activity Templates

This section discusses:

Click to jump to top of pageClick to jump to parent topicPurpose of Activity Templates

Activity templates enable you to enter catalog information into the Enterprise Learning Management system using a single component.

Using activity templates you can:

Click to jump to top of pageClick to jump to parent topicMethods of Creating Activities

Enterprise Learning Management provides two ways to create activities:

Note. In both of these processes, the data-entry page generated from the template provides a way to access fields on the Maintain Items, Maintain Delivery Methods, and Maintain Activities components without having to navigate to numerous different pages. You can, however, access these components to view or modify activity and catalog data that you enter into the system using either the Quick Create Activities process or the Automated Catalog Import process.

Creating a Template By Selecting Group Boxes and Fields

This diagram illustrates how you create template-based pages by selecting group boxes and fields from different activity definition components to produce a single point of data entry:

Selecting Group Boxes and Fields to Create a Template-Based Page

Click to jump to top of pageClick to jump to parent topicActivity Template Setup and Use

To set up an activity template:

  1. On the Template Setup page:

  2. For each group box selected in step 1, use the Template Framework – Section Details page to define the rules for the fields contained in that group box.

    You have the ability to:

  3. Use the Template Framework – Template Security page to define security for the data-entry page.

  4. Preview the data-entry page based on the template and make any necessary corrections.

    To do this, click the Preview Page button on the Template Setup page.

To create a single activity using a template-based page (Quick Create Activity Process) :

  1. Access the Quick Create Activities page and select one of the following options:

  2. Access the template-based page and review or update the activity data.

  3. Access the Rebuild Indexes page and rebuild the search collection.

To create multiple catalog items and activities in one processing instance (Catalog Import Process):

  1. Access the Catalog Import page and enter the following information:

  2. Run the Catalog Import process.

    To do this, click the Load button on the Catalog Import page.

  3. Access the Rebuild Indexes page and rebuild the search collection.

Click to jump to parent topicPrerequisites

Before performing the first import of activities from an external source, run the Datamapping Sync Application Engine process (HRS_DM_SYNC) to synchronize the data mapping tables.

If you have updated the data mapping, run the process again to make sure that the tables are synchronized before importing activities.

See Synchronizing Data Mapping Tables.

Click to jump to parent topicDefining Activity Templates

To define activity templates, use the Activity Templates (LM_TMPL_SETUP) component.

This section discusses how to:

Click to jump to top of pageClick to jump to parent topicPages Used to Define Activity Templates

Page Name

Object Name

Navigation

Usage

Template Setup

LM_TMPL_SETUP

Set Up ELM, Catalog, Activity Templates, Template Setup

  • Define basic template information such as the template name and the name of the data entry page to generate from the template.

  • Select the group boxes from the Maintain Items, Maintain Delivery Methods, and Maintain Activities components to include on the data-entry page.

Template Framework - Section Details

LM_TMPL_SETUP_OBJ

Click theDetails link next to a group box (template section) on the Template Setup page.

Define behavior of the fields on the data-entry page generated from the template.

Template Security

LM_SEC_TMPL

Click the Security link on the Template Setup page.

Define security for the template.

Click to jump to top of pageClick to jump to parent topicDefining Basic Information for Activity Templates

Access the Template Setup page.

Template Name

Specify a name for the template.

Status

Select Active or Inactive.

Template Page

Use the fields in the Template Page group box to select the group boxes and their associated fields from the Maintain Items (LM_CI_LA_CMP), Maintain Delivery Methods (LM_DMTHDS_LA_GBL), and Maintain Activities (LM_ACT) components that you want to consolidate into a single data-entry page for defining activities. The sections in the Template Section column are the group boxes containing the fields. You determine which fields to include from each group box (section) by clicking the Details link and defining the field behavior.

Page Name

Specify the name of the data-entry page to generate from the template.

Page Order

You can divide the template into multiple pages, with one or more group boxes (sections) on each page, or place all group boxes and their associated fields on a single long page.

If you divide the template into multiple pages, indicate the relative order of the pages in the Page Order field.

Note. To create a multi-page template, click the Add Page link.

Template Section

Select the group boxes (template sections) that will appear on the data-entry page. The available group boxes are from the Maintain Items (LM_CI_LA_CMP), Maintain Delivery Methods (LM_DMTHDS_LA_GBL), and Maintain Activities (LM_ACT) components.

Once you have selected the group boxes you want to include in the template, you can configure each section at the field level by clicking the Details link.

Note. The group boxes marked with an asterisk contain required fields. If you create a template that does not include one of these group boxes, the system issues the following warning: These Sections with required fields are not in this template definition: <List of Required Sections>. In addition, if a required field is not included in a template, you will not be allowed to save new activities when you use the template on the Quick Create Activities or Catalog Import components.

New Label

Enter a custom label for the group box that will appear on the template-based page.

Details

Click to access the Section Details page.

Add Section

Click to add a new group box (section) to the page.

Add Page

Click to divide the template into multiple pages.

Clone

Click to copy the template under a new Template Name.

Preview Page

Click to preview a specific data-entry page that you will generate from the template.

Preview Template

Click to preview all of the pages that you will generate from the template.

Click to jump to top of pageClick to jump to parent topicSetting Up Section Details

Access the Template Framework - Section Details page.

For each group box (section) selected on the Template Setup page, set up field level details on the Template Framework - Section Details page.

Required

Select Required if a value must be entered for this field when using the template.

Note. Fields that are required on the source component will default to being required on the template. You cannot override these defaults on the Template Framework – Section Details page.

Object and Data Type

These fields display the name and type of the field.

New Label

Enter a custom field name that will replace the object field name on the template-based page.

Display Status

Indicates if the field is visible on the template-based page, and if it can be edited:

Valid values are:

  • Editable: The field will appear on the page, and can be modified by the user.

  • Invisible: The field will not appear on the page.

    Note. If you hide a field that is required and for which there is no default value, you will not be able to save new activities when using the template on the Quick Create Activities or Catalog Import components. Consider this carefully when selecting the Invisible option.

  • Viewable: The field will appear on the page, but will be read-only.

    Note. If you make a field viewable that is required and for which there is no default value, you will not be able to save new activities when using the template on the Quick Create Activities or Catalog Import components. Consider this carefully when selecting the Viewable option.

Data Source

Specify the starting value of the field. Select one of the following:

  • Blank: The field will have no starting value.

  • Default: The field will appear with the default value entered in the source component.

  • Value: The field will have the value specified in the Custom Data field.

Custom Data

This field appears only if you select Value in the Data Source field. Specify the starting value of the field in this column.

Preview Section

Click to view the section as it will appear on the data-entry page generated from the template.

Click to jump to top of pageClick to jump to parent topicDefining Security for Activity Templates

Access the Template Security page.

Learning Environment

Specify the learning environments that will have access to this template to create activities.

Use For Editing

This field controls whether the template can be used for updating an existing catalog item, delivery method, or activity, or can only be used to create new catalog items, delivery methods, or activities. If you select the Use For Editing check box, then the template is available both for updating and creating new catalog structure components.

Click to jump to parent topicCreating a Quick Activity Using a Template

This section provides an overview of the Quick Create Activities process, and discusses how to:

Click to jump to top of pageClick to jump to parent topicUnderstanding Quick Activities

After defining a template, you can use it to rapidly create activities. You can use existing catalog items, delivery methods, or activities as the basis for defining a new activity, or you can define all new information using the template.

Click to jump to top of pageClick to jump to parent topicPage Used to Define a Quick Activity Using a Template

Page Name

Object Name

Navigation

Usage

Quick Create Activities

LM_CNT_TMPL_LAUNCH

Enterprise Learning, Catalog, Quick Create Activities, Quick Create Activities

Create a single activity by loading activity and catalog data from an external file, or by defining the data manually.

Content Template - <Template Name>

LM_CT_PAGE

Click Continue on the Quick Create Activities page.

View and edit the data on the data-entry page generated from an activity template.

Click to jump to top of pageClick to jump to parent topicDefining a Quick Activity Using a Template (Quick Create Activity Process)

Access the Quick Create Activities page.

Quick Create Options

Valid values are:

Note. If you select Use Existing, you can modify or update the existing definitions for the selected catalog item, delivery method, and activity on the Content Template - <Template Name> page.

Import Catalog Data

This group box appears only when the Quick Create Option is Import Catalog Data.

Select Type

Select the type of file containing the data.

Valid file types are:

  • AICC

  • PeopleSoft XML Format

  • SCORM 1.2

Template

Select one of the templates you defined on the Template Setup page.

The system populates the template fields with data in the external file when you click Continue and upload a file.

Note. You must specify a template before you can upload a file.

Continue

Click Continue to upload the file containing the activity and catalog data.

When you click Continue and upload a file, the sysem takes you to the data-entry page based on the selected template. You can modify or update the activity information on this page.

Manually Quick Create

This group box appears only when the Quick Create Option is Manually Quick Create.

Select one of the following options for the catalog item, delivery method, or activity you are creating:

Template

Select one of the templates you defined on the Template Setup page.

The system populates the template fields with data when you click Continue.

Continue

Click Continue to populate the template fields with data and to access the data-entry page based on the selected template. You can modify or update the information on this page.

Click to jump to top of pageClick to jump to parent topicReviewing Course Data on the Template-Based Page

Access the Content Template - <Template Name> page.

The group boxes and fields on this page vary depending on the template definition.

Review and modify the required and optional data on this page.

Save

Click to save the data entered on the Content Template - <Template Name> page. If you navigate to another page, the data will no longer be viewable on the template–based page. To view the data, access the source components (Maintain Items [LM_CI_LA_CMP], Maintain Delivery Methods [LM_DMTHDS_LA_GBL], and Maintain Activities [LM_ACT]). .

Send Notification

Click to open the Send Notification page. Use this page to search for users with the administrator role designation and to send workflow notifications to these users regarding the newly created catalog items and activities.

Note. The workflow notification contains a link that transfers the user to the Review Imported Catalog Items page.

Click to jump to parent topicCreating Multiple Activities Using a Template (Catalog Import Process)

This section provides an overview of creating multiple activities, and discusses how to create multiple activities using a template.

Click to jump to top of pageClick to jump to parent topicUnderstanding Creating Multiple Activities

After defining a template, you can use it to load multiple activities into Enterprise Learning Management from an external file or group of files. The system automatically maps the data contained in the files to the fields defined in the template, and uses the template to select and format this data so that it can be imported into the database.

Click to jump to top of pageClick to jump to parent topicPage Used to Create Multiple Activities Using a Template

Page Name

Object Name

Navigation

Usage

Catalog Import

LM_CT_LOAD

Enterprise Learning, Catalog, Catalog Import, Catalog Import

Quickly import multiple activities into the system.

Content Template - <Tempate Name>

LM_CT_PAGE

Click the edit icon for a single file on the Catalog Import page, or click the Edit Selected button for a group of files.

View and edit imported activity data on the data-entry page generated from an activity template.

Click to jump to top of pageClick to jump to parent topicCreating Multiple Activities Using a Template

Access the Catalog Import page.

Basic Information

Name

System generated name for the import load.

Load Status

Displays the overall status of the import process.

Values are:

In Preperation: The import request is being prepared but has not yet been submitted for processing.

Ready for Load: The import request has been submitted, but has not yet been processed.

Load in Progress: the system is importing the data in the files.

Loaded: the data in the files is fully imported.

Error: the data could not be imported due to an error in one or more files.

Default Type

Select a default file type for the files you are uploading.

Valid values are:

  • AICC

  • PeopleSoft XML Format

  • SCORM 1.2

You can override the default value for selected files by entering a different file type in the Select Type field.

Template

Specify the template to use to select and format the data in the external files.

File Information

File

Displays the name of the file you are loading into the system.

Click the file link to view the contents of the file.

Select Type

Override the default file type for an individual file if required.

Load Multiple Files

Click to upload multiple files.

Select Single File

Click to upload a single file.

Load Files

Click to import the uploaded files into the system.

The Load Files button becomes available only after a file is successfully uploaded.

Refresh

Click to update the status displayed in the Load Status field.

The Refresh button appears when you click Load Files to import single or multiple files.

Load Status

Displays the import status of a file.

Values are:

Ready: the file is ready to be imported.

Error: the data could not be imported due to an error in the file.

Edit

After an activity file is imported, click the edit icon to review and update the information about the activity on the template-based data-entry page.

The Edit icon appears when you click Load Files to run the import process.

Edit Selected

Select a group of activity files in the File Information group box and click Edit Selected to review and update information about the selected activities on the template-based data-entry page.

The Edit Selected button appears when you click Load Files to run the import process.

Click to jump to top of pageClick to jump to parent topicReviewing Course Data on the Template-Based Page

Access the Content Template - <Template Name> page.

The group boxes and fields on this page vary depending on the template definition.

Review and modify the required and optional data on this page.

Save

Click to save the data entered on the Content Template - <Template Name> page. If you navigate to another page, the data will no longer be viewable on the template-based page. To view the data, access the source components (Maintain Items [LM_CI_LA_CMP], Maintain Delivery Methods [LM_DMTHDS_LA_GBL], and Maintain Activities [LM_ACT]).

Send Notification

Click to open the Send Notification page. Use this page to search for users with the administrator role designation and to send workflow notifications to these users regarding the newly created catalog items and activities.

Note. The workflow notification contains a link that transfers the user to the Review Imported Catalog Items page.