user guide dmessage™eng.dmessage.com/document/doctech.pdfmgi consultants 11 rue de téhéran -...

MGI Consultants

11 Rue de Téhéran - 75008 PARIS • tél. : 01 53 53 41 00 • fax : 01 53 53 41 99

URSSAF 756 30 0157899 001 011 • SA au capital de 1.537.500 Euros

RCS Paris B 382 770 584 • SIRET : 382 770 58400078 • APE : 6202A • TVA : FR 59 382 770 584

USER GUIDE DMESSAGE™

SOCIETE MGI CONSULTANTS – 2017

Reference 2017/dMessage/DOC_ENG

Issuer MGI Consultants

Start date of broadcast

FEBRUARY 2017

This document contains 42 pages.

USER GUIDE DMESSAGE™ MGI Consultants

© MGI Consultants – Reproduction et utilisation interdites sans autorisation 2017/dMessage/DOC_ENG | /42

SUMMARY

INTRODUCTION 3

1. CREATE AND SEND A MESSAGE 4

1.1 DMESSAGETM CONSOLE PRESENTATION 4

1.2 CREATE A MESSAGE WITH DMESSAGETM 5

1.3 TEMPLATES AND MESSAGES MANAGEMENT 16

1.4 INTEGRATING AN HTML PAGE AS THE BODY OF MESSAGE 18

1.5 CREATE A SHORTCUT TO SEND A MESSAGE 19

2. DMESSAGE™ CONFIGURATION 21

2.1 MESSAGES STORAGE 21

2.2 CHANGING THE DEFAULT OPTIONS FOR MESSAGES AND TEMPLATES 22

2.3 CONFIGURATION OF THE DMESSAGETM CONSOLE 24

2.4 AUTOMATIC ARCHIVING AND DESTRUCTION OF MESSAGES 29

2.5 IMPORTING LISTS OF RECIPIENTS (USERS, COMPUTERS OR GROUPS) 31

2.6 CONFIDENTIALITY OF MESSAGES MANAGEMENT 32

2.7 MANAGING THE MESSAGES ACCESS RIGHTS 33

3. DMESSAGE ADVANCED SETTINGS 34

3.1 SEND MESSAGES IN THE COMMAND LINE 34

3.2 SEND MESSAGES IN COMMAND LINE 35

3.3 MANAGING THE SIZE OF THE WINDOWS 36

3.4 DEBUG OPTION 37

3.5 PREVENT THE DELETION OF THE RECEPTION AGENT 37

APPENDIXES 38

APPENDIX 1: MANUAL EDITING OF TEMPLATES OR MESSAGES 38

APPENDIX 2: RECEPTION WINDOW 39

APPENDIX 3: COMMAND LINE OPTIONS FOR THE DMESSAGETM CONSOLE 40

APPENDIX 4: RETRIEVE INFORMATION FROM THE CLIENT WORKSTATION 40

APPENDIX 5: DMESSAGE™ SILENT SET UP OPTIONS 42



INTRODUCTION DMESSAGETM , THE POP-UP MESSAGE SENDER SOFTWARE ON LOCAL NETWORK.

dMessage ™ is a pop-up messaging solution that allows you to send pop-up messages to target users

through your local network.

With dMessage ™, you can:

- Define message templates by categories of users

- Send messages to target users, groups or computers by using conditions (group in the directory, presence of a file on their desktop, executing a process…) or a predetermined timetable.

- Track the message deliveries on users’ machines

Therefore, you can regularly broadcast news or information to the relevant users the right information

about the corporate life and their activities such as the workers’ committee newsletter, IT charter

reminder, memorandum or progress on support incidents…

Figure 1: example of a message received by users



1. CREATE AND SEND A MESSAGE Sending a message with dMessageTM is performed by using the dMessageTM console in two different steps:

- Creation of a message or a message template

- Sending a message (From a template or not)

Launching of the console

Click on the icon to launch the console of sending messages

1.1 dMessageTM console presentation

The dMessageTM console allows you to edit and send messages to your users.

It is divided into two distinct management areas:

- a top area for template management - a bottom area for message management

Figure 2: dMessageTM console presentation

List of sent messages

List of templates



display the list of templates

By default, the templates

list is not displayed

Click on the bouton

to display this list.

Creating and sending messages are done directly through the buttons provided for this purpose in each

area:

