Uvoz večjega števila oseb

Uvoz prebere osebe iz datoteke CSV – na primer iz kadrovske službe ali imeniške storitve –, preveri vsako vrstico, preden kar koli shrani, in nato v enem koraku ustvari nove osebe z njihovimi pravili.

Česa uvoz ne naredi: ne spreminja obstoječih oseb, ne izdaja ključev in ne nastavlja drugega faktorja. Za te korake so na voljo ločeni postopki (glejte Napotki).

stateDiagram-v2
    direction LR
    state "Obstoječa" as Obstojeca
    state "Neuspešna" as Neuspesna
    [*] --> Nova: vrstica veljavna, ime neznano
    [*] --> Obstojeca: ime je že v shrambi
    [*] --> Napaka: vrstica neveljavna
    Nova --> Ustvarjena: Prevzemi, oseba in pravila shranjeni
    Nova --> Delno: oseba shranjena, pravilo zavrnjeno
    Nova --> Neuspesna: oseba zavrnjena
    Delno --> Ustvarjena: ponovno Prevzemi
    Neuspesna --> Ustvarjena: ponovno Prevzemi
    Obstojeca --> [*]: ostane nespremenjena
    Napaka --> [*]: popravite datoteko, preberite znova

*Slika: stanja vrstice. Levo je stanje po branju datoteke, desno stanje po ukazu Übernehmen (Prevzemi). Ukaz obdela samo vrstice s stanjem „Nova“, „Delno“ in „Neuspešna“; pri vrsticah s stanjem „Obstoječa“ in „Napaka“ ne zapiše ničesar.*

Prva vrstica navaja imena stolpcev. Vrstni red stolpcev ni pomemben; pri imenih stolpcev se velike in male črke, presledki in vezaji ne upoštevajo.

Druge stolpce, na primer Oddelek, povzetek navede, uvoz pa jih preskoči. V datoteko vključite samo stolpce, ki so za dostop res potrebni (glejte Varstvo podatkov).

Name;Windows-Konto;E-Mail;Regeln
Ana Novak;PODJETJE\anovak;ana.novak@example.org;fachdaten-lesen
"Kovačič, Jure";PODJETJE\jkovacic;;fachdaten-lesen,fachdaten-pflege

