Create a desktop shortcut

1

2

20

= Initial situation =

8

9

The Client Command module ‘Create Shortcut’ allows you to distribute a shortcut on the desired Clients. The desired shortcut could link to a central application or to a URL, e.g. to the company intranet. This allows every employee to access the intranet directly from the desktop of any Client to obtain information or documents.

10

11

In this example, the script checks whether the „ACMP Kiosk“ shortcut already exists on the public desktop of a client. If the shortcut does not exist, it is created. If the shortcut already exists on the client desktop, the command to create the shortcut is skipped and the script exits without making any changes to the system.

How to proceed:

== Select Script ==

1. Navigate to the //Client Commands// > //Create// module.

18

1. Click on //Add.// The Client Commands Editor opens, where you can decide in advance whether the command should be executed on the Client or on the Console side. In this example, select the Client Script.

19

20

== **Insert and customize Command //If file (not) exist//** ==

21

22

1. In the command list, select //Conditions > If file (not) exist//.

23

1. Double-click on this condition to open the command properties, which can be customized for each case.

24

1. In the //Details// tab, enable the //If file does not exist// radio button.

25

1. In the settings, insert the path of the file that should appear as a shortcut on the desktop, in this case, for example, %SHELLFOLDER_COMMON_DESKTOP%ACMP KIOSK.Ink

26

1. Click on //OK//. The first command appears in row 1.

(((

[[image:642_Use Case Client Command_Verknüpfungen Desktop_489.png||alt="If file (not) exist.png" data-xwiki-image-style-alignment="center"]]

31

32

33

Customised If file (not) exist command

)))

== **Insert Command //Create Shortcut//** ==

39

40

1. Then go to //Files > Create shortcut// in the command list.

41

1. In the General tab, enter a description of the action, e.g. „Create Shortcut“ in //Description of action//. All other settings can be left as they are.

42

1. The following items are entered in the //Action Details// tab:

43

44

(% style="width:799.481px" %)

45

|(% style="width:159px" %)**Description**|(% style="width:638px" %)ACMP Kiosk

46

|(% style="width:159px" %)**Command line**|(% style="width:638px" %)(((

47

C:\Program Files (x86)\ACMPClient\Acmpkiosk.exe

48

49

50

The path leading to the file to be linked is entered here.

51

52

)))

53

|(% style="width:159px" %)**Location**|(% style="width:638px" %)%SHELLFOLDER_COMMON_DESKTOP%

54

|(% style="width:159px" %)**Start**|(% style="width:638px" %)Normal window

55

|(% style="width:159px" %)**Working file**|(% style="width:638px" %)(((

56

C:\Program Files (x86)\ACMPClient\

57

58

59

As a rule, you enter the folder in which the working directory is to be located here.

)))

(((

)))

4. Click //OK//. The command should appear in row 2.

68

69

70

Please note that this command must be indented under the main command //If file (not) exist//. To do this, use the arrows in the toolbar < > or the shortcuts CTRL + -> or CTRL + <-.

(((

)))

== **Optional: Adding a Command //Comment//** ==

78

79

This step is optional and can be added if you want to add a comment to the Client Command to provide a more detailed explanation.

80

81

1. Select the //Miscellaneous > Comment// command from the command bar.

82

1. Insert the desired comment in the free text field, such as: //This is the public desktop.//

83

84

The editor should then look like this:

85

86

87

[[image:Client Command Editor vollständig.png]]

88

89

90

Client Command Editor

3. Save the Client Command.

95

96

== **Running Client Command phases** ==

97

98

The Client Command can now be moved through the //Test//, //Synchronise//, //Release// and //Execute// phases. Only then can the link on the desktop be checked and added if necessary.

Wiki source code of Verknüpfung auf dem Desktop erzeugen

Navigation