- “New” button to create a new message or a template - "Send now" or "Send again" buttons to send a message

1.2 Create a message with dMessage TM

Creating a message is divided into 4 steps:

- Defining the basic parameters - Publishing the message contents - Choosing the recipients - Adding optional parameters (range of validity and filters to apply on the recipients)

Note: each time you send a message (from a template or not) from the

console, the editing widow will open in order for you to check and

customize your message before sending it.



1.2.1 Use the message editing interface

Launching the dMessage console

Click on the “New” button in the "messages” area or the “templates" area to create a message or a template.

Note: when you create a new template, you can save it but cannot send it

directly from the template creation interface.

However, if you create a new message without a template, you can send

the message directly.

The interface for creating messages is divided into 3 parts:

- A first part for the basic parameters - A second part for step choice: editing content, choosing recipients or adding conditions - A third part for information input

Figure 3: message editing interface presentation

Basic settings

Choice of the design conception

Message editing



Note: If you have launched this interface from the template area, the

“Send” button will be replaced by the “Save as” and “Save” buttons.

1.2.2 Step 1: The basic settings

Basic setup

1) Specify the message information level. Three levels for messages are available:

- Information (Icon in the lists of templates or

messages : ) - Warning (Icon in

the lists of templates or

messages : )

- Alert (Icon in the lists of templates or messages

: )

2) Choose a category of users

Note: The categories enable the management of application access and

editing rights of messages for users with the sending console.



Example: You can configure the sending console so the users from the

“corporate Information” category can only read or edit messages of their

category. From the sending console, they will not have access to messages

belonging to other categories than “Corporate Information”.

Basic setup

3) select the visual effect wanted for

the message :

- Discrete - Pop-up message - Information bubble - Animated image

Discrete : Simple animation of the icon in the notification area depending of the level of priority. Caution, the message will not appear automatically as a pop-up and this, whatever level of priority it is.

Pop-up message: A pop-up window appear on the recipient’s workstations

Information bubble: A tooltip appears in the bottom right-hand corner of the recipient’s screen during few seconds. The image displayed depends of the level of priority of the message. One click on the tooltip opens the pop-up.



Basic setup

Animated image: An image appears in the bottom right-hand corner of the recipient’s screen, and will stay at the firs plan as long as the message has not been opened. The image displayed depends of the level of priority of the message. One click on the image opens the pop-up.

1.2.3 Step 2: Edit content

Edit content

1) Select the step “Message content”

2) Choose the needed languages for your message by clicking the

button Then select the desired language. If you select “French”, a French language tab will appear in the interface.

Languages

chosen

Language

selection



Edit content

3) Edit your message. (title, message body and signature)

Note: when you use multiple languages, make sure that all languages tabs

have been filled (title and body text). By default, if you have chosen French

and that you have not set the content of the ‘French’ tab, the user will

receive a blank (if the language of its OS is French).

Therefore, if you use only one language, we strongly recommend that you

disable all unnecessary languages and use only the “Default language”

tab.

For the message body, you can import an rtf file. For this, clear the "Description" field using the

button and then import your rtf file by clicking the button .

Word will make you able to edit your .rtf file.

Note: For the user convenience, it is recommended to put a short text for the title

and add additional information in the message body field.



Edit content

4) Click on the button in the « Advanced » window. You can associate a sound to your message file (. wav only) and a hyperlink.

Note: You can import your “.wav” file or your hyperlink by clicking the button .

The hyperlink may be a document or an executable with or without parameters (as

you would do in the Run command from Start menu). In all case, the specified link

must be reachable from the receiving stations.

Edit content

5) The message will appear as follows on the user station.



1.2.4 Step 3: The selection of recipients

Recipients selection

1) Select the « Recipient list » option To add a new user, two modes are possible: "Directory" mode or manual mode.

2) To browse the

directory: select the button to access your directory (users, groups, or computers). The list of matching items will appear.

Note: Before you browse your directory by using the shortcut, you can apply a

filter



Recipients selection

3) Select your recipients and press « OK » to add it to the list

4) Manual mode: Enter the

name of your

recipient (user, group, or

computer) as defined in

your directory and confirm

the item by clicking on the

button

Note 1: Sending a message can be done if the target fulfills at least one of the three

membership criteria (users, groups, or computers).

Note 2: To name a computer, you can use the machine name (NetBIOS or DNS name)

