4.1.10. cludes Connect

Die Installation des cludes Connect Addons ist mit wenigen Handgriffen erledigt. Das Addon kann bequem dem bestehenden GREYHOUND-Vertrag hinzugebucht werden. Der GREYHOUND Server und die Clients installieren das Addon dann vollautomatisch.

Achtung! Für die Verwendung des cludes Connect-Addons ist eine GREYHOUND-Version 4.2.7 build 1642 oder höher notwendig. Eine gegebenenfalls installierte frühere Erweiterung sollte über den Client unter Funktionen > Erweiterungen entfernt werden, damit es beim Anwender nicht zu Verwechslungen kommt.

Perma Link1. cludes Connect dem GREYHOUND Vertrag hinzubuchen

Das Produkt Addon cludes Connect im GREYHOUND Control Center (GCC) dem bestehenden Vertrag hinzubuchen:

Wichtig: Kunden im Eigenbetrieb müssen die Verwendung des gebuchten Addons zusätzlich im GREYHOUND Admin aktivieren (-> Anleitung siehe hier). Außerdem sind die Funktionen des neuen Addons erst nach einem Neustart des GREYHOUND Clients verfügbar.

Damit Daten aus cludes in GREYHOUND angezeigt werden können, muss in cludes eine Schnittstelle hinzugefügt werden. Dies kann nur der cludes Support erledigen - Kunden müssen sich also an den Kundenservice von cludes wenden mit der Bitte, eine neue, aktive Schnittstelle vom Typ "cludes_api" für GREYHOUND inkl. Secret-Key anzulegen. Der Name der Schnittstelle sollte "Cludes API" sein.
Sobald die Schnittstelle angelegt ist, klickt man im cludes Backend auf Verwaltung und dann bei Schnittstellen auf Optionen und hier auf Anzeigen. Hier sollte nun eine Schnittstelle namens "Cludes API" zu sehen sein.
Mit einem Klick auf den Namen der Schnittstelle wählt man diese nun aus. Der hier angezeigte Secret-Key wird gleich für die Einrichtung des Addons im GREYHOUND Client benötigt.

Tipp
Fragt bitte auch beim cludes Support direkt an, wie die korrekte API URL lautet.

Perma Link3. cludes Connect in GREYHOUND einrichten

Standardmäßig ist ein neues Addon immer für alle in GREYHOUND angelegten Benutzergruppen sichtbar. Wir empfehlen, nach der Installation die Sichtbarkeit des cludes Einstellungsdialogs als auch des Addons selber zu konfigurieren. Informationen über Benutzergruppen gibt es an dieser Stelle im Handbuch.

Nachdem das Addon dem Vertrag hinzugebucht wurde, erscheint im GREYHOUND Client ein neuer Menüeintrag Erweiterungen > cludes Connect - Einstellungen. Darin werden einmalig die individuellen Verbindungsdaten zu cludes sowie einige globale Einstellungen konfiguriert. Diese werden im Folgenden Schritt für Schritt beschrieben.

Perma LinkVerbindung


Neben einer optionalen Bezeichnung sind hier die Daten der angelegten Schnittstelle einzutragen. Welche API URL hier einzutragen ist, kann der cludes Support beantworten. Den Secret-Key kann man sich, wie oben beschrieben, aus dem cludes Backend ziehen. Im Feld Empfänger können die E-Mailadressen eingetragen werden, bei denen das Addon in cludes nach Auftragsdaten suchen soll. Sollen alle Mails durchsucht werden, ist der Platzhalter "*" einzugeben. Das Feld darf nicht leer bleiben!

