ANGEL Help

Description

Add Variable

The Add Variable action allows the course editor to create and manage environment variables that are associated with the user submitting a quiz item.  This could track course progress, competency, etc.  An example of the Add Variable action could be used to create and increment a variable called Quiz_Competency that would increment by 1 for every quiz a student received a 70% or higher and decrement for every quiz a student received 69% or lower.  A unique Quiz_Competency value would be stored for each student in the course – the results of which could be printed to a page for instructor review.

1. Select the user from the Add Variable For drop-down.
2. Click the Add -> button.
3. Type the variable name in the Variable Name field.
4. Provide the value to add in the Amount to Add (optional) field.
5. Click the Save Action button.

Alert

Add a JavaScript pop-up message.

1. In the Alert Message Text field, type the text you wish to display in the pop-up message.
2. Click the Save Action button.

Announcement

Add an announcement to a user’s course announcements.

1. Select who will see the announcement from the Add Announcement For drop-down list.
2. In the Announcement text area, type the text you wish to be displayed as the personal announcement. 
3. Click the Save Action button.

Calendar

The Calendar action posts a personal calendar event to a user’s course calendar page.

1. In the Title textbox, type the text you wish to be displayed as the title of the personal calendar event.
2. Select a user from the Users drop-down list.
3. In the Category textbox, type the category for the personal calendar event.
4. In the Notes text area, type any additional viewable notes that you wish to be associated with the personal calendar event.
5. You may optionally type a numeric value in the Days Offset textbox to specify the number of days to offset (wait before displaying) the personal calendar event.
6. You may optionally type a numeric value in the Duration textbox to specify the number of minutes the personal calendar event should remain posted.
7. Click the Save Action button.

Email (External)

The Email action sends an Internet email message when triggered by a specified event.  This item would be useful if you need to send an email message to someone outside of the ANGEL environment.

1. Type a valid Internet email address in the From textbox to specify who appears as the sender of the message.
2. Type a valid Internet email address(es) in the To textbox to specify who should receive the Internet email message. 
3. Your may optionally type a valid email address(es) in the Cc or Bcc fields to specify who should also receive the Internet email message.
4. Type a subject in the Subject field.
5. Type your message text in the Message Text field.
6. You may optionally select the format from the Format drop-down list.
7. Click the Save Action button.

GoTo

The GoTo action redirects the user to another content item (in the same course) when triggered by a specified event.

1. In the Match Text field, type the exact Entry_ID, password, or title of the item you with to redirect the student to,

 To copy the Entry_ID for an item, right-click on the title or icon of an item, select Copy Shortcut, paste the copied link into the Match Text field, and delete the entire pasted link except the last alpha-numeric characters following “ENTRY_ID=” (without the quotes).

 If more than one item exists with the same title or password provided in the Match Text field, the user is redirected to a list of the matching items.  You can combine partial titles with an asterisk (*) as a wildcard to locate multiple items with similar titles.

2. Leave the Delay field blank or type 0 if you wish the redirect to take place immediately.  Type a higher number such as 600 (10 minutes) to allow the user to view the confirmation/results page for as long as they wish.
3. You may optionally provide an item type in the Item Type field to restrict the GoTo action to a particular type of item.
4. You may optionally configure an additional action to be performed on the resulting page.  For example, if you are redirecting to a quiz or form, type TAKE in the Action field and the user is directed into the quiz or form, bypassing the intermediate “Take the Quiz” page.
5. Additional advanced functions or sub-events can be triggered using the Sub-event field.
6. Click the Save Action button.

Grade Assignment

Posts a grade to the gradebook:

1. Select the assignment from the Assignment drop-down list
2. Select the user(s) from the Max Points Grade For drop-down list.
3. Click the Add -> button to add the user(s).
4. Add the Percentage or Points value to be added.
5. Select the Locked checkbox to keep the grade from changing in the gradebook.
6. Type comments in the Comments field.
7. Click the Save Action button.