or an IP address.

Note 3: It is possible to insert wildcards for usernames and computers. For example,

if you want to send a message to all the workstations that start with "a", enter a*.



1.2.5 Step 4: Optional parameters

In addition to the choice of recipients, filters can be added to target recipients even more. However,

unlike the choice of recipients, where recipient has to belong to only one of the three lists (users,

groups or computers), the message is sent only if the recipient matches ALL filters.

1.2.5.1 Message validity interval

Validity Interval

1) Select the « Optional

parameters » option

2) Click on the "From" and

"To" buttons to specify

date and time to define an

interval for sending your

message.

Click on the “From” button

to define the day starting

from when the message

will not be received.

Note: To cancel an interval, first click on the buttons "From" and "To". Then in

the new window, click on the “Cancel” button.



1.2.5.2 Recipient filters

In addition to date, you can choose to add filters for sending your message. By default, there are 13

possible filters.

Configuring filters

1) Choose a filter from the dropdown menu and set it up, then click on “Add”

Sending the message will

depend on the result of the

filters.

2) By default, the message

is send only if the filter is

verified for the recipients.

Untick the box if you want

to send the message if the

filter is NOT verified.

Note: Remember the button that lets you quickly set conditions.



The available filters by default are the following:

Available filters

Condition type Parameters Description

Membership of the user to groups

List of groups Test if user belongs to all groups

in the list

Content of a text file Full path to the txt file

Search text

Test if text file contents a line ; the search doesn’t take into

account capital letters

Login domain Name (or list) login domain Test if the user is logged on a

domain in a given list

Process execution Process name Test if a given process name, which may contain models is

running

Existence of a folder Full path to the folder Test if a folder exists

Existence of a file Full path to the file Test if a file exists

Existence of a registry key registry key Test if a key exists in the

registry key

Existence of a registry value Value of a registry key Test if a value exists in the

registry key

OU computer OU

(Organizational unit of your directory )

Test if computer is in selected OU

OU user OU

(Organizational unit of your directory )

Test if user is in selected OU

Login server Name (or list) login server Test if user is logged on a server

in a given list

A window title A window title Test if a given window (which

can contain template) is displayed

1.3 Templates and messages management

The dMessage™ console also allows you to perform the following actions:

- Edit a message - Delete a message - Archive a message



Edit a message

Select a message and click

on the button to edit the message

Delete a message


on the button or on the “Delete” key on your keyboard to erase it.

Archive a message


on the button to archive your message.

Note: Archiving a message allows you to keep a copy in a dedicated folder. For more

information about the storage of messages, please refer to the section 2.1.



1.4 Integrating an HTML page as the body of message

In order to benefit from this feature, the version 6.11.2 (or higher) must be installed on every

workstation.

The body of a message can also be a HTML source. To do this, simply click on the icon and specify

the path to the html source (URL or absolute path).

Note: If you choose to embed a HTML page as the body of a message, you

will not be able to add text in it.



1.5 Create a shortcut to send a message

dMessage allows you to create shortcuts on the workstation to quickly send messages from the

message template.

To create a shortcut, it is important to use (or to create) a template with a distinguished name.

Create a shortcut to send a message

1) Save the template under the name wanted

2) Open (or create if it does not exist) the shortcut

configuration file which is in the shared folder of

messages

Create your own shortcuts following the example

(without the semicolons)

Répertoire_des_messages\Custom\Shortcut.ini

Champ Description Examples

[Name of the Template of messages]

Gives the name of the template which will be sent by the shortcut

[Warning]

Users

Defines users for whom the shortcut will be created (it will appears on the desktop)

(in the example, “*” matches all the users)

Administrator

*

Computers Defines the computers on which the

shortcut will be created Computer1

Groups Defines the AD groups whose members will

have the shortcut

Note: It is not mandatory to fill in the three fields Users, Computers and Groups

if only one is enough to define for whom the shortcut will be created.



Create a shortcut to send a message

3) Save the Shortcut.ini file

The shortcut is created at

the next Log-in of each

users meeting the criteria

previously chosen.

4) When users click on the

shortcut, the

corresponding message is

immediately sent.

Note: The sending console must be installed beforehand on the workstation where

the shortcut will be created.



2. DMESSAGE™ CONFIGURATION

2.1 Messages Storage

