REST - hur funkar det

[Patrik]

Hej
Jag är ny med denna fantastiska programvara.
Nu hade jag tänkt styra lite saker från min telefon. Det är en HTC med Windows Mobile.
Det enklaste verkar ju vara att bara köra lite REST länkar. Fast då måste man ju veta vad man skall skriva i länkarna.
Jag har hittat något exempel här på forumet och det funkade bra, fast jag skulle gärna vilja veta lite mer.
Är det någon som har tips på var kan man läsa sig till hur detta fungerar.

[Martin]

Det finns viss dokumentation för detta på sajten, men det täcker egentligen bara 0.8-versionerna. Jag har inte hunnit uppdatera detta för 0.9.

REST-interfacet är begränsat - all funktionalitet finns inte här. Det är mer tänkt som en enkel väg in för att utföra enkla operatoner - tända, släcka, dimma etc...

Jag skickar med de sökvägar som man kan använda. Generellt så är det som står innanför "måsvingarna" ("{" och "}") något du måste fylla i.
Exempelvis "{id}" som kan vara en enhets id, datakällas id etc...

Följande sökvägar finns i 0.9.x och är sökvägar som _inte_ påverkar något i servern:

• http://localhost:8800/datasources
• http://localhost:8800/datasources/{id}
• http://localhost:8800/datasources/filesystemwatchers
• http://localhost:8800/datasources/{id}/ ... {newerThan}
• http://localhost:8800/devices
• http://localhost:8800/devices?groupid={groupId}
• http://localhost:8800/devices/{id}
• http://localhost:8800/devicegroups
• http://localhost:8800/devicegroups?incl ... udeDevices}
• http://localhost:8800/devicegroups/{id}
• http://localhost:8800/devicegroups/{id} ... udeDevices}
• http://localhost:8800/events/future?maxcount={maxCount}
• http://localhost:8800/events/historic?m ... ={maxCount}
• http://localhost:8800/scenarios
• http://localhost:8800/scenarios/active
• http://localhost:8800/entitylogentries? ... {newerThan}
• http://localhost:8800/entitylogentries/latest
• http://localhost:8800/systemsettings/byname
• http://localhost:8800/systemsettings
• http://localhost:8800/systemsettings/byname/{name}
• http://localhost:8800/systemstates/byname
• http://localhost:8800/systemstates
• http://localhost:8800/systemstates/byname/{name}
• http://localhost:8800/systemlogentries? ... {newerThan}
• http://localhost:8800/extendedservices/ ... et={offset}

Följande sökvägar gör att servern påverkas när du anropar dem...
I "riktig" REST så ska egentligen inget påverkas när man inte postar in information till servern, men för enkelhets skull så krävs ingen postning till Switch Kings REST-delar:

• http://localhost:8800/datasources/{id}/ ... lue={value}
• http://localhost:8800/devices/{id}/turnon
• http://localhost:8800/devices/{id}/turnoff
• http://localhost:8800/devices/{id}/dim/{level}
• http://localhost:8800/devices/{id}/synchronize
• http://localhost:8800/devices/{id}/cancelsemiauto
• http://localhost:8800/devicegroups/{id}/turnon
• http://localhost:8800/devicegroups/{id}/turnoff
• http://localhost:8800/devicegroups/{id}/dim/{level}
• http://localhost:8800/devicegroups/{id}/cancelsemiauto
• http://localhost:8800/commandqueue?oper ... m3={param3}

Den sistnämnda, commandqueue, är den som används om du exempelvis vill ändra scenario.

Fråga på om det är något speciellt du är ute efter...

[Patrik]

Superbra, tack!
Precis vad jag undrade över.

Fast nu har det tagit stopp igen.

Jag hade tänkt mig att när jag är på väg hem så skulle jag kunna tända lite olika lampor så att det ser trevligt ut.
För detta har jag lagt upp en (virtuell) enhet i SK som inte är kopplad till någon riktig lampa. Sedan har jag installerat ScriptExecutor och CmdLine.
Jag har skapat en .bat fil som tänder lämpliga lampor med CmdLine. Denna .bat fil funkar perfekt om man klickar på den. Sedan tänkte jag att ScriptExecutor skulle köra denna fil när jag tänder min virtuella enhet.
Här tar det dock stopp totalt. Inga lampor tänds. Om jag går in i "Event Viewer --> Application" så står det klart och tydligt att filen har körts.
Jag har helt tömt ut mina idéer så något uppslag om vad det kan vara som är fel hade varit mycket välkommet.

[Isaksson]

Låter som det skulle kunna ha med behörighet att göra.

Hur ser din .bar fil ut och vart ligger den sparad och vilket operativsystem kör du?

[Martin]

Hur ser konfigurationsfilen för Script Executor ut?
Om du inte har gjort det - prova att sätta:

Code: Select all

waitForExit="true"

och

Code: Select all

intercept="true"

Det känns också som om det skulle kunna bli en låsning här... När Switch King jobbar med att utföra ett kommando så blockerar den (lite beroende på anrop) inkommande anrop för att servern inte ska hamna i ett läge där den inte vet vad som egentligen gäller för dina enheter.

Switch King -> Plugin -> Cmd Line -> Switch King skulle kunna orsaka en låsning. Dock så kan jag tycka att det isf borde smälla och ge ett fel i loggen - antingen i Windows logg eller i Switch Kings logg.

[Patrik]

Jag kör SBS2003.
Bat filerna ligger i CmdLine-katalogen.
I SK loggen ser man att den virtuella enheten ändras och i Windowsloggen ser man att bat-filerna körs efter det, fast sedan händer inget mer.

Det blir möjligen någon intern låsning som inte går att komma runt.
Jag får kanske fundera ut ett annat sätt att angripa problemet.

[Martin]

Lägg in " >info.txt" i bat-filen, så att output från filen hamnar i en textfil.
Då kan du få en visuell bekräftelse på att filen verkligen körs.

[Patrik]

Klurigt värre.
Enligt systemloggen så körs filen. Fast Martin har helt rätt, det dyker inte upp någon outputfil. Det måste nog innebära att det blir något fel i körningen i all fall.

Jag funderade på ett annat spår.
Att göra ungefär samma sak via webinterfacet. Fast jag har inte hållit på något med ASP.
Det är möjligen inte så att någon har en "Hello world" kod som inte gör något annat än att den tänder en lampa. I så fall skulle jag ju kunna bygga från detta i stället.