Rollentypen
Legt Rollentypen an oder ändert sie, mit Reihenfolge und Einstellungen für die Rollenerfassung.
- Format
- CSV (Komma, Semikolon oder Tab), UTF-8 oder Windows-1252
- Rechte
- Administrator, Kontakte (CRM) mit Schreibrecht
- Beispieldateien
- rollentypen-beispiel_technisch.csv (technische Spaltennamen)
rollentypen-beispiel_anwender.csv (deutsche Spaltennamen)
Kurz gesagt: Rollentypen sind die Arten von Rollen und Funktionen, etwa Vorstand oder Kampfrichter. Hier legt ihr sie an oder ändert sie. Vorhandene Typen erkennt vynst (inwendo ERP) an ihrer ID oder ihrem Namen.
Wofür ihr das braucht
Damit ihr einer Person eine Rolle oder Funktion zuordnen könnt, braucht es die Rollentypen. Diese Datei hilft beim Anlegen eines ganzen Katalogs und beim Ändern vieler Typen auf einmal.
Bevor ihr startet
- Rechte: Ihr braucht Administratorrechte und das Schreibrecht für Kontakte (CRM).
- Vorlage: Exportiert zuerst die bestehenden Rollentypen unter Einstellungen → Export, Eintrag „Export der Rollentypen“. Diese Datei könnt ihr direkt bearbeiten und wieder importieren.
- Zugriffs-Tags: Die Zugriffs-Tags der Rollentypen gehören nicht zu Export und Import.
Datei vorbereiten
- Dateiname: Er muss
.csventhalten. - Erste Spalte: Die Rollentyp-ID steht in der ersten Spalte. Ihre Position ist Pflicht. Die Zelle darf bei neuen Typen leer sein.
- Namensspalte:
Rollentyp-NameoderNAME. Bei neuen Typen ist der Name Pflicht. - Trennzeichen: Komma, Semikolon oder Tab. vynst erkennt es an der Kopfzeile.
- Zeichensatz: UTF-8 oder Windows-1252, wie es Excel speichert. Beides wird richtig gelesen.
- Ja/Nein:
ja/nein,1/0,true/false,yes/no,wahr/falsch,on/off.
Spalten
| Spalte | Pflicht | Inhalt | Beispiel |
|---|---|---|---|
Rollentyp-ID (LOG_BOOK_ENTRY_TYPE_IDENTIFIER), erste Spalte |
ja | ID des Rollentyps. Leer bei neuen Typen erlaubt. Höchstens 190 Zeichen. Auch erlaubt: Rollentyp-ID, Rollentyp, Funktionstyp. |
LOG_CONTENT_TYPE_KAMPFRICHTER |
Rollentyp-Name (NAME) |
bei neuen Typen | Name des Rollentyps. Auch erlaubt: Rollentyp-Name, Name. |
Kampfrichter |
Gelöscht (DELETED) |
nein | Ja/Nein. Auch erlaubt: Gelöscht. |
nein |
Reihenfolge (VIEW_ORDER) |
nein | Zahl für die Sortierung. Auch erlaubt: Reihenfolge. |
30 |
Filter (FILTER) |
nein | Filterangabe. Eine leere Zelle löscht den Wert. Auch erlaubt: Filter. |
|
Hat Kalender-Menüeintrag (HAS_CALENDAR) |
nein | Ja/Nein. Auch erlaubt: Kalender. |
nein |
Ablauf-Erinnerung aktiv (HAS_REMINDER) |
nein | Ja/Nein. Auch erlaubt: Ablauf-Erinnerung. |
ja |
Benötigt Kategorie (REQUIRE_CATEGORY) |
nein | Ja/Nein | nein |
Benötigt Produkt (REQUIRE_PRODUCT) |
nein | Ja/Nein | nein |
Enddatum aus Person übernehmen (COPY_PERSON_END_DATE) |
nein | Ja/Nein | nein |
Mindestdauer (Tage) (MIN_DURATION) |
nein | Zahl. Eine leere Zelle löscht den Wert. Auch erlaubt: Mindestdauer. |
30 |
Access-Tag aus Kategorie / Sparte übernehmen (USE_ACCESS_TAG_FROM_CATEGORY) |
nein | Ja/Nein | nein |
Passive Rolle / Funktion ignorieren (ACCESS_TAG_SKIP_PASSIVE) |
nein | Ja/Nein | nein |
Fehlende Abrechnungskonto-Verknüpfung ignorieren (ACCESS_TAG_IGNORE_MISSING_COMPANY) |
nein | Ja/Nein | nein |
Import-Feldname (IMPORT_FIELD_NAME) |
nein | Text. Eine leere Zelle löscht den Wert. | |
Darf eigene Verfügbarkeiten anlegen (ALLOW_OWN_AVAILABILITY) |
nein | Ja/Nein | nein |
Eine fehlende oder leere optionale Spalte lässt den bisherigen Wert stehen.
Beispiel
Die technische Datei mit den Spaltennamen des Imports:
LOG_BOOK_ENTRY_TYPE_IDENTIFIER,NAME,DELETED,VIEW_ORDER,FILTER,HAS_CALENDAR,HAS_REMINDER,REQUIRE_CATEGORY,REQUIRE_PRODUCT,COPY_PERSON_END_DATE,MIN_DURATION,USE_ACCESS_TAG_FROM_CATEGORY,ACCESS_TAG_SKIP_PASSIVE,ACCESS_TAG_IGNORE_MISSING_COMPANY,IMPORT_FIELD_NAME,ALLOW_OWN_AVAILABILITY
,Übungsleitung,nein,10,,nein,nein,nein,nein,nein,,nein,nein,nein,,nein
,Vorstand,nein,20,,nein,nein,nein,nein,nein,,nein,nein,nein,,nein
LOG_CONTENT_TYPE_KAMPFRICHTER,Kampfrichter,nein,30,,nein,ja,nein,nein,nein,30,nein,nein,nein,,nein
Beispieldateien: rollentypen-beispiel_technisch.csv mit den technischen Spaltennamen, rollentypen-beispiel_anwender.csv mit den deutschen Spaltennamen.
Die ersten beiden Zeilen haben keine ID. vynst legt die Rollentypen an und bildet die ID aus dem Namen, also LOG_CONTENT_TYPE_UEBUNGSLEITUNG und LOG_CONTENT_TYPE_VORSTAND. Die dritte Zeile nennt ihre ID selbst.
So geht’s
- Öffnet Einstellungen → Import.
- Klickt auf Hinzufügen und wählt die Datei aus.
- Lest das Protokoll. Die Zeile
Readfasst die Ergebnisse zusammen. - Korrigiert Zeilen mit Fehlern und importiert nur diese erneut.
Gut zu wissen
- Mit ID sucht vynst den Typ über diese ID, ohne Unterschied bei Groß- und Kleinschreibung.
- Ohne ID sucht vynst den Typ über den Namen. Ein gelöschter Typ wird dabei nur gewählt, wenn kein aktiver mit dem Namen existiert. Steht in
DELETEDnichts, wird er wieder aktiv. - Ein neuer Typ ohne ID bekommt die ID
LOG_CONTENT_TYPE_und den Namen in Großbuchstaben. Umlaute werden umgeschrieben, Sonderzeichen werden zu_. Ist die ID vergeben, hängt vynst_2,_3und so weiter an. - Unbekannte Ja/Nein-Werte und ungültige Zahlen lassen den bisherigen Wert stehen und erscheinen als Warnung im Protokoll.
- Die Zeilennummer im Protokoll zählt nur die Zeilen mit Inhalt. Leere Zeilen werden nicht gezählt.
- Zugriffs-Tags und die Zusatzangaben zu Rollen sind nicht Teil dieser Datei. Dafür gibt es die Datei „Zusatzangaben zu Rollen“.
Wenn etwas nicht klappt
| Meldung im Protokoll | Bedeutung | Was tun |
|---|---|---|
Error: line N skipped - a new role type needs a name |
Ein neuer Typ hat keinen Namen. | Name ergänzen. |
Error: line N skipped - id longer than 190 characters |
Die ID ist zu lang. | ID kürzen. |
Error: invalid csv file - … |
Die Datei lässt sich nicht lesen, etwa weil die Kopfzeile Spalten doppelt hat. | Kopfzeile prüfen. |
Warning: line N: unknown yes/no value "…" in column … - value kept |
Ein Ja/Nein-Wert ist unbekannt. Der Wert bleibt. | Ja oder Nein eintragen. |
Warning: line N: invalid number "…" in column … - value kept |
Eine Zahl ist ungültig. Der Wert bleibt. | Eine ganze Zahl eintragen. |
Line N: created role type … |
Information: Ein neuer Typ wurde angelegt. | Nichts. |
Line N: reactivated deleted role type … |
Information: Ein gelöschter Typ ist wieder aktiv. | Prüfen, ob das gewollt ist. |
Error: less then one line |
Keine Datenzeile. | Kopfzeile und Inhalt prüfen. |
FAILED: No matching processor found. |
Die erste Spalte ist keine Rollentyp-ID oder die Namensspalte fehlt. | Kopfzeile prüfen. |
Siehe auch
- Zusatzangaben zu Rollen
- Mitgliedschaften