InfoCenter Com API

Hallo Peter,

zu 1.: Ja, die DvAPI. Findest Du im Downloadbereich Deines TSSM Accounts (Account der Lizenz).

zu 2.: Nein, soweit mir bekannt nicht. Wie genau soll der Workflow werden den Du realisieren willst?
Bei CRM oder ERP Anbindungen gibt es meist zwei Standardwege. Bei work ... for all! kann man z.B. per Rechtsklick aus David E-Mails zuordnen (so gehen die meisten Tools damit um) oder E-Mails direkt aus der work ... for all! E-Mail Maske versenden. Der Versand erfolgt mit entsprechender Einstellung dann über die API und damit über David. Die versendete E-Mail liegt also im CRM System und in David.
Das schöne hieran ist, dass man mit entsprechender Programmierung auch die @@-Befehle (z.B. @@Warten, @@VCF, @@VON, etc.) und damit viele David eigene Features nutzen kann.

zu 3.: Ja, mit Client Scripts die in David\Code\Scripts abgelegt werden. Sprache entweder Javascript oder VBS. In diesem Verzeichnis findest Du einige Beispiele und die Schnittstellenbeschreibung. Die Scripte werden im David Administrator in den Benutzereigenschaften unter Benutzerdaten hinterlegt, aktiviert und werden beim Clientstart geladen.

Gruß Jens

Hallo Peter,

korrekt, die API kommuniziert nicht mit dem Client, sondern direkt mit dem David Server.

Mittels des Client-Scripting kannst Du mit dem Client kommunizieren.

Was ich in 2. beschrieben hatte war nicht ganz was Du suchst, sondern genau die andere Richtung. Also im CRM eine eigene E-Mailmaske programmieren, die dann nur die Daten beim Klick auf Senden an David oder Outlook abgibt.

Du kannst den sog. TIC Befehl benutzen. Schau mal in diesem Beitrag: email erstellen und in InfoCenter zum Versenden anzeigen

Problematisch ist aber die Rückmeldung, die erfolgt nicht. D.h. Du musst Dir die Nachricht irgendwie im Ausgang des Users suchen.

Eine Alternative wäre, eine neue Nachricht zu erzeugen und zu speichern, diese dann per dvwin-Parameter (siehe unten oder KB Artikel Q-106.693) zu öffnen und die gespeicherte Nachricht im Ausgang zu löschen. Aber auch hier fehlt Dir die Rückmeldung oder die Referenz auf die versendete Nachricht.

Zitat

KnowledgeBase Q-106.693
Aufrufparameter für das InfoCenter (DVWIN32.EXE)
--------------------------

Um Nachrichten in der Branchensoftware zu öffnen, können verschiedeneAufrufparameter für das InfoCenter (DVWIN32.EXE) genutzt werden. Mit Hilfe dieser Parameter können zum Beispiel eMails, der Kalender-Dialog oder der Kalender Wizard direkt aufgerufen werden.

Folgende Parameter stehen zur Verfügung:

Parameter Bedeutung
<file> voll - qualifizierter Dateiname
<path> lokaler Pfadname
[PATH] Pfadname in Servernotation
<n> Dezimalzahl
<x> Hexadezimalzahl

Genereller Aufbau für das Aufrufen von Einträgen aus dem Tobit Archive System:
Syntax: DVWIN32.EXE [PATH] /POS=n /SA=n (+ weitere Modifier s.u.)

POS = Position in Archive.DAT
SA = Typ (9 = Job, 34 = Archive)

Optionen:
Syntax: DVWIN32.EXE /option

Option Funktion Beispiel

• /EML file EML Datei öffnen und darstellen DVWIN32 /EML C:\TEMP\PRICELIST.EML
• /ICS file ICS Datei öffnen und darstellen DVWIN32 /ICS C:\TEMP\MEETING.ICS
• /VCF file VCF Datei öffnen und darstellen DVWIN32 /VCF C:\TEMP\RSANDERS.VCF
• /DFML file DFML Dokument öffnen und darstellen DVWIN32 /DFML \\Servername\david\archive\resource\forms\0\id1a9e7c.001
• /001 file 001 Datei öffnen und darstellen (ohne Betreff, An etc.) DVWIN32 /001 C:\TEMP\MESSAGE.001
• /IMG path n Image Messaging Drucker, Pfad und laufende Bild Nummer DVWIN32 /IMG C:\TEMP\ 3
  Die Grafiken IMG-001.JPGIMG-002.JPG IMG-003.JPG sollten im Verzeichnis C:\TEMP liegen
