LMS Integrations

Requirements:

To begin the integration process we require the following details from your Blackboard account:

1. Host
   The host your Blackboard API access is available at. This is typically in the following format:
   format: https://{orgainzation}.blackboard.com
   example: https://demoschool.blackboard.com
2. Blackboard Campuses and Programs
   A list of all of the Campuses and Programs at your school that use Blackboard.
3. Blackboard Course Keys
   Each course in Blackboard will have an “external_id” that identifies it. We need the ID for each course that you would like the grade to sync with CampusLogin. To obtain your external IDs from your Blackboard account please follow these instructions:
   
   1. Log in to your Blackboard Learn site.2. Open a new web browser window or tab.3. In the address bar, enter the following REST API URL:                        URL: https://{orgainzation}.blackboard.com/learn/api/public/v3/coursesPress Enter. This will send a request to the API and retrieve a list of all courses, including their external keys. The “external_id” field in the JSON response is the external course key you’re looking for.

To activate the integration you will need grant CampusLogin access from your Blackboard account:

1. CampusLogin’s Application Key
   71ea3336-a3e1-40b2-b5a7-bfa61c18749f
2. Instructions to Add the Key to Your Account
   https://help.blackboard.com/Learn/Administrator/SaaS/Integrations/Compare_Building_Blocks_and_Rest

Available Features

1. Post/Create Student in Blackboard
   This feature posts your students to Blackboard. The process is run nightly and updates Blackboard with any new or changed students in the last 24 hours.
   Important fields: 
    – Student Number: This is used as the External_Person_Key in Blackboard.
    – Email: This is used as the User_ID in Blackboard.
    – Password: Sets the student’s inital Blackboard password.
2. Post Enrollment Data to Blackboard
   CampusLogin will automatically post the enrollment data to Blackboard when the student in enrolled in a program setup for Blackboard.
   Important field:
    – External_Course_Key: Once Blackboard is enabled, the key from step 5 above is used to associate the CampusLogin course with the Blackboard course.
3. Pull Grades from Blackboard
   CampusLogin will automatically pull grades for each enabled program on a daily basis. In the event you need to update the grade on demand, a “Get Grade” button is added to the Program tab. You can click this button at anytime to manually fetch grades for an individual student.
   Important fields:
    – TITLE: This must match the CampusLogin Grading Component name exactly in order to sync the grade for that component.
    – GRADE: This field is used to obtain the grade for the component. Grades can be either percentage or test score.

Requirements:

To begin the integration process we require your Canvas developer API key, token, and API test url (account id). 

Available Features

1. Automatically Create Student in Canvas
   CampusLogin will automatically create the student in Canvas and enroll them into their courses (see 2 below). This saves all the admin work of administrating canvas for enrollments and allows it to be done automatically from CampusLogin.
   
   CampusLogin assigns every student a username and password in Canvas using the following logic:
   Username: Configurable in the admin tool (LastName_StudentID is the default)
   Password: Student Login password
   
   In the admin tool, you can select the trigger that creates the student. You can select to trigger the creation on either student enroll or program enroll.
   
   The Canvas Admin Tool can be configured to enable or disable your automatic enrollment email from Canvas when the student is created.
   
   Students are added with SIS ID, email, username* & password using the following API:
   https://canvas.instructure.com/doc/api/users.html#method.users.create
2. Automatically Enroll Student Into Courses in Canvas
   CampusLogin will automatically create the student in Canvas (see 1 above) and enroll them into their courses. When the student is enrolled into a program, course and schedule in CampusLogin, that information will then post to Canvas as an integrator key. CampusLogin generates a unique code for every course that you schedule which you can enter into Canvas to map the courses between both systems.
   
   You can find the CampusLogin unique codes using the report found here:
   Students > Reporting > Student Reports > Active/Upcoming CoursesYou can find the SIS ID field in Canvas here:
   Settings (in the bottom left of the course navigation) > SIS ID