Lock

The lock action locks existing content from the user when triggered by a specified event.  The lock action can only lock content that had previously been locked and is still associated with a particular password. 

1. Select the user from the Lock content for drop-down list.
2. Click the Add -> button.
3. Type the password(s) in the Password(s) field.
4. Click the Save Action button.

Mail (Internal)

The mail action sends a course mail message when triggered by a specified event.

1. Type a valid ANGEL username in the From field (this is pre-populated with your username) to specify who appears as the sender of the message
2. Select the recipient(s) from the Recipients drop-down list and click the desired send button (To ->, Cc ->, or Bcc ->)
3. Type a subject in the Subject field.
4. Type your message text in the Message Text field.
5. Click the Save Action button.

Message

The message action presents an inline message to the user when triggered by a specified event. 

1. Type the text you wish to be displayed in the inline message in the HTML Message Text field.
2. Click the Save Action button.

Milestone Completion

Allows the instructor to set a milestone completion action when triggered by a specified event.

1. Select the milestone from the Milestone drop-down list.
2. Select the user from the Complete For drop-down list.
3. Click the Save Action button.

Redirect

The redirect action redirects the user to a webpage when triggered by a specified event.

1. In the URL field, type the fully qualified URL of the web page you wish to redirect the user to.
2. You may optionally type a value (in seconds) in the Delay field to specify a period of time to display the conformation/results page before redirecting to the specified URL.
3. Click the Save Action button.

Replace Variable Text

The Replace Variable Text action could be used to update a list of ‘items to be completed’.  As the student complete the items, an image of a checkbox (next to the list item) could be replaced with the image of a selected checkbox.

1. Select the users from the Set Variable For drop-down list.
2. Click the Add -> button.
3. Type the variable name in the Variable Name field.
4. Type the text to find in the optional Find Text field.
5. Type the text to replace in the optional Replace With field.
6. Click the Save Action button.

Set Variable

The Set Variable action could be used to change the starting point for each student based on the last quiz they had received a passing score for.

1. Select the users from the Set Variable For drop-down list.
2. Click the Add -> button.
3. Type the variable name in the Variable Name field.
4. Type the value in the Variable Value field.
5. Click the Save Action button.

Task

Allows a personal task to be created.

1. Type a subject in the Subject field.
2. Type a message in the Body field.
3. Select a due date from the Due Date calendar or n days from agent run date.
4. Select the user from the Assigned To drop-down list.
5. Select a priority from the Priority drop-down list.
6. Select a category from the Category drop-down list or create a new category using the Other button.
7. Click the Save Action button.

Task Completion

Allows a personal task item to be marked complete.

1. Select the task from the Task drop-down list.
2. Select the user from the Complete For drop-down list.
3. Click the Save Action button.

Team Enroll

Allows an instructor the ability to enroll users in a team based on a specified event.

1. Select the user(s) to enroll from the Users to enroll field.
2. Click the Add -> button.
3. Type the team(s) name(s) in the Team(s) fields.
4. Click the Save Action button.

Team Unenroll

Allows an instructor the ability to unenroll users in a team based on a specified event.

1. Select the user(s) to enroll from the Users to unenroll field
2. Click the Add -> button
3. Type the team(s) name(s) in the Team(s) fields.
4. Click the Save Action button.

Unlock

The Unlock action releases password-protected content to the user when triggered by a specified event.  The Unlock action can only unlock content that has been previously locked and is still associated with a particular password.

1. Select the user(s) to unlock content for from the Users to unlock content for field.
2. Click the Add -> button.
3. Type the password(s) in the Password(s) fields.
4. Click the Save Action button.

Using an exclamation point (!) in front of the password hides the folder, quiz or item you wish to unlock from the user without having to set the Hide From Student checkbox.  Use the same format and password on the folder, quiz or item you wish to unlock including the exclamation point (!).  Example:  !password