• /API=n Faxware Drucker, Nummer des Druckjobs
  Ruft den "Nachrichten versenden" Dialog auf und verwendet die angegebene JobDatei DVWIN32 /API=123456789
  JobDatei "0195418B.JOB" und PCX-Grafik "0195418B.001" im Verzeichnis »DAVID\APPS\FAXWARE\OUT\API«. 0195418B ist hierbei der Hexadezimal Wert vomAufrufparameter "26558859".
• /DOC Neues Dokument (ohne cc/bcc)
• /CAL=x:y Neuer Kalendereintrag mit vorgeschlagenem Termin x,y sind hierbei Start- und Stoppzeit in Millisekunden (Hexadezimalwert) seit dem 1.1.1970
• /ADDRESS Addressdialog
• /HWND Fenster der aufrufenden Applikation
• /W Kalender Wizard
• /FROM=file Template für neue Nachricht
• /VCARD User VCard darstellen
• /Options Settings-Dialog darstellen
• /M Modal zu HWND
• -A öffnen eines Archives -A\\Server\david\archive\user\10004000\in

Modifier:

• /F Forward Mail
• /R Reply Mail
• /A Reply to All
• /D Drag&Drop in Kalender Archive
• /I Received Status der Mail ignorieren (In Bearbeitenmodus öffnen)
• /X Eintrag als Attachment an neue Nachricht anhängen
• /Y In Kalender speichern
• /S Dialog »Erneut Versenden« für diesen Eintrag

Beispiel:
Forwarden eines Eintrages:
DVWIN32.EXE \\SERVER\DAVID\ARCHIVE\USER\10004000\IN /POS=103 /SA=34 /F

Alles anzeigen

Aber wie oben gesagt, eine Möglichkeit ist auch, das Ganze mit einer eigenen E-Mailmaske in Deinem CRM zu lösen und die Daten dann an die entsprechenden Programme zu übergeben.

David Befehle

Zitat

Aus der David Hilfe (Im Client F1, dann im Inhalt auf "David Befehle")
David unterstützt eine Vielzahl von Kommandos, so genannte »David Befehle«, mit denen der Anwender das Layout von Nachrichten und deren Versand beeinflussen kann. Der wohl wichtigste dieser Befehle dient der Angabe der Zieladresse (z.B. Faxnummer oder eMail-Adresse). Weiterhin können Sie mit David Befehlen beispielsweise den Versandtermin festlegen, das optische Layout bei Faxaufträgen regeln oder Rundsendungen erstellen.

David Befehle können direkt innerhalb des Nachrichtentextes von Sendeaufträgen verwendet werden. Sie sind hierbei durch eine so genannte »Befehls-ID« zu kennzeichnen. Üblicherweise besteht diese Befehls-ID aus zwei direkt aufeinanderfolgenden @-Zeichen. (...)

Zitat

Bsp. @@WARTEN@@ / @@WRT@@
Wenn man den Text @@WARTEN@@ in eine Nachricht schreibt, dann wird dieser Text beim Versenden vom David Service Layer ausgewertet und aus dem Nachrichtentext entfernt. Der Befehl selbst hat zur Folge, dass die Nachricht im Wartezustand (nur bei externen Nachrichten möglich) in das Versandbuch gestellt wird.

Die schließenden @@-Zeichen werden nur dann benötigt, wenn man mehrere Befehle in eine Zeile schreiben will. Man sollte aber versuchen diese möglichst immer zu verwenden um Fehlern vorzubeugen.

In der Hilfe (F1 im Client) findest Du alles was Du brauchst. Es gibt allerdings noch mehr David @@-Befehle die nicht dokumentiert sind. Manche davon findet man in der KnowledgeBase. Interessante Artikel zu dem Thema sind noch Q-109.646 und Q-109.131.