Oblika. Datoteka CSV v kodiranju UTF-8, ločilo je podpičje. V Excelu jo shranite z Datoteka > Shrani kot in vrsto datoteke „CSV UTF-8 (ločeno z vejicami)“. Datoteka se bere po RFC 4180 („Common Format and MIME Type for Comma-Separated Values (CSV) Files“, https://www.rfc-editor.org/rfc/rfc4180): polje v narekovajih lahko vsebuje ločila in prelome vrstic, "" v takem polju pomeni en narekovaj. Odstopanje od RFC 4180 je samo ločilo: RFC predpisuje vejico, tu se uporablja podpičje. Presledki na začetku in koncu polja se odstranijo.

1. Odprite Personen und Schlüssel (Osebe in ključi), izberite Weitere (Več) > Personen importieren … (Uvozi osebe …) in izberite datoteko.

2. Desno od seznama oseb se prikažejo vse vrstice datoteke, združene po stolpcu Stand (Stanje) in z zaporedno številko vrstice v datoteki. Vrstica nad mrežo pove, koliko vrstic je novih, obstoječih in napačnih, koliko zahtev bo ukaz Übernehmen poslal prehodu in koliko časa bo to približno trajalo. Do tega koraka se ne shrani nič.

   

   Na sliki: (1) povzetek, (2) vrstice po stanju, (3) Übernehmen (Prevzemi), Andere Datei (Druga datoteka), Schließen (Zapri).

3. Vrstice s stanjem Fehler (Napaka) popravite v datoteki in jo z ukazom Andere Datei … (Druga datoteka …) preberite znova. Lahko pa najprej prevzamete veljavne vrstice, popravljeno datoteko pa preberete pozneje; že ustvarjene osebe imajo tedaj stanje Vorhanden (Obstoječa).
4. Izberite Übernehmen (n); n je število vrstic, ki jih je še treba obdelati. Vrstica nad mrežo prikazuje osebo, ki se trenutno obdeluje. Anhalten (Ustavi) uvoz ustavi po trenutni zahtevi; ko znova izberete Übernehmen, se uvoz nadaljuje tam, kjer se je ustavil.
5. Schließen (Zapri) uvoz zapre, seznam oseb je znova v celoti na voljo, prebrane vrstice pa se izbrišejo.

Rezultat: Vrstice imajo stanje Angelegt (Ustvarjena), osebe pa so na seznamu, vsaka s svojimi pravili. Kot vsaka druga sprememba je tudi vsaka nova oseba zapisana v dnevniku sprememb (področje Protokoll (Dnevnik)).

Prehod ne sprejema skupinskih zahtev: vsaka oseba je ena zahteva, vsako njeno pravilo pa še ena. Število zahtev na klicatelja je omejeno (privzeto 300 v 60 sekundah; glejte HTTP: skrbništvo, razdelek „Veliko dejanj naenkrat“ (dokumentacija podatkovnega prehoda)). Uvoz zato med dvema zahtevama počaka najmanj 250 ms, kar pomeni največ 240 zahtev na minuto; preostanek omejitve ostane na voljo zahtevam, ki jih med uvozom pošilja aplikacija sama. Na tem temelji ocena v povzetku: 850 oseb z enim pravilom pomeni 1.700 zahtev in približno 7 minut. To je spodnja meja, ki izhaja iz omejitve; po počasni povezavi uvoz traja dlje.

Če prehod kljub temu odgovori s „preveč zahtev“ (HTTP 429), uvoz počaka 60 sekund in isto zahtevo ponovi, največ trikrat. Nato vrstica dobi stanje Fehlgeschlagen (Neuspešna), uvoz pa nadaljuje z naslednjo.

Kar je bilo shranjeno pred napako, ostane shranjeno. Uvoz si zato za vsako vrstico zapomni, ali je oseba že ustvarjena in katera pravila še manjkajo. Ponovni Übernehmen osebe nikoli ne ustvari dvakrat, temveč dopolni, kar manjka. Če se povezava med zahtevo prekine, aplikacija zahtevo ponovi, ne da bi prehod kar koli shranil dvakrat.

Ali oseba že obstaja, se ugotovi samo po imenu, pri čemer se velike in male črke ne razlikujejo; ime je v shrambi enolično. Iz tega sledita dve omejitvi:

• Če imata dve različni osebi enako ime, uvoz drugo preskoči kot Vorhanden. Dajte ji ime, po katerem se razlikuje, na primer z dodanim oddelkom.
• Če ima obstoječa oseba v datoteki drug račun Windows ali drug e-poštni naslov, je uvoz ne spremeni in razlike ne sporoči. Take osebe preverite v njihovem obrazcu.

Kdor se prijavlja z računom Windows ali s prijavo SQL, ključa ne potrebuje. Ključe izdate samo tistim, ki jih potrebujejo; za več oseb je to najlažje po e-pošti. Tudi 2FA uvoženim osebam najlaže nastavite s povabilom po e-pošti, za več oseb hkrati prek kartice Auswahl (Izbor) (glejte Urejanje več oseb hkrati). Oseba lahko 2FA ob prijavi nastavi sama, vendar samo v določenem času po izdaji ključa (nastavitev totp_enrol_hours, privzeto 24 ur). Kdor se prijavlja samo z računom Windows ali s prijavo SQL, nima ključa in zato tudi te možnosti ne (glejte Nastavitev ali ponastavitev 2FA).

Pravila, identitete podatkovne zbirke in pravila za prijavo lahko dodelite celotni skupini Windows (glejte Dodelitev računov in skupin Windows). Lasten vnos osebe potrebuje samo tisti, ki dobi ključ, 2FA ali privzeto identiteto. Če pravilo za prijavo za skupino zahteva 2FA, prehod zavrne vsakega člana, ki nima lastnega vnosa osebe. Pri takih skupinah z uvozom vse člane ustvarite kot osebe.

Prehod članov skupine Windows ne posreduje. Seznam pripravite v imeniški storitvi, na primer z ukazom Get-ADGroupMember na delovni postaji, in ga kot datoteko CSV s stolpcema Name in Windows-Konto uvozite tukaj. Poznejših vstopov v skupino in izstopov iz nje ne prehod ne aplikacija ne upoštevata samodejno.

Seznam vsebuje osebne podatke v smislu točke 1 člena 4 splošne uredbe o varstvu podatkov (GDPR): imena, račune in e-poštne naslove. Za obdelavo je odgovoren upravljavec namestitve. Aplikacija načeli najmanjšega obsega podatkov in omejitve shranjevanja (točki © in (e) odstavka 1 člena 5 GDPR) podpira takole:

Za izvorno datoteko ste odgovorni sami: po uvozu jo izbrišite, če je ne potrebujete za drug namen.

Kaj ostane: Vsaka ustvarjena oseba je zapisana v dnevniku sprememb prehoda z vsemi vrednostmi; ta zapis ostane neomejeno, tudi če osebo pozneje izbrišete (glejte Varnost in varstvo podatkov). Zato uvozite samo osebe, ki naj dostop res dobijo, in samo potrebne stolpce.

• Ustvarjanje osebe in izdaja ključa: posamezna oseba z vsemi koraki do predaje
• Pošiljanje povabila po e-pošti: izdaja ključev več osebam
• Delo s področji, seznami in ukazi: kartice, seznami, ukazi
• Referenčni priročnik: HTTP: skrbništvo, razdelek „Veliko dejanj naenkrat“ (dokumentacija podatkovnega prehoda)