Especificações de arquivo simples de entrada
Elaborar exercícios
Os exercícios podem ser criados usando arquivos simples com o recurso Exportação de notas. Um exemplo do arquivo simples é fornecido abaixo, juntamente com as especificações e descrições.
Nota
A linha de cabeçalho deve incluir todos os campos relacionados abaixo; no entanto, somente os campos obrigatórios 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 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
Especificações do arquivo
O nome do arquivo deve terminar em .asg; por exemplo, term2023_01.asg.
Cabeçalho do 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 este exercício deve ser elaborado 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. S/N | Não | Booleano (Padrão N) |
grupo | Indica se o exercício é um exercício em grupo S/N | Não | Booleano (Padrão N) |
contentAreaName | O nome da área de conteúdo do menu do curso na qual o exercício será criado. | Não | String (255 caracteres) "Exercícios" padrão |
disponível | Disponibilidade de exercícios. S/N | Não | Booleano (Padrão N) |
cor | Nome da cor ou valor da cadeia de caracteres 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 ilimitado. | Não | Inteiro (Padrão -1) |
Controladas | Habilite o rastreamento para o item de exercício. | Não | Booleano (Padrão N) |
data inicial | Exibir a partir da data do exercício. | Não | Data formatada conforme especificado na tela Configurações de entrada. Nenhum valor especificado como padrão. |
Data de término | Exibir até a data do exercício. | Não | Data formatada conforme especificado na tela Configurações de entrada. Nenhum valor especificado como padrão. |
data de vencimento | Data de entrega para o exercício. | Não | Data formatada conforme especificado na tela Configurações de entrada. Nenhum valor especificado como padrão. |
Pontos | Pontos possíveis para o exercício. | Não | Flutuante (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 nota no curso de destino para que a configuração seja aplicada. | Não | String (333 caracteres) O comportamento padrão é pontuação. |
optionalData | Pares de chave/valor com cada conjunto de pares separados por dois-pontos e chaves/valores separados por um sinal de igual. Por exemplo: key1=value1:key2=value2 Mais comumente usado para rastrear valores exclusivos na extração para correspondência de registros com sistemas de origem. | Não | Cadeia de caracteres (2000 caracteres por par chave/valor) |
Criar colunas do Centro de Notas (calculadas)
As colunas ponderadas calculadas do Centro de Nota podem ser criadas usando arquivos simples com o recurso Exportação de nota. Colunas e pesos precisarão ser adicionados manualmente no Centro de Nota à coluna ponderada calculada criada.
Nota
A linha de cabeçalho deve incluir todos os campos relacionados abaixo; no entanto, somente os campos obrigatórios devem ser especificados em um registro.
Exemplo de arquivo simples
courseId|name|description|duedate|points|gradeSchema|optionalData GETEST1|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 do 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 correspondência. | Sim | String (333 caracteres) |
descrição | Descrição da coluna de notas. | Não | String (2000 caracteres) |
data de vencimento | Data de entrega para a coluna de notas. | Não | Data formatada conforme especificado na tela Configurações de entrada. Nenhum valor especificado como padrão. |
Pontos | Pontos possíveis para a coluna de notas. | Não | Flutuante (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 nota no curso de destino para que a configuração seja aplicada. | Não | String (333 caracteres) O comportamento padrão é pontuação. |
optionalData | Pares de chave/valor com cada conjunto de pares separados por dois-pontos e chaves/valores separados por um sinal de igual. Por exemplo: key1=value1:key2=value2 Mais comumente usado para rastrear valores exclusivos na extração para correspondência de registros com sistemas de origem. | Não | Cadeia de caracteres (2000 caracteres por par chave/valor) |
Criar colunas do Centro de Notas (não calculadas)
O objetivo dessa interface é criar ou atualizar colunas do boletim de notas.
Nota
A linha de cabeçalho deve incluir todos os campos relacionados abaixo; no entanto, somente os campos obrigatórios devem ser especificados em um registro.
Exemplo de arquivo simples
courseId|name|description|duedate|points|gradeSchema|optionalData GETEST1|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, term2023_01.colnc.
Cabeçalho do 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 esta coluna de notas deve ser criada ou atualizada | Sim | String (256 caracteres) |
nome | Nome da coluna de notas. Este campo é usado para correspondência. | Sim | String (333 caracteres) |
descrição | Descrição da coluna de notas. | Não | String (2000 caracteres) |
data de vencimento | Data de entrega para a coluna de notas. | Não | Data formatada conforme especificado na tela Configurações de entrada. Nenhum valor especificado como padrão. |
Pontos | Pontos possíveis para a coluna de notas. | Não | Flutuante (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 nota no curso de destino para que a configuração seja aplicada. | Não | String (333 caracteres) O comportamento padrão é pontuação. |
optionalData | Pares de chave/valor com cada conjunto de pares separados por dois-pontos e chaves/valores separados por um sinal de igual. Por exemplo: key1=value1:key2=value2 Mais comumente usado para rastrear valores exclusivos na extração para correspondência de registros com sistemas de origem. | Não | Cadeia de caracteres (2000 caracteres por par chave/valor) |
Definir colunas de notas externas (somente no curso original)
O objetivo dessa interface é definir uma coluna como a coluna Nota 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 relacionados abaixo; no entanto, somente os campos obrigatórios devem ser especificados em um registro.
Exemplo de arquivo simples
courseId|name GETEST1|GC Final Grade
Especificações do arquivo
O nome do arquivo deve terminar em .colext; por exemplo, term2017_01.colext.
Cabeçalho do 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 correspondência. | Sim. | String (333 caracteres) |
Criar valores de coluna de notas (não calculados)
O objetivo dessa interface é criar valores de colunas do boletim de notas.
Nota
A linha de cabeçalho deve incluir todos os campos relacionados abaixo; no entanto, somente os campos obrigatórios devem ser especificados em um registro.
Exemplo de arquivo simples
courseId|userId|name|value GETEST1|User001|GC Final Grade|90
Especificações do arquivo
O nome do arquivo deve terminar em .colncval; por exemplo, term2023_01.colncval.
Cabeçalho do 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) |
ID do usuário | user_id do usuário para o qual esse valor de nota deve ser criado ou atualizado | Sim | String (333 caracteres) |
nome | Nome da coluna de notas. Este campo é usado para correspondência. | Sim | String (2000 caracteres) |
valor | Valor a ser atribuído. | Sim | String (2000 caracteres) |
Criar esquema de notas
Os esquemas de notas podem ser criados usando arquivos simples com os serviços da Jornada de Notas. Outros arquivos que criam exercícios ou colunas de notas podem depender de definições de 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 nota sejam processados antes de executar outros arquivos de dados dependentes.
Nota
A linha de cabeçalho deve incluir todos os campos relacionados abaixo; no entanto, somente os campos obrigatórios 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, term2023_01.sch.
Cabeçalho do 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 de chave/valor com cada conjunto de pares separados por dois-pontos e chaves/valores separados por um sinal de igual. Por exemplo: key1=value1:key2=value2 Mais comumente usado para rastrear valores exclusivos na extração para correspondência de registros com sistemas de origem. | Não | Cadeia de caracteres (2000 caracteres por par chave/valor) |