Bei Verwendung der API ist darauf zu achten, dass die @@-Befehle bei Plaintextnachrichten durchgereicht werden, ich kann diese also in meinem Programm im Text verwenden und der Service Layer führt Sie dann bei Verarbeitung aus. Anders ist es mit HTML Mails die man über die API versendet. Hierbei gehen die @@-Befehle verloren, bzw. werden nicht beachtet.
In der API selbst gibt es aber das "MessageOptions" Objekt, mit dem man die entsprechenden Befehle übergeben kann (für HTML- und Plaintext Nachrichten).

Weitere interessante Ressourcen
Q-106.236 - Variablen im Nachrichteneditor
Q-103.503 - Nutzung von Variablen im Tobit InfoCenter PC mit "if-then-else" Funktionen
Q-103.076 - Adressbuch-Variablen

Q-105.207 - Verschachtelte DvISE Befehle und Variablen verwenden
Q-101.196 - Variablen für den DvISE-Server und für das Tobit InfoCenter

Q-103.045 - Variablen für die Verteilung empfangener Nachrichten
Q-106.499 - Erweiterte Variablen für die Verteilung
Q-106.583 - Einsatz von Variablen mit Verteilregeln

Gruß Jens

Noch ein kleiner Tip am Rande. Falls Du mit Taskobjekten arbeitest (Aufgaben) und den Reminder verwendest, benutze als Zeitangabe den Unix-TimeStamp. In der Hilfe steht Minuten in Integer, das stimmt aber nicht. Dies trifft nur für den Reminder von Terminen zu.

Gruß Jens

Hallo Peter,

zu 2.: Nicht getestet, sry.

Das ganze ist keine MAPI Schnittstelle (mailto). Die gibt es natürlich auch, bzw. nur die Simple Mapi, darüber kannst Du auch arbeiten.
Über den TIC Befehl kannst Du aber z.B. auch Vorlagen und ähnliches übergeben oder direkt zu einem bestimmten Ordner springen.

zu 3.: Mit der Variante die ich ebenfalls schon erwähnte (Nachricht über API erzeugen, speichern, per dvwin32.exe Parameter öffnen, löschen) könntest Du ein Userfield oder eine Property schreiben. Allerdings musst Du zum wiederfinden dann das gesamte Ausgangsverzeichnis in einer Schleife durchlaufen, da Du nicht direkt nach der Property oder dem Userfield suchen kannst.

Ob Dein Lösungsansatz über Scripting und API klappen wird weiß ich nicht, ich glaube aber fast nicht. Das Scripting nutzen wir in der Regel nur um Anwendungen zu starten und dahin entsprechende Daten zu übergeben. Ich kann mir nicht vorstellen, dass man auf einen externen Event horchen kann.
Events die es dort gibt haben immer mit dem Client selbst zu tun, also z.B. eine Aktion nach dem Klick auf Senden ausführen. Das könntest Du natürlich nutzen, allerdings greift das dann bei jeder Mail...

Wie gesagt, genau kann ich es Dir nicht sagen, da ich diesen Weg bisher nicht gegangen bin.

Aber was spricht denn gegen eine eigene E-Mailmaske im CRM? Ich behaupte mal, dass dies für Deine Anforderung der beste Weg wäre. Hört sich zunächst mal nach mehr Aufwand an, aber letztlich wird das vermutlich schneller gehen, wie das rumgeochse mit den verschiedenen Schnittstellen.

Gruß Jens

Hallo Peter,

ich habe Deinen Beispielcode zur besseren Lesbarkeit mal in Code-Tags gesetzt. Benutze beim Einfügen von Beispielcode bitte den #-Button des Editors hier im Forum.

Aus eigener Erfahung kann ich sagen, dass die Verwendung einer eigenen E-Mailmaske keineswegs unzumutbar ist. Im Gegenteil, dadurch kann der Workflow sogar verbessert werden. Wir selbst nutzen work ... for all! welches wir auch vertreiben und hier ist es genauso gelöst. Bisher hatte kein Kunde damit ein Problem.

