Framework:MakroExecutor

Beschreibung

Der MakroExecutor dient dazu, um ohne einen CoPlanner Client geöffnet zu haben, Makros ausführen zu können. Der Aufruf erfolgt über die DOS – Eingabeaufforderung.

Einrichten der Verbindung

Wie bei allen Clients des CoPlanner existiert hierfür eine Konfigurationsdatei mit dem Namen ClientConfig.xml. Dieses liegt im selben Verzeichnis wie der MakroExecutor.

<?xml version="1.0" encoding="utf-16" standalone="yes"?>
<ClientConfig>
   <IpSettings>
      <Version>1</Version>
      <Server>localhost</Server>
      <Port>8963</Port>
      <MaxRows>100000</MaxRows>
      <MaxCells>0</MaxCells>
      <TcpFormatter>Bin</TcpFormatter>
   </IpSettings>
</ClientConfig>

Tragen Sie bei Server den Namen oder die IP des Rechners ein, auf welchem der CoPlanner Server installiert ist ein. Port ist jenes TCP Port, das vom Server geöffnet wird um die Kommunikation mit den Clients zu ermöglichen (Standard: 8963). MaxRows ist die Anzahl der Datensätze, die maximal an den Client gesendet werden können (ist für den MakroExecutor jedoch nicht relevant).

Aufruf

In unserem Beispiel nehmen wir an der der CoPlanner im Programm – Verzeichnis des Systemlaufwerks liegt. Dh. der Pfad dorthin lautet C:\Programme\CoPlanner. Bei CoPlanner Server Installationen finden Sie den MakroExecutor im Verzeichnis Tools. Der Name des MakroExecutors lautet CopMakro. Als Kommandozeilenparameter wird ihm der Name des Makros, welches Sie ausführen möchten übergeben. Nehmen wir an, das Makro heißt „MyCopMakro“. Der Aufruf lautet: C:\Programme\CoPlanner\Tools\MakroExecutor\CopMakro.exe Makroname=MyCopMakro

Hinweis  Der Aufruftext ist casesensitive. Das bedeutet, dass die Groß-/Kleinschreibung des Makronamens ausschlaggebend ist.

Nach dem Bestätigen des Befehls wird eine Verbindung hin zum CoPlanner Server aufgebaut und das Makro wird ausgeführt. Ist in dem Makro eine Importprozedur enthalten oder Aufgaben, die einen bestimmten Plan betreffen gibt es die Möglichkeit, Benutzer, Plan und Unternehmen dem MakroExecutor mitzuteilen und sich dadurch mit einem bestimmten Benutzer, an ein Unternehmen und an einen gewünschten Plan anzumelden. Die ist durch die Datei SessionSetting.xml möglich.

<?xml version="1.0" encoding="utf-16" standalone="yes"?>
<SessionSetting>
   <Version>1</Version>
   <User>Administrator</User>
   <Password>pwd</Password>
   <Entity>Bike GmbH</Entity>
   <Plan>Plan Bike GmbH</Plan>
</SessionSetting>

Tragen Sie bei User den gewünschten Benutzer und bei Password das zugehörige Passwort ein. Entity steht für Unternehmen und bei Plan tragen Sie den Plan ein, an den Sie sich anmelden möchten.

Hinweis  Keiner der obigen Einträge darf Sonderzeichen enthalten, also z.B. auch keine Umlaute!