Messages created and sent through dMessage™ are stored in a dedicated folder as a .ini files and saved

under the <Date-Time-Category>.ini .

The default storage folder is: “C:\Documents and Settings\All Users\Application Data\Dynamic

Desktop\Popup Messages”

“C:\Users\<Username>\AppData\Local\dMessage™” for Vista and more (Public directory under

Windows Vista).

How to change the storage folder

Go to the file menu and

click on « Select the

message folder... »

Note: This directory can also be changed thanks to the modification of the

command line or by editing the DDSendMsg.ini (refers to 2.2.1 section)

Warning: Your users must have the reading right on the dedicated folder in

order to receive your messages.

This directory folder contain also the following subdirectories:

Folder Description

Archives Folder for archived messages

Templates Folder for messages templates

rtfFiles Folder for rtf files used in the different messages

wavFiles Folder for optional associated sound



2.2 Changing the default options for messages and templates

The “DDSendMsg.msg” file manages the default options of templates and messages. This file can be

opened with any text editor.

2.2.1 [Options] Section

In this section, you can manage the default settings of message (refer to 1.2.2 section)

[Options] Section

Key Description Value by default

Level Default message display mode Warning

Category Default category NA

Users Default recipient (user) %DefaultValue% (Current sender)

Groups Default recipient (group) NA

Computers Default recipient (workstation) NA

MinDate Starting delivery date for the

(Pattern to use: YYYYMMDDHHMMSS)

NA

MaxDate Ending delivery date for the

(Pattern to use: YYYYMMDDHHMMSS)

NA

ExpDate Delivery length (days) +7d

Archive Delay before automatic (days) +14d

Delete Delay before automic

destruction (days) +60d



2.2.2 [Default] Section

In this section, you can manage the default language and the settings of the body message (refer to

1.2.3).

Section [Default]

Key Description Value by default

Language Languague of the message (Informative for the user)

English

Title Title of the message Message without title

Description Body of the message

Please clear this area using the DEL button and then either give a description here, or

import an existing rtf document using the ...

button

rtfFile UNC path to the rtf file

(Recommended: leave empty) NA

hlkFile UNC path to a file or a web page

(Recommended: leave empty) NA

wavFile UNC path to a .wav file NA

Signature Signature of the sender %DefaultValue% (Current sender)

ExpDate duration of delivery (measurement unit in day) +7d

Archive Duration before automatic archiving process

(measurement unit in day, refer to 3.2 section) +14d

Delete Duration before automatic destruction

(measurement unit in day, refer to 3.2 section) +60d

LanguageUsed Language to use English

TitleFont Fonts to use for the title NA

DescriptionFont Fonts to use for the message body NA

MsgDateFont Fonts to use for the date NA

hlkFont Fonts to use the link text NA

MenuFont Fonts to use for the menu NA

MsgDateFormat Date format NA



2.2.3 Other sections

For each language needed, a section must be created based on the [Default] section template. For

more information on the values of this section, please refer to the 2.2.2. Section.

2.3 Configuration of the dMessageTM console

The dMessageTM console is managed by the DDSendMsg.ini settings file located in C:\program

Files\Dynamic Desktop.

This file contains the following sections:

- [Options]

- [DirectoryServices]

2.3.1 [Options] Section

[Default] section keys

Key Description Default value

MessagesFolder Message storage folder <Userprofile>\Application Data\dMessage\Messages

TempDisplayedCategories Manage the categories to display in the Template area of the console.

( Use “;” to separate the categories)

*

“*” displays all the categories

SentDisplayedCategories Manage the categories to display in

the message part of the console ( Use “;” to separate the categories)

*

“*” displays all the categories

AvailableCategories All the available categories

( Use “;” to separate the categories)

Languages To add languages to the language list NA

LinkFilesMustExist If this field is True, specified link must exist. Otherwise the link is not added

to the message (see § 1.2.3) False

CategoryInSentMessage Add automatically category name in

the message tittle True



2.3.2 [DirectoryServices] Section

This section manages the interfacing between your LDAP and dMessageTM and contains the following

keys:

[DirectoryServices] section keys


UseOldNTGroups Must be True if you are using NT(Netbios) format for groups names (Domain\Group name, interlocking not supported)

True

LDAPCompliant

Manage the analisis methodology of your directory for groups and users listing.

If your directory is a NT4 type, set it as False as the value.

