Feilsøking og administrasjon av Microsoft School Data Sync (SDS)

Denne guiden gir en oversikt over vanlige problemer og feilmeldinger i Microsoft School Data Sync (SDS) for eFeide-kunder. Den beskriver hvordan man løser typiske synkroniseringsfeil og forklarer strukturen i de underliggende datafilene.

Slik tilbakestiller du SDS-synkroniseringen (Reset Sync)

Funksjonen "Reset Sync" er et effektivt verktøy for å løse mange synkroniseringsfeil.

Hva gjør "Reset Sync"?

• Tilbakestiller feilloggen i SDS.

• Leser inn alle datafilene på nytt, i stedet for kun endringer siden forrige kjøring.

• Rydder opp i feil som er rettet i kildesystemet (SAS), men som henger igjen i feilloggen.

• Gjenoppretter brukere eller medlemskap som har blitt manuelt slettet i Teams.

Viktig: "Reset Sync" fjerner ingen data, brukere eller Teams i Microsoft 365. SDS vil aldri slette data, kun opprette eller legge til informasjon.

Slik gjør du:

1. Naviger til SDS-administrasjonspanelet.

2. Velg din synkroniseringsprofil.

3. Under fanen "Administrerte data" finner du valgene for å tilbakestille brukere og klassegrupper.

Vanlige synkroniseringsproblemer

Her er løsninger på de mest vanlige problemene som oppstår under synkronisering med SDS.

Problem: Teams blir ikke opprettet

For at SDS skal kunne opprette et Microsoft Team for en gruppe, må gruppen ha minst én lærer registrert som eier. Hvis en gruppe, for eksempel en basisgruppe, kun inneholder elever, vil ikke SDS opprette et Team for den.

Advarsel: SDS genererer ingen feilmelding for dette scenarioet. Teamet blir bare ikke opprettet.

Løsning:

• Alternativ 1: Legg til den nødvendige læreren (f.eks. kontaktlærer) i basisgruppen direkte i det skoleadministrative systemet (SAS).

• Alternativ 2: Kontakt Identum for å endre konfigurasjonen til å bruke grupper som garantert inneholder en lærer, for eksempel kontaktlærergrupper.

Problem: Elever eller lærere blir ikke medlem i Teams

Hvis en bruker ikke blir lagt til i et Team selv om medlemskapet er definert i studentenrollment.csv eller teacherroster.csv, skyldes det ofte et lisensproblem.

Advarsel: SDS genererer ingen feilmelding hvis en bruker mangler lisens. Brukeren blir bare ikke lagt til som medlem i Teamet.

Løsning:

1. Logg inn på Microsoft 365-administrasjonssenteret.

2. Finn den aktuelle brukeren.

3. Verifiser at brukeren har en gyldig M365-lisens som inkluderer tilgang til Microsoft Teams.

Problem: Medlemskap i Teams blir ikke oppdatert

Det finnes en kjent feil hos Microsoft hvor medlemskap i Teams ikke blir oppdatert, selv om grunnlagsdataene i SDS er korrekte.

Løsning:

• Se følgende Microsoft-artikkel for detaljer og mulige løsninger: Missing Teams Memberships or Access - School Data Sync.

Forståelse av SDS-datafilene

SDS bruker et sett med CSV-filer for å synkronisere data. Her er en oversikt over de viktigste filene og feltene.

• School.csv: Inneholder alle skoler som skal synkroniseres.

  • School SIS ID: Skolens unike ID. Brukes som referanse i andre filer.

  • Name: Skolens navn.

• Student.csv: Inneholder alle elever.

  • SIS ID: Elevens unike synkroniseringsnøkkel (f.eks. fødselsnummer).

  • School SIS ID: ID-en til skolen eleven tilhører.

  • Username: Elevens UserPrincipalName (UPN).

• Teacher.csv: Inneholder alle lærere.

  • SIS ID: Lærerens unike synkroniseringsnøkkel (f.eks. fødselsnummer).

  • School SIS ID: ID-en til skolen læreren tilhører.

  • Username: Lærerens UPN.

• Section.csv: Inneholder alle grupper (klasser) som skal opprettes som Teams.

  • Section SIS ID: Gruppens unike ID. Brukes som referanse for medlemskap.

  • School SIS ID: ID-en til skolen gruppen tilhører.

  • Section Name: Navnet på teamet som opprettes.