Anmeldedaten gibt man bei der API in der Regel nicht an. Startet man die Connection mit leeren Parametern, werden die der aktuellen Verbindung genommen, also mein Username und Passwort (die auf Windows basieren) und der "Current Server" aus der Registry, also der zuletzt verbundene Server:

// Codebeispiel zum API Aufruf mit Setzen des pers. Ausgans als Archive-Objekt
using DvAPI32;
...


DvApi32.DavidAPIClass oApp;
DvApi32.Account oAcc;
DvApi32.Archive oArchive;


oApp = new DavidAPIClass();
oApp.LoginOptions = DvLoginOptions.DvLoginForceAsyncDuplicate;
oAcc = oApp.Logon("", "", "", "", "", "NOAUTH");
oArchive = oAcc.GetSpecialArchive(DvArchiveTypes.DvArchivePersonalOut);

Zu Deinem Beispiel kann ich nicht viel sagen. Ich mache fast nichts in VB, nur C# und JS.

Zitat

oInfoCenter.Msgbox(errtxt) ' leider tritt immer ein Error Text Objekt erforderlich

Handelt es sich bei errtxt.description wirklich um Text? Oder musst Du zunächst in eine String konvertieren?
Das würde zumindest die Meldung erklären.

Gruß Jens

Hallo Peter,

Zitat von Peterle

Meine einzige Erklärung ist, dass es im VBS von Tobit das Object

WScript

nicht gibt. Stimmt das??

möglich ist das, kann ich aber nicht wirklich beantworten.

Zitat von Peterle

Vielleicht ist ja auch die mailitem.Save Methode statt mailItem.Send aus DvApi eine Möglichkeit dem Benutzer die Regie zu übergeben.

Geht auch, aber auch die hat den ein oder anderen Nachteil. Denn wenn der User auf Senden klickt, wird ein neues Item im Ausgang erzeugt, und das hat natürlich Deine Property nicht...

Gruß Jens

Hallo Peter,

der Code ist beide male der Gleiche, oder?

Zitat von Peterle

Klappt das so mit dem code

Vermutlich nicht, da Du ja ein Kommentar mit nem Error dran geschrieben hast.

Ich denke das Problem ist, dass Du ein neues Item erzeugst. Du kannst aber das Userfield anscheinend nur auf bereits existierende Items anwenden. Du musst also vorher speichern, was dann aber wieder dazu führt, dass Du nicht weißt, wie Du den Eintrag findest.

Wie erwähnt nutze ich immer SetProperty und nicht die Userfields. Habe das Ganze aber gerade mal getestet (ich hoffe Du weißt den Einsatz zu schätzen, meine Amazon Wunschliste ist lang ). Beim Userfield kommt bei mir der gleiche Fehler sofern es ein neues Item ist, mit bereits existierenden Items geht es.

Mit SetProperty geht es auch mit neu erzeugten MessageItem2.

oMessageItem2 = oArchive.CreateArchiveEntry(DvItemTypes.DvEMailItem);
oMessageItem2.Subject = "Test";
oMessageItem2.SetProperty(4190, "Test");
oMessageItem2.Save();

Wenn Du die .0tx des zugehörigen Eintrags im Editor öffnest, wirst Du Deine Property darin finden.

Übrigens ist das MessageItem2 auch um ca. Faktor 10 schneller als MessageItem und seine abgeleiteten Objekte (MailItem, etc.).
Daher versuche ich immer soviel wie möglich über MessageItem2 zu realiseren und caste nur in speziellen Fällen in die entsprechenden Objekttypen. Da man nicht direkt von MessageItem2 zu MessageItem casten kann, muss man einen Umweg gehen, indem man die ID des MessageItem ausliest und damit das MessageItem2 erzeugt (öffnet).

Gruß Jens

Hallo Peter,

Zitat von Peterle

Die Userfields, bzw Propertys gehen beim senden einer Mail (d.h. nach Übergang ins Ausgangspostfach) verloren.

das stimmt so nicht. Arbeitest Du mit dem MessageItem2 und SetProperty findet man diese auch in der 0tx der versendeten E-Mail. Die Property steht also auch nach dem Versand zur Verfügung.

Gruß Jens