Benutzerdefinierte Site-Einstellungen für den DQE-Lizenzcode (API-Schlüssel) konfigurieren
Um DQE-Dienste in Ihre Salesforce Commerce Cloud (SFCC)-Umgebung zu integrieren, konfigurieren Sie den DQE-Lizenzcode (API-Schlüssel) in Ihren Site-Einstellungen. Dieser Schritt ist erforderlich. Andere Konfigurationen sind optional.
DQE-Lizenzcode konfigurieren
- Gehen Sie im Business Manager zu Site > gewünschte SFCC-Site auswählen > Site Preferences > Custom Preferences > DQE.
- Wählen Sie in der Dropdown-Liste die passende DQE-Instanz aus, z. B. Sandbox/Development, Staging oder Production.
- Geben Sie den von Ihrem DQE-Ansprechpartner bereitgestellten DQE-Lizenzcode (API-Schlüssel) in das Feld DQE License Code ein.
- Klicken Sie auf Apply, um die Konfiguration zu speichern.
Optionale benutzerdefinierte Site-Einstellungen
Zusätzlich zum Lizenzcode können unter den DQE-Einstellungen weitere optionale Einstellungen konfiguriert werden.
Gehen Sie zu Site > gewünschte SFCC-Site auswählen > Site Preferences > Custom Preferences > DQE, um auf diese Einstellungen zuzugreifen und sie zu konfigurieren.
DQE-Site-Einstellungen
| ID | Name | Beschreibung |
|---|---|---|
dqeLicenceCode |
DQE License Code | DQE-Lizenzcode (API-Schlüssel). Er ist für die DQE-API-Authentifizierung erforderlich und muss vom DQE-Team bereitgestellt werden. |
dqeAddressSuggestionsEnabled |
DQE Address Suggestions Enabled | Aktiviert oder deaktiviert die Funktion für Adressvorschläge auf der Site. |
dqeAddressCompleteEnabled |
DQE Address Suggestions Complete Enabled | Aktiviert oder deaktiviert den vollständigen Adress-API-Aufruf für die Funktion der Adressvorschläge auf der Site. |
dqeAddressValidationEnabled |
DQE Address Validation Enabled | Aktiviert oder deaktiviert die Funktion der Adressvalidierung auf der Site. |
dqeAddressValidationMode |
DQE Address Validation Mode |
Legt fest, wann übermittelte Adressen mit DQE validiert werden. Mögliche Werte: Bei Bei |
dqeAddressValidationPropositionEnabled |
DQE Address Validation Proposition Enabled | Setzt den Parameter Proposition beim RNVP-Aufruf auf O. Dadurch können Vorschläge zurückgegeben werden, wenn die Adresse falsch ist. |
dqeAddressValidationModificationEnabled |
DQE Address Validation Modification Enabled | Setzt den Parameter Modification beim RNVP-Aufruf auf O. Dies gibt an, was von der RNVP-Engine geändert wurde, um eine Postadresse gültig zu machen. |
dqePhoneEnabled |
DQE Phone Enabled | Aktiviert oder deaktiviert die Funktion der Telefonvalidierung auf der Site. |
dqePhoneResponsePhoneFormat |
DQE Response Phone Format | Legt das DQE-Antwortformat für Telefonnummern fest. Weitere Details finden Sie in der DQE-API-Dokumentation. |
dqeEmailEnabled |
DQE Email Enabled | Aktiviert oder deaktiviert die Funktion der E-Mail-Validierung auf der Site. |
dqeEmailRectifyEnabled |
DQE Email Rectify Enabled | Schlägt eine Domänenkorrektur vor, wenn die eingegebene Domäne unbekannt ist. |
dqeEmailCheckuserEnabled |
DQE Email Checkuser Enabled | Prüft den linken Teil einer E-Mail-Adresse. Bei der Einstellung No ist der Validierungs-API-Aufruf schneller, aber der linke Teil der E-Mail-Adresse wird nicht validiert. |
dqeCustomMappingUsageIsEnabled |
DQE Custom Mapping Usage Is Enabled | Aktiviert die Verwendung der im Business Manager konfigurierten Validierungszuordnungsregeln. Bei der Einstellung No verwendet die Validierung die auf Code-Ebene konfigurierten Regeln. |
Dienste in SFCC konfigurieren
Nach dem Import der Datei services.xml aus dem Metadaten-Ordner sind die DQE-Dienste im Business Manager von Salesforce Commerce Cloud (SFCC) verfügbar.
Dienste anzeigen und konfigurieren
- Gehen Sie im SFCC Business Manager zu Administration > Operations > Services.
- Im Bereich Services werden Dienste mit dem Präfix
dqe.httpaufgeführt. - Die verknüpften Dienstprofile mit dem Präfix
dqe.httpwerden ebenfalls aufgeführt. Diese Profile legen fest, wie das System mit den DQE-Diensten interagiert. - Die verknüpften Dienst-Credentials mit dem Präfix
dqe.httpwerden ebenfalls aufgeführt. Diese Credentials sind erforderlich, um Anfragen zwischen SFCC und DQE zu authentifizieren und zu autorisieren.
Dienstprofile
Dienstprofile werden verwendet, um allgemeine Verbindungseigenschaften zu konfigurieren.
Gehen Sie zu Administration > Operations > Services > Profiles.
Dienst-Credentials für DQE-Dienste in SFCC konfigurieren
Dienst-Credentials werden verwendet, um bei Bedarf die URL hinzuzufügen oder zu ändern.
- Gehen Sie zu Administration > Operations > Services > Credentials.
- In der Liste Credentials sollten Credentials mit dem Präfix
dqe.httpsichtbar sein. - Öffnen Sie die benötigten DQE-Dienst-Credentials und konfigurieren Sie die URL-Felder gemäß den Angaben von DQE. Bei Bedarf können Sie der URL auch zusätzliche Abfrageparameter hinzufügen.
Business-Manager-Module für DQE in SFCC
Die Cartridge bm_dqe enthält Erweiterungen und zusätzliche Module für den Business Manager von Salesforce Commerce Cloud (SFCC). Sobald die Cartridge global eingerichtet und der BM-Benutzerzugriff gewährt ist, können die DQE-Module über den Business Manager aufgerufen und konfiguriert werden.
Zugriff auf DQE-Module im Business Manager
- Gehen Sie im Business Manager zu BM > Merchant Tools > DQE.
- Wählen Sie die entsprechende Site aus, da DQE-Module und -Konfigurationen site-spezifisch sind.
DQE-Links
Das Modul DQE-Links bietet Benutzern zwei Schaltflächen für den einfachen Zugriff auf DQE-Dienste:
- Eine Schaltfläche, die Benutzer zu https://new.mydqe.com weiterleitet, um ihren Verbrauch zu verfolgen.
- Eine Schaltfläche, die Benutzer zum Help Center unter https://helpcenter.dqe.tech/hc/en-gb weiterleitet.
DQE-Codezuordnungen
Mit dem Modul DQE-Codezuordnung können Admin-Benutzer die Zuordnung von DQE-Validierungsantwortcodes zu Validierungsergebnissen und den entsprechenden, den Benutzern angezeigten Meldungen einrichten und verwalten.
Am oberen Seitenrand stehen drei Optionen zur Zuordnung verschiedener Antworttypen zur Verfügung:
- Email DQE Code Mapping
- Phone DQE Code Mapping
- Address DQE Code Mapping
Wählen Sie die passende Option aus, um die entsprechende Zuordnung anzuzeigen.
Verfügbare Aktionen:
- Neue Codes erstellen.
- Vorhandene Codes bearbeiten.
- Codes bei Bedarf entfernen.
Jede DQE-Codekonfiguration umfasst folgende Felder:
- DQE Code
- Validation Status
- Display Message (lokalisierbar)
Die Anzeigemeldung ist locale-spezifisch. Stellen Sie daher sicher, dass Sie vor der Bearbeitung die richtige Locale im Feld Locale auswählen.
Wichtiger Hinweis: Die DQE-Validierungszuordnung ist cachefähig. Invalidieren Sie nach Änderungen den benutzerdefinierten DQE-Cache. Andernfalls werden die Änderungen im Storefront möglicherweise nicht sofort übernommen.
Der benutzerdefinierte Cache ist verfügbar unter BM > Administration > Operations > Custom Caches.
Modul „DQE Site Preferences"
Das Modul DQE Site Preferences bietet eine alternative Methode zur Konfiguration DQE-bezogener Site-Einstellungen. Dieses Modul ist nützlich, wenn eine Business-Manager(BM)-Benutzerrolle keinen Zugriff auf alle Site Preferences-Module der Site hat oder haben soll.
Wichtige Punkte:
- Das Modul DQE Site Preferences ermöglicht die Konfiguration benutzerdefinierter DQE-Site-Einstellungen wie in den obigen Abschnitten beschrieben.
- Es bietet eine Möglichkeit, diese Einstellungen zu verwalten, ohne auf das umfassendere Modul Site Preferences zugreifen zu müssen, was nützlich ist, wenn für bestimmte Benutzer Zugriffsbeschränkungen bestehen.
Dies gibt Benutzern die Kontrolle darüber, wie DQE-Einstellungen auf der Site konfiguriert werden, selbst wenn nur eingeschränkter Zugriff auf Site Preferences gewährt wird.
Verknüpfung mit