Uso de IPSIS OneRoster con Brightspace Parent & Guardian
Con IPSIS OneRoster es posible enviar relaciones de usuario entre un padre o tutor legal y un niño a Brightspace. La integración de IPSIS OneRoster en TBD solo está disponible para los clientes de los EE. UU., Canadá, Australia e Irlanda.
Actualmente, solo los siguientes roles se consideran relevantes para la relación:
- Elemento principal
- Tutor
- Estudiante
Se ignorarán los demás roles.
Pasos para configurar OneRoster
- En la página Administración de IPSIS, abra la pestaña Configuración.
- Si tiene un sistema de origen OneRoster 1.1 - CVS, se mostrarán las credenciales de SFTP. Copie el host, el nombre de usuario y la contraseña (SIS las necesita para enviar archivos CSV a Brightspace).
- Si tiene un sistema de origen OneRoster 1.1 – REST, debe seleccionar el método OAuth.
- OAuth1.0a está seleccionado de forma predeterminada. Ingrese la URL del punto de conexión válida, la clave del consumidor, la respuesta secreta del consumidor y seleccione el método de firma de OAuth.
- Si está seleccionado OAuth2, ingrese una ID de cliente y la respuesta secreta del cliente válidas.
- Asigne el rol de padre o tutor del Sistema de información de estudiantes al rol de Brightspace para los padres o tutores.
- Asigne el rol de estudiante del Sistema de información de estudiantes al rol de Brightspace para los estudiantes.
- Asignar la organización educativa del Sistema de información de estudiantes a un tipo de unidad de organización de Brightspace.
- Revise otras configuraciones y haga clic en Guardar.
Nota: Según el formato de intercambio de datos, cargue el archivo .CSV para crear relaciones de elementos principales-secundarios o realice una solicitud REST para crear relaciones de elementos principales-secundarios. A continuación, puede ver un ejemplo del archivo CSV y la solicitud REST.
Valores de asignación de CSV
A fin de crear relaciones padre o tutor-hijo, AgentSourceIds en el archivo users.CSV debe actualizarse tanto para los padres o tutores como para los estudiantes.
Para obtener información detallada sobre los valores de asignación de CSV, consulte el tema de la documentación Asignación de valores CSV y vea la tabla de usuarios en la que se muestra información acerca de los valores admitidos y requeridos.
Archivo CSV de muestra
sourcedId,status,dateLastModified,enabledUser,orgSourcedIds,role,username,userIds,givenName,familyName,middleName,identifier,email,sms,phone,agentSourcedIds,grades,password
{studentsourceId},active,,TRUE,{orgSourcedIds},student,{learner username},{userId},{learner given Name},{learner family name},,,{learner email},,, "{parentsourceId1}, {parentsourceId2}",,{password}
{parentsourceId1},active,,TRUE,{orgSourcedIds},parent,{parent username},{userIds},{parent given name},{parent family name},,,{parent email},,,{studentsourceId},,{ password}
{parentsourceId2},active,,TRUE,{orgSourcedIds},parent,{parent username},{userId},{parent given name},{parent family name},,,{parent email},,,{studentsourceId},,{ password}
Solicitud REST
A fin de crear relaciones padre o tutor-hijo, en la solicitud de creación de usuarios REST se debe incluir información para padres o tutores en el campo de agente.
Para obtener información detallada sobre la solicitud REST, visite el tema Valores de asignación REST.
Muestra de REST JSON con relaciones definidas
Para un estudiante:
{
"users": [{
"sourcedId": "user1",
"status": "active",
"dateLastModified": "2017-06-05T22:15:00.000Z",
"username": "userone",
"givenName": "Richard",
"middleName": "",
"familyName": "Deckard",
"role": "student",
"identifier": "user1",
"enabledUser": true,
"grades": [],
"userIds": [],
"orgs": [{
"sourcedId": "District1",
"href": "https://oneroster.infinitec",
"type": "org"
},
{
"sourcedId": "School1",
"href": "https://some_url/learningdata/v1p1/schools/5C354F4D-DFD0-406D-8B83-7D5C8B64EF8B",
"type": "org"
}],
"agents": [{
"sourcedId": "Parent1",
"href": "https://some_url/learningdata/learningdata/v1p1/users/Parent1",
"type": "user"
},
{
"sourcedId": "Parent2",
"href": "https://some_url/learningdata/learningdata/v1p1/users/Parent2",
"type": "user"
}]
}]
}
Para un padre o tutor:
{
"users": [{
"sourcedId": "Parent1",
"status": "active",
"dateLastModified": "2017-06-05T22:15:00.000Z",
"username": "Parent1",
"givenName": "James",
"middleName": "",
"familyName": "Deckard",
"role": "parent",
"identifier": "Parent1",
"enabledUser": true,
"grades": [],
"userIds": [],
"orgs": [{
"sourcedId": "District1",
"href": "https://oneroster.infinitec",
"type": "org"
},
{
"sourcedId": "School1",
"href": "https://some_url/learningdata/v1p1/schools/5C354F4D-DFD0-406D-8B83-7D5C8B64EF8B",
"type": "org"
}]
}]
}