You can manage entitlements from the User Entitlements page on the admin UI.

Entitlements refer to a lab's time limit, the time a student has to work on a lab, and the valid period for a lab, the time during which a lab is active and available for sign-up and use. VMware Learning Platform copies values for an entitlement from the lab record when the entitlement is created.

Clicking Entitlements > User Entitlements opens the Entitlements page.

Action Options

On the Entitlements page, you can select one or more entitlements, then open the Action drop-down menu and select one of the following choices.

  • End: Ends an entitlement that has already started.

  • Cancel: Cancels an entitlement that has not yet been started.

  • Extend Time: Adds more elapsed time to the entitlement. When you select Extend, an entry box opens that allows you add to the remaining time.

    Caution:

    If the class end date or time is changed, then the Entitlement expiration date is updated to the same. For more information, see Edit an Existing Class.

  • Reset: Forces the vApp in the cloud to be deleted. The next time the user starts the entitlement, the user gets a new vApp (either a prepop or an on-demand).

  • Power Reset: Resets the power cycles for all the VMs in a vApp.

  • Make Ready: Assigns cloud resources (vApp) to an entitlement before the entitlement initially starts. Once the entitlement is ready, the system either takes an existing prepop from the available prepops pool or triggers an on-demand deployment. So, a vApp exists in the cloud assigned to this entitlement. The Make Ready option, allows you to assign cloud resources to the entitlement but does not trigger the entitlement’s time allotted time to start counting down.

  • Send Email: Sends an email to the user with the entitlement's quick launch URL.

  • Add to Class: Adds the selected entitlements to the class you select. Once you select the Add to Class action, the Class text box appears. So, the steps are first click Add to Class to display the Class text box, and then select a class from the Class text box.

  • Change Step: Changes the current manual step for the entitlement.

  • Power off cloud vApp: Powers off the vApp for the current entitlement.

  • Graded: This option is enabled only if the entitlement is in the “awaiting grading” status. The awaiting grading status is an interim status between an entitlement being started and ended.

    • If a lab is not marked as requiring grading, then when it ends the system moves the entitlement to a transcript and deletes the vApp.

    • If grading is required, then the system transitions the entitlement into the awaiting grading status and retains the vApp. The entitlement is no longer active and so a lab user cannot take or re-enroll into the lab.

    • If the Graded option is enabled and you (the tenant admin) click it, then the system removes the entitlement from the awaiting grade status, copies it to a transcript and deletes the vApp.

Editing Options

Click an entitlement on the Entitlement page to open a form. The form includes two tabs: E Entitlement and Clone vApp.

The Edit Entitlement tab allows you to edit some of its text boxes:

  • Time Allotted: Allots an amount of time for the selected entitlement.

  • Expiration Date: Sets an expiration date for the selected entitlement.

  • Score: Assigns a numerical score to the entitlement. For more information about scores, see “Grading Options”.

  • Grade: Assigns a text grade (for example, “A”) to the entitlement. For more information about grade strings, see “Grading Options”.

  • Entitlement Metadata: Adds the metadata you enter. For example, you might include the following metadata “This is an example of metadata”. In this example, the system adds the metadata “This is an example of metadata” to the entitlement.

  • Tracking Code: A tracking code is a useful way to track the link by which an end user found a lab. Consider the following examples:

    • A promotion campaign posts a link to a lab that includes the tracking code promoA:https://www.vmwarelearningplatform.com/hol/catalogs?ti d=promoA this example, the system adds the tracking ID promoA to the entitlements of anyone who clicked the link.

    • Another promotion campaign posts a link to the same lab but instead includes the tracking code promoB:https://www.vmwarelearningplatform.com/hol/catalogs?tid=promoB this example, the system adds the tracking ID promoB to the entitlements of anyone who clicked the link.

  • Always Run vApp: If enabled, the system prevents the vApp from shutting down and powering off.

The Clone vApp tab allows you to take one vApp in a cloud and create another version of it in the same virtual data center (vDC). You can select one or more entitlements and then click Clone vApp.

Entitlement Statuses

On the Entitlement page, you can select one or more entitlements, then click Status to filter the list by entitlement status. The life cycle of an entitlement in VMware Learning Platform includes the following statuses:

  • Complete: Legacy status which the system no longer uses. When an entitlement has been completed, the system moves it to a transcript.

  • Incomplete: Initial status of an entitlement. An incomplete status means that the entitlement is ready to be started. The entitlement still has time left and has not reached its expiration date, but is not currently active (end user is not using the lab console). An incomplete entitlement can be in either of the following states: Just created (not started yet) or Started but paused.

  • Expired: Every entitlement has an expiration date and a time allotted. If the expiration date is reached or the time allotted is over, then the entitlement expires. This temporary status means that a couple of hours after expiration, the system ends the entitlement and moves it to a transcript.

  • Suspended: Not yet been implemented so no entitlement must be in this status.

  • Gone: Entitlement was active but one of the following occurred:

    • End user closed the browser without first exiting or ending the entitlement.

    • End user navigated away from the lab console without first exiting or ending the entitlement.

    • Internet connection on the client dropped.

    • No activity on the browser console has occurred for a while and as a result the system navigated the end user to an Idle page.

  • Active: End user is using the entitlement. During an Active status, the browser pings the server to verify a connection. If the browser drops the connection or if the connection closes, then the ping does not occur, and the system sets the entitlement to the next status.

  • Canceled: Similar to the Complete status. Canceled is a status of a transcript rather than an entitlement. If an entitlement has never been started a tenant admin can cancel it. The transcript marks the entitlement as having been canceled.

  • Awaiting Grade: Only for entitlements that require grading. If an entitlement requires grading, then, after it has been ended, the system does not move it to a transcript. Instead, the system keeps the entitlement in an Awaiting Grading status meaning that it is waiting for a tenant admin to grade it.

  • Ready: Much like the Incomplete status. However, the Ready status means the system assigned a pre-populated vApp to the entitlement. When an end user starts an entitlement in a Ready status, then it starts without delay as the vApp is already assigned.

Grading Options

You can use the Score and Grade String text boxes on the Entitlement page to add grading data to an entitlement. You can subsequently edit the grading data. To grade an entitlement:

  1. Enter a Score or Grade String.
  2. When you use scores or grade strings, the system does not actually grade the entitlement. Grading an entitlement requires transferring its grading data to a transcript. To transfer the grading data to a transcript, you must click the Graded option from the pull-down.

Export Option

The Entitlement page includes an Export option. The Export option allows you to export all notifications to a CSV, Excel, or PDF.