Es ist sinnvoll, bei den Empfängern nur die E-Mail-Adressen einzutragen, an die cludes-Kunden auch Nachrichten schreiben. Beispielsweise "kundenservice@meinefirma.de". So vermeidet man, dass das Addon auch bei eingehenden Lieferanten-E-Mails an einkauf@meinefirma.de unnötig nach Kundendaten in cludes sucht.

  • Präfix für Vorgangsnummern
    Um eingehende Nachrichten zum gleichen cludes-Auftrag automatisch zu einem Vorgang zusammen zu fassen, kann diese Funktion hier aktiviert und das gewünschte Präfix ausgewählt werden.

  • Vorgangsnummern automatisch zuordnen
    Wenn diese Funktion aktiviert ist, werden die Vorgangsnummern von Nachrichten, zu denen ein cludes-Auftrag gefunden wird, automatisch dem Auftrag zugeordnet. Ist die Option deaktiviert, so kann diese Zuordnung nur manuell erfolgen.

  • Feld für Kunden-ID
    Sofern bereits ein Benutzerdefiniertes Feld in GREYHOUND angelegt wurde, kann dieses Feld hier ausgewählt werden. Alternativ kann dieses hier angelegt werden. Sofern keine automatische Kontaktsynchronisierung in GREYHOUND eingerichtet wurde, sind hier keine Angaben notwendig.

  • Schnellzugriff Textbausteine
    Hier kann der Basistextbaustein ausgewählt werden, welcher direkt über das Addon erreichbar sein soll. Damit entfällt das Wechseln des Karteireiters zwischen Addon und Textbausteinen.

  • CC in Auftrags-E-Mail
    Ist diese Option aktiviert, wird beim Beantworten stets eine Kopie der Nachricht in CC an die Mail-Adresse des Kunden gesendet, die im jeweiligen Auftrag hinterlegt ist.

Perma LinkDatenübernahme


Hier hat man die Möglichkeit, Auftragsdaten zu benutzerdefinierten Feldern zuzuordnen. Das Addon befüllt diese benutzerdefinierten Felder dann mit den abgerufenen Daten. Weitere Infos siehe hier.

Hinweis
Um neue Daten hinzuzufügen, muss man nach dem Ausfüllen der Felder auf das grüne Plus-Icon auf der rechten Seite klicken. Das gilt auch für die nachfolgenden Reiter.

Perma LinkVorschauzeile


In diesem Reiter können die Daten festgelegt werden, die in der Vorschauzeile angezeigt werden - hier kann also jeder individuell festlegen, welche Daten er bereits beim ersten Klick auf eine Kundenanfrage sehen möchte. Hier sollte man die Auftrags- und Kundeninformationen aus cludes wählen, die in der Regel ausreichen, um einen Vorgang schnell und kompetent beantworten zu können.

Perma LinkTracking


Ordnet das Addon einer Paketnummer den falschen (oder gar keinen) Link zu, so können hier die Links zur Sendungsverfolgung für einzelne Nummernkreise hinterlegt werden. Für Paketnummern, die mit dem angegebenen Nummernkreis beginnen, wird dann der angegebene Versanddienstleister angezeigt und die Tracking-URL als Link verwendet. In der Tracking-URL wird die Variable "[$Nr]" durch die Paketnummer des jeweiligen Auftrags ersetzt.

Perma LinkErweitert

  • Timeout
    Bei besonders großen cludes-Systemen kann es notwendig sein, den Timeout-Wert anzuheben, damit Verbindungsdaten angezeigt werden.

  • Debug-Modus
    Zu besseren Fehleranalyse kann der Debugmodus aktiviert werden. Damit werden dann detailliertere Informationen bei Problemen angezeigt. Zusätzlich wird damit eine Option aktiv, mit der Informationen direkt an den GREYHOUND Kundenservice gesendet werden können.

Sind alle Daten korrekt hinterlegt, kann man das Addon cludes Connect nutzen. Die Addon-Seitenleiste sieht dann z. B. so aus:

Perma Link4. Variablen für Textbausteine

