XML Aufrufparameter
Immer wieder besteht die Notwendigkeit, Consolidate aus anderen Anwendungen "fernzusteuern".
Das ist über Kommandozeilen-Parameter möglich.
Damit diese Option eine höchstmögliche Flexibilität erreicht, wurde eine einfache XML-Syntax entwickelt, die hier genauer beschrieben wird.
Die XML-Syntax hat folgende Struktur:
Syntax des Command-Parameters:
<xml>
<cmd>befehl</cmd>
<param1>p1</param1>
<param2>p2</param2>
<paramX>p3</paramX>
</xml>
Aufruf-Beispiel:
C5.exe <xml><cmd>editcontact</cmd><param1>7</param1></xml>
Dieses Beispiel öffnet automatisch das Eigenschaftsfenster der Person mit der CID «7».
Verwenden Sie diese Syntax als Übergabeparameter in einer Verknüpfung (LNK) oder bei der Eingabe als Befehl in der DOS-Befehlszeile (Start / Ausführen). Wenn Sie eine Batch-Datei (BAT/CMD) verwenden wollen, setzen Sie den XML-String in Anführungszeichen. Der Umfang der möglichen Kommandos und der Parameter wird laufend nach Bedarf erweitert. Gerne nehmen wir hierzu Ihre Vorschläge entgegen.
Außerdem ist es auch möglich, Consolidate ohne sichtbares Hauptmenü zu starten:
Start-Parameter: C5.exe <login><uid>yz</uid><pwd>csyz</pwd></login>
Zur Sicherheit empfiehlt es sich den Pfad des Programms in Hochkommas zu speichern.
Gerade bei englischen Systemen mit Leerzeichen drin ("Program files") können sonst Fehler auftreten. Der Pfad und der XML-Befehl müssen jedoch abgetrennt sein:
"C:\Program Files\Consolidate\C5.exe" "<xml><cmd>opendocument</cmd><param1>
Beim Login kann mit "/WinLogon" angegeben werden, dass der User bei CONSOLIDATE angemeldet wird, der in Windows angemeldet ist. Falls der Windows-Username anders lautet als der Username innerhalb von Consolidate, so können Sie dies in der Mitarbeiterverwaltung in Consolidate anpassen.
Maximallänge beachten:
Windows erlaubt nur eine gewisse Menge an Zeichen in einem Programmaufruf, daher kann es erforderlich werden, die XML-Aufrufparameter innerhalb einer Textdatei (hier command.xml) zu übergeben in der es kein Zeichenlimit gibt:
"C:\Program Files\Consolidate\C5.exe" "<xml><cmd>filecommand</cmd><param1>c:\test\command.xml</param1></xml>"
anschließend finden Sie eine Liste aller XML Aufrufbefehle und Parametern.
Kommando-Eintrag: | Löst aus: | Parameter: |
anonymizecontacts | Anonymisiert die Kontakte | Param1 = CIDs, kommagetrennt |
birthdaylist | Öffnen der Geburtstagsliste | Param1 = Startdatum Bemerkung: Einträge von Mitarbeiter werden IMMER angezeigt. Alle Parameter sind optional : |
closeAkt | Schließt das Fenster mit der Aktivitätennummer | Param1 = AktID |
combinecompanies | Adressen/Firmen Doublettenzusammenführung | Param1 = ID der Adresse/Firma1 |
combinecontacts | Personen Doublettenzusammenführung | Param1 = ID der Person |
combineprojects | Projekten Doublettenzusammenführung | Param1 = ID des Projekts |
customcall | Aufruf Weiterleitung XMLString an das CDK | Param1 = Text für das CDK |
deladdr | Löscht eine Adresse/Firma | Param1 = Adress ID’s ; können mehrere sein, kommagetrennt, ohne führendes Komma Alternativ: |
delakt | Löscht eine Aktivität | Param1 = Aktivitätennummer |
delperson | Löscht eine Person | Param1 = Personen ID’s ; können mehrere sein, kommagetrennt, ohne führendes Komma Alternativ: |
delproject | Löscht ein Projekt | Param1 = Projekt ID’s; können mehrere sein, kommagetrennt, ohne führendes Komma Alternativ: |
editaddr | Eigenschaft der Adresse/Firma | Param1=Adress-/Firmennummer |
editakt | Bearbeiten der Aktivität | Param1 = Aktivitätennummer |
editcontact | Bearbeiten der Person | Param1 = Personnennummer |
editresource | Bearbeiten des Reservierungsobjekt | Param1 = Reservierungsobjekt ID |
edituser | Bearbeiten eines Mitarbeiters | Param1 = User ID |
hidemenu | Blendet die Menüs aus | Keine |
newaddr | Neue Adresse/Firma | Param1 = Adress-/Firmenname |
newakt | Neue Aktivität | Param1 = Betreff Param2 = Aktivitätsart (Nummer) (Dies ist frei definierbar, die jeweilige Nummer ist unter der Aktivitätsart einsehbar). Param3 = Technologie (Nummer) Beispiel: 12 = E-Mail Param4 = Dateiname (Wenn mehrere verwendet werden, werden diese mit Semikolon getrennt) Param5 = E-Mail Adresse des Empfängers/Gesprächspartners (Wenn die CIDs und ANRs nicht bekannt sind). Bei mehr als einem Empfänger werden diese durch Semikolon getrennt. Sofern es sich um die Technologie E-Mail handelt, werden diese als TO-Empfänger eingetragen. Param6 = Projektzuordnung (ID des Projekts welches zugeordnet werden soll) Param7 = Adress-/Firmen ID (ANR) (Wenn mehrere verwendet werden, werden diese mit Semikolon getrennt (E-Mail Empfänger). Wenn eine Person einer Firma angeschrieben wird, ist die Adresse nicht anzugeben). Param8 = Personen ID (CID) (Wenn mehrere verwendet werden, werden diese mit Semikolon getrennt (E-Mail Empfänger). Param9 = AktID der Vorgängeraktivität (falls bekannt) Param10 = Wenn die Technologie "Faxausgang" ist, kann hier die Faxnummer des Empfängers angegeben werden. Param11 = Der Inhalt der E-Mail (um dies als HTML-Textfile anzugeben: <file>c:\test.htm</file>) (Die Signatur des verwendete Mailprofils vom Login wird ebenfalls hinzugefügt und der Text wird nach der Anrede plaziert). Param12 = Kürzel der Mitarbeiter welche diese Aktivität als CC erhalten sollen (Wenn mehrere verwendet werden, werden diese mittels Semikolon getrennt). Param13 = Objekte ID Param14 = Adress/Firmen IDs der Mandanten (ANR) (Wenn mehrere verwendet werden, werden diese mittels Semikolon getrennt (keine E-Mail Empfänger) Wenn eine Person einer Firma angeschrieben wird, ist die Adresse nicht anzugeben). Param15 = Personen IDs der Mandanten (CID) (Wenn mehrere verwendet werden, werden diese mittels Semikolon getrennt (keine E-Mail Empfänger) Param16 = Soll das Erfassungsfenster in Consolidate offen bleiben oder geschlossen werden (1 = Schliessen) Param17 = Verantwortlicher Mitarbeiter (falls anders als der Login). Kann direkt mit Userkürzel oder auch durch die E-Mail Adresse des Mitarbeiters angegeben werden. Param18 = Alternative E-Mail Absender-Mailadresse Param20 = ID des vordefinierten Textbausteins als Mailtext verwenden. Param21 = Status der Aktivität (0 = Offen, 1 = Erledigt) Param22 = Leistungserfassung öffnen Param23 = Bisher geleistete Zeit Param24 = Datum intern Param 25 = Erinnerungsdatum Param26 = Kategorie Param27 = Vertraulichkeitsgruppe Param28 = CC-Empfänger E-Mail Liste. Die E-Mail Adressen werden durch Semikolon getrennt. Param29 = BCC-Empfänger E-Mail Liste. Die E-Mail Adressen werden durch Semikolon getrennt. Param30 = Antwortmöglichkeiten Param31 = Eingang Einträge erstellen (0 = Nein, 1 = Ja) Param32 = AktCreatedBy = Username des Benutzers, welcher als Ersteller dieser Aktivität verwendet werden soll (falls keiner übergeben wird, wird der Login-User verwendet) Param33 = Zusatzdaten mit welchen die Aktivität erstellt wird. Keine Parameter werden verwendet = Es wird nur die Auswahl für die Aktivitätsarten geöffnet Format: Beispiel: |
newinfo | Öffnet den Eingang | Keine |
newperson | Neue Person | Param1 = Nachname |
newproject | Neues Projekt | Param1 = Projektname |
newuser | Neu anmelden | Keine |
openaddresslist | Adressliste wird geöffnet | Keine |
openaktivitylist | Öffnet das Aktivitätensuchfenster | Param1 = Gespeicherte Listen ID |
openaktlistadress | Aktivitätenliste der Adresse/Firma wird geöffnet | Param1= Adress/Firmen ID |
openaktlistcontact | Aktivitätenübersicht einer Person | Param1 = Personennummer |
openaktlistproj | Aktivitätenübersicht eines Projektes | Param1= Projektnummer |
opencontactcalendar | Öffnet den Kalender der Person | Param1 = Personen ID |
opencontactlist | Öffnet die Personenliste | Keine |
opencontactlistadress | Öffnet die Liste der Personen der Adresse | Param1 = Adress-/Firmen ID |
opendocument | Öffnet das Dokument | Param1 = Akt ID |
openfilteredlist | Öffnet eine Liste mit optionalem Filter | Param1 = Listtyp |
openformdetails | Öffnet ein benutzerdefiniertes Formular | Param1 = Formularname |
openformlist | Öffnet eine Liste für ein benutzerdefiniertes Formular | Param1 = Tabellenname |
opengroupcalendar | Öffnet den Gruppenkalender | Keine |
openprojectlist | Öffnet das Projektsuchfenster | Keine |
openresourcelist | Öffnet die Liste der Reservierungsobjekte | Keine |
opensessionsettings | Benutzer-Einstellungen zeigen | Keine |
opensubst | Stellvertretungen von ... | Param1 = User ID |
opentodos | Öffnet die Aufgabenliste | Param1 = Kürzel des Mitarbeiters Kein Parameter = Auswahl der Mitarbeiter Liste |
openusercalendar | Öffnet den Kalender | Param1 = Gespeicherte Ansicht |
Openuserlist | Öffnet das Mitarbeitersuchfenster | Keine |
quit | Beendet Consolidate | Keine |
remindercheck | Auf Erinnerungen prüfen | Keine |
showakthistory | Öffnet die Historie einer Aktivität als Liste | Param1 = Akt ID |
showmenu | Blendet die Navigation ein | Keine |
updateaktonallscreens | Aktualisiert die Aktivität in allen Fenstern | Param1 = Akt ID |
versioningactivate | Aktiviert die Versionsverwaltung | Param1 = Aktivitätennummer |
versioningcreatedraft | Erstellt eine neuen Entwurf in der Versionsverwaltung – sofern noch keiner vorhanden ist. | Param1 = Aktivitätennummer Im erstem Fall wird der neue Entwurf von einer vorhandenen freigegebenen Version erstellt ; im zweitem Fall kann ein Dateipfad angegeben werden. |
versioningdeletedraft | Löscht den vorhandenen Entwurf aus der Versionsverwaltung – sofern noch eine freigegebene Version vorhanden ist. | Param1 = Aktivitätennummer |
versioningreleasedraft | Gibt den aktuellen Entwurf frei | Param1 = Aktivitätennummer |
warningcheck | Öffnet die fälligen Erinnerungen | Keine |
Phonemanager Aufrufe: | ||
pmcall | Anruf aus Consolidate auslösen | Param1 = Adressen/Firmen ID Diese drei Parameter sind zwar |
pminfo | Anruf-Informationsfenster | Param1 = Infotext |
pmshowdetails | Anrufer-Eigenschaftenöffnen | Param1 = "CID" + Personen ID oder |