If you have a LDAP directory, you can set it as False to analize your whole directory or begin the analysis starting from a precise OU.

False

DefaultDomain

Default domain

You can specify a Netbios name ( example : MGI) or a LDAP path (DC=MGI, DC=FR)

NA

LDAPPageSize Fix the maximum size of components list appearing in the the Browsing directory mode (cf § 1.2.4)

50000

LDAPTimeOut Fix the maximum waiting delay 300

LDAPDefaultOU-Users

LDAPDefaultOU-Groups

LDAPDefaultOU-Computers

Starting OU for the directory listing. Leave these keys empty for browsing the whole directory listing.

NA

ADPath Keeps in memory the used path in the last directory listing browsing. This key is only used when the LDAPComplaint key is equal to True.

False

LDAPFullPath

Automatically add a root LDAP path for all the recipients (not only for the groups)

This key is only used when the LDAPCompliant is equal to True. False

DSType

Specify the LDAP directory. (empty to use an Active Directory) This key is only used when the ‘LDAPCompliant’ is equal to True.

NA

ContainersClasses UsersClasses

GroupsClasses ComputersClasses

Objets classes

This key is used only if ‘LDAPCompliant’ is equal to True. NA



2.3.3 Configuration of the reception agent

[Options] section keys

Key Description

CorporatePicture InformationPicture

WarningPicture ErrorPicture

Manages the image of the reception agent when a message is received.

For this key, specify the complete path to the image.

The images are in order:

- Default image - Information image - Warning image - Error image

InformationIcon WarningIcon

ErrorIcon

Manages the icon of the reception agent when a message is received.

The images are in order:

- Default image - Information image - Warning image - Error image

The ‘DDSendMsg.ini’ file manages the dMessageTM console. This file is located by default in ‘C:\Program

Files\Dynamic Desktop’.

This file contains the following sections:

- The [Options] section

- The [Default] section

- The [<Language>] sections



[Options] section keys

Key Description

IconX

(X somewhere between 1 and 9)

Manages the icon of the menu in the notification area

The icons are corresponding with the following events in

order:

Icon 1 : Default icon

Icon 2 : Receipt of a warning message

Icon 3 : Receipt of an error message

Icon 4 : dMessage is in the process of being activated

Icon 5 : dMessage is in the process of being activated (with an

unread warning message)

Icon 6 : Deactivation of dMessage (with an unread error

message)

Icon 7 : Receipt of an information message

Icon 8 : Receipt of a warning message

Icon 9 : Receipt of an error message

Note: The icons 1 and 7, 2 and 8, and 3 and 9 are displayed alternately when the receipt of a corresponding message. You can define the animations during the receipt of a message.

The icons must be in the 16x16 format, 16 colors.

MessagesFolder Messages storage folder

NotificationTimer Manages the reading frequency of the messages in the shared

folder (time in seconds)

Enable_MessagesFolderName Display the current directory read

Enable_ChangeMessagesFolder Change the current directory of messages.

The change will be effective at the next log-in.

Enable_localFolderAlert Alert the user when the Directory of messages is a local file (ie

located in C:/)



[Default] and [Others languages] section keys


WindowTitle

Title of the display window of the reception agent

[Default] : What happens today?

[French] : Que se passe-t'il aujourd'hui?

NATooltip

Manage the displayed text during the overview of the dMessage™ icon in the Taskbar

[Default] Double-click here to display the received

messages!

[French] : Double-cliquez ici pour afficher les messages

reçus!

NAShowNW Manage the text when the user right click on

dMessage™ icon in the notification bar

[Default] : Show my messages

[French] : Afficher mes messages



2.4 Automatic archiving and destruction of messages

2.4.1 Native operation and settings messages

This option allows to archive and/or destroy automatically a message.

An archived message will not be displayed in the reception window of the user, neither in the

dMessage console. However, it is saved in a sub-folder Archives of the storage messages Directory.

By default, a message is archived 14 days after its sending and is destroyed 60 days after its sending.

At the time of message edition, you can define specified dates for its automatic archiving and/or

destruction.

Automatic archiving and destruction of messages

1) In this area ‘Author settings’, click on ‘Automatic archive’ or on ‘Automatic delete’,

2) In the window that appears, select the date and the hour wanted and click on the ‘OK’ button The button ‘Cancel’ deletes the date configured and remove the automatic archiving or destruction.



