Was sind die Unica Plan Integration Services?

Unica Plan Integration Services kombiniert die Unica Plan Integration Webservice, SOAP-API-Prozeduren und Trigger, um Geschäftskompetenzen zu erweitern.

Die Unica Plan Integration Services setzen sich aus folgenden Komponenten zusammen.

  • Unica Plan Integration Webservice

    Integration Services bietet Unica Plan-Kunden und Professional Services eine Möglichkeit, Unica Plan in andere Anwendungen in ihrer Umgebung zu integrieren.

  • Unica Plan-Prozeduren und SOAP-API

    Benutzerdefinierte Prozeduren können in Unica Plan definiert werden, um Unica Plan-Geschäftslogiken beliebig zu erweitern. Nachdem Sie Prozeduren definiert haben, können diese Prozeduren die Ziele für Aufrufe des Web-Service Integration Services aus anderen Anwendungen sein. Prozeduren können auch zum Senden von Nachrichten an andere Anwendungen definiert werden.

  • Unica Plan Trigger

    Trigger können Ereignissen und Prozeduren in Unica Plan zugeordnet sein. Wenn eines dieser Ereignisse auftritt, wird der zugeordnete Trigger ausgeführt.

REST-APIs verwenden Unica Plan Integration Services nicht. Informationen zur REST-API finden Sie im Unica Plan-Administratorhandbuch.

Versionen und Abwärtskompatibilität

Zukünftige Versionen von Integration Services werden abwärtskompatibel mit allen untergeordneten Releases und Wartungsreleases mit gemeinsamer Hauptversionsnummer sein. behält sich jedoch das Recht vor, keine Kompatibilität mit früheren Versionen für Hauptreleases (x.0) zu gewährleisten, wenn die vorliegende Geschäftssituation bzw. die technischen Umstände dies rechtfertigen.

Die Hauptversionsnummer dieser API wird inkrementell erhöht, wenn eine der folgenden Änderungen vorgenommen wird.

  • Änderungen der Dateninterpretation
  • Änderung der Geschäftslogik (beispielsweise Änderungen in den Funktionen der Servicemethode)
  • Änderungen der Methodenparameter und/oder der Rückgabetypen

Die Nebenversionsnummer dieser API wird inkrementell erhöht, wenn eine der folgenden Änderungen vorgenommen wird. Diese Änderungen sind per Definition mit einer früheren Version kompatibel.

  • Neue Methode hinzugefügt
  • Neuer Datentyp hinzugefügt und dessen Verwendung auf eine neue Methode beschränkt
  • Neues Element zu einem Aufzählungstyp hinzugefügt
  • Eine neue Version einer Benutzeroberfläche wird mit einem Versionssuffix definiert

Authentifizierung

Eine Authentifizierung ist nicht erforderlich. Alle Clients sind einem bekannten Unica Plan-Benutzer mit dem Namen „PlanAPIUser“ zugeordnet. Ein Systemadministrator konfiguriert die Sicherheitsfunktionen dieses Benutzers mit Sonderberechtigung entsprechend den Anforderungen aller Web-Service-Clients.

Ländereinstellung

Als Ländereinstellung wird ausschließlich die derzeit für die Unica Plan-Systeminstanz konfigurierte Ländereinstellung unterstützt. Es wird für alle von der Ländereinstellung abhängigen Daten, wie Nachrichten und Währungen, die Ländereinstellung des Systems vorausgesetzt.

Statusverwaltung

API und Web-Service sind statusunabhängig. Die Serviceimplementierung speichert keine clientspezifischen Informationen für nachfolgende API-Aufrufe. Mit dieser Funktion wird eine effiziente Serviceimplementierung ermöglicht und die Clusterunterstützung vereinfacht.

Datenbanktransaktionen

Unica Plan Integration Services legt dem Client keine Datenbanktransaktionen offen, verwendet aber entsprechende Informationen, sofern sie im Ausführungskontext miteinbezogen sind. Nach dem Start einer Transaktion sind die Auswirkungen aller API-Aufrufe innerhalb einer bestimmten Prozedur atomar. Das bedeutet, dass die Datenbank bei einem fehlgeschlagenen API-Aufruf in dem Status verbleibt, den sie vor dem Aufruf der API hatte. Andere Benutzer von Unica Plan können die Änderungen erst einsehen, nachdem die Prozedur die Transaktion erfolgreich ausgeführt hat.

API-Aufrufe, die die Datenbank aktualisieren, müssen zunächst eine Bearbeitungssperre anfordern, um zu verhindern, dass andere Benutzer die zugrundeliegenden Daten während der API-Aufrufe verändern. Andere Benutzer können gesperrte Komponenten nicht aktualisieren, bis der API-Aufruf abgeschlossen ist. Ebenso müssen die nächsten Unica Plan-Benutzer oder API-Clients die Datensperre anfordern, bevor ein weiterer API-Aufruf übergeben wird.

Ereignisverarbeitung

Wenn eine Operation auf einer Unica Plan-Komponente über die API ausgeführt wird, werden dabei die gleichen Ereignisse generiert wie bei einer Ausführung der Operation durch einen Unica Plan-Benutzer. Benutzer, die bestimmte Benachrichtigungen abonniert haben, beispielsweise bei der Statusänderung eines Projekts, werden über Statusänderungen benachrichtigt, die aus API-Aufrufen sowie aus Aktionen von Benutzern folgen.