Beim Beantworten oder Verfassen einer Nachricht über die Buttons in der Seitenleiste des Addons stellt das Addon einige Variablen bereit, die im Text der Nachricht oder in eingefügten Textbausteinen ersetzt werden. Der Inhalt der Variablen hängt von den Auftrags- und Kundendaten ab, die das Addon ermittelt hat. So können z.B. Variablen wie die Lieferanschrift leer sein, wenn in den Auftragsdaten keine separate Lieferanschrift übermittelt wurde. Wie üblich kann die Vorschaufunktion beim Verfassen der Nachricht genutzt werden, um zu überprüfen, durch welche Daten die Variablen ersetzt werden.
Es folgt eine Auflistung der Variablen und ihres Inhalts:
Variable
Beschreibung
[$Order.OrderNumber] Bestellnummer
[$Order.InvoiceNumber] Rechnungsnummer
[$Order.CustomerNumber] Kundennummer
[$Order.Date] Bestelldatum (Tag.Monat.Jahr)
[$Order.DateInfo.D] Bestelldatum (Tag, z.B. "01")
[$Order.DateInfo.M] Bestelldatum (Monat, z.B. "02")
[$Order.DateInfo.Y] Bestelldatum (Jahr, z.B. "2013")
[$Order.DateInfo.Day.DE] Bestelldatum (Tag auf deutsch, z.B. "Montag")
[$Order.DateInfo.Day.EN] Bestelldatum (Tag auf englisch, z.B. "Monday")
[$Order.DateInfo.Day.ES] Bestelldatum (Tag auf spanisch, z.B. "Lunes")
[$Order.DateInfo.Day.FR] Bestelldatum (Tag auf französisch, z.B. "Lundi")
[$Order.DateInfo.Month.DE] Bestelldatum (Monat auf deutsch, z.B. "Januar")
[$Order.DateInfo.Month.EN] Bestelldatum (Monat auf englisch, z.B. "January")
[$Order.DateInfo.Month.ES] Bestelldatum (Monat auf spanisch, z.B. "Enero")
[$Order.DateInfo.Month.FR] Bestelldatum (Monat auf französisch, z.B. "Janvier")
[$Order.DateInfo.Timestamp] Bestelldatum (Unix-Zeitstempel, Sekunden seit 01.01.1970)
[$Order.TotalAmount] Gesamtbetrag des Auftrags inkl. Währung
[$Order.TotalAmountInfo.Value] Gesamtbetrag des Auftrags (Zahl mit Dezimalpunkt)
[$Order.TotalAmountInfo.Currency] Währung des Gesamtbetrags (drei Buchstaben)


