...

Web service Apogée

Les notes et résultats affichés dans MonDossierWeb proviennent du web service "Pédagogique" des webservices Apogée.

Le webservice web service "Pédagogique" se base sur plusieurs paramètres clés :

...

La méthode recupererContratPedagogiqueResultatVdiVet du webservice web service "Pédagogique" est appelée avec les paramètres suivant :

...

La méthode recupererContratPedagogiqueResultatElpEpr du webservice web service "Pédagogique" est appelée avec les paramètres suivant :

...

• Si le paramètre temoinFictif est renseigné, seuls les éléments dont le tem_fictif correspond seront affichés dans l'écran du détail des notes.
• Si le paramètre temNotesEtuSem est actif et que "sourceResultats" n'est pas égale à "Apogee-Extraction"
  • suppression des ELP de type semestre (et de leurs ELP fils) si leur état de délibération n'est pas à "T"
• Récupération des notes d'un ELP si son témoin de délibération correspond à :
  • Si "sourceResultats" = "Apogee-Extraction" => "AET" (aucun filtre sur la délibération)
  • Si "sourceResultats" ="Apogee", en fonction du profil de l'utilisateur et du paramètre correspondant :
    
    • temoinNotesEtudiant
    • temoinNotesEnseignant
• Si l'ELP possède des résultats pour 2 MCC différentes (session unique + session double)
  • La session des résultat aux ELP doit correspondre au témoin de session unique de la VET (ex : si VET en session unique, prise en compte des résultats de l'ELP en session unique uniquement)
• Affichage des résultats d'admissibilité uniquement si le paramètre affResultatsAdmissibilite l'autorise
• Si un résultat d'ELP indique une année de PRC, récupération de ce résultat uniquement si l'année est valide pour la durée de conservation indiquée au niveau de l'ELP
• Récupération des épreuves qui ont une note ou un résultat (si on veut afficher les résultats via le paramètre affResultatsEpreuves)
• Récupération des notes aux épreuves si l'une des conditions suivantes est remplie :
  • "sourceResultats" = "Apogee-Extraction"
  • le type de l'épreuve fait partie de la liste des types épreuve à afficher (paramètre typesEpreuveAffichageNote)
  • le témoin de délibération de l'épreuve fait partie de la liste des témoins paramétrés (temoinNotesEtudiant ou temoinNotesEnseignant)
  • le témoin de délibération de  l'elp père fait partie de la liste des témoins paramétrés  (temoinNotesEtudiant ou temoinNotesEnseignant)
  • le témoin CtlValCadEpr de l'épreuve est égal au paramètre temoinCtlValCadEpr
• Non affichage des épreuves seules sous leur ELP père si elles ont la même note que ce dernier.

Tester les WebServices Apogée avec SoapUI

Lorsqu'une anomalie est constatée dans l'affichage des notes et résultats proposé par MonDossierWeb interroger directement les web services Apogée est souvent nécessaire.

Recouper le retour avec la documentation ci-dessus permet de cibler l'origine du problème : Apogée (et ses web services) ou MonDossierWeb.

Un outil couramment utilisé pour tester des web services SOAP est SoapUI : https://www.soapui.org/tools/soapui/

Voici un exemple d'utilisation pour tester un appel à la méthode recupererContratPedagogiqueResultatElpEpr du web service "Pédagogique" d'Apogée :

• Créer un nouveau projet SOAP : File > New SOAP Project

Image Added

• Dans la pop-up de création de projet s'ouvre. Indiquer un nom de projet, l'url vers le WSDL du web service à tester, cocher "Create Requests" puis cliquer sur OK.

Image Added

• Le projet est créé avec des requêtes d'exemple pour chaque méthode du service. Modifier la requête automatiquement créée pour recupererContratPedagogiqueResultatElpEpr en double-cliquant sur cette dernière

Image Added

• L'enveloppe SOAP de la requête s'affiche. Il suffit de renseigner les paramètres dans le XML à la place de chaque "?", de vérifier que l'url du service est correcte et de cliquer sur l’icône verte "submit" pour exécuter la requête

Image Added

• Le retour est affiché dans la partie droite de la fenêtre. Penser à activer le formatage en XML pour faciliter sa lecture

Image Added