author	version	line-number	content
		1	{{aagon.priorisierung}}
		2	20
		3	{{/aagon.priorisierung}}
		4
		5	{{aagon.floatingbox/}}
		6
		7	= Initial situation =
		8
		9	The Client Command module ‘Create Shortcut’ allows you to distribute a shortcut on the desired Clients. The desired shortcut could link to a central application or to a URL, e.g. to the company intranet. This allows every employee to access the intranet directly from the desktop of any Client to obtain information or documents.
		10
		11	In this example, the script checks whether the „ACMP Kiosk“ shortcut already exists on the public desktop of a client. If the shortcut does not exist, it is created. If the shortcut already exists on the client desktop, the command to create the shortcut is skipped and the script exits without making any changes to the system.
		12
		13	How to proceed:
		14
		15	== Select Script ==
		16
		17	1. Navigate to the //Client Commands// > //Create// module.
		18	1. Click on //Add.// The Client Commands Editor opens, where you can decide in advance whether the command should be executed on the Client or on the Console side. In this example, select the Client Script.
		19
		20	== Insert and customize Command //If file (not) exist// ==
		21
		22	1. In the command list, select //Conditions > If file (not) exist//.
		23	1. Double-click on this condition to open the command properties, which can be customized for each case.
		24	1. In the //Details// tab, enable the //If file does not exist// radio button.
		25	1. In the settings, insert the path of the file that should appear as a shortcut on the desktop, in this case, for example, %SHELLFOLDER_COMMON_DESKTOP%ACMP KIOSK.Ink
		26	1. Click on //OK//. The first command appears in row 1.
		27
		28	(((
		29	{{figure}}
		30	[[image:642_Use Case Client Command_Verknüpfungen Desktop_489.png\|\|alt="If file (not) exist.png" data-xwiki-image-style-alignment="center"]]
		31
		32	{{figureCaption}}
		33	Customised If file (not) exist command
		34	{{/figureCaption}}
		35	{{/figure}}
		36	)))
		37
		38	== Insert Command //Create Shortcut// ==
		39
		40	1. Then go to //Files > Create shortcut// in the command list.
		41	1. In the General tab, enter a description of the action, e.g. „Create Shortcut“ in //Description of action//. All other settings can be left as they are.
		42	1. The following items are entered in the //Action Details// tab:
		43
		44	(% style="width:799.481px" %)
		45	\|(% style="width:159px" %)Description\|(% style="width:638px" %)ACMP Kiosk
		46	\|(% style="width:159px" %)Command line\|(% style="width:638px" %)(((
		47	C:\Program Files (x86)\ACMPClient\Acmpkiosk.exe
		48
		49	{{aagon.infobox}}
		50	The path leading to the file to be linked is entered here.
		51	{{/aagon.infobox}}
		52	)))
		53	\|(% style="width:159px" %)Location\|(% style="width:638px" %)%SHELLFOLDER_COMMON_DESKTOP%
		54	\|(% style="width:159px" %)Start\|(% style="width:638px" %)Normal window
		55	\|(% style="width:159px" %)Working file\|(% style="width:638px" %)(((
		56	C:\Program Files (x86)\ACMPClient\
		57
		58	{{aagon.infobox}}
		59	As a rule, you enter the folder in which the working directory is to be located here.
		60	{{/aagon.infobox}}
		61	)))
		62
		63	(((
		64
		65	)))
		66
		67	4. Click //OK//. The command should appear in row 2.
		68
		69	{{aagon.infobox}}
		70	Please note that this command must be indented under the main command //If file (not) exist//. To do this, use the arrows in the toolbar < > or the shortcuts CTRL + -> or CTRL + <-.
		71	{{/aagon.infobox}}
		72
		73	(((
		74
		75	)))
		76
		77	== Optional: Adding a Command //Comment// ==
		78
		79	This step is optional and can be added if you want to add a comment to the Client Command to provide a more detailed explanation.
		80
		81	1. Select the //Miscellaneous > Comment// command from the command bar.
		82	1. Insert the desired comment in the free text field, such as: //This is the public desktop.//
		83
		84	The editor should then look like this:
		85
		86	{{figure}}
		87	[[image:Client Command Editor vollständig.png]]
		88
		89	{{figureCaption}}
		90	Client Command Editor
		91	{{/figureCaption}}
		92	{{/figure}}
		93
		94	3. Save the Client Command.
		95
		96	== Running Client Command phases ==
		97
		98	The Client Command can now be moved through the //Test//, //Synchronise//, //Release// and //Execute// phases. Only then can the link on the desktop be checked and added if necessary.