====== Basis - iProt Butler ======
Schnittstelle zur Protokoll Software iProt [[https://iprot.info|]].

Die Informationen zur [[https://iprot.info/cms/tips-tricks/api-zum-datenaustausch-mit-untermstrich/|API zum Datenaustausch mit untermStrich von iPROT finden Sie hier]].

===== Installation des Butlers =====
Butler-Zip Datei in der Konfiguration hochladen.
{{ :de:flink2go:f2g_zip_hochladen.png?800 |}}

===== iProt Projekte in untermStrich verwalten =====
Über Konfiguration :vor: Projekte :vor: Zusatzdaten-Projekte muss ein neues Zusatzdatenfeld vom Typ **„Passwort“** erstellt werden. Über diesen Typ können Daten verschlüsselt in der Datenbank gespeichert werden. Diese Daten werden nirgendwo angezeigt (Auswertungen etc.). Sie können ausschließlich über eine Schaltfläche in die Zwischenablage kopiert werden.
{{ :de:iprot_butler_config.png?1000 |}}

In diesem Zusatzdatenfeld wird dann im Modul Projekte der jeweilige iProt Projekttoken gespeichert.

{{ :de:iprot_butler_token.png?800 |}}

===== iProt Butler konfigurieren =====
Vor der Verwendung muss der Butler in den Einstellungen :wartung: konfiguriert werden:
{{ :de:iprot_butler_config2.png?600 |}}

Bei **„Zusatzdatenfeld für iPROT Token“** muss das gewünschte Zusatzdatenfeld ausgewählt werden, dass den iProt Projekttoken enthält. Diese Einstellung ist global für alle Butlerinstanzen gültig.

{{ :de:iprot_butler_config3.png?600 |}}

Der Butler zeigt alle untermStrich Projekte die einen iProt Projekttoken besitzen. Zu diesen Projekten wird auch die Projektinformation von iProt (Projektname und Nummer) dargestellt.
Über dies Sync-Symbol :up: können die beim Projekt beteiligten Adressen als BenutzerInnen an iPROT übermittelt werden.

{{ :de:iprot_butler_config4.png?600 |}}

Übernommen werden dabei:
  * Interne untermStrich ID :vor: id
  * Vorname:vor: Vorname
  * Ansprechpartner + ev. Mastertitel :vor: Nachname
  * E-Mail  
  * Firma / Name :vor: Company
Optional:
  * Telefon 1 :vor: Telefonnummer
  * Anrede
  * Titel
<wrap round important 20%>
Die Felder „Vorname“, „Ansprechpartner“, „Firma / Name“ und „E-Mail“ sind dabei Pflicht. Sind diese in untermStrich nicht befüllt, kann die Adresse nicht an iProt übertragen werden. Der Butler gibt für diese Fälle aber eine entsprechende Info aus:
</wrap>

{{ :de:iprot_butler_important.png?800 |}}

Adressen die einmal übertragen wurden, können über die API aktuell nicht aktualisiert werden. Zur Erkennung ob eine Adresse schon existiert nutzt iPROT aktuell offenbar die Kombination aus Vorname und Nachname, leider nicht die ID. Wenn sich daher bei einer Adresse in untermStrich Vor- oder Nachname ändert wird dieser BenutzerIn iPROT neu angelegt.