Generelle Konzepte und Lösungen:Wilkommensdialog

Der Willkommensdialog

Der Willkommensdialog wird bei unseren Assistenten beim Starten des Office-Programmes (Word, PowerPoint, Excel) angezeigt und erfüllt diese Aufgaben:

• Er informiert darüber, dass der Assistent als eine Erweiterung des Office-Programmes dient
• Er weist auf Neuerungen im Assistenten hin

Der Willkommensdialog kann durch setzen eines Hakens in einer CheckBox ausgeschaltet werden (siehe 'TimeStamp').

Die Bestandteile des Willkommensdialoges liegen im Verzeichnis:

custom\ui\<sprache>\welcome

Wenn Sie Änderungen am Willkommensdialog vornehmen, stellen Sie uns bitte die geänderten Daten zur Verfügung, damit wir sie in die nächsten Auslieferung an Sie integrieren können.

welcome.xml

Bitte beachten: Verwenden Sie immer ein für XML-Dateien vorgesehenes Bearbeitungsprogramm, damit die korrekte Kodierung der Texte gewährleistet wird!!

In der welcome.xml finden Sie die Einstellungen und Texte, die im Willkommensdialog angezeigt werden.

Bei den meisten Bestandteilen des Willkommensdialoges werden die angezeigten Texte in der Eigenschaft 'Caption' bzw. 'Prompt' hinterlegt. Nur der eigentliche Willkommenstext wird als Wert des Feldes (zwischen '<Message>' und '</Message>') eingegeben.

Willkommenstext

Der Haupttext des Willkommensdialoges wird zwischen den Feldbezeichnern '<Message>' und '</Message>' frei eingegeben. Nur dieser Text kann mehrzeilig erscheinen.

TimeStamp

Der TimeStamp dient dazu, dass einerseits der Anwender den Willkommensdialog aus-, der Administrator ihn aber auch wieder einschalten kann, wenn zum Beispiel neue Informationen vorliegen.

Der Timestamp wird von uns standardmäßig mit dem Datum der Erstauslieferung belegt und kann dementsprechend auf ein späteres Datum gesetzt werden. Sie können jedoch einen beliebigen Text angeben -- solange er gleich bleibt, können Anwender ihren Willkommensdialog ausschalten, und wenn er sich ändert, erscheint er wieder.

In der welcome.xml

Eintrag: In der Datei 'welcome.xml' im Hauptknoten 'Dialog' die Eigenschaft 'TimeStamp'.

Beispiel:

<Dialog 
  LocalStore="HKEY_CURRENT_USER\Software\VB and VBA Program Settings\$AssistantName$\WelcomeDialog"
  TimeStamp="2007-05-12"
  Caption="Willkommen zum $AssistantName$en">

Bitte beachten: In manchen älteren 'welcome.xml'-Dateien kann noch ein weiterer Eintrag des TimeStamp als eigener Knoten erscheinen. Dieser wird jedoch inzwischen vom Assistenten ignoriert.

<TimeStamp>2007-05-12</TimeStamp>    wird ignoriert!

In der Registry

Wenn der Anwender den Willkommensdialog ausschaltet, wird der Text des TimeStamp an folgende Stelle in der Registry geschrieben:

Pfad: Siehe Eigenschaft 'LocalStore' in der welcome.xml, wobei '$AssistantName$' dem Namen Ihres Assistenten entspricht.
Eintrag: 'Last Stamp'

Beispiel:

[HKEY_CURRENT_USER\Software\VB and VBA Program Settings\<Name des Assistenten>\WelcomeDialog]
"Last Stamp"="2007-05-13"

Willkommensdialog gezielt ausschalten

Wenn Sie den Registry-Eintrag mit dem aktuellen TimeStamp eintragen, wird an diesem Arbeitsplatz der Willkommensdialog nicht mehr angezeigt, bis sich der TimeStamp in der welcome.ini ändert.