ACHTUNG!
Die Download-Links wurden überarbeitet und bieten neue Funktionen sowie zusätzliche Sicherheitsmaßnahmen.
Worum es geht
Unter Einstellungen / Tokens kann die Funktion Download-Link aktiviert werden. Mit Download-Links ist es möglich, Akten-Stammdaten als CSV-Dateien herunterzuladen.
Was sind CSV-Dateien?
- CSV-Dateien sind Textdateien, die maschinell verarbeitet werden können.
- Sie sind kompatibel mit Programmen wie OpenOffice, Numbers oder Excel.
- CSV-Dateien dienen häufig dem Datenaustausch zwischen Programmen, z. B. für Newsletter-Tools.
Filterung
Du hast die Wahl, alle Akten oder nur gefilterte Akten (mit einem bestimmten Merkmal) über den Download-Link herunterzuladen.
Merkmalsbasierte Filterung: In den Einstellungen der Akten-Merkmale kann jedem Merkmal eine Download-Referenz zugewiesen werden, die als Filter dient.
Sicherheit
Download-Links bieten einen Download der Stammdaten an. Damit so ein Download nicht unbeabsichtigt eingeschaltet werden kann, haben wir drei Sicherheitshebel eingerichtet, die du umschalten musst. Ein Download-Link sollte vertraulich behandelt und nicht veröffentlicht werden.
Token
Der Download-Link Token muss eingeschaltet werden. Der Token kann jederzeit "aktualisiert" werden - dann wird der aktuell gültige Token durch einen neuen ausgetauscht. Download-Links, die den alten Token noch nutzen, funktionieren nicht mehr. Das Aktualisieren eines Tokens sollte immer dann genutzt werden, wenn der Verdacht besteht, der Link könnte veröffentlicht (geleakt) worden sein.
Zu exportierende Datenfelder
In den Token-Parameter muss eingerichtet werden welche Daten exportiert werden sollen.
Aktuell sind folgende Daten für den Export vorgesehen:
export: email,firstname,lastname,address,invaddress
Wichtiger Hinweis: Wenn keine Export-Felder eingetragen werden, enthält die CSV-Datei lediglich die Akten-Nr. Durch diese explizite Freigabe der zu exportierenden Informationen wird sichergestellt, dass die Datenmenge bewusst und gezielt festgelegt wird.
Das schützt vor ungewolltem Export sensibler Daten und gibt dir volle Kontrolle über die Inhalte.
Freigabedatum
Ebenfalls in den Token-Parameter muss das Datum der letzten Freigabe eingetragen werden:
lastreviewed: 2024-12-31
Eine Freigabe ist maximal 90 Tage gültig. Sobald das eingetragene Datum älter als 90 Tage ist, wird der Download deaktiviert. Diese Sicherheitsmaßnahme soll sicherstellen, dass ein Link nicht "vergessen" wird und für immer und ewig online verfügbar bleibt. Spätestens vor Ablauf der Freigabe muss ein neuer Freigabedatum eingetragen werden.
Link zusammenstellen
Die letzte Hürde besteht darin, einen gültigen Link zusammenzustellen. ;)
Ein Download-Link besteht aus einer Basis-URL, dem Download-Link Token und optional ein oder mehr Parameter.
https://api.lemniscus.de/mvc/downloadlink/TOKEN
TOKEN muss durch dein Download-Link Token ersetzt werden.
Nach dem Token können eines oder mehr Parameter aus der folgenden Liste angegeben werden. Das erste Parameter einer URL muss mit einem "?" hinzugefügt werden, folgende Parameter werden mit einem "&" eingeleitet.
Folgende Parameter sind erlaubt und allesamt optional. Wenn kein Parameter angegeben wird, werden alle Datensätze im CSV Format exportiert.
Parameter | Bedeutung | Inhalt |
exportRef | Datensätze auf einen Merkmal beschränken. | Export Referenz aus dem Merkmal |
query | Suchbegriff, nachdem gesucht werden soll. | Suchbegrif, URL-Encoded |
format | Ausgabeformat | JSON oder CSV |
Ein Download-Link könnte wie folgt aussehen:
https://api.lemniscus.de/mvc/downloadlink/AAAA-BBBB-CCCC-DDDD?format=JSON&query=Mustermann&exportRef=NEWSL
Rundmails verschicken
lemniscus bietet keine integrierte Rundmailfunktionalität an. Der Newsletter-Versand unterliegt strengen rechtlichen Anforderungen, und die Umsetzung dieser überlassen wir spezialisierten Anbietys.
CSV-Export für Newslettertools
Mit lemniscus kannst du Akten-Stammdaten über die Download-Links als CSV-Dateien exportieren und in fast allen gängigen Newslettertools importieren.
Mehr dazu unter Newsletter, Rundmails an Klientys & Co.
Wichtiger Hinweis: lemniscus speichert keine Informationen über Abmeldungen von deinem Newsletter. Wir bekommen es nicht mit, wenn sich ein Empfängy direkt im Newsletter-Tool abmeldet. Damit du keine abgemeldeten Kontakte erneut anschreibst, musst du Austragungen in lemniscus manuell nachpflegen – dafür empfehlen wir den Einsatz eines Akten-Merkmals.
Hinweise zu Newslettertools
Wir haben nicht alle Tools getestet, aber in der Regel unterstützen sie den Import von Kontaktdaten via CSV-Dateien.
Direkte Verknüpfung mit Tools
Manche Anbietys bieten die Möglichkeit, Daten direkt über eine URL zu importieren (zum Beispiel Cleverreach).
Hierfür kannst du die lemniscus-Download-Links verwenden. Schau dir die Hilfeseiten deines bevorzugten Tools an oder kontaktiere deren Support, um zu prüfen, ob dies unterstützt wird.