Skip to main content

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)