Creating a new Section API Call

Developer's Corner General Dev Discussions
1

Does anyone know if there is an http based URL call to create a new “Section” for a home? A section is an organizational unit that rooms can be associated to. I saw on the documentation that new rooms can be created with the following command:
http://ip_address:3480/data_request?id=room&action=create&name=Kitchen

However, when I try guessing what the format of this is for creating a new Section, it does not work. Here’s what I tried:
http://ip_address:3480/data_request?id=section&action=create&name=Basement

Any thoughts? I’m using a Vera2.

Thanks,
-Shawn

2

Are you running UI5 on your Vera 2? If so this is currently not possible.

  • Garrett
3

Yes. It is running UI5. I was hoping to use API calls to clean up sections. I had created sections in my old house then moved. The old sections still show up in Automator.app which lead me to believe they are still there. I was hoping that they simply removed the UI to make these changes but some underlying API calls might still be available. New rooms created in UI5 appear to default to the section “My Home”.

4

Sections do not exist in UI5, but if you created them in say UI4, they will still show up. I have not found any api that will create sections. I’ve done my time to find something to incorporate into my app. MCV was suppose to add sections back at some point but still hasn’t done so.

  • Garrett
5
Sections do not exist in UI5
MCV chose not to provide a User Interface for Sections in UI5 ... They just pretend the rooms are all in one section. They still organize using the UI4 organization of rooms in section's in their data structures ...

You can still create and manipulate Sections from Java Script … (There was NO Vera Side api in UI4) using functions like:

[ul][li]function get_section_rooms(section)[/li]
[li]function new_section_id[/li]
[li]function add_section(sectionName)[/li]
[li]function delete_section(section)[/li][/ul]

And using the add_room code below … you can see how to navigate rooms to move rooms between sections.

function add_room(sectionID,roomName){
	var roomID=new_room_id();

	var pos=jsonp.ud.rooms.length;

	var new_room=(roomName)?roomName:"New room";

	jsonp.ud.rooms[pos]={};
	jsonp.ud.rooms[pos].id=roomID;
	jsonp.ud.rooms[pos].name=new_room;
	jsonp.ud.rooms[pos].width=5;
	jsonp.ud.rooms[pos].height=4;
	jsonp.ud.rooms[pos].section=sectionID;
	
	return roomID;
}

So you could write a plugin to provide a User Interface for sections … but
Vera will NOT display them … I am not sure which 3rd party apps will honor sections …
Since I eliminated mine when I went to UI5 … I am not sure how the various Apps handle sections.
Personally I would like to see them added back.