3. Receive Grades from Canvas into CampusLogin
   For the Grade API to function the CampusLogin Course Instance ID (a unique ID for each course) must be mapped to the corresponding course in Canvas using the “Course SIS ID” field in Canvas.  You can look up your course instance id’s in CampusLogin using the “Active/Upcoming Courses” report found in CampusLogin.

   You can set your Canvas grade policy in the CampusLogin Canvas admin tool to pull the overall grade for each course, or the grading components for each course depending on your requirements and desired outcome. If you wish to pull grading components your grading component names must be the same spelling in both systems, and the same grading policy, such as percentage grade. If the spelling is different between the two systems for any component name the grade can not be downloaded.

   In the Canvas grade API CampusLogin will use “entered_grade” to download the grade value, “assignment_name” to associate to the correct grading component, and “userid” to associate to the correct student.

Please note: All Moodle integration requests must go through an internal scope call. Due to the open source nature of Moodle it can be used in a wide varity of configurations which may or may not be compatible with CampusLogin’s current integration.

Requirements:

To begin the integration process we require your Moodle API URL and Token. 

Available Features

1. Single Sign On (SSO)
   Students will be able to login to their CampusLogin Student Login, and connect directly to Moodle without having to login again to the CMS or remember another username and password.
   Instructions:  https://moodle.org/plugins/auth_saml2
   Table Name : auth_userkey_request_login_url
2. Automatically Create Student in Moodle
   CampusLogin will automatically create the student in Moodle and enroll them into their courses. This saves all the admin work of administrating moodle for enrollments and allows it to be done automatically from CampusLogin.
   Instructions:
   Table Name : – core_user_create_users
   Fields That Will Be Passed to Moodle:
    – createpassword int  Optional //True if password should be created and mailed to user. – username string  //Username policy is defined in Moodle security config. – auth string  Default to “manual” //Auth plugins include manual, ldap, etc – password string  Optional //Plain text password consisting of any characters – firstname string  //The first name(s) of the user – lastname string  //The family name of the user – email string  //A valid and unique email address – idnumber string  Default to “” //Student ID number
3. Automatically Enroll Student Into Courses in Moodle
   CampusLogin will automatically create the student in Moodle and enroll them into their courses. This saves all the admin work of administrating moodle for enrollments and allows it to be done automatically from CampusLogin.
   Instructions: 
   Table Name : enrol_manual_enrol_users
   Fields That Will Be Passed to Moodle:
    – roleid int  //Role to assign to the user – userid int  //The user that is going to be enrolled // for student the roleid=5 – courseid int  //The course to enrol the user role in – timestart int  Optional //Timestamp when the enrolment start // unix time – timeend int  Optional //Timestamp when the enrolment end – suspend int  Optional //set to 1 to suspend the enrolment
   CampusLogin uses the Moodle GetCourses API call to get the course id from CampusLogin to map to the course id in Moodle by using the Moodle Short Name field. Please use the same course code in CampusLogin as Short Name in Moodle
4. Receiving Grade Data from Moodle
   Grades can then be sent back from Moodle and automatically posted into CampusLogin. Moodle does not support a real time sync, so grades are synced nightly.
   Instructions: 
   Table Name : gradereport_overview_get_course_grades
   Fields That Will Be Received from Moodle:
   courseid int  //Course id // CourseCodegrade string  //Grade formattedrawgrade string  //Raw grade, not formatted

Please note: You may need to request access to enable the CampusLogin integration with your Pivot Point representative. Please contact us if you are unable to enable the integration within Pivot Point.

Requirements:

To begin the integration process we require the following credentials from your Pivot Point account:

1.  Service URL
2. API Key
3. Token
4. Role

Available Features

1. Automatically Create Student in Pivot Point
   CampusLogin will automatically create the student in Pivot Point. This saves all the admin work of creating students and allows it to be done automatically from CampusLogin.
2. Automatically Assign License to Student in Pivot Point
   CampusLogin can automatically assign program licenses to students on program enroll. This feature is optional and can be enabled or disabled based on your organization’s license policies.
3. Automatically Pull Student Grades into CampusLogin
   CampusLogin will automatically pull student grades from Pivot Point for each active program. Please note, in order to enable this feature you will need your complete list of licenses to match to their respective CampusLogin program. Currently, the integration only supports pulling grades on the overall course grade level. In order for grades to sync the course names must be identical in both CampusLogin and Pivot Point.