Uploaded image for project: 'Moodle'
  1. Moodle
  2. MDL-67028

LTI: Support Course dates substitution parameters

    XMLWordPrintable

    Details

    • Testing Instructions:
      Hide

      In this test, we're going to create a course with dates, and verify those dates are passed as ISO 8601 to the LTI through substitution parameters.

      pre-requisite

      1. LTI Advantage requires your site to be reachable from the internet. If not, Install ngrok to expose your moodle setup externally. Refer here for additional guidelines
      2. Have a course with an instructor.
      3. As admin install the LTI Robotest test app using the instructions found at https://robotest.theedtech.dev
        1. Make sure to set the custom parameters as indicated, in particular the $CourseSection.timeframe.begin and $CourseSection.timeframe.end since it will be the ones we will verify in this test.
      4. Tool configuration usage: Show in activity chooser and as preconfigured tool
      5. Enter a course as instructor
      6. Turn editing on
      7. Add external activity, choose Robotest app
      8. Click Select Content and Select one item (graded or not, does not matter)
      9. Save and Return to Course
      10. Set no course start date and no end course end dates

      Verify

      1. Launch the newly added link to the test app and verify the $CourseSection.timeFrame.begin and CourseSection.timeFrame.end says it's blank
      2. Edit the course settings and set both a start and end date for the course
      3. Launch the newly added link to the test app and verify the $CourseSection.timeFrame.begin and CourseSection.timeFrame.end and verify the dates match the course dates (dates are in ISO 8601 UTC time)
      Show
      In this test, we're going to create a course with dates, and verify those dates are passed as ISO 8601 to the LTI through substitution parameters. pre-requisite LTI Advantage requires your site to be reachable from the internet. If not, Install ngrok to expose your moodle setup externally. Refer here for additional guidelines Have a course with an instructor. As admin install the LTI Robotest test app using the instructions found at https://robotest.theedtech.dev Make sure to set the custom parameters as indicated, in particular the $CourseSection.timeframe.begin and $CourseSection.timeframe.end since it will be the ones we will verify in this test. Tool configuration usage: Show in activity chooser and as preconfigured tool Enter a course as instructor Turn editing on Add external activity, choose Robotest app Click Select Content and Select one item (graded or not, does not matter) Save and Return to Course Set no course start date and no end course end dates Verify Launch the newly added link to the test app and verify the $CourseSection.timeFrame.begin and CourseSection.timeFrame.end says it's blank Edit the course settings and set both a start and end date for the course Launch the newly added link to the test app and verify the $CourseSection.timeFrame.begin and CourseSection.timeFrame.end and verify the dates match the course dates (dates are in ISO 8601 UTC time)
    • Affected Branches:
      MOODLE_37_STABLE
    • Fixed Branches:
      MOODLE_311_STABLE
    • Pull from Repository:
    • Pull 3.10 Branch:
      MDL-67028-additional-custom-parameters-310
    • Pull Master Branch:
      MDL-67028-additional-custom-parameters

      Description

      Substitution parameters allow tools to tailor launches to contain extra data to their LTI launches.

      This ticket is to add support for course dates related parameters.

      For example it might be useful for a tool to know the course end date, and this would allow a tool to have it passed in every launch by adding a custom parameter such as:

      course_end_date=$CourseSection.timeFrame.end

      AC: Support the following substitution parameters

      CourseSection.timeFrame.begin: course start date ISO 8601 or blank if not set
      CourseSection.timeFrame.end: course end date ISO 8601 or blank if not set

        Attachments

          Activity

            People

            Assignee:
            claudevervoort Claude Vervoort
            Reporter:
            claudevervoort Claude Vervoort
            Peer reviewer:
            Peter Dias
            Integrator:
            Adrian Greeve
            Tester:
            Amaia Anabitarte
            Participants:
            Component watchers:
            Adrian Greeve, Jake Dallimore, Mathew May, Mihail Geshoski, Peter Dias
            Votes:
            0 Vote for this issue
            Watchers:
            5 Start watching this issue

              Dates

              Created:
              Updated:
              Fix Release Date:
              10/May/21

                Time Tracking

                Estimated:
                Original Estimate - Not Specified
                Not Specified
                Remaining:
                Remaining Estimate - 0 minutes
                0m
                Logged:
                Time Spent - 4 hours, 30 minutes
                4h 30m