Skip to main content

Configuration du flux de travail d'approbation

Le flux de travail d'approbation, s'il est activé, est configuré pour s'exécuter selon un calendrier spécifique et extrait automatiquement les notes qui ont été approuvées. Pour accéder aux paramètres d'extrait de notes pour le flux de travail d'approbation :

  1. Accédez au Panneau de configuration de l'administrateur.

  2. Sélectionnez Extensions de plateforme dans Gestion du cloud.

  3. Choisissez Modifier les paramètres dans le menu Exportation de notes v2.

  4. Choisissez la loupe dans la colonne Configurer de la ligne FLUX_DE_TRAVAIL_D'APPROBATION.

Cela vous donnera accès à l'onglet Paramètres d'extraction de notes. Cet onglet comporte sept sections extensibles.

Réglages généraux

  1. Choisissez le Type d'intégration.

    • Intégration NORMALE : format de fichier délimité

    • Intégration REST : format JSON spécifique à Grades Journey

    • Intégration de Legacy Banner : format d'API REST Legacy Banner

  2. Le calendrier CRON détermine la fréquence à laquelle le fichier de notes approuvé est extrait. Activez le bouton Activé ? basculez si vous souhaitez que le processus s'exécute selon le calendrier CRON indiqué, puis entrez l'expression CRON pour spécifier la fréquence de l'extraction.

  3. Dans le Champ décimales, entrez le nombre de chiffres qui seront affichés après la décimale pour les valeurs de score. La valeur est tronquée et non arrondie et la valeur par défaut est de cinq.

  4. Entrez la valeur nulle à renvoyer pour les éléments non notés et non marqués ou les champs dont aucune valeur n'est stockée dans le champ Extraire la valeur des évaluations non notées (par exemple, « 0 » ou « NoValue »).

  5. Spécifiez une liste de notes séparées par des virgules qui seront considérées comme des valeurs de note valides dans le champ Notes valides. Il doit s'agir de notes alphabétiques et non de chiffres. Si une valeur de note n'est pas valide, elle n'est pas incluse dans l'extrait et déclenche une notification par e-mail. Les enregistrements exclus de l'extrait parce qu'ils ne sont pas valides sont ajoutés à un fichier joint à la notification par e-mail.

    Note

    Si vous laissez cette case vide, toutes les notes sont considérées comme valides.

  6. Entrez un masque de format de date valide dans le champ Format pour la colonne de date. Ce format sera utilisé pour toutes les valeurs de date incluses dans l'extrait. Utilisez Java SimpleDateFormat.

Filtre de périodes de cours

  1. Activez le bouton Activé pour filtrer l'extrait par période.

  2. Sélectionnez AJOUTER ou SUPPRIMER pour ajouter ou supprimer des lignes.

  3. Dans la colonne PÉRIODE DE COURS, sélectionnez les périodes de cours selon lesquelles vous souhaitez filtrer l'extrait. Seuls les cours associés aux périodes de cours sélectionnées seront inclus dans l'extrait.

  4. Entrez une date d'entrée en vigueur et une date de fin dans les colonnes appropriées. Les données seront extraites des cours associés à la période de cours donnée si la date actuelle se situe entre la date d'entrée en vigueur et la date de fin. Les dates peuvent être laissées en blanc et la date de l'extrait ne sera pas limitée.

Filtre de colonne

