HS3 Scripting Documentation

[rjh]

[UPDATED 3-4-14]

HS3 scripting docs are here (this is the FULL HS3 Help file):

http://help.homeseer.com/help/HS3/static/

[jiml@quicksmart.com]

Is this scripting documentation complete?

I need to replace all of my very easy and intuitive hs.NewEventEx commands that are in my scripts now that hs.NewEventEx has been removed.

After studying the current script documentation it looks like its fairly easy to create an event. After the event is created it looks like triggers have to be added to the event, and then actions added to the triggers (or events?).

It doesn't look like there are any commands in the scripting documentation that will allow me to add a trigger based on days of the week, for example. And then I haven't found any script commands that will let me add a "run script" action to either a trigger or event, where ever it is supposed to be added.

It looks like the triggers and actions can all be added using the HS3 GUI. Which documentation set shows me how to programmatically build the same events/triggers/actions than I can manually build in the HS3 GUI?

Here's an example of an HS2 command that I need to replace/rebuild:

hs.NewTimeEvent( eventName, runTimeStrr, runDateStr, 1,1,1,1,1,1,1,"", 0,scriptstr, goupName)

Also, on some of my events, I need to set them to automatically delete after running. What is the script command for that?

It seems like this should probably be posted somewhere, so if I'm missing where it is posted, if you could refer me to the documentation that would be helpful. I've already reviewed the existing scripting commands document posted on this thread.

Thanks,

Jim

[surovich]

Is there a PDF or DOC to just print this???

[regm]

I thought I read somewhere that VBScript would not be supported in HS3. However, I see VBScript examples in the HS3 scripting documentation. Can we still use VBScript with HS3 on the Windows platform? Is it only HS3 on Linux where VBScript cannot be used?

[rjh]

VBScript is still supported, but only on Windows. The Linux version only supports vb.net scripting.

I thought I read somewhere that VBScript would not be supported in HS3. However, I see VBScript examples in the HS3 scripting documentation. Can we still use VBScript with HS3 on the Windows platform? Is it only HS3 on Linux where VBScript cannot be used?

[Simonk]

The PDF link at the top of thread doesn't work for me, page cannot be found.

[enigmatheatre]

The PDF link at the top of thread doesn't work for me, page cannot be found.

Simonk,

Remove the ftp.

Try this:

//homeseer.com/support/homeseer/HS3/hs3_scripting.pdf

Greig.


Edit: As a note to Rich most of the FTP post on the board need this removed to work.

[rjh]

I fixed the link to the PDF.

[prsmith777]

Is there anywhere that has a comprehensive list of the differences between scripting in HS2 vs HS3?

It would have been really helpful to have "New in HS3" or "Changed from HS2" or something to that effect in the HS3 scripting pdf file.

[stevea]

Is there anywhere that has a comprehensive list of the differences between scripting in HS2 vs HS3?

It would have been really helpful to have "New in HS3" or "Changed from HS2" or something to that effect in the HS3 scripting pdf file.

I agree, and even better if there was some stuff about how to do things in those cases where the HS2 methods have been dropped completely (e.g., IsON and IsOFF).

Steve

[jiml@quicksmart.com]

Add action to Event

The updated scripting documentation (as of 12-28-2013) provides a function "AddDeviceActionToEvent." This doesn't seem to provide a way to add an action to the event that runs a script.

I need to be able to create an event programmatically, and then attach an action that runs a script. I need to be able to trigger the event on a daily basis.

This seems to be a fairly obvious capability. I hope this capability is supported in HS3.

In addition, in the script documentation for AddDeviceActiontoEvent there is a reference to CAPIControl - the link doesn't work.

Can you tell me if HS3 is going to support the ability to add a "run Script" action on an event that I create programmatically. If this is already available, can someone point me to the correct place in the documentation?

Thanks,
Jim

[rjh]

It is not in there now, you can open a bugzilla ticket for the enhancement.

Can you tell me what you are trying to do so I can see why the current event mechanism will not work? We want to get away from complex scripting as much as possible.

The updated scripting documentation (as of 12-28-2013) provides a function "AddDeviceActionToEvent." This doesn't seem to provide a way to add an action to the event that runs a script.

I need to be able to create an event programmatically, and then attach an action that runs a script. I need to be able to trigger the event on a daily basis.

This seems to be a fairly obvious capability. I hope this capability is supported in HS3.

In addition, in the script documentation for AddDeviceActiontoEvent there is a reference to CAPIControl - the link doesn't work.

Can you tell me if HS3 is going to support the ability to add a "run Script" action on an event that I create programmatically. If this is already available, can someone point me to the correct place in the documentation?

Thanks,
Jim

[jiml@quicksmart.com]

Can you tell me what you are trying to do so I can see why the current event mechanism will not work? We want to get away from complex scripting as much as possible.

I'm updating the EtherRain interface scripts. I need to set up events on the fly to support the ability to run multiple controllers sequentially. The first controller in the chain will start at a pre-determined time, so this event can be a manual setup, the other controllers in the chain will have various starttimes throughout the year depending on cycle setbacks. These events need to be created (as one time self deleting events) when the first controller event runs.

Currently HomeSeer2 supports running a script as an action, both manually and programmatically, and then only manually in HS3, so it seems odd that this request would be considered an enhancement.

I also want my web page interface scripts to be able to build events for the user as an ease-of-use feature, so they don't have to go through the trouble of manually entering the events, for example housing keeping events like emailling upon an error condition. These can be set up manually, but then add complexity to the setup.

Regarding bugzilla: I'm pretty sure I don't have access to your bugzilla - I'm not a certified HomeSeer developer. How do I get access to bugzilla?

thanks,

JIm

[rjh]

Anyone can access bugzilla, just go to homeseer.com/bugzilla and create an account and then log this issue so we can track it.

I'm updating the EtherRain interface scripts. I need to set up events on the fly to support the ability to run multiple controllers sequentially. The first controller in the chain will start at a pre-determined time, so this event can be a manual setup, the other controllers in the chain will have various starttimes throughout the year depending on cycle setbacks. These events need to be created (as one time self deleting events) when the first controller event runs.

Currently HomeSeer2 supports running a script as an action, both manually and programmatically, and then only manually in HS3, so it seems odd that this request would be considered an enhancement.

I also want my web page interface scripts to be able to build events for the user as an ease-of-use feature, so they don't have to go through the trouble of manually entering the events, for example housing keeping events like emailling upon an error condition. These can be set up manually, but then add complexity to the setup.

Regarding bugzilla: I'm pretty sure I don't have access to your bugzilla - I'm not a certified HomeSeer developer. How do I get access to bugzilla?

thanks,

JIm

[FredrikKan]

Link to pdf broken

I fixed the link to the PDF.

The link to the pdf file seems to be broken again(?).