mirror of
https://github.com/OpenXE-org/OpenXE.git
synced 2024-11-15 04:27:14 +01:00
47 lines
8.4 KiB
Plaintext
47 lines
8.4 KiB
Plaintext
<strong><span style="font-size:28px;">snapADDY</span></strong><br /> <pre>
|
|
</pre>Mit dem Adress-Grabber von <a href="https://www.snapaddy.com/de/snapaddy-grabber/adress-grabber.html">snapADDY</a> können Kontaktdaten einfach und schnell aus digitalen Texten extrahiert werden. Zum Beispiel können Adressen aus E-Mailsignaturen, PDF-Dokument oder Webseiten erfasst werden.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=snapaddy&fileid=9" /><br /><br />Mit dem neuen snapADDY Modul von Xentral lassen sich diese Adressen ganz einfach importieren.<h1><br />Adressen Importieren und Anlegen</h1>Sie finden das Modul snapADDY in unserem AppStore.<br /><br />Für die Verbindung mit snapADDY wird ein gültiger API Token benötigt. Dieser kann in den Profilinformationen unter <a href="https://app.snapaddy.com/profile-update">https://app.snapaddy.com/profile-update</a> in der Sektion API Token gefunden werden.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=snapaddy&fileid=10" /><br /><br />Dieser Token muss in den Einstellungen im Feld API Key hinterlegt werden. Vor dem Speichern kann der Schlüssel mit einem Klick auf API Key testen überprüft werden. Mit einem gültigen Token kann Xentral alle bei snapADDY hinterlegten Adressen importieren.<br /><br /><br />Mit dem Importieren-Button werden alle bei snapADDY gespeicherten Adressen importiert. Dieser Vorgang kann einige Zeit in Anspruch nehmen. Ist dieser Vorgang abgeschlossen, wird die Seite neu geladen. Die Adressen sind nun für die weitere Verarbeitung gelistet:<br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=snapaddy&fileid=11" /><br /><br />Mittels einer <strong>Stapelverarbeitung</strong> lassen sich <strong>mehrere Adressen direkt als Kunde oder Lieferant anlegen.</strong><br /><br />Die Datensätze können auch <strong>einzeln als Adresse angelegt </strong>werden. Anschließend öffnet sich die Seite der neuen Adresse. Dort lassen sich die entsprechenden Rollen (Kunde, Lieferant, Mitarbeiter oder Lead) zuweisen. Alternativ lassen sich die Adressen auch einzeln aus der Liste löschen.<h1>Den Direktimport einrichten</h1>Neben dem oben vorgestellten Ablauf lassen sich einzelne Adressen auch direkt aus dem Browser PlugIn nach Xentral importieren. Der direkte Import wird nur bei verschlüsselten Verbindungen (https) empfohlen. Hierfür stellt das snapADDY Modul einen <strong>Authorization-Header </strong>sowie eine URL als Endpoint bereit.<br /><br />Diese Werte müssen komplett und unverändert im Dashboard von snapADDY in den Zentralen snapADDY Einstellungen unter <a href="https://app.snapaddy.com/login?redirect_url=%252Fadmin-change-settings">app.snapaddy.com/admin-change-settings</a> eingetragen werden.<br /><br />In der Sektion <strong>Integrationseinstellungen</strong> unter <strong>Sonstige Integrationen</strong> gibt es den Link zu den API Einstellungen.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=snapaddy&fileid=12" /><br /><br />Mit einem Klick darauf öffnet sich ein Fenster mit den <strong>snapADDY API Einstellungen</strong> in welchem der <strong>Authorization-Header</strong> sowie die gegebene URL hinterlegt werden müssen. Die HTTP-Methode muss auf <strong>POST</strong> gestellt werden.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=snapaddy&fileid=13" /><br /><br />Mit einem Klick auf <strong>Speichern</strong> werden die getätigten Einstellungen bei snapADDY gespeichert. Sie müssen noch <strong>im Browser-PlugIn</strong> aktualisiert werden.<br /><br />Dazu gibt es in den Einstellungen des Browser-PlugIns unter <strong>Support & Hilfe </strong>den Button<strong> Einstellungen aktualisieren</strong>. Mit einem Klick darauf werden die im Dashboard von snapADDY getätigten Einstellungen ins Browser-PlugIN geladen. Nun steht der Direktimport bereit.<h2>Der Direktimport</h2>Im Browser-PlugIn kann nun durch einen Klick auf das snapADDY Logo in der jeweiligen Adress-Zeile der Direktimport angestoßen werden.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=snapaddy&fileid=14" /><br /><br />Direkt nach dem erfolgreichen Import öffnet Xentral in einem neuen Fenster die Seite der neu angelegten Adresse. Dort lassen sich die entsprechenden Rollen zuweisen.<h2>Direktimport als Kunde, Lieferant oder Lead</h2>Alternativ dazu lassen sich auch im Browser-PlugIn die gewünschten Rollen zuweisen. Dazu müssen im Dashborad von snapADDY weitere Einstellungen getätigt und im PlugIn erneut aktualisiert werden.<br /> <h1>Im Dashboard</h1> Im Dashboard von snapADDY unter <strong>Firmen-Einstellungen</strong> und <strong>CRM-Mapping konfigurieren</strong> lassen sich zusätzliche Felder in das Browser-PlugIn integrieren. Dies geschieht durch eine Konfigurationsdatei im JSON-Format.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=snapaddy&fileid=15" /><br /><br />Mit den nachfolgenden Zeilen wird ein neues Drop-Down Menu mit der Bezeichnung <strong>Typ</strong> eingefügt. Die neue Konfiguration muss mit einem Klick auf <strong>Revision aktivieren</strong> aktiviert werden. Der folgende Code ermöglicht die Vorauswahl einer Adresse als Kunde, Lead oder Lieferant. Diese Einstellung wird durch das Modul in Xentral ausgewertet und der Adresse beim Import die entsprechende Rolle zugewiesen. Für komplexere Mappings oder falls dieses Feld in eine bestehende Konfiguration integriert werden soll, kontaktieren Sie bitte den Support von snapADDY - für die entsprechende Integration auf Seiten Xentrals wenden Sie sich dann bitte an den Xentral-Support.<br /><br /><code><code>{</code></code><pre><code><code> "customFields": [
|
|
{
|
|
"type": "SELECT",
|
|
"id": "c_address_type",
|
|
"label": {
|
|
"DE": "Typ",
|
|
"EN": "Type"
|
|
},
|
|
"properties": {
|
|
"defaultValue": "",
|
|
"options": [
|
|
{
|
|
"label": {
|
|
"DE": "Bitte wählen",
|
|
"GB": "Please choose"
|
|
},
|
|
"value": ""
|
|
},
|
|
{
|
|
"label": {
|
|
"DE": "Kunde",
|
|
"GB": "customer"
|
|
},
|
|
"value": "customer"
|
|
},
|
|
{
|
|
"label": {
|
|
"DE": "Lieferant",
|
|
"GB": "vendor"
|
|
},
|
|
"value": "vendor"
|
|
},
|
|
{
|
|
"label": {
|
|
"DE": "Lead",
|
|
"GB": "Lead"
|
|
},
|
|
"value": "lead"
|
|
}
|
|
]
|
|
}
|
|
}
|
|
],
|
|
"integrations": {},
|
|
"layout": {}
|
|
</code></code></pre><code><code> } </code><br /> </code><h1><code>Im Browser-PlugIn</code></h1><p>Nachdem die Einstellungen im Browser-PlugIn aktualisiert wurden, steht das zusätzliche Feld zur Verfügung:</p><br /><code><code><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=snapaddy&fileid=16" /></code></code><p>Über das neu angelegte Auswahlfeld kann nun <strong>direkt im PlugIn</strong> gewählt werden, ob die Adresse <strong>als Kunde, Lieferant oder Lead</strong> importiert werden soll. Die hier getroffene Auswahl wird nur beim Direktimport oder Einzelimport beachtet.<br /> </p><h1>Anwendungstipp</h1><p>In beiden oben beschriebenen Fällen unterstützt Xentral einen SnapADDY-Account, der Daten in Xentral einspielen kann. Sollen mehrere Accounts von SnapADDY in einer Xentral-Instanz verwendet werden kann dies durch Anlegen mehrerer benutzerspezifischer Authorization-Header umgesetzt werden. Dazu muss SnapADDY die entsprechende Zahl von Profilen / Organisationseinheiten bereitstellen, die dann jeweils gegen einen Benutzeraccount gematched werden können.></p> |