2.4.2 Setting from the templates

dMessage™ provides you with the possibility to determine a archive date and/or the automatic

destruction of messages directly from a model, under the +Xd form (with X the number of days).

Automatic archiving and destruction of messages from templates

1) In dMessage console, select

the template that you want to

set up and click on ‘F12’

You can also access to it through

the menu ‘Edit’ then ‘With text

editor’

2) The file that appears in the text

editor, in the ‘[Options]’section,

add:

- ‘Archive=+Xd’ with X equals to

the number of days starting from

when messages will be archived

- ‘Delete=+Yd’ with Y equals to

the number of days starting from

when messages will be deleted

Note: Once archived or deleted, messages will not be displayed to the

recipients



2.5 Importing lists of recipients (users, computers or groups)

In order to benefit from this feature, the version 6.02.4 (or higher) must be installed on the sender

workstation.

Users, computers or groups can be imported directly through a text file with the following structure:

User=name of the user

Computer=name of the computer

Groups=name of the group

Figure 1 : Example of recipients import text file

Import a list of recipients

1) In the ‘Recipients list’ tab,

click on button, then select

the file to be imported.



2.6 Confidentiality of messages management

This option lets you define a message as being confidential. It will not be displayed in the dMessageTM

console of the sender. (All the recipients will received it, but only the author will have access to it

through the dMessageTM console)

Figure 2 : Confidentiality of messages management



2.7 Managing the messages access rights

In order to benefit from this feature, the version 6.02.4 (or higher) must be installed on the sender

workstation.

The authenticity of messages created through dMessage™ can be managed by controling the

dMessage™ console access to the directory of messages.

Manage the messages access rights

Step 1: Create a ‘security’ sub-folder in the storage folder

Step 2: Create the following txt files in the ‘security’ folder: AutorizedComputers.txt AutorizedGroups.txt AutorizedUsers.txt

Step 3: Specify inside the

related file (as in the model

opposite) the users, groups

ou computers allowed to

display the messages

directory content.

Note 1: We recommend to limit as much as possible the number of accounts having access to the ‘security’ folder.

Note 2: The asterisk * is allowed.

Note 3: If the ‘security’ sub-folder is created and no files are put inside, no one will not be able to display messages in the console.

Note 4: The TXT files have a cumulative impact. For example, if the three files are configured, the sender should be sure that:

The name of his computer is listed in AutorizedComputers.txt

His user name is listed in AutorizedUsers.txt

At least one of his groups is listed in AutorizedGroups.txt



3. DMESSAGE ADVANCED SETTINGS

3.1 Send messages in the command line

In order to benefit from this feature, the version 6.33 (or higher) must be installed on every

workstation.

The ‘ddSendMsg.exe’ process located in the dMessage install directory can be called in command line

or in an external program.

There are two types of dispatch set:

Command line options

Dispatch method Options

Through a message template

-Tf <Folder>: Message directory location

-Tn <File name>: Name of the template to use

-Mo <File path>: path to the file Chemin vers le fichier contenant la liste des destinataires

Without going through a template

-Title "Title content"

-Body "Message body"

-Level <Message level>: Degree of information of the message. Possible value : Information, Warning ou Error

-User <Target user> Repeat the option if there are several users: -User "User1" -User "User2" for multiple users -Group <Target group>: Repeat the option if there are several groups: -Group "Group1" -Group "Group2" -Computer <Target computer>: Repeat the option if there are several computers: -Group "Group1" -Group "Group2"

Note: for the option –Mo, recipients of messages must be listed in the file

as below:

Users=name1;name2;name3

Groups=grpname1;grpname2

Computers=computerName1;computerName2;computerName3

Examples of dispatches in command line

Dispatch method Options

Through a message template

ddSendMsg.exe -Tf "\\Srv\dMessage\Popup Messages\Templates" -Tn "English workshops.ini" -Mo \\Srv\dMessage\recipients.txt

Without going through a template

ddSendMsg.exe -Title "this is a test title" -Body "This is the body of your messsage." -Level "Warning" -User "User1" -User "User2"



3.2 Send messages in command line


workstation.

The background color can be changed according to the received message in the ‘Advanced edition’ of

the message. (F12 shortcut)

Procedure

Step 1: Select a template or a

message in the console and click on

F12 to configure it

You can also configure it by going in

