Especificações do arquivo simples Recebendo
Crie exercícios
Os exercícios podem ser criadas usando arquivos planos com o recurso de Exportação de Notas. Um exemplo do arquivo simples é fornecido abaixo, junto com as especificações e descrições.
Nota
A linha de cabeçalho deve incluir todos os campos listados abaixo; no entanto, apenas os campos exigidos devem ser especificados em um registro.
Exemplo de arquivo simples
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
Especificações do Arquivo
O nome do arquivo deve terminar em .asg; Por exemplo, período2023_01.asg.
Cabeçalho de campo | Descrição | Obrigatório | Tipo e tamanho máximo |
|---|---|---|---|
código do curso | Uid em lote do curso onde esse exercício deve ser criado ou atualizado. | Sim | String (256 caracteres) |
nome | Nome do exercício. | Sim | String (333 caracteres) |
instruções | Instruções para o exercício. | Não | String (2000 caracteres) |
anônimo | Indica se o exercício é anônimo. Y/N | Não | Booleano (N padrão) |
grupo | Indica se o exercício é um exercício em grupo Y/N | Não | Booleano (N padrão) |
contentAreaName | O nome da área de conteúdo do menu do curso onde o exercício será criado. Para cursos Ultra, esse título pode ser usado para provisionar uma subpasta e colocar conteúdo nela. O valor tem o formato "parent@>@child", onde "pai" é o nome da pasta de nível superior (pai) e "filho" é o nome da subpasta. Se a subpasta já existir, o exercício será adicionado à subpasta existente. Se a subpasta não existir, ela será criada na pasta pai. | Não | String (255 caracteres) "Exercícios" padrão |
disponível | Disponibilidade de exercícios. Y/N | Não | Booleano (N padrão) |
cor | Nome da cor ou valor da string hexadecimal da cor do item de exercício. | Não | String (10 caracteres) |
tentativas | Número de tentativas concedidas para o exercício. Use -1 para o ilimitado. | Não | Integer (padrão -1) |
monitoradas | Habilite o monitoramento do item do exercício. | Não | Booleano (N padrão) |
data de início | Exiba a data do exercício. | Não | Data formatada conforme especificado na tela de Configurações de Entrada. Nenhum valor especificado como padrão. |
fim Data | Exiba até a data do exercício. | Não | Data formatada conforme especificado na tela de Configurações de Entrada. Nenhum valor especificado como padrão. |
data de entrega | Data de entrega para o exercício. | Não | Data formatada conforme especificado na tela de Configurações de Entrada. Nenhum valor especificado como padrão. |
pontos | Pontos possíveis para o exercício. | Não | Float (Padrão 100.0) |
gradeSchema | Esquema de notas aplicado ao exercício para exibição do Centro de Notas. A string fornecida deve corresponder ao nome de um Esquema de Notas no curso alvo para que a configuração a ser aplicada. | Não | String (333 caracteres) Comportamento padrão é pontuação. |
optionalData | Pares chave/valor com cada conjunto de pares separados por dois pontos e chave/valores separados por um sinal de igual. Por exemplo: chave1=valor1:chave2=valor2 Mais comumente usado para monitorar valores únicos na extração para combinar registros com sistemas de origem. | Não | String (2000 caracteres por par chave/valor) |
Criar colunas de Centro de Notas (calculado)
Colunas ponderadas calculadas pelo Centro de Notas podem ser criadas usando arquivos planos com o recurso de Exportação de Notas. Colunas e pesos precisarão ser adicionados manualmente no Centro de Inclinação à coluna ponderada calculada criada.
Nota
A linha de cabeçalho deve incluir todos os campos listados abaixo; no entanto, apenas os campos exigidos devem ser especificados em um registro.
Exemplo de arquivo simples
courseId|name|description|duedate|points|gradeSchema|optionalData
GJTEST1|GC Calculated Grade||2023-10-30|10.0|Schema1|MOD_CODE=2023MOD1:SESSION=8W1
Especificações do arquivo
O nome do arquivo deve terminar em .col; Por exemplo, term2023_01.col.
Cabeçalho de campo | Descrição | Obrigatório | Tipo e tamanho máximo |
|---|---|---|---|
código do curso | Código de identificação do lote do curso em que essa coluna de notas deve ser criada ou atualizada. | Sim | String (256 caracteres) |
nome | Nome da coluna de notas. Este campo é usado para combinação. | Sim | String (333 caracteres) |
descrição | Descrição da coluna de notas. | Não | String (2000 caracteres) |
data de entrega | Data de entrega para a coluna de notas. | Não | Data formatada conforme especificado na tela de Configurações de Entrada. Nenhum valor especificado como padrão. |
pontos | Pontos possíveis para a coluna de notas. | Não | Float (Padrão 100.0) |
gradeSchema | Esquema de notas aplicado à coluna de notas para exibição. A string fornecida deve corresponder ao nome de um Esquema de Notas no curso alvo para que a configuração a ser aplicada. | Não | String (333 caracteres) Comportamento padrão é pontuação. |
optionalData | Pares chave/valor com cada conjunto de pares separados por dois pontos e chave/valores separados por um sinal de igual. Por exemplo: chave1=valor1:chave2=valor2 Mais comumente usado para monitorar valores únicos na extração para combinar registros com sistemas de origem. | Não | String (2000 caracteres por par chave/valor) |
Criar colunas de Centro de Nota (não calculado)
O objetivo desta interface é criar ou atualizar colunas do Boletim de Notas.
Nota
A linha de cabeçalho deve incluir todos os campos listados abaixo; no entanto, apenas os campos exigidos devem ser especificados em um registro.
Exemplo de arquivo simples
courseId|name|description|duedate|points|gradeSchema|optionalData
GJTEST1|GC Final Grade||2023-12-30|100|Schema1|MOD_CODE=2023MOD1:SESSION=8W1
Especificações do arquivo
O nome do arquivo deve terminar em .colnc; por exemplo, período2023_01.colnc.
Cabeçalho de campo | Descrição | Obrigatório | Tipo e tamanho máximo |
|---|---|---|---|
código do curso | Código de identificação do lote do curso onde essa coluna de notas deve ser criada ou atualizada | Sim | String (256 caracteres) |
nome | Nome da coluna de notas. Este campo é usado para combinação. | Sim | String (333 caracteres) |
descrição | Descrição da coluna de notas. | Não | String (2000 caracteres) |
data de entrega | Data de entrega para a coluna de notas. | Não | Data formatada conforme especificado na tela de Configurações de Entrada. Nenhum valor especificado como padrão. |
pontos | Pontos possíveis para a coluna de notas. | Não | Float (Padrão 100.0) |
gradeSchema | Esquema de notas aplicado à coluna de notas para exibição. A string fornecida deve corresponder ao nome de um Esquema de Notas no curso alvo para que a configuração a ser aplicada. | Não | String (333 caracteres) Comportamento padrão é pontuação. |
optionalData | Pares chave/valor com cada conjunto de pares separados por dois pontos e chave/valores separados por um sinal de igual. Por exemplo: chave1=valor1:chave2=valor2 Mais comumente usado para monitorar valores únicos na extração para combinar registros com sistemas de origem. | Não | String (2000 caracteres por par chave/valor) |
Defina colunas externas de notas (apenas Curso Original)
O objetivo dessa interface é definir uma coluna como a coluna de notas externa. Para marcar uma coluna como externa, uma coluna de notas deve ser provisionada ou criada.
Nota
A linha de cabeçalho deve incluir todos os campos listados abaixo; no entanto, apenas os campos exigidos devem ser especificados em um registro.
Exemplo de arquivo simples
courseId|name
GJTEST1|GC Final Grade
Especificações do arquivo
O nome do arquivo deve terminar em .colext; por exemplo, período2017_01.colext.
Cabeçalho de campo | Descrição | Obrigatório | Tipo e tamanho máximo |
|---|---|---|---|
código do curso | Código de identificação do lote do curso em que essa coluna de notas deve ser criada ou atualizada. | Sim | String (256 caracteres) |
nome | Nome da coluna de notas. Este campo é usado para combinação. | Sim. | String (333 caracteres) |
Criar valores de coluna de notas (não calculados)
O objetivo dessa interface é criar os valores das colunas do Boletim de Notas.
Nota
A linha de cabeçalho deve incluir todos os campos listados abaixo; no entanto, apenas os campos exigidos devem ser especificados em um registro.
Exemplo de arquivo simples
courseId|userId|name|value
GJTEST1|User001|GC Final Grade|90
Especificações do arquivo
O nome do arquivo deve terminar em .colncval; Por exemplo, período2023_01.colncval.
Cabeçalho de campo | Descrição | Obrigatório | Tipo e tamanho máximo |
|---|---|---|---|
código do curso | Código de identificação do lote do curso em que essa coluna de notas deve ser criada ou atualizada. | Sim | String (256 caracteres) |
userId | user_id do usuário para quem esse valor de nota deve ser criado ou atualizado | Sim | String (333 caracteres) |
nome | Nome da coluna de notas. Este campo é usado para combinação. | Sim | String (2000 caracteres) |
valor | Valor a ser atribuído. | Sim | String (2000 caracteres) |
Criar esquema de classificação
Esquemas de notas podem ser criados usando arquivos planos com os serviços Jornada de Notas. Outros arquivos que criam atribuições ou colunas de notas podem depender das definições do esquema de notas nesse arquivo, mas o processador de dados não impõe uma sequência de execução específica. Portanto, você deve garantir que os dados do esquema de notas sejam processados antes de executar outros arquivos de dados dependentes.
Nota
A linha de cabeçalho deve incluir todos os campos listados abaixo; no entanto, apenas os campos exigidos devem ser especificados em um registro.
Exemplo de arquivo simples
title|symbols|optionalData
Schema1|A=90:B=80:C=70:D=60:F=0|
Especificações do arquivo
O nome do arquivo deve terminar em .sch; por exemplo, período2023_01.sch.
Cabeçalho de campo | Descrição | Obrigatório | Tipo e tamanho máximo |
|---|---|---|---|
título | Título do esquema de avaliação | Sim | String (333 caracteres) |
símbolos | Símbolos em uma lista com limite inferior (opcional), separados por dois-pontos. | Sim | String (2000 caracteres) |
optionalData | Pares chave/valor com cada conjunto de pares separados por dois pontos e chave/valores separados por um sinal de igual. Por exemplo: chave1=valor1:chave2=valor2 Mais comumente usado para monitorar valores únicos na extração para combinar registros com sistemas de origem. | Não | String (2000 caracteres por par chave/valor) |