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.

...
<Message>Willkommen zu Ihrem Assistenten!

Dies ist der Willkommenstext 

Mit freundlichen Grüßen,

Ihre Administratoren</Message>
...

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.xml ändert.

Optional: welcome.img

Die Datei 'welcome.img' wird im Willkommensdialog als Bild links neben dem Willkomenstext angezeigt.

Wenn diese Datei nicht vorhanden ist, wird das Standardbild angezeigt.

Eigenschaft	Wert	Anmerkungen
Bilddatei	jpg, png	Mit der Dateiendung 'img' versehen.
Breite	324 pixel
Höhe	588 pixel
Auflösung	96 dpi

Optional: Versionsspezifischer Willkommensdialog

Bei Bedarf können Sie steuern, dass verschiedene Willkommensdialoge ab einer bestimmten Office Version gezeigt werden. Hängen Sie dazu die erste offizielle Office Version, für die ein anderer Willkommenstext gelten soll, an die Dateinamen an.

Beispiel:

Datei	Beschreibung
welcome15.xml	Ab einschließlich Office 2013 (Version 15) wird dieser Willkommenstext angezeigt.
welcome15.img	Ab einschließlich Office 2013 (Version 15) wird dieses Bild neben dem Willkommenstext angezeigt.
welcome.xml	Bei allen vorangegangenen Office Versionen wird dieser Willkommenstext angezeigt.
--	Da keine 'img' Datei für frühere Office Versionen angegeben war, erscheint bei diesen das Standardbild neben dem Willkommenstext.