Le filtre de colonnes est utilisé pour déterminer quelles colonnes de notes sont affichées aux évaluateurs pour approbation. Une seule option de filtre peut être active à la fois.

  • Filtre de colonne Remplissez cette case si vous souhaitez afficher uniquement des colonnes spécifiques aux évaluateurs lorsque le provisionnement est désactivé. Entrez les colonnes dans une liste de noms de colonnes séparés par des virgules. L'objectif de ce paramètre est de permettre à l'extrait de contenir uniquement les colonnes qui doivent être signalées.

  • Colonne de note externe (original) ou note globale (Ultra) uniquement Cochez cette case si vous souhaitez afficher uniquement la colonne de note externe (dans les cours d'origine) ou la note globale (dans les cours Ultra) pour les évaluateurs. Ce paramètre est prioritaire sur le paramètre Filtre de colonne et le paramètre Provisioning Enabled.

  • Provisionnement activé Cochez cette case si vous souhaitez afficher uniquement les colonnes de notes importées dans le cadre des éléments évaluables fournis par le système d'informations pour les étudiants aux évaluateurs. Ce paramètre est prioritaire sur le paramètre Filtre de colonne.

  • Validation des métadonnées de colonne Si vous choisissez Provisionnement activé, une boîte de dialogue Validation des métadonnées de colonne apparaît. Si vous le souhaitez, entrez un ensemble de paires clé/valeur et leur nombre d'occurrences attendu dans les métadonnées de la colonne de notes pour déterminer si le cours peut être extrait. Si ces paramètres ne sont pas respectés, le système renvoie une erreur et les données du cours ne sont pas extraites.

Cartographie des colonnes

Entrez une liste de paires nom/valeur séparées par un symbole circulaire pour identifier les champs de données de la colonne de notes à inclure pour chaque enregistrement du rapport. Si cette case est laissée vide, une liste de champs par défaut sera transmise dans l'extrait.

Voici un exemple de mappage :

external_course_key=Course.getBatchUid|External_person_key.=User.getBatchUid|student_id=User.getStudentId|column=Item.getDisplayColumnName|grade=Grade.getSchemaValue

Mappage de colonnes supplémentaire

Activez le bouton Activer pour chacun des champs de données supplémentaires suivants si vous souhaitez les inclure dans l'extrait :

  • Date de dernière participation Date à laquelle un devoir ou une tentative d'évaluation a été créé pour la dernière fois. La valeur de l'en-tête peut être modifiée en mettant à jour le champ EXTRACTION KEY. La valeur par défaut est last_attendance_date.

  • Feed-back du formateur Commentaire fourni par le professeur ou l'approbateur dans une colonne de notes calculées. La valeur de l'en-tête peut être modifiée en mettant à jour le champ EXTRACTION KEY. La valeur par défaut est instructor_comment.

Extraire les paramètres des rôles dans le cours

  1. Activez le bouton Activer le flux de travail des soumissionnaires pour ajouter une étape supplémentaire au flux de travail dans laquelle les notes sont soumises à un approbateur (par exemple, un assistant d'enseignement soumet les notes au professeur pour approbation).

  2. Pour Rôles requis pour approbation, spécifiez les rôles de cours qui seront requis pour qu'un utilisateur puisse lancer le processus d'approbation pour approuver les notes (par exemple, professeur). Si vous le souhaitez, spécifiez également tous les rôles d'établissement supplémentaires requis pour approuver les notes (par exemple, approbateur de notes). Un utilisateur possédant l'un de ces rôles pourra approuver les notes.

  3. Pour Rôles requis pour être soumis, spécifiez les rôles de cours qui seront requis pour qu'un utilisateur puisse lancer le processus d'approbation pour soumettre des notes (par exemple, assistant d'enseignement). Si vous le souhaitez, spécifiez également tout rôle d'établissement supplémentaire requis pour soumettre des notes (tel que Approbateur de notes). Un utilisateur possédant l'un de ces rôles pourra soumettre des notes.

    Note

    Ce paramètre ne s'affiche que si le workflow de l'expéditeur est activé.

  4. Le message d'accès refusé ne doit pas être renseigné ici ; le message d'accès refusé personnalisé est désormais saisi sur l'écran Configurer les rôles.

Paramètres de transfert des résultats

Option d'intégration NORMALE

Paramètres de transfert des résultats

  1. Dans le champ Filename Mask, définissez le modèle pour le nom de l'extrait de fichier. Lorsque le type de transfert est défini sur Fichier combiné, « combined_ » est ajouté au début du nom du fichier.

  2. Choisissez la Méthode de transfert. Le SFTP est la méthode de transfert la plus courante et ses paramètres sont décrits dans ces étapes.

  3. Choisissez le Type de transfert.

    • Chaque fichier entraîne le transfert individuel d'un seul fichier d'extrait par cours

    • Les résultats combinés du fichier dans un seul fichier seront tous approuvés pour tous les cours

      Note

      Un extrait manuel générera un fichier d'extrait spécifique au cours.

  4. Activez Utiliser Windows EOL si cela doit être traité dans un environnement Windows nécessitant Windows EOL.

  5. Entrez l'URL ou l'adresse IP du serveur SFTP dans le champ Serveur.

  6. Entrez le port du serveur SFTP (généralement 22) dans le champ Port.

  7. Entrez le nom d'utilisateur SFTP dans le champ Nom d'utilisateur.

  8. Entrez le mot de passe SFTP dans le champ Mot de passe.

  9. Entrez le chemin des fichiers d'extrait dans le champ Chemin.

Format de fichier d'extraction

  1. Entrez le Séparateur de champs à utiliser pour le fichier d'extrait. La valeur par défaut est un tube (|).

  2. Entrez le Qualificatif de champ. Il s'agit du caractère à utiliser si les données extraites contiennent le délimiteur. La valeur par défaut est un guillemet double («).

Option d'intégration REST

Paramètres de transfert des résultats

  1. Spécifiez le point final pour les notes à publier dans le champ Post Webservice Endpoint.

  2. Entrez le nombre maximum d'enregistrements à inclure dans une transaction dans le champ Nombre maximum d'enregistrements restants.

Options de sécurité restantes (sortantes)

Sélectionnez Oui pour Activer l'interface de programmation d'application REST sécurisée. Si cette option est activée, définissez également un mécanisme de sécurité.

OAuth 1.0

  • Secret partagé  : entrez le secret partagé OAuth

  • Clé API  : entrez la clé API OAuth

Sécurité MAC

En savoir plus sur la Sécurité MAC.

  • Secret partagé : entrez le secret partagé

  • Clé API : entrez la clé API

  • Paramètre d'horodatage : entrez le paramètre qui indiquera la valeur d'horodatage dans la chaîne de requête

  • Paramètre MAC : entrez le paramètre qui indiquera la valeur MAC dans la chaîne de requête

  • Paramètre de clé API : entrez le paramètre qui indiquera la valeur MAC dans la chaîne de requête

OAuth 2.0

Grades Journ enverra une demande au point de terminaison configuré avec l'URL du jeton REST. L'autorisation sera envoyée sous forme d'en-tête de demande. Le type de subvention sera client_credentials et sera envoyé dans le corps de la requête : grant_type : « client_credentials ».

Renseignez les champs suivants :

  • Clé REST  : entrez la clé qui sera utilisée pour accéder à l'interface de programmation d'application

  • Secret REST  : entrez le secret qui sera utilisé pour accéder à l'interface de programmation d'application

  • URL du jeton REST  : entrez l'URL qui sera utilisée pour demander un jeton d'accès

Paramètres d'approbation et de transfert des notes

Paramètres d'approbation et de transfert des notes

  1. Activez Approbation des notes requise pour activer l'approbation des notes au niveau de la colonne ou du grade. Si cette option n'est pas activée, les notes ne peuvent être approuvées qu'au niveau du cours.

  2. Sélectionnez Bouton Extraire les notes activé pour faire apparaître le bouton Extraire les notes pour les approbateurs. Les évaluateurs pourront exécuter l'extrait immédiatement. Pour une intégration NORMALE, l'extrait ne sera généré et envoyé que lorsque le type de transfert est défini sur Chaque fichier.

    Note

    Le bouton Extraire les notes apparaîtra toujours pour les utilisateurs administrateurs de l'approbateur de notes.

  3. Sélectionnez Le bouton Soumettre les notes est activé ? pour faire apparaître le bouton Soumettre les notes pour les soumissionnaires.

    Note

    Si le flux de travail de l'expéditeur n'est pas activé, cette case à cocher sera masquée.

    Le bouton Soumettre les notes apparaîtra toujours pour les utilisateurs administrateurs de l'approbateur de notes si le flux de travail de soumission est activé.

  4. Sélectionnez Autoriser uniquement les approbations pour les notes soumises pour empêcher que les notes dont le statut est différent de celui soumis soient approuvées ou non approuvées.

    Note

    Si le flux de travail de l'expéditeur n'est pas activé, cette case à cocher sera masquée.

  5. Select Only allow extract for approved grades? to prevent grades that are not in the Approved status from being extracted. If a grader tries to manually extract grades that are not in the Approved status, they will receive an error message.

  6. Sélectionnez Activer les feed-backs des professeurs si la colonne Feed-back des professeurs doit être accessible aux professeurs dans la zone d'approbation des notes pour les notes associées aux colonnes calculées et manuelles.

  7. Sélectionnez Autoriser la recherche de cours pour les approbateurs de notes ? si le lien Recherche avancée doit être visible pour les professeurs dans la zone d'approbation des notes afin qu'ils puissent rechercher un autre cours qui leur est assigné.

  8. Sélectionnez Le bouton Approuver les notes est activé ? pour faire apparaître le bouton Approuver les notes pour les approbateurs.

    Note

    Le bouton Approuver les notes apparaîtra toujours pour les utilisateurs administrateurs de l'approbateur de notes.

  9. Sélectionnez Autoriser les refus d'approbation uniquement avec un message de raison ? pour éviter que les notes ne soient rejetées dans l'outil d'approbation et de transfert des notes si aucune raison n'a été saisie.

    Note

    Si le flux de travail de l'expéditeur n'est pas activé, la case à cocher sera masquée.

  10. Sélectionnez Limiter l'accès aux cours pour enfants aux seuls soumissionnaires ou approbateurs pour empêcher les soumissionnaires ou les approbateurs de ne voir que les étudiants du niveau scolaire correspondant aux cours pour enfants auxquels ils sont affectés.

  11. Sélectionnez Restreindre les opérations au niveau de note pour empêcher toutes les actions d'approbation des notes au niveau du cours et de la colonne de notes. Les soumissionnaires et les approbateurs ne pourront prendre des mesures qu'au niveau de la note.

  12. Le paramètre Lancer directement au niveau scolaire concerne une fonctionnalité à venir du flux de travail d'approbation et ne doit pas être sélectionné.

  13. Sélectionnez Inclure les notes non publiées pour inclure les notes qui n'ont pas été publiées dans l'extrait des notes. Cela n'inclut pas les colonnes manuelles ni les colonnes dans lesquelles les notes ont été annulées mais n'ont pas encore été publiées.

  14. Select Validate Grades to prevent invalid grades from being submitted, approved, or extracted, based on the valid grades that are configured in the General Settings section. If a grader tries to submit, approve, or extract invalid grades, they will receive an error message.

Configuration de la valeur d'affichage des notes

Définissez la valeur de note à afficher dans le flux de travail d'approbation :

  • Lettre de note  : si la valeur du schéma est une lettre, il renvoie une note ; sinon, il renverra une chaîne vide

  • Valeur du schéma  : renvoie la colonne de notes Affichage principal

  • Score en pourcentage  : renvoie le score en pourcentage calculé

  • Valeur du schéma secondaire  : renvoie la colonne de notes Affichage secondaire (s'applique uniquement aux cours d'origine)

  • Valeur du score  : renvoie la valeur du score

Centre de notes en lecture seule (original)

Les options suivantes s'appliquent uniquement à l'expérience de cours d'origine. Les options disponibles pour l'expérience du cours Ultra sont abordées dans la section suivante.

Vous pouvez verrouiller le centre de notes des cours et rediriger les utilisateurs qui tentent d'accéder aux notes vers une page en lecture seule. Pour Verrouiller l'approbation, choisissez l'une des trois options suivantes :

  • Immédiatement après approbation  : verrouille le centre de notes immédiatement après l'approbation d'une note pour ce cours par l'approbateur

  • Après la date d'échéance de la colonne de notes  : verrouille le centre de notes une fois que la date d'échéance de la colonne de notes sélectionnée est atteinte

    Note

    Si cette option est sélectionnée, vous devez activer les fonctionnalités de lecture seule améliorées et saisir le nom de la colonne de notes dont la date d'échéance sera utilisée pour déterminer quand le centre de notes sera verrouillé dans la case Verrouiller le nom de la colonne de notes.

  • Désactivé  : ne verrouille pas le centre de notes.

Activez le bouton Fonctionnalités améliorées en lecture seule pour configurer des fonctionnalités de lecture seule supplémentaires pour les cours originaux.

  • Titre de la page  : entrez un titre de page pour la page en lecture seule

  • Verrouiller le nom de la colonne de notes : entrez le nom de la colonne de notes dont la date d'échéance sera utilisée pour déterminer quand le centre de notes sera verrouillé

  • Durée de verrouillage du parcours  : si vous le souhaitez, entrez l'heure d'exécution de la tâche de verrouillage. Si aucune heure n'est saisie, la tâche sera exécutée à minuit.

  • Durée de conservation des cours déverrouillés manuellement (heures)  : entrez éventuellement une valeur correspondant à la durée (en heures) pendant laquelle un cours déverrouillé manuellement doit rester déverrouillé avant d'être automatiquement verrouillé à nouveau

  • Temps nécessaire pour verrouiller automatiquement le centre de notes (heures) : entrez éventuellement une valeur pour la durée (en heures) pendant laquelle le centre de notes doit être verrouillé après l'événement d'approbation des notes

  • Verrouiller l'exception d'approbation (heures) : entrez éventuellement une valeur correspondant à la durée (en heures) pendant laquelle un rôle doté de privilèges d'approbateur peut encore accéder au centre de notes après l'événement de verrouillage

  • Verrouiller l'exception de non-approbation (heures) : entrez éventuellement une valeur correspondant à la durée (en heures) pendant laquelle un rôle doté des privilèges d'expéditeur peut encore accéder au centre de notes après le verrouillage, même s'il existe des notes non approuvées

  • Rôle de cours non affecté par le verrouillage : sélectionnez les rôles de cours qui ne seront pas redirigés vers la page d'affichage en lecture seule du centre de notes et qui pourront toujours accéder à la page complète de transfert et d'approbation des notes même si elle est verrouillée

    Note

    L'administrateur système est le seul rôle qui pourra toujours accéder à la page complète de transfert et d'approbation des notes.

Centre de notes en lecture seule (Ultra)

Les options suivantes s'appliquent uniquement à l'expérience de cours Ultra. Les options disponibles pour l'expérience de cours d'origine sont abordées dans la section précédente.

Vous pouvez verrouiller le centre de notes des cours et rediriger les utilisateurs qui tentent d'accéder aux notes vers une page en lecture seule. Pour Verrouiller l'approbation, vous disposez des options suivantes :

  • Immédiatement après approbation  : cette option ne s'applique pas à la vue en lecture seule

  • Après la date d'échéance de la colonne de notes  : verrouille le centre de notes une fois que la date d'échéance de la colonne de notes sélectionnée est atteinte

    Note

    Si cette option est sélectionnée, vous devez activer les fonctionnalités de lecture seule améliorées et saisir le nom de la colonne de notes dont la date d'échéance sera utilisée pour déterminer quand le centre de notes sera verrouillé dans la zone Verrouiller le nom de la colonne de notes.

    Note

    Vous pouvez déverrouiller temporairement le cours si nécessaire une fois la tâche de verrouillage terminée.

  • Désactivé  : ne verrouille pas le centre de notes.

Activez la bascule Fonctionnalités améliorées en lecture seule pour configurer le nom de la colonne de notes de verrouillage et l'heure de verrouillage du cours pour les cours Ultra.

  • Verrouiller le nom de la colonne de notes : entrez le nom de la colonne de notes dont la date d'échéance sera utilisée pour déterminer quand le centre de notes sera verrouillé

  • Durée de verrouillage du parcours  : si vous le souhaitez, entrez l'heure d'exécution de la tâche de verrouillage. Si aucune heure n'est saisie, la tâche sera exécutée à minuit.

Note

Aucune des autres fonctionnalités améliorées en lecture seule ne s'appliquera aux cours Ultra.

Sélectionnez un ou plusieurs emplacements

Spécifiez les placements LTI qui seront utilisés pour exécuter l'outil d'approbation et de transfert de notes à partir des cours Original et Ultra. L'outil pour les formateurs et l'outil pour les administrateurs sont des emplacements obligatoires. Sélectionnez Lancer dans une nouvelle fenêtre pour que le LTI s'ouvre dans une fenêtre séparée.

Sélectionnez Soumettre pour enregistrer tous vos choix.