background image

Using i!-ConnectLinx

7

i!-ConnectLinx

Action Persistence and Distribution

i!-ConnectLinx stores the supported actions in a XML file called 

i!-ConnectLinx.xml

 located in 

the 

doc:\user\connectlinx directory

. All action information is stored in this file. i!-ConnectLinx 

compatible technologies retrieve this file directly from the NetLinx Master.

It may not always be practical to keep all the i!-ConnectLinx action list files on the NetLinx Master. 

For instance, in a corporate environment with 20 NetLinx Masters in various conference rooms, a 

user outside the company needs to have direct access to each NetLinx Master through the firewall 

in order to download the files. Additionally, each NetLinx Master needs it’s own DNS entry, so 

users do not have to remember an IP Address.

To simplify action list management, i!-ConnectLinx compatibly technologies support an action list 

index file format. This index file lists the names of various files and a URL where the file can be 

retrieved. This allows you to move all the action list files from the NetLinx Masters to a web server 

for easy retrieval. Place this index file in a directory called 

connectlinx

 off the root directory of the 

web server and name it 

i!-ConnectLinx.xml

. However, it can contain links to any URL with any 

file name in any folder.

In the above example, the IT department might collect all the action list files and place them in the 

connectlinx directory of the company’s web server. Each file should be renamed to reflect the room 

that the action list is for. Then a web developer should edit the supplied i!-ConnectLinxList.xml file 

to reflect the names and URL’s of each of these files and rename it to i!-ConnectLinx. Now anyone 

can retrieve an action list for the company’s system by pointing to the company’s main web address 

and selecting a room file from the list.

If desired, the action list index file can be viewed in an HTML browser by using an eXtensible 

Style Language file. A web developer can make any adjustments to the XSL file so the index file 

has the look of the company’s web site when viewed in an HTML browser. A sample XSL file, 

i!-ConnectLinxList.xsl

, is supplied with i!-ConnectLinx and should be placed in the same 

directory on the web server as the index file.

The URL contained in the index file can point to an additional index file to allow for tree style 

navigation. For instance, the main file might list cities where the company has offices, which point 

to an index file for each city. Each city index file might contain a list of buildings and point to 

building index files. Then each building index file contains the list of rooms in that building and 

points to the actual action list for each room.

Summary of Contents for i!-ConnectLinx

Page 1: ...instruction manual integration Solutions i ConnectLinx...

Page 2: ...ceipt AMX DISCLAIMS ALL OTHER WARRANTIES EITHER EXPRESS OR IMPLIED INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE WITH REGARD TO THE AMX SOFTWA...

Page 3: ...d Operating Systems 1 Minimum PC Requirements 1 Installing i ConnectLinx 2 Using i ConnectLinx 3 Standard Actions 4 Action Arguments 6 Action Persistence and Distribution 7 International Issues Locali...

Page 4: ...ii i ConnectLinx Table of Contents...

Page 5: ...nectLinx module that handles exposing and executing action requests see the Module section on page 11 To support i ConnectLinx you simply include this module in your program define your actions and wr...

Page 6: ...Windows programs before going any further Click Next to proceed 4 In the Select i ConnectLinx Install Location dialog use the Browse button to navigate to a directory other than the default install di...

Page 7: ...s say you want the user to be able to allow the ability to play and stop a VCR Imagine you have two touch panel buttons that do these functions write code that responds to the pushes BUTTON_EVENT TP 1...

Page 8: ...technology programs itself to execute an action on a system it also stores a copy of the system identifier from the action list This identifier is sent to i ConnectLinx along with this action executio...

Page 9: ...x with the macro you want added For example DATA_EVENT vdvCLActions ONLINE Setup actions VCR Select and Play Record SEND_COMMAND vdvCLActions ADD MACRO vcr For a complete list of macros see the i Conn...

Page 10: ...alue from Each argument is numbered in the order they are added Arguments are added by using the ADD NARG ADD LARG ADD SARG and ADD EARG commands When an i ConnectLinx compatible technology requests a...

Page 11: ...ks to any URL with any file name in any folder In the above example the IT department might collect all the action list files and place them in the connectlinx directory of the company s web server Ea...

Page 12: ...wever this file is difficult to edit in a standard text editor so an XML file editor is recommended Alternatively the i ConnectLinxStdText xml file can be created using the i ConnectLinxEngineStdTextW...

Page 13: ...Min Max Step Default Adds a number argument to Action The Arg Name Argument Name is required The Min and Max define the limits for this argument in the range 32767 to 32767 The Step defines the minim...

Page 14: ...Parent Describes a child of a node Returned by GET NODE command ACTION ID Action Help String Folder Describes an action Returned by GET ACTION command NARG Action Arg Name Min Max Step Default Descri...

Page 15: ...LinxEngineMod Module definition code is displayed below DEFINE_MODULE i ConnectLinxEngineMod mdlCL vdvCLActions Where mdlCL is a unique module name i ConnectLinxEngineMod Module Parameter vdvCLActions...

Page 16: ...ve richardson TX 75082 USA 469 624 8000 800 222 0193 fax 469 624 7153 technical support 800 932 6993 033 004 2641 2 05 2005 AMX Corporation All rights reserved AMX the AMX logo the building icon the h...

Reviews: