Zum Inhalt springen
Developer

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 .csv enthalten.
  • Erste Spalte: Die Rollentyp-ID steht in der ersten Spalte. Ihre Position ist Pflicht. Die Zelle darf bei neuen Typen leer sein.
  • Namensspalte: Rollentyp-Name oder NAME. 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

  1. Öffnet Einstellungen → Import.
  2. Klickt auf Hinzufügen und wählt die Datei aus.
  3. Lest das Protokoll. Die Zeile Read fasst die Ergebnisse zusammen.
  4. 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 DELETED nichts, 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, _3 und 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