[$BillingAddress.Company] Rechnungsanschrift: Firma
[$BillingAddress.Salutation] Rechnungsanschrift: Anrede
[$BillingAddress.Sex.Number] Rechnungsanschrift: Geschlecht ("0" = unbekannt, "1" = männlich, "2" = weiblich)
[$BillingAddress.Sex.Name] Rechnungsanschrift: Geschlecht ("Unbekannt", "Männlich", "Weiblich")
[$BillingAddress.Name] Rechnungsanschrift: Vorname und Nachname
[$BillingAddress.Firstname] Rechnungsanschrift: Vorname
[$BillingAddress.Lastname] Rechnungsanschrift: Nachname
[$BillingAddress.Letter.Identifier] Rechnungsanschrift: Straße, Postleitzahl, Stadt, Land in einer Zeile (komma-getrennt)
[$BillingAddress.Letter.Street] Rechnungsanschrift: Straße und Hausnummer
[$BillingAddress.Letter.AdditionalInfo] Rechnungsanschrift: Zusatzinfo (z.B. Appartment, Etage)
[$BillingAddress.Letter.ZipCode] Rechnungsanschrift: Postleitzahl
[$BillingAddress.Letter.City] Rechnungsanschrift: Stadt
[$BillingAddress.Letter.Country] Rechnungsanschrift: Land
[$BillingAddress.Letter.CountryInfo.ISO2] Rechnungsanschrift: ISO3166 Länderkürzel (zwei Buchstaben)
[$BillingAddress.Letter.CountryInfo.ISO3] Rechnungsanschrift: ISO3166 Länderkürzel (drei Buchstaben)
[$BillingAddress.Letter.CountryInfo.DE] Rechnungsanschrift: Land (deutsche Schreibweise)
[$BillingAddress.Letter.CountryInfo.DE_UC] Rechnungsanschrift: Land (deutsche Schreibweise, Blockbuchstaben)
[$BillingAddress.Letter.CountryInfo.EN] Rechnungsanschrift: Land (englische Schreibweise)
[$BillingAddress.Letter.CountryInfo.EN_UC] Rechnungsanschrift: Land (englische Schreibweise, Blockbuchstaben)
[$BillingAddress.Letter.CountryInfo.ES] Rechnungsanschrift: Land (spanische Schreibweise)
[$BillingAddress.Letter.CountryInfo.ES_UC] Rechnungsanschrift: Land (spanische Schreibweise, Blockbuchstaben)
[$BillingAddress.Letter.CountryInfo.FR] Rechnungsanschrift: Land (französische Schreibweise)
[$BillingAddress.Letter.CountryInfo.FR_UC] Rechnungsanschrift: Land (französische Schreibweise, Blockbuchstaben)
[$BillingAddress.Email] Rechnungsanschrift: E-Mail Adresse
[$BillingAddress.Phone] Rechnungsanschrift: Telefonnummer
[$BillingAddress.Fax] Rechnungsanschrift: Faxnummer
[$BillingAddress.Birthday] Rechnungsanschrift: Geburtsdatum (Tag.Monat.Jahr)
[$BillingAddress.BirthdayInfo.D] Rechnungsanschrift: Geburtsdatum (Tag, z.B. "01")
[$BillingAddress.BirthdayInfo.M] Rechnungsanschrift: Geburtsdatum (Monat, z.B. "02")
[$BillingAddress.BirthdayInfo.Y] Rechnungsanschrift: Geburtsdatum (Jahr, z.B. "2013")
[$BillingAddress.BirthdayInfo.Day.DE] Rechnungsanschrift: Geburtsdatum (Tag auf deutsch, z.B. "Montag")
[$BillingAddress.BirthdayInfo.Day.EN] Rechnungsanschrift: Geburtsdatum (Tag auf englisch, z.B. "Monday")
[$BillingAddress.BirthdayInfo.Day.ES] Rechnungsanschrift: Geburtsdatum (Tag auf spanisch, z.B. "Lunes")
[$BillingAddress.BirthdayInfo.Day.FR] Rechnungsanschrift: Geburtsdatum (Tag auf französisch, z.B. "Lundi")
[$BillingAddress.BirthdayInfo.Month.DE] Rechnungsanschrift: Geburtsdatum (Monat auf deutsch, z.B. "Januar")
[$BillingAddress.BirthdayInfo.Month.EN] Rechnungsanschrift: Geburtsdatum (Monat auf englisch, z.B. "January")
[$BillingAddress.BirthdayInfo.Month.ES] Rechnungsanschrift: Geburtsdatum (Monat auf spanisch, z.B. "Enero")
[$BillingAddress.BirthdayInfo.Month.FR] Rechnungsanschrift: Geburtsdatum (Monat auf französisch, z.B. "Janvier")
[$BillingAddress.BirthdayInfo.Timestamp] Rechnungsanschrift: Geburtsdatum (Unix-Zeitstempel, Sekunden seit 01.01.1970)


