Mit diesem Formular können Sie fehlende, unklare oder fehlerhafte Inhalte in der Dokumentation melden und Verbesserungsvorschläge machen. Ihr Feedback hilft uns, die Qualität und Vollständigkeit kontinuierlich zu verbessern.
Grundeinrichtung
Hinweis
Grundvoraussetzung für die Verwendung der Schnittstelle ist die Bereitstellung des Fundraisning Proxys durch die Infrastruktur der GOB.
Öffnen Sie über die Suche "Fundraising Schnittstelle Einrichtung". Im Reiter "Allgemein" geben Sie den Standard-Verkäufercode für Daten, die über die Fundraising Schnittstelle importiert wurden, an. Unter "Logging" aktivieren Sie den Schalter "Logging aktivieren" und geben Sie einen "Logging Protokollartcode" an.
Logging
Das Logging protokolliert alle Aktivitäten, die den Import und die Datenverarbeitung betreffen. Dabei werden u. a. Fehler festgehalten, wenn importierte Daten nicht für valide gehalten werden oder Verarbeitungsbausteine nicht fehlerfrei verarbeitet wurden.
Die Protokolle können Sie an dieser Stelle einsehen, indem Sie in dem Drilldown-Menü "Aus vollständiger Liste auswählen" klicken und die Datensätze der "Offenen Protokollköpfe" öffnen.
In der Liste "Fundraising Schnittstelle Log" finden Sie alle relevanten Informationen zur Protokollierung, z. B. die Anzahl der verarbeiteten Zeilen oder, ob ein Fehler aufgetreten ist (Protokollart: Fehler). Sofern Sie auf die "Anzahl Zeilen" klicken, öffnen Sie die Protokollzeilen. Den Zeilen können Sie Meldungen entnehmen oder ablesen, welche Verarbeitungsbausteine an diesem Datensatz ausgeführt wurden. Die Meldungen geben darüber Aufschluss, ob ein Verarbeitungsbaustein mithilfe der Rohdaten erfolgreich durchgeführt werden konnte.
Hinweis
In einem Datensatz erkennt man immer ausschließlich den zuletzt erkannten Fehler.
Standardeinrichtung FundraisingBox
In der "Fundraising Schnittstelle Einrichtung" können Sie mithilfe einer Aktion eine Standardeinrichtung erstellen. Dieses Konfigurationspaket ist speziell für die "FundraisingBox" implementiert. Hier wird die Partner-ID für den technischen Austausch, der Name und ein Kanal eingetragen. Wählen Sie dazu in der Navigation "Aktionen" und den gleichnamigen Menüpunkt. Bestätigen Sie die Erstellung mit "Ja". In der Liste "Fundraising Schnittstellenpartner", welche Sie über den Menüpunkt "Zugehörig" aufrufen, ist jetzt automatisch ein Datensatz hinzugefügt worden.
Fundraising Schnittstelle Log
Um das Logging zu öffnen, klicken Sie in der Einrichtung auf den Menüpunkt "Zugehörig" und "Fundraising Schnittstelle Log". Hierbei handelt es sich um die gleiche Liste, wie Sie diese bereits in den ersten Punkten der Grundeinrichtung aufgerufen haben. Sie finden hier alle relevanten Informationen zur Protokollierung, z. B. die Anzahl der verarbeiteten Zeilen oder, ob ein Fehler aufgetreten ist (Protokollart: Fehler).
Sofern Sie auf die "Anzahl Zeilen" klicken, öffnen Sie die Protokollzeilen. Den Zeilen können Sie Meldungen entnehmen oder ablesen, welche Verarbeitungsbausteine an diesem Datensatz ausgeführt wurden. Die Meldungen geben darüber Aufschluss, ob ein Verarbeitungsbaustein mithilfe der Rohdaten erfolgreich durchgeführt werden konnte.
Fundraising Schnittstellenpartner einrichten
Wählen Sie in der Einrichtung die Menüpunkte "Zugehörig" und "Fundraising Schnittstellenpartner". In dieser Liste legen Sie Ihre Partner an.
Vergeben Sie einen nummerischen oder sprechenden Code, fügen Sie eine Beschreibung und einen Namen hinzu.
In Absprache mit dem Schnittstellenpartner erhalten Sie eine eindeutige ID, welche Sie in das Feld "ID" eintragen. Diese ist technisch für den Austausch der Daten notwendig.
In der Tabelle finden Sie ebenso die Spalte namens "Kanäle". Mithilfe der "Kanäle" wird die Herkunft der Daten klassifiziert, z. B., ob Ihre Daten über einen Partner automatisch verarbeitet werden dürfen oder erst geprüft und anschließend manuell verarbeitet werden sollen.
Daten-Mapping
Das Daten-Mapping bezeichnet das Verknüpfen von Informationen unterschiedlicher Datenbanken, denn Feldinhalte in der Datenbank Ihrer Partner sind oftmals anders betitelt als Ihre eigenen. Um die Daten korrekt zuordnen zu können, müssen diese Informationen im System zugeordnet werden.
Ausgehend von der Liste "Fundraising Schnittstellenpartner" rufen Sie über "Zugehörig" die "Wertezuordnungen" auf.
Wählen Sie aus dem Drilldown-Menü den zu verknüpfenden Typ aus:
- Anredecode
- Titel
- Zahlungsformcode
- Produktcode
- Aktionscode
- Mittelverwendungscode
Die Feldnr. wird nach der Auswahl des Typs automatisch eingetragen.
Im Quellwert geben Sie den Feldinhalt der Partner-Datenbank ein. Im Zielwert geben Sie hingegen den Wert der eigenen Datenbank ein. Bei der Verarbeitung werden die Zielwerte in die Datensätze übernommen und ersetzen die Quellwerte des Partners.
Hinweis
Beim Transport der Rohdaten in den Schnittstellen Puffer wird das Mapping sofort übersetzt.
Fundraising Schnittstellenkanäle
Mithilfe der "Fundraising Schnittstellenkanäle" klassifizieren Sie die Herkunft der Daten. Mit den Kanälen unterscheiden Sie als Beispiel, ob die Daten eines Partners automatisch verarbeitet werden dürfen und auch, welche Daten verarbeitet werden sollen (Adressverwendung definieren).
Hinweis
Es ist möglich, dass mehrere Partner denselben Kanal nutzen.
Wählen Sie in der "Fundraising Schnittstelle Einrichtung" die Menüpunkte "Zugehörig" und "Fundraising Schnittstellenkanäle". In dieser Liste legen Sie Ihre Kanäle an.
Um einen neuen Kanal anzulegen, befüllen Sie die Zeilen. Ergänzen Sie einen Code und eine Beschreibung.
Ergänzen Sie einen Adressverwendungscode. Dieser gibt den Standard-Adressverwendungscode des Schnittstellenkanals an.
Kanal einem Partner zuweisen/einsehen
Um einem Partner einen Kanal zuzuordnen, rufen Sie die "Fundraising Schnittstellenpartner” über die Navigation auf. Wählen Sie in der Einrichtung die Menüpunkte "Zugehörig" und "Kanäle".
In der Liste "Fundraising Schnittstellenpartnerkanäle" tragen Sie einen "Schnittstellenkanal Code" ein.
Über den Rohdatenimport ist "Standard" vorgegeben.
De-/aktivieren Sie die "automatische Verarbeitung", wenn Sie möchten, dass Verarbeitungsbausteine (nicht) automatisch durchgeführt werden sollen.
Kontaktverarbeitung einrichten
Definieren Sie mit der Kontaktverarbeitung Vorgabewerte eines Kontaktes und entscheiden Sie, ob Kontakte beim Import automatisch aktualisiert werden sollen.
Rufen Sie in der "Fundraising Schnittstelle Einrichtung" über "Zugehörig" die "Kontaktverwaltung Einrichtung" auf.
Aktivieren Sie den Schalter "Vorhandene Kontakte aktualisieren", um die Kontakte, die bereits in Ihrer Datenbank vorhanden sind, automatisiert beim Import zu aktualisieren.
Die Vorgabewerte für neue Kontakte können Sie wie folgt festlegen. Entscheiden Sie über die Adressart für Personen und Unternehmen oder wie Sie den Kontakt anreden möchten. Die Anreden können Sie hier aus der vollständigen Liste aufrufen.
Unter dem Menüpunkt "Adressverwendungen" definieren Sie, wie die Adressen weiterverarbeitet werden und welche Verarbeitungsbausteine erfolgen.
Adressverwendung definieren (inkl. Verarbeitungsbausteine)
Die Verarbeitungsbausteine sind eine Abwicklung von automatischen, im Hintergrund ablaufenden, Aktionen zur Überprüfung oder Erstellung von Datensätzen. Diese können Sie in den "Adressverwendungen", je nach Anwendungsszenario, zusammensetzen. Öffnen Sie zunächst die "Fundraising Schnittstellen Einrichtung", wählen Sie "Zugehörig" und "Kontaktverwaltung Einrichtung". Von dort aus rufen Sie ebenfalls über den Menüpunkt "Zugehörig" die "Adressverwendungen" auf.
Vergeben Sie zunächst für eine neue Adressverwendung einen Code und eine Beschreibung.
In dieser Adressverwendung listen Sie alle Verarbeitungsbausteine auf, die ausgeführt werden sollen. Dazu klicken Sie im Menü auf "Zugehörig" und "Verarbeitungsbausteine".
Klicken Sie in das Feld "Verarbeitungsbaustein" und wählen Sie aus dem Drilldown-Menü die passenden Bausteine aus:
Verarbeitungsbaustein Beschreibung Standard Dublettenprüfung Führt die unitop Dublettenprüfung gegen den Kontaktstamm durch. Kontakt erstellen/aktualisieren Erstellt einen neuen Kontakt auf Grundlage der empfangenen Daten. Falls bei der Datenübertragung bereits eine Kontaktnummer angegeben ist, wird stattdessen der bestehende Kontakt aktualisiert. Kommunikationsdaten erstellen Erstellt oder aktualisiert die Kommunikationsdaten für einen Kontakt. Debitor erstellen (nicht fürs Fundraising relevant) Erstellt einen Debitor für einen existierenden Kontakt. Es wird eine Debitorvorlage benötigt, die entweder im Puffer mitgegeben oder über einen Dialog ausgewählt werden kann. Kreditor erstellen (nicht fürs Fundraising relevant) Erstellt einen Kreditor für einen existierenden Kontakt. Es wird eine Kreditorvorlage benötigt, die entweder im Puffer mitgegeben oder über einen Dialog ausgewählt werden kann. Debitorenbankkonto erstellen (nicht fürs Fundraising relevant) Erstellt ein Debitorbankkonto. Kreditorenbankkonto erstellen(nicht fürs Fundraising relevant) Erstellt ein Kreditorbankkonto. Kontaktbankkonto erstellen Erstellt ein neues Bankkonto für den Kontakt, wenn die Kontoverbindung nicht existiert. Spender erstellen Erstellt einen Spender auf Grundlage eines bereits vorhandenen Kontaktes. Spenderprodukt und Mandat erstellen Erstellt ein neues Spenderprodukt und ein Mandat für den Kontakt. Spenderprodukt aktualisieren Aktualisiert ein Spenderprodukt. Im Feld "Reihenfolge" bestimmen Sie, in welcher Reihenfolge die Bausteine ausgeführt werden. Tragen Sie dazu manuell einen nummerischen Wert ein. Die Beschreibung wird automatisch gefüllt.
Mit der Zusammenstellung der Verarbeitungsbausteine legen Sie fest, ob z. B. nur Kontaktdaten, optional mit Dublettenprüfung und Kommunikationsdaten verarbeitet werden sollen. Oder aber zusätzlich auch Spendendaten. In den "Fundraising Schnittstellenpartnerkanälen" tragen Sie die für den Partner und Kanal den Adressverwendungscode ein.