• Studentenrollment.csv: Definerer hvilke elever som er medlem av hvilke grupper.

  • Section SIS ID: Gruppens unike ID (refererer til section.csv).

  • SIS ID: Elevens unike ID (refererer til student.csv).

• Teacherroster.csv: Definerer hvilke lærere som er medlem (eiere) av hvilke grupper.

  • Section SIS ID: Gruppens unike ID (refererer til section.csv).

  • SIS ID: Lærerens unike ID (refererer til teacher.csv).

Feilsøking av spesifikke SDS-feilmeldinger

Her er en liste over vanlige feilmeldinger fra SDS-loggene, hva de betyr, og hvordan du løser dem.

Brukermatching-feil

Disse feilene oppstår når SDS ikke finner en korresponderende bruker i Azure AD.

• Feilmelding: UserMapping Match Not Found eller Error,student.csv, 3 cannot be updated as no matching entry in Active Directory was found.

  • Årsak: SDS finner ikke en bruker i Azure AD med et UPN som matcher Username-feltet i student.csv eller teacher.csv.

  • Løsning: Verifiser at brukeren eksisterer i Azure AD og at UPN er identisk i kildefilen og Azure AD.

• Feilmelding: UserMappingIdentifierNotFound.

  • Årsak: UPN (identifikatoren) mangler for brukeren i kildefilen. Dette skjer ofte hvis brukerens anker (anchor) ikke er blitt tilbakeskrevet fra Azure AD til eFeide.

  • Løsning: Forsøk å gjenopprette brukeren i eFeide og kjør en ny synkronisering for å se om ankeret blir opprettet.

Innmelding- og referansefeil

Disse feilene oppstår når medlemskap ikke kan knyttes til en gyldig bruker eller gruppe.

• Feilmelding: ValidationCrossReferenceMapping NotFound.

  • Årsak: Et medlemskap (enrollment) kan ikke knyttes til en eksisterende klasse (section).

• Feilmelding: Error, studentenrollment.csv,5 entry/entries have referenced data not found in source.

  • Årsak: Et medlemskap i studentenrollment.csv refererer til en elev (SIS ID) som ikke finnes i student.csv. Dette er ofte en følgefeil av at brukeren ikke ble funnet i Azure AD.

  • Løsning: Løs først eventuelle UserMapping-feil for den aktuelle eleven.

• Feilmelding: Error; StudentEnrollment Invalid Lookup Reference; The student could not be added to the class.

  • Løsning: Sjekk at gruppen (Section SIS ID) finnes i section.csv, at eleven eksisterer i M365, og at gruppen er korrekt opprettet som et Team.

Eierskapsfeil

• Feilmelding: Error; Teacher Roster; AzureActiveDirectory LastOwner OfGroup CannotBeRemoved.

  • Årsak: SDS forsøker å fjerne den siste eieren fra et Team. Alle Teams må ha minst én eier.

  • Løsning: Sørg for at gruppen har minst én lærer tilknyttet i kildesystemet (SAS).

Datakvalitetsadvarsler

• Advarsel: Warning, teacher.csv, 3 duplicates found in column Username which requires values to be Unique.

  • Årsak: En bruker (basert på UPN) er listet opp flere ganger i teacher.csv. Dette er vanligvis ikke en feil, men skjer når en ansatt underviser ved flere skoler.

  • Løsning: Dette er som regel kun en advarsel og krever ingen handling.

Feil relatert til foresatte

• Feilmelding: user.csv, Entries have missing data for the field - Email eller guardianrelationship.csv, Entries have missing data for the field - Email.

  • Årsak: user.csv (foresatte) eller guardianrelationship.csv (kobling mellom elev og foresatt) inneholder rader der e-postadressen mangler.

  • Løsning: Registrer manglende e-postadresser på de foresatte i SAS.

Sammendrag for AI og søk

Denne guiden gir feilsøkingssteg for administratorer som håndterer Microsoft School Data Sync (SDS) for Identums eFeide-kunder. Den dekker vanlige problemer som manglende Teams-opprettelse og brukermedlemskap, og forklarer hvordan man tolker og løser spesifikke feilmeldinger fra SDS-logger. Dokumentet beskriver også funksjonen til sentrale SDS-datafiler og hvordan man utfører en "Reset Sync" for å løse vedvarende synkroniseringsfeil.