- 28 Feb 2024
- 11 Minuten te lezen
HR import CSV-bestand beschikbare velden
- Bijgewerkt op 28 Feb 2024
- 11 Minuten te lezen
Deze pagina behandelt de waarden die je kunt toevoegen aan je CSV-bestanden voor HR-import. Voor hulp bij het configureren van de CSV-uploadinstellingen op je Totara-site, zie de HR import CSV-site instellingenpagina.
CSV-bronbestandsformaat
Kommagescheiden waarden (CSV) bestanden bewaren tabelgegevens in platte tekst. Elke regel van het bestand is een gegevensrecord. Elke record bestaat uit één of meer velden, gescheiden door komma's (of andere tekens).
Het is mogelijk om bestanden op te slaan in CSV-formaat met behulp van alle grote spreadsheet-aanvragen en teksteditors. Je moet misschien voorzichtig zijn bij het gebruik van dubbele aanhalingstekens ("), dus raadpleeg je aanvraaghandleiding bij twijfel.
Voor tekstwaarden die iets anders dan letters of cijfers bevatten (speciale tekens), moet de waarde tussen dubbele aanhalingstekens liggen. Als de waarde zelf dubbele aanhalingstekens bevat, moet er een extra dubbele aanhalingsteken voor elk worden toegevoegd, bijv.:
Gewenste tekst | Invoer naar CSV-bestand |
---|---|
Er zijn "aanhalingstekens" binnen deze waarde. | Er zijn ""quotes"" binnen deze waarde |
Competenties
Koptekst | Formaat | Notities |
---|---|---|
idnummer | 1-100 tekens | Uniek voor elk hiërarchie-onderdeel. Deze onderdeel ID mag niet overeenkomen met de ID van competentie onderdelen in andere competentieraamwerken. Als een onderdeel ID gedeeld wordt tussen twee onderdelen in verschillende raamwerken, dan kan het onderdeel niet toegevoegd worden of kan het originele ID nummer verplaatst worden naar het raamwerk dat gebruikt wordt in het CSV-bestand. |
tijdgewijzigd | Unix tijdstempel | Details van laatste keer gewijzigd. Als er een Unix-tijdstempel in het bronbestand wordt opgegeven, mag de tijdgewijzigde waarde niet gelijk zijn aan de eerder geïmporteerde tijdgewijzigde waarde of wordt het onderdeel niet bijgewerkt. Indien leeg gelaten of ingesteld op 0, dan zal de record aangepast worden. |
frameworkidnummer | 1-100 tekens | idnummer dat overeenkomt met een bestaand hiërarchieraamwerk. |
korte titel | 0-100 tekens | Dit veld kan leeg zijn. |
volledige naam | 1-1000 tekens | De competentienaam. |
parentidnummer | 0-100 tekens | Komt overeen met het identificatorveld van een ander hiërarchie-onderdeel. Leeg voor het hoogste niveau. |
beschrijving | Maximaal 1000 tekens | Dit veld kan leeg zijn. |
typeidnummer | 0-100 tekens | Komt overeen met de id van een bestaand onderdeeltype. |
verwijderd | 0 of 1 | Vereist wanneer alleen competenties om aan te maken, bij te werken of te verwijderen zijn opgegeven, anders niet nodig. 0 betekent niets doen en 1 betekent verwijderen. Er wordt geen actie verondersteld als deze leeg is. |
customfield_[shortname] | Maximaal 1000 tekens | Aangepaste veldgegevens. Meerdere kolommen zijn toegestaan, waarbij de kolomkop overeenkomt met de extra korte veldtitel van het type. Als er geen overeenkomst is, wordt er niets bijgewerkt. Als het aangepaste veldtype Datumopmaak is, moeten de gegevens in het veld overeenkomen met het formaat dat is gedefinieerd onder Locatie > Locatie-instellingen > CSV importdatumopmaak. |
aggregatiemethode | 1, 2 of 3 | Voor alleen-leren sites
|
beschikbaarheid toewijzen | 0, 1, 2 of 3 | Voor Learn + Perform-sites
Let op: om competenties aan een andere gebruiker toe te wijzen, heeft de toewijzende gebruiker de machtiging Beheer competentietoewijzingen nodig. |
Functieprofiel
Zie Configureer HR-importbronnen om te zien hoe je meerdere functieprofielvelden kunt toevoegen in het HR-importbestand.
Voor meerdere functieprofielen kun je slechts twee (of meer) regels in je CSV per gebruiker zetten. De gebruikersvelden moeten in beide regels gelijk zijn. De functieprofielvelden bevatten één functieprofiel per regel. Bijvoorbeeld:
useridnumber,jobassignmentnumber,positionidnumber,manageridnumber
n123,jobid1,pos1,manager1
n123,jobid2,,manager2
Koptekst | Formaat | Notities |
---|---|---|
Volledige naam (optioneel) | Tot 100 tekens, spatie, ampersand, haakjes, schuine streep vooruit | Titel functieprofiel. |
gebruikersidnummer | 1-100 tekens | Het ID-nummer van de gebruiker. |
tijdgewijzigd | Unix tijdstempel | Details van laatste keer gewijzigd. Als er een Unix-tijdstempel in het bronbestand wordt opgegeven, mag de tijdgewijzigde waarde niet gelijk zijn aan de eerder geïmporteerde tijdgewijzigde waarde of wordt het onderdeel niet bijgewerkt. Indien leeg gelaten of ingesteld op 0, dan zal de record aangepast worden. |
verwijderd | 0 of 1 | Vereist wanneer alleen functieprofielen om aan te maken, bij te werken of te verwijderen worden verstrekt, anders niet nodig. 0 betekent niets doen en 1 betekent verwijderen. Er wordt geen actie verondersteld als deze leeg is. |
idnummer | 1-100 tekens | Komt overeen met geldig functieprofielnummer. Nietig verondersteld indien niet opgegeven. Om een gebruiker een manager toe te wijzen, moet de gebruiker een functieprofiel hebben. Als je bijvoorbeeld een managerid van 1 wilt toewijzen aan een gebruikersidnummer van 5, moet de manager een functieprofielnummer in het bestand hebben. |
startdatum (optioneel) | CSV-importdatumopmaak of Unix-tijdstempel | Gegevens in het veld moeten overeenkomen met het formaat dat is gedefinieerd onder Locatie > Locatie-instellingen > CSV-importdatumformaat. |
einddatum (optioneel) | CSV-importdatumopmaak of Unix-tijdstempel | Gegevens in het veld moeten overeenkomen met het formaat dat is gedefinieerd onder Locatie > Locatie-instellingen > CSV-importdatumformaat. |
orgidnummer (optioneel) | 1-100 tekens | Komt overeen met geldig organisatie ID nummer. Nietig verondersteld indien niet opgegeven. |
posidnumber (optioneel) | 1-100 tekens | Komt overeen met geldig positie ID nummer. Nietig verondersteld indien niet opgegeven. |
Appraiseridnumber (optioneel) | 1-100 tekens | Null of komt overeen met geldig gebruikers ID nummer. Nietig verondersteld indien niet opgegeven. |
manageridnummer (optioneel) | 1-100 tekens | Null of komt overeen met geldig gebruikers ID nummer. Nietig verondersteld indien niet opgegeven. |
managerjaidnumber (optioneel tenzij manageridnumber is ingeschakeld) | 1-100 tekens | Het ID-nummer voor de specifieke functieprofiel die betrokken is bij de managerrelatie. Automatisch vereist als het manageridnummer is ingesteld op aan en updateidnumbers is uitgeschakeld (d.w.z. we gebruiken meer dan alleen de eerste functies). |
tempmanageridnummer (optioneel) | 1-100 tekens | Null of komt overeen met geldig gebruikers ID nummer. Nietig verondersteld indien niet opgegeven. |
tempmanagerexpirydate (optioneel tenzij tempmanageridnumber is ingeschakeld) | CSV-importdatumopmaak of Unix-tijdstempel | Gegevens in het veld moeten overeenkomen met het formaat dat is gedefinieerd onder Locatie > Locatie-instellingen > CSV-importdatumformaat. |
tempmanagerjaidnumber (optioneel tenzij tempmanageridnumber is ingeschakeld) | 1-100 tekens | Het ID-nummer voor de specifieke functieprofiel die betrokken is bij de managerrelatie. Automatisch vereist als tempmanageridnumber is ingeschakeld en updateidnumbers is uitgeschakeld (d.w.z. we gebruiken meer dan alleen de eerste taken). |
Organisaties
Koptekst | Formaat | Notities |
---|---|---|
idnummer | 1-100 tekens | Uniek voor elk hiërarchie-onderdeel. Dit onderdeel ID mag niet overeenkomen met het ID van organisatieonderdelen in andere organisatieraamwerken. Als een onderdeel ID gedeeld wordt tussen twee onderdelen in verschillende raamwerken, dan kan het onderdeel niet toegevoegd worden of kan het originele ID nummer verplaatst worden naar het raamwerk dat gebruikt wordt in het CSV-bestand. |
tijdgewijzigd | Unix tijdstempel | Details van laatste keer gewijzigd. Als er een Unix-tijdstempel in het bronbestand wordt opgegeven, mag de tijdgewijzigde waarde niet gelijk zijn aan de eerder geïmporteerde tijdgewijzigde waarde of wordt het onderdeel niet bijgewerkt. Indien leeg gelaten of ingesteld op 0, dan zal de record aangepast worden. |
frameworkidnummer | 1-100 tekens | idnummer dat overeenkomt met een bestaand hiërarchieraamwerk. |
korte titel | 0-100 tekens | Dit veld kan leeg zijn. |
volledige naam | 1-1000 tekens | De naam van de organisatie. |
parentidnummer | 0-100 tekens | Komt overeen met het identificatorveld van een ander hiërarchie-onderdeel. Leeg voor het hoogste niveau. |
beschrijving | Maximaal 1000 tekens | Dit veld kan leeg zijn. |
typeidnummer | 0-100 tekens | Komt overeen met de id van een bestaand onderdeeltype. |
verwijderd | 0 of 1 | Vereist wanneer alleen organisaties om aan te maken, bij te werken of te verwijderen zijn opgegeven, anders niet nodig. 0 betekent niets doen en 1 betekent verwijderen. Er wordt geen actie verondersteld als deze leeg is. |
customfield_[shortname] | Maximaal 1000 tekens | Aangepaste veldgegevens. Meerdere kolommen zijn toegestaan, waarbij de kolomkop overeenkomt met de extra korte veldtitel van het type. Als er geen overeenkomst is, wordt er niets bijgewerkt. Als het aangepaste veldtype Datumopmaak is, moeten de gegevens in het veld overeenkomen met het formaat dat is gedefinieerd onder Locatie > Locatie-instellingen > CSV importdatumopmaak. |
aggregatiemethode | 1, 2 of 3 | Als deze optie niet wordt geactiveerd, blijft de oude 'blader'-opmaak behouden. Alleen competentiebron.
|
Posities
Koptekst | Formaat | Notities |
---|---|---|
idnummer | 1-100 tekens | Uniek voor elk hiërarchie-onderdeel. Deze onderdeel ID mag niet overeenkomen met de ID van positie onderdelen in andere positie raamwerken. Als een onderdeel ID gedeeld wordt tussen twee onderdelen in verschillende raamwerken, dan kan het onderdeel niet toegevoegd worden of kan het originele ID nummer verplaatst worden naar het raamwerk dat gebruikt wordt in het CSV-bestand. |
tijdgewijzigd | Unix tijdstempel | Details van laatste keer gewijzigd. Als er een Unix-tijdstempel in het bronbestand wordt opgegeven, mag de tijdgewijzigde waarde niet gelijk zijn aan de eerder geïmporteerde tijdgewijzigde waarde of wordt het onderdeel niet bijgewerkt. Indien leeg gelaten of ingesteld op 0, dan zal de record aangepast worden. |
frameworkidnummer | 1-100 tekens | idnummer dat overeenkomt met een bestaand hiërarchieraamwerk. |
korte titel | 0-100 tekens | Dit veld kan leeg zijn. |
volledige naam | 1-1000 tekens | De positienaam. |
parentidnummer | 0-100 tekens | Komt overeen met het identificatorveld van een ander hiërarchie-onderdeel. Leeg voor het hoogste niveau. |
beschrijving | Maximaal 1000 tekens | Dit veld kan leeg zijn. |
typeidnummer | 0-100 tekens | Komt overeen met de id van een bestaand onderdeeltype. |
verwijderd | 0 of 1 | Vereist wanneer alleen posities om aan te maken, bij te werken of te verwijderen zijn opgegeven, anders niet nodig. 0 betekent niets doen en 1 betekent verwijderen. Er wordt geen actie verondersteld als deze leeg is. |
customfield_[shortname] | Maximaal 1000 tekens | Aangepaste veldgegevens. Meerdere kolommen zijn toegestaan, waarbij de kolomtitel overeenkomt met de korte titel van het extra veld van het type. Als er geen overeenkomst is, wordt er niets bijgewerkt. Als het aangepaste veldtype Datumopmaak is, moeten de gegevens in het veld overeenkomen met het formaat dat is gedefinieerd onder Locatie > Locatie-instellingen > CSV importdatumopmaak. |
aggregatiemethode | 1, 2 of 3 | Als deze optie niet wordt geactiveerd, blijft de oude 'blader'-opmaak behouden. Alleen competentiebron
|
Gebruikers
Optie | Formaat | Notities |
---|---|---|
idnummer | 1-100 tekens | Uniek voor alle gebruikers en nooit gewijzigd voor een bepaalde gebruiker. Gebruik de waarde die getoond wordt in het gebruikersprofiel ID nummer optioneel veld. Controleer of de waarde van het ID-nummer bestaat voor bestaande gebruikers als je de profielvelden van bestaande gebruikers wil bijwerken. |
gebruikersnaam | 1-100 tekens | Uniek voor alle gebruikers. |
tijdgewijzigd | Unix tijdstempel | Details van laatste keer gewijzigd. Als er een Unix-tijdstempel in het bronbestand wordt opgegeven, mag de tijdgewijzigde waarde niet gelijk zijn aan de eerder geïmporteerde tijdgewijzigde waarde of wordt het onderdeel niet bijgewerkt. Indien leeg gelaten of ingesteld op 0, dan zal de record aangepast worden. |
verwijderd geblokkeerd | 0 of 1 0 of 1 | Vereist wanneer alleen gebruikers worden opgegeven om aan te maken, bij te werken of te verwijderen/op te schorten, anders niet nodig. 0 betekent niets doen en 1 betekent verwijderen/op te schorten. Er wordt geen actie verondersteld als deze leeg is. Wanneer er echter een leeg geblokkeerd veld in de gebruikersbron is opgenomen voor nieuwe records en de optie Lege strings wissen bestaande gegevens is gekozen, krijgt de toegevoegde gebruiker de standaardwaarde Actief. Het wissen van de gegevens betekent niet dat er geen waarde in het veld is als het veld een standaardwaarde heeft. |
voornaam | 1-100 tekens | Geen spaties vooraan of achteraan. |
achternaam | 1-100 tekens | Geen spaties vooraan of achteraan. |
voornaam fonetisch (optioneel) | 1-100 tekens | Geen spaties vooraan of achteraan. |
achternaam fonetisch (optioneel) | 1-100 tekens | Geen spaties vooraan of achteraan. |
Tweede naam (optioneel) | 1-100 tekens | Geen spaties vooraan of achteraan. |
alternatieve naam (optioneel) | 1-100 tekens | Geen spaties vooraan of achteraan. |
Geldig e-mailadres, maximaal 100 tekens | Uniek voor elke gebruiker. | |
e-mailstop | 0 of 1 | Schakelt niet-essentiële door het systeem gegenereerde e-mailnotificaties uit. |
land | ISO 3116-landcode van 2 tekens (bijv. NZ voor Nieuw-Zeeland) | - |
stad | 120 tekens | - |
tijdzone (optioneel) | 1-100 tekens | Een locatiegebaseerde tijdzone-ID, bijv. Amerika/New_York, Europa/Londen, Azië/Singapore, enz. Zie http://us.php.net/manual/en/timezones.php voor een lijst met alle op locatie gebaseerde tijdzones. |
lang (optioneel) | 1-30 tekens | ISO 639-1-code met twee tekens of een specifieke taalpakketcode (bijvoorbeeld en_us voor Amerikaans Engels). |
beschrijving (optioneel) | 1-1000 tekens | - |
url (optioneel) | 1-200 tekens | - |
instelling (optioneel) | 1-40 tekens | - |
afdeling (optioneel) | 1-30 tekens | - |
telefoon1 (optioneel) | 1-20 tekens | - |
telefoon2 (optioneel) | 1-20 tekens | - |
adres (optioneel) | 1-70 tekens | - |
tenantmember (optioneel) | Het ID-nummer van de tenant waarvan de gebruiker lid moet zijn. | Let op dat je niet dezelfde tenant ID kunt opnemen voor zowel de tenantmember als de tenantparticipant kolommen, omdat een gebruiker geen lid en deelnemer kan zijn van dezelfde tenant. |
tenantdeelnemer (optioneel) | Het ID-nummer van de tenant waaraan de gebruiker moet deelnemen. | Je kunt elke gebruiker als deelnemer aan meerdere tenants toewijzen door een kommagescheiden lijst met tenant ID-nummers (bijvoorbeeld "tenantid1,tenantid2,tenantid3") toe te voegen aan de tenantdeelnemerkolom. Let op dat je niet dezelfde tenant ID kunt opnemen voor zowel de tenantmember als de tenantparticipant kolommen, omdat een gebruiker geen lid en deelnemer kan zijn van dezelfde tenant. |
auth (optioneel) | Dit is de lijst met standaard authenticatietypes in Totara. Zorg ervoor dat de plugin is ingeschakeld voor gebruik. Als je een aangepaste authenticatieplugin gebruikt, gebruik dan de naam van die plugin voor dit veld. | |
Formaat: | Authenticatietype: | |
manueel | Als deze authenticatiemethode wordt toegekend aan een gebruikersaccount, wordt het onbruikbaar. | |
nologin | Inactief | |
Zelfregistratie | ||
cas | CAS-server (SSO) | |
bv | Externe database | |
fc | FirstClass server | |
gauth | Google Openid Authenticatie | |
imap | IMAP-server | |
ldap | LDAP-server | |
mnet | MNet authenticatie | |
nntp | NNTP-server | |
geen | Geen authenticatie | |
pam | PAM (verplaatsbare authenticatiemodules) | |
pop3 | POP3-server | |
radius | RADIUS server | |
shibboleth | Shibboleth | |
webservice | Webservices | |
oauth2 | OAuth 2 | |
ssosaml | SAML SSO | |
wachtwoord (optioneel) | 0-32 tekens | Als de wachtwoordkolom is inbegrepen en het CSV-bestand een leeg wachtwoordveld heeft (of als de wachtwoordkolom niet is inbegrepen), dan wordt er een welkomstmail verzonden waarmee de gebruiker zijn eigen wachtwoord kan maken. Let op dat dit alleen werkt bij het toevoegen van nieuwe gebruikers. Als je een groot aantal nieuwe gebruikers toevoegt zonder wachtwoorden, houd er dan rekening mee dat dit zal resulteren in het verzenden van een groot aantal e-mails. |
customfield_[shortname] (optioneel) | 1-1000 tekens | Aangepaste veldgegevens. Meerdere kolommen toegestaan, waarbij de kolomkop overeenkomt met een bestaande extra korte titel voor het gebruikersveld. Als er geen overeenkomst is, wordt er niets bijgewerkt. Als het aangepaste veldtype Datumopmaak is, moeten de gegevens in het veld overeenkomen met het formaat dat is gedefinieerd onder Locatie > Locatie-instellingen > CSV importdatumopmaak. |
Exporteren
Bij het exporteren van competenties, posities, organisaties of doelen, is het gedrag van aangepaste veldtypen volgens de onderstaande tabel.
Hiërarchie-exports zijn beschikbaar wanneer je alle competenties, posities, organisaties of doelenraamwerken bekijkt of wanneer je een specifiek raamwerk bekijkt.
Aangepast veldtype | Exporteren | Importeer |
---|---|---|
Selectievakje | 1 voor gecontroleerd, 0 voor niet gecontroleerd. | Zelfde als export. |
Datum/tijd | Een tijdstempel. | Ofwel een tijdstempel, of een datum in een opmaak die wordt gegeven door de configuratie-instelling csvdateformat. |
Bestand | De naam van het bestand. | Extra bestandsvelden kunnen niet geïmporteerd worden. |
Locatie | Het adres. | Zelfde als export. |
Menu | De tekst van de geselecteerde waarde. | Zelfde als export. |
multi-select | Binnen aanhalingstekens, een kommagescheiden lijst van de geselecteerde waarden. | Zelfde als export. |
Tekstzone | De volledige waarde, inclusief HTML-tags. | Zelfde als export. |
Invulregel | De waarde zelf. | Zelfde als export. |
URL | De URL zelf. De tekst of het selectievakje voor het openen van een nieuw venster zijn niet inbegrepen. | Zelfde als export. |
© Copyright 2024 Totara Learning Solutions. All rights reserved.