Documentación del administrador

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.
1. 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.
2. 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.

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 las solicitudes REST, consulte Valores de asignación REST a continuación.

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"
		}]
	}]
}

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.

Sesiones académicas

OneRoster	Valores compatibles	Asignaciones de Brightspace	Obligatorio	Notas
SourcedId			Sí
Estado	activo, tobedeleted		No	El campo para los archivos en modo delta es obligatorio.
Fecha de última modificación			No	El campo para los archivos en modo delta es obligatorio. Formato de fecha AAAA-MM-DDTHH:mm:SS.sssZ
Título		Nombre de la unidad de organización y código de la unidad de organización	Sí
Tipo			Sí	Tipo de unidad de organización
StartDate			Sí	AAAA-MM-DD
EndDate			Sí	AAAA-MM-DD
ParentSourcedId			No	Sin utilizar
SchoolYear			No	Sin utilizar

Organizaciones

OneRoster	Valores compatibles	Asignaciones de Brightspace	Obligatorio	Notas
SourcedId			Sí
Estado	activo, tobedeleted		No	El campo para los archivos en modo delta es obligatorio.
Fecha de última modificación			No	El campo para los archivos en modo delta es obligatorio. Formato de fecha AAAA-MM-DDTHH:mm:SS.sssZ
Nombre		Nombre de la unidad de organización y código de la unidad de organización	Sí	Si el campo Identificador está vacío, el nombre se copia en el código de la unidad de organización en Brightspace
Tipo	nacional, estatal, local, distrito, escuela, departamento		Sí	Define OrgUnitType en Brightspace. http://www.imsglobal.org/oneroster-v11-final-specification#_Toc480452024
Identificador		Código de la unidad de organización (si lo hubiera)	No
ParentSourcedId			No	Este campo especifica la unidad de organización principal.

Cursos

OneRoster	Valores compatibles	Asignaciones de Brightspace	Obligatorio	Notas
SourcedId			Sí
Estado	activo, tobedeleted		No	El campo para los archivos en modo delta es obligatorio.
Fecha de última modificación			No	El campo para los archivos en modo delta es obligatorio. Formato de fecha AAAA-MM-DDTHH:mm:SS.sssZ
SchoolYearSourcedId			No	Sin utilizar
Título		Nombre de la unidad de organización y código de la unidad de organización	Sí	Crea una plantilla de cursos de Brightspace. Si el campo CourseCode está vacío, el título se copia en OrgUnitCode.
Código del curso		Código de unidad de organización	No	Si se proporciona
Calificaciones			No	Sin utilizar
OrgSourcedId			Sí	Este campo especifica la unidad de organización principal.
Asuntos			No	Sin utilizar
SubjectCodes			No	Sin utilizar

Clases

OneRoster	Valores compatibles	Asignaciones de Brightspace	Obligatorio	Notas
SourcedId			Sí
Estado	activo, tobedeleted		No	El campo para los archivos en modo delta es obligatorio.
Fecha de última modificación			No	El campo para los archivos en modo delta es obligatorio. Formato de fecha AAAA-MM-DDTHH:mm:SS.sssZ
Título		Nombre de la unidad de organización y código de la unidad de organización	Sí	Crea una sección de Brightspace y una oferta de cursos. Si el campo ClassCode está vacío, el título se copia en el código de la unidad de organización.
Calificaciones			No	Sin utilizar
CourseSourcedId			Sí	Este campo especifica la unidad de organización principal
ClassCode		Código de la unidad de organización (si lo hubiera)	No	Si se proporciona
ClassType			Sí	Sin utilizar
Ubicación			No	Sin utilizar
SchoolSourcedId			Sí	Sin utilizar
TermsSourcedIds			No	Sin utilizar
Asuntos			No	Sin utilizar
SubjectCodes			No	Sin utilizar
Períodos			No	Sin utilizar

Usuarios

OneRoster	Valores compatibles	Asignaciones de Brightspace	Obligatorio	Notas
SourcedId		OrgDefinedId	Sí	Si el campo Identificador está vacío, SourcedId se copia en OrgDefinedId.
Estado	activo, tobedeleted		No	El campo para los archivos en modo delta es obligatorio.
Fecha de última modificación			No	El campo para los archivos en modo delta es obligatorio. Formato de fecha AAAA-MM-DDTHH:mm:SS.sssZ
EnabledUser			Sí	Sin utilizar
OrgSourcedIds		Inscripciones superiores de la unidad de organización (con rol en la organización)	Sí	Inscripción en las unidades de organización de escuela
Rol	administrador, ayudante, tutor, padre, supervisor, pariente, estudiante, docente		Sí	Rol en la organización
UserName		UserName	Sí
UserIds			No	Sin utilizar
GivenName		FirstName	Sí
FamilyName		LastName	Sí
MiddleName		MiddleName	No
Identificador		OrgDefinedId	No	Si se proporciona
Correo electrónico		ExternalEmail	No
Sms		MobilePhone	No
Teléfono		HomePhone	No
AgentSourcedIds			No	Se utiliza para Brightspace Parent & Guardian. Este campo asevera la relación padre-hijo. Tanto la fila de padre como la de hijo deben hacer referencia a los sourcedIds mutuos.
Calificaciones			No	Sin utilizar
Contraseña		Contraseña	No

Inscripciones

OneRoster	Valores compatibles	Asignaciones de Brightspace	Obligatorio	Notas
SourcedId			Sí
Estado	activo, tobedeleted		No	El campo para los archivos en modo delta es obligatorio.
Fecha de última modificación			No	El campo para los archivos en modo delta es obligatorio. Formato de fecha AAAA-MM-DDTHH:mm:SS.sssZ
UserSourcedId			Sí	Usuario que se inscribirá
ClassSourcedId	AAAA-MM-DD		Sí	Inscripción de Brightspace
SchoolSourcedId			No	Sin utilizar
Rol	administrador, ayudante, tutor, padre, supervisor, pariente, estudiante, docente	Rol	Sí
Principal			No	Sin utilizar
BeginDate			No	AAAA-MM-DD
EndDate			No	AAAA-MM-DD

Valores de asignación de REST