[$ShippingAddress.Company] Lieferanschrift: Firma
[$ShippingAddress.Salutation] Lieferanschrift: Anrede
[$ShippingAddress.Sex.Number] Lieferanschrift: Geschlecht ("0" = unbekannt, "1" = männlich, "2" = weiblich)
[$ShippingAddress.Sex.Name] Lieferanschrift: Geschlecht ("Unbekannt", "Männlich", "Weiblich")
[$ShippingAddress.Name] Lieferanschrift: Vorname und Nachname
[$ShippingAddress.Firstname] Lieferanschrift: Vorname
[$ShippingAddress.Lastname] Lieferanschrift: Nachname
[$ShippingAddress.Letter.Identifier] Lieferanschrift: Straße, Postleitzahl, Stadt, Land in einer Zeile (komma-getrennt)
[$ShippingAddress.Letter.Street] Lieferanschrift: Straße und Hausnummer
[$ShippingAddress.Letter.AdditionalInfo] Lieferanschrift: Zusatzinfo (z.B. Appartment, Etage)
[$ShippingAddress.Letter.ZipCode] Lieferanschrift: Postleitzahl
[$ShippingAddress.Letter.City] Lieferanschrift: Stadt
[$ShippingAddress.Letter.Country] Lieferanschrift: Land
[$ShippingAddress.Letter.CountryInfo.ISO2] Lieferanschrift: ISO3166 Länderkürzel (zwei Buchstaben)
[$ShippingAddress.Letter.CountryInfo.ISO3] Lieferanschrift: ISO3166 Länderkürzel (drei Buchstaben)
[$ShippingAddress.Letter.CountryInfo.DE] Lieferanschrift: Land (deutsche Schreibweise)
[$ShippingAddress.Letter.CountryInfo.DE_UC] Lieferanschrift: Land (deutsche Schreibweise, Blockbuchstaben)
[$ShippingAddress.Letter.CountryInfo.EN] Lieferanschrift: Land (englische Schreibweise)
[$ShippingAddress.Letter.CountryInfo.EN_UC] Lieferanschrift: Land (englische Schreibweise, Blockbuchstaben)
[$ShippingAddress.Letter.CountryInfo.ES] Lieferanschrift: Land (spanische Schreibweise)
[$ShippingAddress.Letter.CountryInfo.ES_UC] Lieferanschrift: Land (spanische Schreibweise, Blockbuchstaben)
[$ShippingAddress.Letter.CountryInfo.FR] Lieferanschrift: Land (französische Schreibweise)
[$ShippingAddress.Letter.CountryInfo.FR_UC] Lieferanschrift: Land (französische Schreibweise, Blockbuchstaben)


[$Payment.Method] Zahlungsart
[$Payment.TransactionID] Transaktions-ID des Zahlungsanbieters


[$Shipping.Provider] Versanddienstleister
[$Shipping.Costs] Versandkosten inkl. Währung
[$Shipping.CostsInfo.Value] Versandkosten (Zahl mit Dezimalpunkt)
[$Shipping.CostsInfo.Currency] Währung der Versandkosten (drei Buchstaben)
[$Shipping.Date] Lieferdatum (Tag.Monat.Jahr)
[$Shipping.DateInfo.D] Lieferdatum (Tag, z.B. "01")
[$Shipping.DateInfo.M] Lieferdatum (Monat, z.B. "02")
[$Shipping.DateInfo.Y] Lieferdatum (Jahr, z.B. "2013")
[$Shipping.DateInfo.Day.DE] Lieferdatum (Tag auf deutsch, z.B. "Montag")
[$Shipping.DateInfo.Day.EN] Lieferdatum (Tag auf englisch, z.B. "Monday")
[$Shipping.DateInfo.Day.ES] Lieferdatum (Tag auf spanisch, z.B. "Lunes")
[$Shipping.DateInfo.Day.FR] Lieferdatum (Tag auf französisch, z.B. "Lundi")
[$Shipping.DateInfo.Month.DE] Lieferdatum (Monat auf deutsch, z.B. "Januar")
[$Shipping.DateInfo.Month.EN] Lieferdatum (Monat auf englisch, z.B. "January")
[$Shipping.DateInfo.Month.ES] Lieferdatum (Monat auf spanisch, z.B. "Enero")
[$Shipping.DateInfo.Month.FR] Lieferdatum (Monat auf französisch, z.B. "Janvier")
[$Shipping.DateInfo.Timestamp] Lieferdatum (Unix-Zeitstempel, Sekunden seit 01.01.1970)
[$Shipping.Tracking.Code] Sendungsnummer / Tracking-Code


[$Addon.Name] Name des Addons
[$Addon.Version] Version des Addons (z.B. "1.2.3 build 456")
[$Addon.VersionInfo.Number] Versionsnummer des Addons (z.B. "1.2.3")
[$Addon.VersionInfo.Build] Build-Nummer des Addons (z.B. "456")