Reglas para todos los archivos CSV
- Los valores de los archivos distinguen mayúsculas y minúsculas.
- Un valor vacío se representa con dos comas, sin espacios entre ellas. Por ejemplo, excluir los corchetes [,,] indica un valor vacío, mientras que [, ,] indica un carácter de espacio, el cual se considera un valor no válido.
- Los archivos CSV deben tener un encabezado (primera línea) que debe coincidir exactamente, incluso las mayúsculas y minúsculas, con el formato que aparece en los ejemplos de las secciones que se mencionan a continuación.
- Las subsiguientes líneas del archivo contienen los datos que se deben procesar (ingresar, actualizar o eliminar).
- Los nombres de archivo son estándar (usuarios, organizaciones, etc.).
Manifiesto
Debe incluir un archivo de manifiesto con cada paquete. El manifiesto contiene la versión y la lista de archivos que está enviando a Brightspace e indica si los datos del registro reflejan el valor de cada paquete.
- el nombre de archivo debe ser manifest.csv.
- El valor puede ser una de las siguientes opciones:
- Carga masiva: para la importación masiva de instantáneas. Los campos de estado y datelastmodified deben dejarse en blanco si utiliza el modo de carga masiva. El modo de carga masiva elimina de manera implícita solo las inscripciones.
- Delta: para la importación de deltas. Los campos de estado y datelastmodified deben completarse. Este es el único modo que permite la eliminación explícita.
- Ausente: si un archivo no se envía, debe marcarse como ausente.
A continuación, aparece una lista de contenido de muestra para el manifiesto (junto con la línea de encabezado obligatoria):
propertyName,value
manifest.version,1.0
oneroster.version,1.1
file.academicSessions,delta
file.categories,absent
file.classes,delta
file.classResources,absent
file.courses,delta
file.courseResources,absent
file.demographics,absent
file.enrollments,delta
file.lineItems,absent
file.orgs,delta
file.users,delta
file.resources,absent
file.results,absent
|
Nota: El uso de CSV de OneRoster en modo de carga masiva permite que el SIS anule automáticamente la inscripción de los usuarios de los cursos y las secciones si ya no están incluidos en el archivo de carga masiva. Esta función garantiza que Brightspace se mantenga sincronizado con el SIS sin requerir datos de anulación de inscripción explícitos en los archivos de OneRoster. |
Sesiones académicas
En el siguiente ejemplo, aparece una lista de dos filas de contenido para una sesión académica (junto con la línea de encabezado obligatoria). El archivo consta de nueve columnas obligatorias, cada una de las cuales requiere un valor válido o puede dejarse sin completar, según el formato del archivo.
sourcedId,status,dateLastModified,title,type,startDate,endDate,parentSourcedId,schoolYear
TERM_LW11,active,2016-04-30T00:00:00Z,Spring TERM_LW11,term,2017-04-30,2017-06-30,,2017
GRADINGPERIOD_LW11,active,2016-04-30T00:00:00Z,Full Spring GRADINGPERIOD_LW11,gradingPeriod,2017-04-30,2017-06-30,TERM_LW11,2017
| Columna |
Campo |
Obligatorio |
Valores admitidos |
Notas |
| 1 |
SourceId (ID de fuente) |
Sí |
|
Almacenada en IPSIS para asignar a una unidad de organización en Brightspace |
| 2 |
Estado |
Sí |
activo, tobedeleted |
Se utiliza para crear/actualizar o eliminar la sesión académica. Se requiere si dateLastModified (fecha de la última modificación) está presente y si envía deltas. |
| 3 |
Fecha de última modificación |
No |
AAAA-MM-DDTHH:mm:SS:ssZ |
*Seguimiento interno* |
| 4 |
Título |
Sí |
|
Nombre de la unidad de organización y código de la unidad de organización |
| 5 |
Tipo |
Sí |
gradingPeriod (período de calificación), semester (semestre), schoolyear (año escolar), term (término) |
Tipo de unidad de organización |
| 6 |
StartDate |
Sí |
AAAA-MM-DD |
Se puede copiar la fecha de inicio de la sesión académica a las fechas de inicio de las ofertas de cursos asociadas. |
| 7 |
EndDate |
Sí |
AAAA-MM-DD |
Se puede copiar la fecha final de la sesión académica a las fechas finales de las ofertas de cursos asociadas. |
| 8 |
ParentSourceId (ID de fuente principal) |
No |
|
Ignorado |
| 9 |
Año escolar |
Sí |
AAAA |
No asignado |
Organizaciones
En el siguiente ejemplo, aparece una lista de cuatro filas de contenido para las organizaciones (junto con la línea de encabezado obligatoria). El archivo consta de siete columnas obligatorias, cada una de las cuales requiere un valor válido o debe dejarse sin completar, según el formato del archivo.
sourcedId,status,dateLastModified,name,type,identifier,parentSourcedId
DISTRICT_LW11,active,2016-04-30T00:00:00Z,DISTRICT_LW11,district,,
SCHOOL_LW111,active,2016-04-30T00:00:00Z,SCHOOL_LW111,school,,DISTRICT_LW11
DISTRICT_LW12,active,2016-04-30T00:00:00Z,DISTRICT_LW12,district,,
SCHOOL_LW121,active,2016-04-30T00:00:00Z,SCHOOL_LW121,school,,DISTRICT_LW12
| Columna |
Campo |
Obligatorio |
Valores admitidos |
Notas |
| 1 |
SourceId (ID de fuente) |
Sí |
|
Almacenada en IPSIS para asignar a una unidad de organización en Brightspace |
| 2 |
Estado |
No |
active o tobedeleted (activo o para eliminar) |
Crear/actualizar o eliminar la unidad de organización. Se requiere si dateLastModified (fecha de la última modificación) está presente y si envía deltas |
| 3 |
Fecha de última modificación |
No |
AAAA-MM-DDTHH:mm:SS:ssZ |
*Seguimiento interno* |
| 4 |
Nombre |
Sí |
|
Nombre y código de la unidad de organización (si no se completó el identificador) |
| 5 |
Tipo |
Sí |
departamento, escuela, distrito, local, estatal, nacional |
Tipo de unidad de organización |
| 6 |
Identificador |
No |
|
Código de la unidad de organización (si lo hubiera) |
| 7 |
ParentSourcedId |
No |
|
El SourcedId de la unidad de organización principal no se requiere específicamente; sin embargo, sin esto, las unidades de organización no formarán parte de una jerarquía. |
Cursos
A continuación, aparece una lista de dos filas del contenido de muestra para los cursos (junto con la línea de encabezado obligatoria). El archivo consta de 10 columnas obligatorias, cada una de las cuales requiere un valor válido o debe dejarse sin completar, según el formato del archivo.
sourcedId,status,dateLastModified,schoolYearSourcedId,title,courseCode,grades,orgSourcedId,subjects,subjectCodes
COURSE_LW11,active,2017-04-30T00:00:00Z,,The ways of the Force,COURSE_LW11,,SCHOOL_LW111,,
COURSE_LW12,active,2017-04-30T00:00:00Z,,French As A Second Language,COURSE_LW12,,SCHOOL_LW111,,
| Columna |
Campo |
Obligatorio |
Valores admitidos |
Notas |
| 1 |
SourceId (ID de fuente) |
Sí |
|
Almacenada en IPSIS para asignar a una unidad de organización en Brightspace (plantilla de cursos) |
| 2 |
Estado |
No |
active o tobedeleted (activo o para eliminar) |
Crear/actualizar o eliminar la plantilla del curso. Se requiere si dateLastModified (fecha de la última modificación) está presente y si envía deltas |
| 3 |
Fecha de última modificación |
No |
AAAA-MM-DDTHH:mm:SS:ssZ |
*Seguimiento interno* |
| 4 |
SchoolYearSourceId |
No |
|
Ignorado |
| 5 |
Título |
Sí |
|
Nombre y código de la unidad de organización (si no se completó el identificador) |
| 6 |
Código del curso |
No |
|
Código de la unidad de organización (si lo hubiera) |
| 7 |
Calificaciones |
No |
|
Ignorado
|
| 8 |
OrgSourceId |
Sí |
|
SourceId de la Unidad de organización principal (es decir, Escuela) |
| 9 |
Asuntos |
No |
|
Ignorado |
| 10 |
SubjectCodes |
No |
|
Ignorado |
Clases
A continuación, aparece una lista de tres filas del contenido de muestra para las clases (junto con la línea de encabezado obligatoria). El archivo consta de 14 columnas obligatorias, cada una de las cuales requiere un valor válido o puede dejarse sin completar, según el formato del archivo. Cada registro se crea como una oferta de cursos con una única sección en ella.
sourcedId,status,dateLastModified,title,grades,courseSourcedId,classCode,classType,location,schoolSourcedId,termSourcedIds,subjects,subjectCodes,periods
CLASS_LW111,active,2017-04-30T00:00:00Z,The Force 101,,COURSE_LW11,CLASS_LW111,scheduled,,SCHOOL_LW111,TERM_LW11,,,
CLASS_LW112,active,2017-04-30T00:00:00Z,The Force Advanced,,COURSE_LW11,CLASS_LW112,scheduled,,SCHOOL_LW111,TERM_LW11,,,
CLASS_LW121,active,2017-04-30T00:00:00Z,French - Reading LW1,,COURSE_LW12,CLASS_LW121 fr-reading,scheduled,,SCHOOL_LW111,TERM_LW11,,,
| Columna |
Campo |
Obligatorio |
Valores admitidos |
Notas |
| 1 |
SourceId (ID de fuente) |
Sí |
|
Se almacena en IPSIS para asignar a una unidad de organización en Brightspace (oferta de cursos) |
| 2 |
Estado |
No |
active o tobedeleted (activo o para eliminar) |
Crear/actualizar o eliminar la oferta de cursos y sección (establecer como inactivo o eliminar según la configuración de Administración del IPSIS). Obligatorio si dateLastModified está presente |
| 3 |
Fecha de última modificación |
No |
AAAA-MM-DDTHH:mm:SS:ssZ |
*Seguimiento interno* |
| 4 |
Título |
Sí |
|
Nombre y código de la unidad de organización (si no se proporcionó un classCode) |
| 5 |
Calificaciones |
No |
|
Ignorado |
| 6 |
CourseSourceId (ID de fuente de curso) |
Sí |
|
SourceId (ID de fuente) de la unidad de organización principal (plantilla del curso) |
| 7 |
ClassCode |
No |
|
Código de la unidad de organización (si lo hubiera) |
| 8 |
ClassType |
Sí |
homeroom, programada |
Ignorado |
| 9 |
Ubicación |
No |
|
Ignorado
|
| 10 |
SchoolSourceId (ID de fuente de escuela) |
Sí |
|
SourceId de la Unidad de organización principal (es decir, Escuela) |
| 12 |
TermsSourceId (ID de fuente de términos) |
Sí |
|
SourceId de la Unidad de organización principal (es decir, Período) |
| 12 |
Asuntos |
No |
|
Ignorado |
| 13 |
SubjectCodes |
No |
|
Ignorado |
| 14 |
Períodos |
No |
|
Ignorado |
EMPEZAR AQUÍ
Usuarios
A continuación, aparece una lista de cinco filas del contenido de muestra para los usuarios (junto con la línea de encabezado obligatoria). El archivo consta de 18 columnas obligatorias, cada una de las cuales debe completarse con un valor válido o dejarse sin completar, según el formato del archivo.
|
sourcedId,status,dateLastModified,enabledUser,orgSourcedIds,role,username,userIds,givenName,familyName,middleName,identifier,email,sms,phone,agentSourcedIds,grades,password
STUDENT_LW11,active,2017-04-30T00:00:00Z,TRUE,SCHOOL_LW111,student,STUDENT_LW11,,Luke,Walker,,,email@email.com,,,"PARENT_LW11,TEACHER_LW11,GUARDIAN_LW11",,
STUDENT_LW12,active,2017-04-30T00:00:00Z,TRUE,SCHOOL_LW111,student,STUDENT_LW12,,Prince,Lee,,,email@email.com,,,"PARENT_LW11,GUARDIAN_LW11",,
PARENT_LW11,active,2017-04-30T00:00:00Z,TRUE,SCHOOL_LW111,parent,PARENT_LW11,,Bartholomew,Vadery,,,email@email.com,,,"STUDENT_LW11,STUDENT_LW12",,
GUARDIAN_LW11,active,2017-04-30T00:00:00Z,TRUE,SCHOOL_LW111,guardian,GUARDIAN_LW11,,Obi,Kennedy,,,email@email.com,,,"STUDENT_LW11,STUDENT_LW12",,
TEACHER_LW11,active,2017-04-30T00:00:00Z,TRUE,SCHOOL_LW111,teacher,TEACHER_LW11,,Mac,Yodad,,,email@email.com,,,"STUDENT_LW12,STUDENT_LW11",,
|
| Columna |
Campo |
Obligatorio |
Valores posibles |
Notas |
| 1 |
SourcedId |
Sí |
|
OrgDefinedId si el identificador no se proporciona |
| 2 |
Estado |
No |
active o tobedeleted (activo o para eliminar) |
Activo de manera predeterminada (depende de la configuración de la interfaz de usuario)
Obligatorio si DateLastModified está presente
Inactivo o tobedeleted desactiva al usuario |
| 3 |
Fecha de última modificación |
No |
AAAA-MM-DDTHH:mm:SS*,s*ssZ |
*Seguimiento interno* |
| 4 |
EnabledUser |
Sí |
verdadero o falso |
Activo en LMS si se establece en verdadero |
| 5 |
OrgSourceIds |
Sí |
|
Inscripción en una unidad de organización de escuela |
| 6 |
Rol |
Sí |
|
Rol en la organización |
| 7 |
UserName |
Sí |
|
UserName
|
| 8 |
UserIds |
No |
|
Ignorado |
| 9 |
GivenName |
Sí |
|
FirstName |
| 10 |
FamilyName |
Sí |
|
LastName |
| 11 |
MiddleName |
No |
|
MiddleName |
| 12 |
Identificador |
No |
|
OrgDefinedId (si lo hubiera) |
| 13 |
Correo electrónico |
No |
|
ExternalEmail |
| 14 |
Sms |
No |
|
Ignorado |
| 15 |
Teléfono |
No |
|
Ignorado |
| 16 |
AgentSourcedIds |
No |
|
Se utiliza para indicar la relación padre/tutor |
| 17 |
Calificaciones |
No |
|
No asignado |
| 18 |
Contraseña |
No |
|
|
Inscripciones
A continuación, aparece una lista de una fila del contenido de muestra de las inscripciones (junto con la línea de encabezado obligatoria). El archivo consta de 10 columnas obligatorias, cada una de las cuales debe completarse con un valor válido o dejarse sin completar, según el formato del archivo. Un usuario especificado será inscrito en una oferta de cursos y una sección
|
sourcedId,status,dateLastModified,classSourcedId,schoolSourcedId,userSourcedId,role,primary,beginDate,endDate
STUDENT_CLASS_LW1111,active,2017-04-30T00:00:00Z,CLASS_LW111,SCHOOL_LW111,STUDENT_LW11,student,,,
|
| Columna |
Campo |
Obligatorio |
Valores posibles |
Notas |
| 1 |
SourceId (ID de fuente) |
Sí |
|
*Seguimiento interno* |
| 2 |
Estado |
No |
active o tobedeleted (activo o para eliminar) |
Activo de forma predeterminada
Obligatorio si DateLastModified está presente |
| 3 |
Fecha de última modificación |
No |
AAAA-MM-DDTHH:mm:SS:ssZ |
*Seguimiento interno* |
| 4 |
UserSourcedId |
Sí |
|
Usuario que se inscribirá |
| 5 |
ClassSourcedId |
Sí |
|
Clase en la que se inscribirá |
| 6 |
SchoolSourcedId |
Sí |
verdadero o falso |
No asignado |
| 7 |
Rol |
Sí |
Los únicos valores permitidos son administrador, supervisor, estudiante y profesor. |
Rol en la unidad de organización de la oferta de cursos
|
| 8 |
Principal |
No |
|
No asignado |
| 9 |
BeginDate |
No |
|
No asignado |
| 10 |
EndDate |
No |
|
No asignado |