Especificaciones de archivos planos entrantes
Crear actividades
Las actividades se pueden crear utilizando archivos planos con la función Exportación de calificaciones. A continuación se proporciona un ejemplo del archivo plano, junto con las especificaciones y descripciones.
Nota
La fila de encabezado debe incluir todos los campos que se enumeran a continuación; sin embargo, solo se deben especificar los campos obligatorios en un registro.
Ejemplo de archivo plano
courseId|name|instructions|anonymous|group|contentAreaName|available|colour|attempts|tracked|startDate|endDate|dueDate|points|gradeSchema|optionalData GETEST1|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 de archivo
El nombre del archivo debe terminar en .asg; Por ejemplo, período2023_01.asg.
Encabezado 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. S/N | No | Booleano (predeterminado N) |
grupo | Indica si la actividad es una actividad de grupo S/N | No | Booleano (predeterminado N) |
contentAreaName | El nombre del área de contenido del menú del curso en la que se creará la actividad. | No | Cadena (255 caracteres) "Actividades" predeterminadas |
disponible | Disponibilidad de actividades. S/N | No | Booleano (predeterminado N) |
color | Nombre de color o valor de cadena hexadecimal del color del elemento de actividad. | No | Cadena (10 caracteres) |
Intentos | Número de intentos concedidos para la actividad. Use -1 para ilimitado. | No | Entero (predeterminado -1) |
Seguimiento | Habilite el seguimiento para el elemento de actividad. | No | Booleano (predeterminado N) |
fecha de inicio | Mostrar la fecha de inicio para la actividad. | No | Fecha formateada como se especifica en la pantalla Configuración de entrada. No se ha especificado ningún valor por defecto. |
fecha de finalización | Mostrar hasta la fecha de la actividad. | No | Fecha formateada como se especifica en la pantalla Configuración de entrada. No se ha especificado ningún valor por defecto. |
fecha de vencimiento | Fecha de entrega de la actividad. | No | Fecha formateada como se especifica en la pantalla Configuración de entrada. No se ha especificado ningún valor por defecto. |
puntos | Puntos posibles para la actividad. | No | Float (predeterminado 100.0) |
esquema de grado | Esquema de calificación 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 de destino para que se aplique la configuración. | No | Cadena (333 caracteres) El comportamiento predeterminado es la puntuación. |
optionalData | Pares clave/valor con cada conjunto de pares separados por dos puntos y clave/valores separados por un signo igual. Por ejemplo: clave1=valor1:clave2=valor2 Se usa más comúnmente para rastrear valores únicos en el momento de la extracción para hacer coincidir los registros con los sistemas de origen. | No | Cadena (2000 caracteres por par clave/valor) |
Crear columnas del centro de calificaciones (calculadas)
Las columnas ponderadas calculadas del Centro de calificación se pueden crear utilizando archivos planos con la función Exportación de calificación. Las columnas y los pesos deberán agregarse manualmente en el centro de calificación a la columna ponderada calculada creada.
Nota
La fila de encabezado debe incluir todos los campos que se enumeran a continuación; sin embargo, solo se deben especificar los campos obligatorios en un registro.
Ejemplo de archivo plano
courseId|name|description|duedate|points|gradeSchema|optionalData GETEST1|GC Calculated Grade||2023-10-30|10.0|Schema1|MOD_CODE=2023MOD1:SESSION=8W1
Especificaciones de archivo
El nombre del archivo debe terminar en .col; Por ejemplo, período2023_01.col.
Encabezado de campo | Descripción | Obligatorio | Tipo y tamaño máximo |
|---|---|---|---|
courseId | UID de lote del curso donde se debe crear o actualizar esta columna de calificación. | Sí | Cadena (256 caracteres) |
nombre | Nombre de la columna de calificación. Este campo se utiliza para la coincidencia. | Sí | Cadena (333 caracteres) |
descripción | Descripción de la columna de calificación. | No | Cadena (2000 caracteres) |
fecha de vencimiento | Fecha de entrega para la columna de calificación. | No | Fecha formateada como se especifica en la pantalla Configuración de entrada. No se ha especificado ningún valor por defecto. |
puntos | Puntos posibles para la columna de calificación. | No | Float (predeterminado 100.0) |
esquema de grado | Esquema de calificación aplicado a la columna de calificación para su visualización. La cadena proporcionada debe coincidir con el nombre de un esquema de calificaciones en el curso de destino para que se aplique la configuración. | No | Cadena (333 caracteres) El comportamiento predeterminado es la puntuación. |
optionalData | Pares clave/valor con cada conjunto de pares separados por dos puntos y clave/valores separados por un signo igual. Por ejemplo: clave1=valor1:clave2=valor2 Se usa más comúnmente para rastrear valores únicos en el momento de la extracción para hacer coincidir los registros con los sistemas de origen. | No | Cadena (2000 caracteres por par clave/valor) |
Crear columnas del centro de calificación (no calculadas)
El propósito de esta interfaz es crear o actualizar columnas del libro de calificaciones.
Nota
La fila de encabezado debe incluir todos los campos que se enumeran a continuación; sin embargo, solo se deben especificar los campos obligatorios en un registro.
Ejemplo de archivo plano
courseId|name|description|duedate|points|gradeSchema|optionalData GETEST1|GC Final Grade||2023-12-30|100|Schema1|MOD_CODE=2023MOD1:SESSION=8W1
Especificaciones de archivo
El nombre del archivo debe terminar en .colnc; Por ejemplo, período2023_01.colnc.
Encabezado de campo | Descripción | Obligatorio | Tipo y tamaño máximo |
|---|---|---|---|
courseId | UID de lote del curso donde se debe crear o actualizar esta columna de calificación | Sí | Cadena (256 caracteres) |
nombre | Nombre de la columna de calificación. Este campo se utiliza para la coincidencia. | Sí | Cadena (333 caracteres) |
descripción | Descripción de la columna de calificación. | No | Cadena (2000 caracteres) |
fecha de vencimiento | Fecha de entrega para la columna de calificación. | No | Fecha formateada como se especifica en la pantalla Configuración de entrada. No se ha especificado ningún valor por defecto. |
puntos | Puntos posibles para la columna de calificación. | No | Float (predeterminado 100.0) |
esquema de grado | Esquema de calificación aplicado a la columna de calificación para su visualización. La cadena proporcionada debe coincidir con el nombre de un esquema de calificaciones en el curso de destino para que se aplique la configuración. | No | Cadena (333 caracteres) El comportamiento predeterminado es la puntuación. |
optionalData | Pares clave/valor con cada conjunto de pares separados por dos puntos y clave/valores separados por un signo igual. Por ejemplo: clave1=valor1:clave2=valor2 Se usa más comúnmente para rastrear valores únicos en el momento de la extracción para hacer coincidir los registros con los sistemas de origen. | No | Cadena (2000 caracteres por par clave/valor) |
Establecer columnas de calificación externas (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, se debe aprovisionar o crear una columna de calificación.
Nota
La fila de encabezado debe incluir todos los campos que se enumeran a continuación; sin embargo, solo se deben especificar los campos obligatorios en un registro.
Ejemplo de archivo plano
courseId|name GETEST1|GC Final Grade
Especificaciones de archivo
El nombre del archivo debe terminar en .colext; Por ejemplo, período2017_01.colext.
Encabezado de campo | Descripción | Obligatorio | Tipo y tamaño máximo |
|---|---|---|---|
courseId | UID de lote del curso donde se debe crear o actualizar esta columna de calificación. | Sí | Cadena (256 caracteres) |
nombre | Nombre de la columna de calificación. Este campo se utiliza para la coincidencia. | Sí. | Cadena (333 caracteres) |
Crear valores de columna de calificación (no calculados)
El propósito de esta interfaz es crear valores de columnas del libro de calificaciones.
Nota
La fila de encabezado debe incluir todos los campos que se enumeran a continuación; sin embargo, solo se deben especificar los campos obligatorios en un registro.
Ejemplo de archivo plano
courseId|userId|name|value GETEST1|User001|GC Final Grade|90
Especificaciones de archivo
El nombre del archivo debe terminar en .colncval; Por ejemplo, período2023_01.colncval.
Encabezado de campo | Descripción | Obligatorio | Tipo y tamaño máximo |
|---|---|---|---|
courseId | UID de lote del curso donde se debe crear o actualizar esta columna de calificación. | Sí | Cadena (256 caracteres) |
ID de usuario | user_id del usuario para el que se debe crear o actualizar este valor de calificación | Sí | Cadena (333 caracteres) |
nombre | Nombre de la columna de calificación. Este campo se utiliza para la coincidencia. | Sí | Cadena (2000 caracteres) |
valor | Valor a asignar. | Sí | Cadena (2000 caracteres) |
Crear esquema de calificación
Los esquemas de calificación se pueden crear utilizando archivos planos con los servicios de Grades Journey. Otros archivos que crean actividades o columnas de calificaciones podrían depender de las definiciones de esquema de calificaciones en este archivo, pero el procesador de datos no aplica una secuencia de ejecución determinada. Por lo tanto, debe asegurarse de que los datos del esquema de calificaciones se procesen antes de ejecutar otros archivos de datos dependientes.
Nota
La fila de encabezado debe incluir todos los campos que se enumeran a continuación; sin embargo, solo se deben especificar los campos obligatorios en un registro.
Ejemplo de archivo plano
title|symbols|optionalData Schema1|A=90:B=80:C=70:D=60:F=0|
Especificaciones de archivo
El nombre del archivo debe terminar en .sch; Por ejemplo, período2023_01.sch.
Encabezado de campo | Descripción | Obligatorio | Tipo y tamaño máximo |
|---|---|---|---|
título | Título del esquema de explanación | Sí | Cadena (333 caracteres) |
Símbolos | Símbolos en una lista con límite 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 igual. Por ejemplo: clave1=valor1:clave2=valor2 Se usa más comúnmente para rastrear valores únicos en el momento de la extracción para hacer coincidir los registros con los sistemas de origen. | No | Cadena (2000 caracteres por par clave/valor) |