Métodos de definição de campo
Esta página descreve as definições de campo comuns que estão disponíveis para inclusão na carga de extração de notas. A definição de campo real que deve ser colocada no campo Valor dos dados pode ser encontrada na parte inferior de cada célula de "descrição".
Campos do curso
Campo | Descrição |
|---|---|
Chave principal | O identificador interno da Blackboard para o curso. Esse valor é um número inteiro de incremento automático gerado pelo esquema da Blackboard quando um curso é criado e geralmente não tem sentido fora da Blackboard.
|
Chave de curso externo | Um identificador exclusivo que não é voltado para o usuário, geralmente preenchido por meio do Snapshot ou integração semelhante. Se um curso for criado por meio da GUI, a "Chave de curso externa" corresponderá ao "Código do curso". Este campo também é conhecido como código de identificação do lote.
|
Classificação | O título da classificação deste curso.
|
Código do curso | O identificador exclusivo e voltado ao usuário para o curso.
|
Disponibilidade | "Y" se o registro do curso estiver disponível, "N" se estiver indisponível.
|
Tipo | "FULL" para cursos normais, "COMMUNITY" para organizações. Outros valores podem existir para cursos internos, como "SISTEMA"; no entanto, as notas desses cursos não existiriam.
|
Criar data | A data que o curso foi criado.
|
Data modificada | A data da última modificação do curso. Observe que isso se refere apenas à modificação do próprio registro do curso e NÃO a qualquer conteúdo, exercícios etc.
|
Título | O título voltado ao usuário ou o "nome do curso" do curso.
|
Códigos da categoria | Lista delimitada com todos os códigos das categorias do curso (se houver) para o curso. O subdelimitador é configurado nas propriedades da extração. Exemplo (assumindo subdelimitador de pipe): MATEMÁTICA |ÁLGEBRA
|
Nomes das categorias | Lista delimitada com todos os nomes de categoria do curso (se houver) para o curso. O subdelimitador é configurado nas propriedades da extração. Exemplo (assumindo subdelimitador de pipe): MATEMÁTICA |ÁLGEBRA
|
Campos do usuário
Campo | Descrição |
|---|---|
Chave principal | O identificador interno do Blackboard para o usuário. Esse valor é um número inteiro de incremento automático gerado pelo esquema do Blackboard quando um usuário é criado e geralmente não tem significado fora do Blackboard.
|
Chave pessoal externa | Um identificador exclusivo que não é voltado para o usuário, geralmente preenchido por meio do Snapshot ou integração semelhante. Se um usuário for criado por meio da GUI, a "Chave de Pessoa Externa" corresponderá ao "Código do Usuário". Este campo também é conhecido como código de identificação do lote.
|
Telefone comercial 1 | Telefone comercial primário para o usuário.
|
Telefone comercial 2 | Telefone comercial secundário para o usuário.
|
Empresa | Empresa do usuário.
|
País | País do endereço do usuário.
|
Departamento | Departamento do usuário.
|
Endereço de e-mail do usuário.
| |
Sobrenome | Sobrenome ou nome de "família" do usuário.
|
Primeiro nome | Nome ou primeiro nome do usuário.
|
Telefone residencial 1 | Telefone residencial primário do usuário.
|
Telefone residencial 2 | Telefone residencial secundário do usuário.
|
Disponibilidade | "S" se o registro do usuário estiver disponível, "N" se estiver indisponível.
|
Cargo | Cargo do usuário.
|
Data do último acesso | Data do último acesso bem-sucedido do usuário no sistema. Se o usuário nunca tiver feito acesso, esse valor estará vazio.
|
Nome do meio | Nome do meio do usuário.
|
Celular | Número de telefone celular do usuário.
|
ID do aluno | Atributo de código do aluno do registro do usuário. Não que esse valor NÃO seja garantido como exclusivo no sistema. Apenas o nome de usuário e a chave de pessoa externa são campos exclusivos garantidos.
|
Título | Título do usuário. Ex: Sr. Sra. Dr.
|
Código do usuário | O identificador exclusivo e voltado ao usuário do usuário. Também conhecido como nome de usuário.
|
Códigos das funções da instituição | Lista delimitada por dois pontos de todos os códigos de função da instituição para o usuário. A ID da função primária será a primeira, seguida por todas as IDs da função secundária (se houver) para esse usuário. Staff:Observer:Role_13
|
Nomes de funções na instituição | Lista delimitada por dois pontos com todos os nomes de funções na instituição para o usuário. O nome da função primária será o primeiro, seguido por todos os nomes de função secundária (se houver) para esse usuário. Equipe:Observador:Função 13
|
Código de função primária da instituição | O código da função primária da instituição para o usuário.
|
Nome da função primária da instituição | O nome da função primária da instituição para o usuário.
|
Códigos de função secundária da instituição | Lista delimitada por dois pontos com todos os códigos de função secundária (se houver) para o usuário. Observer:Role_13
|
Nomes de função secundária da instituição | Lista delimitada por dois pontos com todos os nomes de funções secundárias (se houver) para o usuário. Observador:Função 13
|
Códigos de função do sistema | Lista delimitada por dois pontos com todos os códigos de função do sistema para o usuário no domínio PADRÃO. A ID da função do sistema primário será a primeira, seguida por todas as IDs da função do sistema secundário (se houver) para esse usuário. N:U:C
|
Nomes de função do sistema | Lista delimitada por dois pontos com todos os nomes de função do sistema para o usuário no domínio PADRÃO. O nome da função do sistema primário será o primeiro, seguido por todos os nomes de função do sistema secundário (se houver) para esse usuário. Nenhum:UsuárioAdministrador:Administrador do curso
|
Código da função primária do sistema | Código da função primária do sistema para o usuário.
|
Nome da função primária do sistema | Nome da função primária do sistema para o usuário.
|
Códigos de função secundária do sistema | Lista delimitada por dois pontos de todos os códigos de funções secundárias do sistema (se houver) para o usuário no domínio PADRÃO. U:C
|
Nomes de funções secundárias do sistema | Lista delimitada por dois pontos com todos os nomes de funções secundárias do sistema (se houver) para o usuário no domínio PADRÃO. Administrador de usuários:Administrador do curso
|
Campos de nota
Os campos nesta seção são usados para acessar informações relacionadas à nota de um aluno em um determinado item (ou coluna) do Centro de notas do Blackboard Learn.
Campo | Descrição |
|---|---|
Chave principal | O identificador interno Blackboard para a nota. Esse valor é um número inteiro de incremento automático gerado pelo esquema do Blackboard quando um usuário é criado e geralmente não tem significado fora do Blackboard.
|
Nota da tentativa | A nota visual da última tentativa em relação ao item avaliável da matrícula. Se a nota não for um exercício ou avaliação, haverá apenas uma tentativa.
|
Resultado da tentativa | Os pontos decimais da última tentativa em relação ao item avaliável da matrícula.
|
Data da tentativa | A data em que a tentativa foi criada. Para avaliações e exercícios, esta é a data em que o item foi criado pelo aluno. Para notas inseridas manualmente (ou seja, inseridas diretamente na planilha do Centro de Notas), esta é a data em que o instrutor forneceu a nota. Observe que isso NÃO deve ser confundido com a data de substituição inserida pelo instrutor, que é um campo diferente.
|
Status da tentativa | A representação numérica do status da tentativa:
|
Nota manual | O valor de exibição de uma nota substituída manualmente para o aluno. Se a nota não tiver sido substituída manualmente, esse valor estará vazio.
|
Pontuação manual | Os pontos decimais de uma nota substituída manualmente para o aluno. Se a nota não tiver sido substituída manualmente, esse valor estará vazio.
|
Exibir nota | O valor da nota como ela é exibida no Centro de notas. Esse valor é responsável por várias tentativas e notas substituídas manualmente. Na maioria dos casos, esse é o valor que você deseja incluir na extração.
|
Exibir pontuação | O valor de casas decimais da nota no Centro de notas. Esse valor é responsável por várias tentativas e notas substituídas manualmente. Na maioria dos casos, esse é o valor que você deseja incluir na extração.
|
Indicador isento | “Y” se a nota foi dispensada pelo instrutor, “N” caso contrário.
|
Indicador de nota nulo | "Y" se a nota não existir, "N" caso contrário.
|
Indicador de nota manual/substituída | "Y" se a nota tiver sido substituída manualmente pelo instrutor, "N" caso contrário.
|
Substituir a data | A data em que a nota foi substituída pelo instrutor. Observe que isso NÃO é o mesmo que apenas uma nota atribuída manualmente por meio da planilha do Centro de Notas, mas a data em que uma nota de substituição real foi especificada (adicionada ou atualizada).
|
Campos do item do Centro de notas
Os campos nesta seção se aplicam aos itens (ou colunas) do Centro de notas.
Campo | Descrição |
|---|---|
Chave principal | O identificador interno do Blackboard para o item avaliável. Esse valor é um número inteiro de incremento automático gerado pelo esquema do Blackboard quando um usuário é criado e geralmente não tem significado fora do Blackboard.
|
Indicador de nota externa | "Y" se o item for a nota externa para o curso. "N" caso contrário. Observe que só pode haver um item marcado como nota externa por curso.
|
Exibir descrição | A descrição voltada ao usuário do item avaliável.
|
Nome da coluna de exibição | O nome da coluna de exibição é um valor obrigatório no centro de notas da Blackboard e será o valor exibido aos usuários finais, A MENOS que um título de exibição tenha sido fornecido.
|
Pontos Possíveis | Número decimal que representa o número de pontos possíveis para o item avaliável.
|
Exibir título | O título de exibição não é obrigatório; no entanto, se for fornecido para um item no centro de notas, ele será exibido aos usuários finais no lugar do "nome da coluna de exibição".
|
Campos de associação
Campo | Descrição |
|---|---|
Chave principal | O identificador interno da Blackboard para a matrícula. Esse valor é um número inteiro de incremento automático gerado pelo esquema do Blackboard quando um usuário é criado e geralmente não tem significado fora do Blackboard.
|
Disponibilidade | "Y" se o registro de matrícula estiver disponível, "N" se estiver indisponível.
|
Data da matrícula | A data em que o usuário foi matriculado no curso. Observe que esse valor pode ser nulo se a data de matrícula não tiver sido fornecida explicitamente com a integração.
|
Data modificada | A data em que o registro de matrícula foi modificado pela última vez.
|
Data do último acesso | A data em que o usuário acessou o curso pela última vez. Esse valor será nulo se o usuário não tiver acessado o curso.
|
Campo de dados estáticos
Campo | Descrição |
|---|---|
Valor estático | Permite a inclusão de conteúdo estático no mapeamento de colunas, em que XXX é o valor do conteúdo estático a ser incluído. Esse campo permite que caracteres especiais sejam incluídos como parte do valor estático. Os caracteres especiais precisam ser configurados conforme o próprio valor codificado. Por exemplo: PROCESSSTATUS=::static::I%7C escreverá o valor "I|" no arquivo de extração com o cabeçalho da coluna PROCESSSTATUS.
|
Valores derivados especiais
Os campos nesta seção são campos especiais cujos valores derivam de outros campos.
Campo | Descrição |
|---|---|
Grade.PERCENTAGE_SCORE | Esse valor conterá os pontos divididos pelos pontos possíveis apenas se puder ser calculado. Caso contrário, ficará em branco. |
Grade.LETTER_GRADE | Este valor será o valor do esquema somente se uma letra estiver presente. Caso contrário, ficará em branco. |
Item.EXTERNAL_SEQNUM | Este valor será o valor especificado no mapeamento de sequência externa. |
User.OPTIONAL_DATA:XXX | Este valor será o valor dos dados opcionais de matrícula do usuário, conforme especificado em XXX. Ex: Se o provisionamento de entrada estiver passando um campo de dados opcional série com os dados de matrícula do usuário, a implementação a ser incluída na extração seria: User.OPTIONAL_DATA: COHORT |
Grade.OPTIONAL_DATA:XXX | Este valor será o valor dos dados opcionais da nota, conforme especificado em XXX. Ex: Se o provisionamento de entrada estiver passando um campo de dados opcional PartTerm com o item avaliável, a implementação a ser incluída na extração será: Grade.OPTIONAL_DATA:PartTerm |
Grade.getCategoryName | Este valor será o nome da categoria da nota (isto é, Exercício). |
User.EXTRACTOR_BATCH_UID | Este valor será o batch_uid do usuário que aprovou a extração. |
User.EXTRACTOR_USER_ID | Este valor será o código de usuário do usuário que aprovou a extração. |
User.EXTRACTOR_FULLNAME | Este valor será o nome completo do usuário que aprovou a extração. |
User.EXTRACTOR_EMAIL | Este valor será o e-mail do usuário que aprovou a extração. |
User.GRADER_FULLNAME | Este valor será o nome completo do último Grader do item avaliável. |
User.GRADER_EMAIL | Esse valor será o e-mail do último avaliador do item avaliável. |
Course.TERM_CODE | Este valor será o Nome do período a que a seção do curso está associada. |
X::regEx:Y | O valor será o resultado da expressão regular especificada por S para o campo X. Ex: Course.getBatchUid::regEx:^.*?_(.*?) onde o lote_uid do curso é 202210_12345 retornaria 12345 |
Grade.getPostedDate | Este valor será a data publicada (para cursos do Ultra). |
Term.getSourceId | Este valor será o código de origem do período a que o curso está associado. |