the ‘Edit’ menu and then click on

‘With text editor’

Step 2: Indicate the R-G-B value for the items below in every language section of the file: - TitleColor (Title panel color) - BackColor (background color - MessagebackColor (Text

background color) - PanelbackColor (Navigation

panel backgroung color)

Step 3: Once the modifications are done, save et close the file

Some elements of the font can also be changes as in the following classification:

Font=<Bold>,<Italic>,<Underlined>,<Size>,<Name>,<Color R-G-B> Example: TitleFont=True,False,False,10,Verdana,255-0-0 If you want to impose a font color by default in every message, you should modify the ‘ddSendMsg.msg’ with a text editor for each sender concerned.



3.3 Managing the size of the windows

3.3.1 Enforce the minimal size of the reception window


workstation.

The following keys of the [Options] section from the dMessage.ini file allow to manage the size of the

reception window (height and width are percentages relative to the screen size).

[Options] Keys of the section

Key Description

windowHeight=50 Disabled option by default which allows to set the maximum size (in height) of the reception window on the local machine.

windowWidth=50 Disabled option by default which allow to set the minimal size (in width) of the reception window on the local machine.

3.3.2 Enforce a size per message


workstation.

Each of your messages can be displayed with a different format. This setting can be modify directly in

the ini file matching with the message in the storage folder:

Keys of the [Options] section

Key Description

GUI

Syntax Horizontal resolution; Vertical resolution ; Horizontal position ; Vertical position ; Height required (relative to the defined resolution) ; Witdh required (relative to the defined resolution) Example Supposing we have configured the size as followed : GUI=1000;1000;10;10;500;500 The screen will be considered as a 1000x1000 grid. The reception window will be positionned on the grid on (10;10). The size of the window will be 500x500 (relatively to the 1000x1000 grid)



3.3.3 Input the distribution lists


workstation.

If you want to browse the distribution lists configure the key as below in the ddsendmsg.ini of the

sender.

[Options] ddsendmsg.ini

Key Description

LDAPCompliant

Manage the analysis methodology of the directory for groups and users listing.

This key must be set as True

The distribution lists will appear in the Windows groups list or in ‘Browse the LDAP directory (tree view)

3.4 Debug Option


workstation.

The following keys of dMessage.ini allow to manage the messages storage folder.

3.5 Prevent the deletion of the reception agent


workstation.

In order to prevent users from deleting the reception agent process (ddesktop.exe), create on the user

workstation the following register value:

- Register key: HKEY_LOCAL_MACHINE\SOFTWARE\Dynamic Desktop\Parameters

- Register value: DenyKillAgent

- Type: DWORD

- Value: 1

Attention, if the user is the administrator of his workstation, he will be able to delete the ddesktop.exe.

Keys of the [Options] section

Key Description

Enable_MessagesFolderName Display the current directory read by right clicking on the dMessage icon in the notification area.

Enable_ChangeMessagesFolder

Change the messages directory by right clicking on the dMessage icon in the notification area.

The change will be effective at the next log-in.

Enable_localFolderAlert Warn the user if the storage folder is a local folder.



APPENDIXES

Appendix 1: Manual editing of templates or messages

Go in the storage folder that you set up by default. You will find files under the form

<YYYYMMDDHHMMSS> - < Category>.ini. These files are the messages sent through the console. They

are composed by at least two sections:

- The [Options] section groups the ‘basic setting’ and ‘conditions’ stages.

- The [Default] section groups all the settings regarding the message content.

Note: The ini files for the templates are located in the subfolder ‘Templates’.

[Options] Section

Keys Description Possible values

Level Display level of the message Information

Warning Error

Users Recipients of the messages

(users)

Name of the user in the Directory

*To add all the users

Groups Recipients of the messages

(groups) Name of a group in the

Directory

Computers Recipients of the messages

(workstation) Hostname IP address

GroupsID Group ID in the Directory

MinDate Message delivery starting date Universal Date format

MaxDate Message delivery ending date Universal Date format

CC<Number>Section Corresponding custom

condition section Section condition of DDSendMsg.ini file

CC<Number>Script Script Dynamic Desktop de la

condition personnalisée correspondante

Dynamic Desktop script name

CC<Number>Function Dynamic Desktop function of

the corresponding custom condition

Dynamic Desktop function name

CC<Number>Not Indicates if the message should be sent when the

condition is verified Empty

CC<Number>Param#<Number> Condition settings Not



[Default] and [other languages] section

Keys Description Valeurs possibles

Language Language Character string

Title Title of the message Character string

Description Recipients of the message

(groups) Character string

_rtfFile Recipients of the message

(workstations) Related path to the file

rtfFile Group ID in the directory Related path to the file

MoreInfoPath Message delivery starting date Related path to the file

_MoreInfoPath Message delivery ending date Related path to the file

_wavFile Corresponding custom condition

section Related path to the file

wavFile Dynamic Desktop script of the

corresponding custom condition section

Absolute path to the file

Appendix 2: Reception window

Click to display the time of dispatch or

reception of the message.

By default, the displayed time is the time

of dispatch.

Pest l’heure d’envoi du message.

Drag your mouse pointer to

display a tooltip to know the

language used.

If the message was created in numerous

languages this links allows to switch the

language. A right-click on this link allows to

choose directly the displayed language.

These buttons allow to browse through

the messages. A right-click erases the

current message or clear the messages

list.



Appendix 3: Command line options for the dMessage TM console

dMessage™ console release options

Options Syntax Description

- T -T "<Title header>” dMessage™ console title

-MF -MF "<Default messages

folder>" Default messages folder

-TempCat -TempCat "<Categories>" Displayed messages categories in the templates list (use ; as a splitter)

-SentCat -SentCat "<Categories>" Displayed messages categories in the sent messages list (use ; as a splitter)

-H -H "<Folder path>" Home folder

-Of -Of "<text file path>" Enables you to configure options from a file

-I -I "<Ini file path>" Path to the DDSendMsg.ini file

-Msg -Msg "<Msg file path>" Path to the DDSendMsg.msg file

Appendix 4: Retrieve information from the client workstation

On the user workstation, the following information can be retrieved and/or modified:

- Messages delivery

- Windows appearance (Messages displaying and dialog window)

Messages delivery HKEY_CURRENT_USER\Software\Dynamic Desktop\PlugIns\Popup messages in notification window

Keys Description

<Path to the messages storage folder>\Displayed

List of messages which must be delivered

<Path to the messages storage folder>\Failed

List of messages which have not been issued correctly

<Path to the messages storage folder>\FolderID

Folder ID

<Path to the messages storage folder>\ForcedDate

Date of the next messages directory browsing

<Path to the messages storage folder>\LastTry

Date of the last messages directory browsing



dMessage console setup HKEY_CURRENT_USER\Software\Dynamic Desktop

Keys Description

dMessage Messages storage folder

dMessage\Modules\dMessage\ShowTips Display the online Help in the dMessageTM

console (set up the key to 0 in order to desable the Help)

Time zones display HKEY_CURRENT_USER\Software\Dynamic Desktop\Modules\FrmNotification\Full mode\2

Keys Description

Time Zones\Format Time format for the time zones

Time Zones\Separator Time zones spliter

Time Zones\#X\(par défaut) X varie entre 1 et 5

Selected time zone

Time Zones\#X\City X varie entre 1 et 5

Name of the city to display

Reception window appearance HKEY_CURRENT_USER\Software\Dynamic Desktop\Modules\FrmNotification\Reduced mode

Keys Description

DescriptionHeight Height of the description area

Height Height of the window

Left Position horizontale par rapport au bord gauche

de l’écran

Top Position horizontale par rapport au bord

supérieur de l’écran

Width Largeur de la fenêtre

dialog boxes appearance HKEY_CURRENT_USER\Software\Dynamic Desktop\Modules\FrmUserDialog\ConfBox

Keys Description

Height Height of the window

Left Horizontal postion from the left edge of the screen

Top Horizontal postion from the upper edge of the screen

Width Window width



Appendix 5: dMessage™ silent set up options

dMessageTM is delivered with an installation executable which can be launched in a silent mode with

the following command lines:

dMessage Installation

Type of installation Command line

Full silent version « Path to dMessageSetup.exe » /S

Full silent version with the messages storage folder choice

« Path to dMessageSetup.exe » /S /MF=« Path to messages storage folder »

Silent reception agent version « Path to dMessageSetup.exe » /S /Mode=AGENT

Silent agent version with the messages storage folder choice

« Path to dMessageSetup.exe » /S /MF=« Path to the messages storage folder » /Mode=AGENT