Integratoren: hier beginnen
Dieser Bereich der Hilfe ist für Systemintegratoren: Integrationsentwickler, Lösungsarchitekten und die Integrationsunternehmen, die Exponential mit anderen Systemen verbinden. Typische Projekte verbinden ein CRM, ein ERP oder ein Produktinformationssystem (PIM), ein Digital Asset Management (DAM), einen Identitätsanbieter, einen Suchserver, einen E-Mail- oder Newsletter-Dienst, einen Zahlungsanbieter, ein Analysewerkzeug oder ein anderes Content-Management-System, das ersetzt oder parallel weiterbetrieben wird.
Er beantwortet vier Fragen: welche Integrationsschnittstellen Exponential tatsächlich hat (und welche nicht), welche zu einer bestimmten Aufgabe passt, wie Sie eine Integration bauen, die Importe, Ausfälle und Upgrades übersteht, und wie Sie ein Integrationsprojekt von der Analyse bis zur Übergabe durchführen.
Hinweis Jede technische Aussage in diesem Bereich nennt die Datei, Einstellung, Klasse oder den Befehl, auf dem sie beruht, und wurde am Code von Exponential 6.0.15 und der Erweiterungen geprüft, die die
composer.jsonim Wurzelverzeichnis voraussetzt. Wo etwas nicht angeboten wird, sagt die Seite das klar. Beispiele verwendenexample.com, „Ihr Unternehmen“ und Platzhalter-Bezeichner; keine Seite beschreibt einen echten Kunden oder Partner.
Inhalt
- Exponential integrieren, in einer Minute
- Was dieser Bereich abdeckt und was nicht
- Übersicht der Seiten für Integratoren
- Lesepfade nach Rolle
- Ihre erste Woche in einem Integrationsprojekt
- Wen Sie fragen
Exponential integrieren, in einer Minute
- Zwei HTTP-APIs werden mit dem Produkt ausgeliefert. Die REST-Inhalts-API der Erweiterung
ezprestapiantwortet unter/api/ezp/v1/und/api/ezp/v2/(Lesen in beiden Versionen, Anlegen und Löschen in v2), und die Erweiterungexpservicesbietet etwa tausend benannte Dienste als JSON unter/ezjscore/call/exp<domain>::<method>an (REST-API für Integratoren, Remote-Dienste mit expservices). - Drei Arten von Zugangsdaten. OAuth-2.0-Anwendungen, registriert unter Setup > oAuth-Verwaltung, persönliche
API-Schlüssel (
expk_...) für ein Programm eines Benutzers und Tokens vonexpservices(expt_...). Keine davon kann mehr als der Benutzer dahinter (Zugangsdaten wählen). - Die PHP-API ist die stärkste Schnittstelle. Importe, die auf dem Server laufen, verwenden
eZContentFunctions::createAndPublishObject()undupdateAndPublishObject()mit einer stabilenremote_id, sodass Veröffentlichungsoperation, Workflows, Caches und Suchindex im Einklang bleiben (Idempotente Importe mit remote_id als Schlüssel). - Hooks für „etwas ist passiert“. Workflows an Triggern (zum Beispiel
content / publish / after), Event-Listener vonezpEvent, Benachrichtigungs-Handler und die signierte Webhook-Senke des Audit-Trails (Workflows und Trigger als Hooks, Ausgehende Webhooks aus dem Audit-Trail). - Feeds, Pakete und Dateien. Exporte als RSS 1.0, RSS 2.0, Atom und OPML, RSS-Importe per Cronjob, Pakete
.ezpkg, CSV-Import und -Export und zeitgesteuerter Austausch mit SFTP, S3, WebDAV oder einem HTTP-Endpunkt überxrowextract. - Identität. Login-Handler (
standard,LDAP,textfile, Ihr eigener), Single-Sign-on-Handler und Social Login über die Erweiterungsevenx_authentication_2fa(Login-Handler, Single Sign-on und Social Login). - Alles läuft als Erweiterung. Eine Integration ist eine Erweiterung: Einstellungen, Klassen, Cronjob-Teile, Konsolenbefehle, Workflow-Ereignisse. Sie lässt sich versionieren, testen, veröffentlichen und zurückgeben (Eine Integration als Erweiterung bauen).
- Was es nicht gibt. Keine OpenAPI-Beschreibung der Inhalts-API, kein XML-RPC, kein SAML, kein Connector für Message Broker im Kernel und kein Ändern von Inhalten über REST (GraphQL kann es). Planen Sie diese als individuelle Arbeit ein (Integrationsschnittstellen auf einen Blick).
Was dieser Bereich abdeckt und was nicht
| Hier behandelt | An anderer Stelle lesen |
|---|---|
| Jede Integrationsschnittstelle für eine Aufgabe wählen und nutzen | Erweiterungen allgemein schreiben: Erweiterungsentwicklung: das Buch |
| Integrationsmuster: Push und Pull, Batch und Echtzeit, Idempotenz, Abbildung | Anwendungen auf Exponential bauen: App-Ersteller: hier beginnen |
| Sicherheit, Tests, Überwachung und Upgrades von Integrationen | Server hosten und betreiben: Hosting-Unternehmen: hier beginnen |
| Ein Integrationsprojekt durchführen: Schätzungen, Leistungsbeschreibungen, Übergabe | Das Partnerprogramm selbst: Partner: hier beginnen |
| Arbeitsblätter, Checklisten, FAQ und Glossar für Integratoren | Mit Git am Code arbeiten: Mit Git entwickeln |
Zwei Schwesterbereiche sind für benachbarte Rollen geschrieben: Wiederverkäufer: hier beginnen für Unternehmen, die Exponential und Leistungen rund darum verkaufen, und Bündler: hier beginnen für Unternehmen, die Exponential in einem Produkt oder einer Distribution ausliefern.
Übersicht der Seiten für Integratoren
Lesepfade nach Rolle
Der ganze Bereich in einer Reihenfolge steht im Lesepfad für Integratoren.
Ihre erste Woche in einem Integrationsprojekt
| Tag | Tun Sie dies | Seite |
|---|---|---|
| 1 | Füllen Sie mit dem Kunden das Analyse-Arbeitsblatt aus: Systeme, Daten, Richtung, Menge, Zeitpunkte | Analyse-Arbeitsblatt für Integrationen |
| 1 | Prüfen Sie, welche Schnittstellen die Installation aktiv hat (ActiveExtensions, rest.ini, soap.ini, webdav.ini) | Integrationsschnittstellen auf einen Blick |
| 2 | Wählen Sie pro Datenfluss eine Schnittstelle und Zugangsdaten, und schreiben Sie sie auf | Eine Integrationsschnittstelle wählen, Zugangsdaten wählen |
| 2 | Bilden Sie jeden externen Datensatz auf eine Inhaltsklasse und ein Schema für die remote_id ab | Klassen auf externe Daten abbilden |
| 3 | Richten Sie eine Entwicklungsinstallation aus Git und ein Dienstkonto mit einer engen Rolle ein | Mit Git entwickeln, Dienstkonten und Rollen |
| 4 | Bauen Sie einen ersten Import oder Aufruf von Anfang bis Ende, mit einem Probelauf | Einen Import schreiben |
| 5 | Schreiben Sie die Schnittstellenspezifikation, und vereinbaren Sie Fehlerbehandlung und Überwachung | Vorlage für eine Schnittstellenspezifikation, Überwachung |
Wen Sie fragen
| Frage | Wo |
|---|---|
| Technische Fragen zu den APIs und dem Kernel | die Foren https://share.exponential.earth/forums und Telegram https://t.me/exponentialcms |
| Bezahlter Support, Entwicklung oder eine Prüfung Ihrer Integration durch 7x | https://se7enx.com/contact |
| Das Partnerprogramm, Stufen, Empfehlungen | das Partnerteam: [email protected] oder das Formular unter https://exponential.earth/partner/contact-us |
| Ein Sicherheitsproblem, das Sie beim Integrieren gefunden haben | [email protected], vertraulich, nie in einem öffentlichen Issue |
| Ein Fehler oder eine fehlende Funktion in einer Erweiterung | das Repository der Erweiterung auf https://github.com/se7enxweb (Gute Issues schreiben) |
Verwandte Seiten
- Mit Git entwickeln: vom Benutzer zum Entwickler
- Erweiterungsentwicklung: das Buch (hier beginnen)
- Partner: hier beginnen und Implementierungspartner
- Wiederverkäufer: hier beginnen, Bündler: hier beginnen
- App-Ersteller: hier beginnen
- Migrationen in Kundenprojekten, Migrationen
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.
Werden Sie Exponential-Partner
Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.