Métodos de definição de campo
Updated on
Note
Esta documentação foi traduzida utilizando tradução automática assistida por IA. As traduções são fornecidas “no estado em que se encontram”, sem qualquer garantia quanto à sua precisão. A versão em inglês deste conteúdo é a fonte oficial e de referência.
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 | Este valor conterá os pontos obtidos divididos pelos pontos possíveis apenas se for possível calculá-lo. Se o valor não puder ser calculado, será ERROR. |
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. |