Especificaciones entrantes de archivos planos
Crear actividades
Las actividades pueden crearse usando archivos planos con la función de Exportación de Notas. A continuación se ofrece un ejemplo del archivo plano, junto con las especificaciones y descripciones.
Nota
La fila de cabecera debe incluir todos los campos listados a continuación; sin embargo, solo deben especificarse los campos requeridos en un registro.
Ejemplo de archivo plano
courseId|name|instructions|anonymous|group|contentAreaName|available|colour|attempts|tracked|startDate|endDate|dueDate|points|gradeSchema|optionalData
GJTEST1|Assignment 2|assignment instructions|false|false|Assignments|true||1|false|2023-10-17|2023-10-31|2023-10-31|100.0|Schema1|MOD_CODE=2023MOD1:SESSION=8W1
Especificaciones del archivo
El nombre del archivo debe terminar en .asg; por ejemplo, período2023_01.asg.
Cabecera de campo | Descripción | Obligatorio | Tipo y tamaño máximo |
|---|---|---|---|
courseId | UID de lote del curso donde se debe crear o actualizar esta actividad. | Sí | Cadena (256 caracteres) |
nombre | Nombre de la actividad. | Sí | Cadena (333 caracteres) |
instrucciones | Instrucciones para la actividad. | No | Cadena (2000 caracteres) |
anónimo | Indica si la actividad es anónima. Y/N | No | Booleano (N por defecto) |
grupo | Indica si la actividad es una actividad grupal Y/N | No | Booleano (N por defecto) |
contentAreaName | El nombre del área de contenido del menú del curso en la que se creará la actividad. Para cursos Ultra, este encabezado puede utilizarse para provisionar una subcarpeta y colocar contenido en la subcarpeta. El valor tiene el formato "parent@>@child", donde "parent" es el nombre de la carpeta superior (parent) y "child" es el nombre de la subcarpeta. Si la subcarpeta ya existe, la actividad se añadirá a la subcarpeta existente. Si la subcarpeta no existe, se creará en la carpeta padre. | No | Cadena (255 caracteres) "Actividades" por defecto |
disponible | Disponibilidad de actividades. Y/N | No | Booleano (N por defecto) |
color | Nombre de color o valor hexadecimal del color del elemento de la actividad. | No | Cadena (10 caracteres) |
Intentos | Número de intentos concedidos para la actividad. Utilice -1 para el ilimitado. | No | Entero (por defecto -1) |
Seguimiento | Activa el seguimiento del elemento de la actividad. | No | Booleano (N por defecto) |
Fecha de inicio | Mostrar desde la fecha de la actividad. | No | Fecha formateada según lo especificado en la pantalla de Configuración entrante. No se especifica ningún valor como predeterminado. |
endDate | Mostrar hasta la fecha de la actividad. | No | Fecha formateada según lo especificado en la pantalla de Configuración entrante. No se especifica ningún valor como predeterminado. |
dueDate | Fecha de entrega para la actividad. | No | Fecha formateada según lo especificado en la pantalla de Configuración entrante. No se especifica ningún valor como predeterminado. |
Puntos | Puntos posibles para la actividad. | No | Float (Por defecto 100.0) |
gradeSchema | Esquema de calificaciones aplicado a la actividad para la visualización del Centro de Calificación. La cadena proporcionada debe coincidir con el nombre de un Esquema de Calificaciones en el curso objetivo para que se aplique la configuración. | No | Cadena (333 caracteres) El comportamiento por defecto es la puntuación. |
optionalData | Pares clave/valor con cada conjunto de pares separados por dos puntos, y clave/valores separados por un signo de igual. Por ejemplo: clave1=valor1:clave2=valor2 Más comúnmente utilizado para rastrear valores únicos al extraer y así emparejar registros con sistemas fuente. | No | Cadena (2000 caracteres por par clave/valor) |
Crear columnas de Centro de Calificaciones (calculado)
Las columnas ponderadas calculadas por el Centro de Calificaciones pueden crearse usando archivos planos con la función de Exportación de Calificaciones. Las columnas y pesos deberán añadirse manualmente en el Centro de Calificaciones a la columna ponderada calculada creada.
Nota
La fila de cabecera debe incluir todos los campos listados a continuación; sin embargo, solo deben especificarse los campos requeridos en un registro.
Ejemplo de archivo plano
courseId|name|description|duedate|points|gradeSchema|optionalData
GJTEST1|GC Calculated Grade||2023-10-30|10.0|Schema1|MOD_CODE=2023MOD1:SESSION=8W1
Especificaciones del archivo
El nombre del archivo debe terminar en .col; Por ejemplo, período2023_01.col.
Cabecera de campo | Descripción | Obligatorio | Tipo y tamaño máximo |
|---|---|---|---|
courseId | UID del lote del curso en el que se debe crear o actualizar esta columna de calificaciones. | Sí | Cadena (256 caracteres) |
nombre | Nombre de la columna de calificación. Este campo se utiliza para emparejar. | Sí | Cadena (333 caracteres) |
descripción | Descripción de la columna de calificación. | No | Cadena (2000 caracteres) |
dueDate | Fecha de entrega para la columna de calificaciones. | No | Fecha formateada según lo especificado en la pantalla de Configuración entrante. No se especifica ningún valor como predeterminado. |
Puntos | Puntos posibles para la columna de calificación. | No | Float (Por defecto 100.0) |
gradeSchema | Esquema de calificaciones aplicado a la columna de calificaciones para mostrar. La cadena proporcionada debe coincidir con el nombre de un Esquema de Calificaciones en el curso objetivo para que se aplique la configuración. | No | Cadena (333 caracteres) El comportamiento por defecto es la puntuación. |
optionalData | Pares clave/valor con cada conjunto de pares separados por dos puntos, y clave/valores separados por un signo de igual. Por ejemplo: clave1=valor1:clave2=valor2 Más comúnmente utilizado para rastrear valores únicos al extraer y así emparejar registros con sistemas fuente. | No | Cadena (2000 caracteres por par clave/valor) |
Crear columnas de Centro de Calificaciones (no calculado)
El propósito de esta interfaz es crear o actualizar columnas de libros de calificaciones.
Nota
La fila de cabecera debe incluir todos los campos listados a continuación; sin embargo, solo deben especificarse los campos requeridos en un registro.
Ejemplo de archivo plano
courseId|name|description|duedate|points|gradeSchema|optionalData
GJTEST1|GC Final Grade||2023-12-30|100|Schema1|MOD_CODE=2023MOD1:SESSION=8W1
Especificaciones del archivo
El nombre del archivo debería terminar en .colnc; por ejemplo, período2023_01.colnc.
Cabecera de campo | Descripción | Obligatorio | Tipo y tamaño máximo |
|---|---|---|---|
courseId | Uid de la generación del curso donde se debe crear o actualizar esta columna de calificaciones | Sí | Cadena (256 caracteres) |
nombre | Nombre de la columna de calificación. Este campo se utiliza para emparejar. | Sí | Cadena (333 caracteres) |
descripción | Descripción de la columna de calificación. | No | Cadena (2000 caracteres) |
dueDate | Fecha de entrega para la columna de calificaciones. | No | Fecha formateada según lo especificado en la pantalla de Configuración entrante. No se especifica ningún valor como predeterminado. |
Puntos | Puntos posibles para la columna de calificación. | No | Float (Por defecto 100.0) |
gradeSchema | Esquema de calificaciones aplicado a la columna de calificaciones para mostrar. La cadena proporcionada debe coincidir con el nombre de un Esquema de Calificaciones en el curso objetivo para que se aplique la configuración. | No | Cadena (333 caracteres) El comportamiento por defecto es la puntuación. |
optionalData | Pares clave/valor con cada conjunto de pares separados por dos puntos, y clave/valores separados por un signo de igual. Por ejemplo: clave1=valor1:clave2=valor2 Más comúnmente utilizado para rastrear valores únicos al extraer y así emparejar registros con sistemas fuente. | No | Cadena (2000 caracteres por par clave/valor) |
Establecer columnas externas de calificación (solo Curso original)
El propósito de esta interfaz es establecer una columna como columna de calificación externa. Para marcar una columna como externa, debe ser provisionada o creada una columna de calificación.
Nota
La fila de cabecera debe incluir todos los campos listados a continuación; sin embargo, solo deben especificarse los campos requeridos en un registro.
Ejemplo de archivo plano
courseId|name
GJTEST1|GC Final Grade
Especificaciones del archivo
El nombre del archivo debe terminar en .colext; por ejemplo, período2017_01.colext.
Cabecera de campo | Descripción | Obligatorio | Tipo y tamaño máximo |
|---|---|---|---|
courseId | UID del lote del curso en el que se debe crear o actualizar esta columna de calificaciones. | Sí | Cadena (256 caracteres) |
nombre | Nombre de la columna de calificación. Este campo se utiliza para emparejar. | Sí. | Cadena (333 caracteres) |
Crear valores de columna de calificación (no calculados)
El propósito de esta interfaz es crear los valores de las columnas del libro de calificaciones.
Nota
La fila de cabecera debe incluir todos los campos listados a continuación; sin embargo, solo deben especificarse los campos requeridos en un registro.
Ejemplo de archivo plano
courseId|userId|name|value
GJTEST1|User001|GC Final Grade|90
Especificaciones del archivo
El nombre del archivo debe terminar en .colncval; Por ejemplo, período2023_01.colncval.
Cabecera de campo | Descripción | Obligatorio | Tipo y tamaño máximo |
|---|---|---|---|
courseId | UID del lote del curso en el que se debe crear o actualizar esta columna de calificaciones. | Sí | Cadena (256 caracteres) |
userId | user_id del usuario para el que este valor de calificación debe ser creado o actualizado | Sí | Cadena (333 caracteres) |
nombre | Nombre de la columna de calificación. Este campo se utiliza para emparejar. | Sí | Cadena (2000 caracteres) |
valor | Valor a asignar. | Sí | Cadena (2000 caracteres) |
Crear esquema de calificaciones
Los esquemas de calificaciones pueden crearse usando archivos planos con los servicios Grades Journey. Otros archivos que crean actividades o columnas de calificación podrían depender de definiciones de esquemas de calificaciones en este archivo, pero el procesador de datos no impone una secuencia de ejecuciones concreta. Por lo tanto, debe asegurarse de que los datos del esquema de calificación se procesen antes de ejecutar otros archivos de datos dependientes.
Nota
La fila de cabecera debe incluir todos los campos listados a continuación; sin embargo, solo deben especificarse los campos requeridos en un registro.
Ejemplo de archivo plano
title|symbols|optionalData
Schema1|A=90:B=80:C=70:D=60:F=0|
Especificaciones del archivo
El nombre del archivo debe terminar en .sch; por ejemplo, período2023_01.sch.
Cabecera de campo | Descripción | Obligatorio | Tipo y tamaño máximo |
|---|---|---|---|
título | Título del esquema de calificaciones | Sí | Cadena (333 caracteres) |
Símbolos | Símbolos en una lista con cota inferior (opcional), separados por dos puntos. | Sí | Cadena (2000 caracteres) |
optionalData | Pares clave/valor con cada conjunto de pares separados por dos puntos, y clave/valores separados por un signo de igual. Por ejemplo: clave1=valor1:clave2=valor2 Más comúnmente utilizado para rastrear valores únicos al extraer y así emparejar registros con sistemas fuente. | No | Cadena (2000 caracteres por par clave/valor) |