Programmierschnittstelle (API)

ArcFlow API
Programmierschnittstelle von ArcFlow

Mit der Programmierschnittstelle können die Funktionen von ArcFlow aus einer anderen CONZEPT 16-Applikation heraus genutzt werden. Auf diese Weise kann ArcFlow in beliebige Applikationen integriert werden.

Im Lieferumfang der API sind folgende Dateien enthalten:

Pfad / Datei	Beschreibung
af_api.dll	ArcFlow-API-DLL
arcflow_api.ca1	Beispielapplikation inklusive der API-Prozeduren

Installation

Die im Lieferumfang enthaltenen Dateien müssen in ein Verzeichnis kopiert werden, beispielsweise in das Unterverzeichnis "Arcflow\API". Sie dürfen nicht in das Client-Verzeichnis von CONZEPT 16 kopiert werden.

Die Datenbank "arcflow_api.ca1" muss beim C16-Server eingetragen werden. In der Datenbank sind zwei Benutzer (USER und SUPERUSER) definiert. Für beide Benutzer ist kein Passwort notwendig. Mit dem Benutzer "USER" kann die Beispielapplikation gestartet werden. Weitere Hilfe zum Umgang mit der Beispielapplikation befindet sich weiter unten.

Um die Schnittstelle in eine CONZEPT 16-Applikation einzubinden, muss die Beispielapplikation mit dem Benutzer "SUPERUSER" oder "SU" ohne Passwort aufgerufen werden. Die Datenbank enthält folgende Prozeduren:

AF.API	Prozedur mit den ArcFlow-Funktionen
AF.API.Arg	Include-Prozedur
AF.API.Base	Prozedur mit den ArcFlow-Basisfunktionen.
AF.API.Def	Prozedur mit den Variablen-Definitionen
Frm_ApiTest	Prozedur für die Beispielapplikation

Die Prozedur "Frm_ApiTest" wird nur in der Beispielapplikation benötigt. Sie zeigt den Aufruf der API-Funktionen, sowie die Verarbeitung der zurückgelieferten Daten. Alle anderen Prozeduren müssen aus der Beispielapplikation exportiert und in die CONZEPT 16-Applikation importiert werden.

Diese Prozeduren dürfen nicht verändert werden. Im Falle von Änderungen kann kein Support geleistet werden!

Damit die ArcFlow-Hilfe in der Entwicklungsumgebung von CONZEPT 16 eingesetzt werden kann, um zum Beispiel die Online-Hilfe für die API-Befehle anzuzeigen, muss in der Konfigurationsdatei des Clients (c16.cfg oder c16_apgi.cfg) der Eintrag ApiHelp1=<Pfad und Dateiname> vorhanden sein. <Pfad und Dateiname> ist dabei der relative Verzeichnispfad und der Dateiname zur Datei ArcFlow.rid.

Beispiel:

ApiHelp1=Arcflow\ArcFlow.rid

Sind die Angaben korrekt, kann im Prozedureditor über die direkt Befehlshilfe (<Strg>+<F1>) die Hilfe zu dem Befehl aus der ArcFlow-Onlinehilfe angezeigt werden.

Bedienung der Beispielapplikation

Die Beispielapplikation startet direkt, wenn sich der Benutzer "USER" ohne Passwort einloggt.

Hier muss der Programmpfad eingetragen werden, in dem die ArcFlow-API-DLL gespeichert ist, ebenso Name bzw. die IP des Servers (bspw: "192.168.0.1") und der Name der Arcflow-Datenbank (in der Regel "arcflow").

Nach diesen Eintragungen kann die API geladen werden. Dazu wird die Schaltfläche [API laden] gedrückt. Im nächsten Schritt muss sich mit der ArcFlow-Datenbank verbunden werden. Dazu wird ein Benutzerkürzel sowie das dazugehörende Benutzerpasswort angegeben und auf [Login] geklickt.

Auf der zweiten Notebookseite "Beispielfunktionen" sind in einer Liste alle Funktionen aufgelistet, die die API zur Verfügung stellt. Über die Eingabefelder können die Parameter eingetragen werden, die der Funktion übergeben werden sollen. Die Beschreibung der Funktionen befindet sich im Text im unteren Bereich des Fensters.

Über die Schaltfläche [Funktion ausführen] wird die ausgewählte Funktion aufgerufen und die Inhalte der Eingabefelder als Parameter übergeben. Das Resultat wird im Text unterhalb der Liste angezeigt.