Viewing details of each instance of the LTI Tool in your LMS

LibApps keeps track of each instance of the LTI Tool added to your LMS. Also referred to as a placement, each instance provides a great deal of information, including what content is being displayed, when it was last launched, and how often it has been launched. This can give you a general idea of how often the LTI Tool is being used within your LMS.


Getting there

To view the instance details for your LibApps LTI Tool:

  1. Navigate to LibApps.
  2. Go to Admin > LTI Tool Builder.
    • NOTE: you must be an admin in order to access the LTI Tool Builder settings.
    • If you do not see the Admin menu, then your account does not have admin permissions.
  3. Click on the LTI Instance Details tab.

Navigating to the LTI Instance Details page 


Filtering and searching your LTI instances

At the top of the LTI Instance Details page, you'll find several options for filtering the list. When using multiple filters at once, they will be applied together using AND logic.

Instance filters

  1. Find instances where: this filter allows you to limit records based upon keyword matches in the Context Label, Context Title, Context ID, and Context Type fields.
    • Select a scope from the dropdown menu.
    • Enter the text to filter by in the text field.
  2. Created between: this filter allows you to limit records based upon the date each was created.
    • Enter the starting date in the top field and the ending date in the bottom field. Clicking in the fields will display a date picker, but you can also hand-enter the dates.
    • To display records only for a single date, enter the same date in both fields.
  3. Launched between: this filter allows you to limit records based upon the date each was launched.
    • Enter the starting date in the top field and the ending date in the bottom field. Clicking in the fields will display a date picker, but you can also hand-enter the dates.
    • To display records only for a single date, enter the same date in both fields.
  4. Last Launch between: this filter allows you to limit records based upon the last date it was launched..
    • Enter the starting date in the top field and the ending date in the bottom field. Clicking in the fields will display a date picker, but you can also hand-enter the dates.
    • To display records only for a single date, enter the same date in both fields.
  5. Launch Count is: this filter allows you to limit records based upon how many times it was launched.
    • Select a logical comparison from the dropdown menu (greater than, less than, or equal to).
    • Enter the desired number of launches in the text field.
    • For example, if you only wanted to view instances that have launched more than 20 times, then you'd select "greater than" and enter 20.
  6. Click on the Filter Instances button to apply your filters. 
  7. Click on the Clear and Reload All button to reset your filters and display all records.

Viewing and exporting records

The table on the LTI Instance Details page shows you all of the instances that match your applied filters.

The LTI Instance Details table

  1. To export the list, use the CopyPrintExcel, or PDF buttons depending upon the format you need.
    • Note: only those records visible on the page will be exported. Use the Records Per Page dropdown below the table to increase the number of instances displaying at once.
  2. Use the ID column to sort or filter by an instance's ID number.
    • Each new instance is assigned a unique ID number.
  3. Use the Tool ID column to sort or filter by the ID number of the LTI Tool being used.
    • Each time the LTI Tool is added to an LMS, that tool is assigned a unique ID number.
    • For example, if you add the Automagic tool to your LMS, it would be given a Tool ID. Each instance created using that Automagic tool would share the same Tool ID.
  4. Use the Type column to sort or filter by the type of LTI Tool being used.
    • "Auto" indicates an instance of the Automagic Tool.
    • "Manual" indicates an instance of the Manual Tool.
  5. Use the Context Label field to sort or filter by the context_label of the LMS course (this usually corresponds to the course number).
  6. Use the Context Title field to sort or filter by the context_title of the LMS course (this usually corresponds to the course title).
  7. Use the Content Match column to see which content is being displayed for that instance of the LTI Tool. Click on the name of the content to preview what is being displayed in the LMS.
    • For instances of the Manual Tool, this will display the content that was selected when that instance was set up.
    • For instances of the Automagic Tool, this will display the content that was matched based upon your search type and content display behavior. This could include:
      • A specific guide
      • A specific e-reserves course
      • The Library LTI Page
  8. Use the Created field to sort or filter by the date the instance was created.
  9. Use the Last Launch field to sort or filter by the date that instance was last launched by a user in the LMS.
  10. Use the Launch Count field to sort of filter by the total number of times that instance was launched by a user in the LMS.
    • Click on the number in the column to view a breakdown of the launch count by date.
  11. For instances of the Manual Tool, you'll find two options in the Actions column.
    • Click on the View Launch Parameters () icon to view the parameters passed by the LMS when the instance was created.
    • Click on the Edit LTI Tool () icon to change the content being displayed by that instance.
  12. Use the Records Per Page‚Äč dropdown to increase the number of instances displaying at once.
  13. Use the page navigation buttons to move between pages of records. 

Related Articles