Endre utreiseperiode for utvekslingsstudent

info

• ⏪ Ikke validert: Prosessen er ennå ikke validert/standardisert. Siden viser enten: 1) Dokumentasjon av gjeldende praksis; 2) En prosess som er identifisert, men ikke dokumentert. 3) Prosessen er under vurdering.
• Denne prosessbeskrivelsen er ment som dokumentasjon av gjeldende praksis. Prosessen er ennå ikke standardisert.

I noen tilfeller har man behov for å oppdatere at en utvekslingsstudent har hatt en annen utreiseperiode enn det som var planlagt. Dette kalles å endre på læringsavtale innen utvekslingsfeltet.

Støtte i FS GraphQL API

FS GraphQL API har støtte for å endre utreiseperiode for et eksisterende utvekslingsopphold.

Finn utvekslingsoppholdet

Hvordan man finner riktig utvekslingsopphold, vil variere ut fra implementasjonen på klientsiden. I mange tilfeller vil klienten være den samme som opprettet utvekslingsoppholdet, og klienten kan ha cachet IDen for utvekslingoppholdet da. Her er et eksempel hvor vi kjenner feidebrukernavnet til studenten, men ingenting annet. Da kan vi bruke et studentoppslag for å finne riktig utvekslingsopphold:

query StudentGittFeideBruker {
    studenterGittFeideBrukere(
        eierInstitusjonsnummer: "1234"
        feideBrukere: "14545390087@spusers.feide.no"
    ) {
        id
        utreisendeUtveksling {
            id
            avtale {
                navnAlleSprak {
                    und
                }
            }
            utvekslingsperiode {
                fraDato
                tilDato
            }
        }
    }
}

Svaret blir:

{
  "data": {
    "studenterGittFeideBrukere": [
      {
        "id": "OTk6MTIzNCw4OTE",
        "utreisendeUtveksling": [
          {
            "id": "MjM4OjEyMzQsODkxLEFERUwxLDIwMjQtMDEtMDE",
            "avtale": {
              "navnAlleSprak": {
                "und": "Utveksling bachelor, samfunnsfag, Paris"
              }
            },
            "utvekslingsperiode": {
              "fraDato": "2024-01-01",
              "tilDato": "2024-12-31"
            }
          }
        ]
      }
    ]
  }
}

Her ser vi at studenten har ett og bare ett utreisende utvekslingopphold, og det var tilfeldigvis det samme som vi lette etter. Vi tar vare på IDen vi fikk i responsen.

Endre utreiseperioden

Så endrer vi utreiseperioden i APIet:

mutation MyMutation {
    endreUtreiseperiodeForUtvekslingsstudenter(
        input: {id: "MjM4OjEyMzQsODkxLEFERUwxLDIwMjQtMDEtMDE", fraDato: "2024-02-01", tilDato: "2024-12-31"}
    ) {
        utvekslingsstudenter {
            id
            utreiseperiode {
                fraDato
                tilDato
            }
        }
        errors {
            __typename
            ... on Error {
                path
                message
            }
        }
    }
}

Ut fra responsen kan vi se at utreiseperioden ble endret:

{
  "data": {
    "endreUtreiseperiodeForUtvekslingsstudenter": {
      "utvekslingsstudenter": [
        {
          "id": "MjM4OjEyMzQsODkxLEFERUwxLDIwMjQtMDEtMDE",
          "utreiseperiode": {
            "fraDato": "2024-02-01",
            "tilDato": "2024-12-31"
          }
        }
      ],
      "errors": null
    }
  }
}