NEWS
API Dokumentation
-
Ich hab dasselbe Problem. Ich krieg getChannelsOf einfach nicht zum laufen. Meine Struktur ist
device/channelA/state1
device/channelA/state2
device/channelB/state1
device/channelB/state2this.getDevices((error, result?: Array<any>) => { result.forEach((item: ioBroker.BaseObject) => { let id_alternative_1 = item._id.substr(this.namespace.length + 1); let id_alternative_2 = item._id; this.getChannelsOf(item.common.name, (error, channels?: Array<any>) => {item._id.substr(this.namespace.length + 1)
getDevices liefert mir zwar die Liste der Devices. Aber getChannelsOf ergibt immer dasselbe. Egal ob ich als parent item.common.name, item._id oder item._id.substr(this.namespace.length + 1) angebe. Dabei wäre wohl item._id die elegante Variante.Auf Github finde ich auch kaum Projekte, welche diese Funktion einsetzen. Un dort wo die Funktion gebraucht wird, ist das ganze Inkonsistent.
-
Hi,
also der erste Parameter ist die ID des Device-Objekts von dem man die Channels will. Und es ist erwartet das das auf der obersten ebene liegt. Es sind als per Definition keine Punkte drin. Also unter der Annahme das bei Dir alles auf der ersten Ebene ist was Devices angeht dann sollter id_alternative_2 das sein was gehen sollte.
-
Hi,
Leider will das nicht so ganz.Hier ist ein Screenshot der Objekte:

"enocean_jobe.0" ist die Instanz meines Adapters. enocean_jobe_0_tv ist das erste von 4 Devices. Dann kommte jeweils Channel A und B und je zwei States. Entsprechend sind die devices auf der obersten Ebene des Adapters.On ready führe ich alles mögliche aus, was irgendwie sinnvoll sein könnte:
this.getChannels("enocean_jobe_0_tv", (err, list) => { this.log.info("channel list for enocean_jobe_0_tv: " + JSON.stringify(list)); }) ; this.getChannels("tv", (err, list) => { this.log.info("channel list for tv: " + JSON.stringify(list)); }) ; this.getDevices((error, deviceList?: Array<any>) => { if(deviceList) { deviceList.forEach((item) => { this.log.info("device id " + item._id); this.getChannels(item._id, (err, list) => { this.log.info("channel list for " + item._id + " is: " + JSON.stringify(list)); }); let shortId = item._id.substr(this.namespace.length + 1); this.getChannels(shortId, (err, list) => { this.log.info("channel list for " + shortId + " is: " + JSON.stringify(list)); }); let deviceId = item._id.substr(this.namespace.length + 1); let ns_id = this.namespace.replace(/[.\s]/g, "_") let longId = this.namespace + "." + ns_id + "_" + deviceId; this.getChannels(longId, (err, list) => { this.log.info("channel list for " + longId + " is: " + JSON.stringify(list)); }); let stateId = longId + "." + ns_id + "_" + deviceId + "_A.switch_A"; this.log.info("state is " + stateId); this.getState(stateId, (error: string | null, obj: ioBroker.State | null | undefined) => { this.log.info("state is for " + stateId + " is " + JSON.stringify(obj)); }); }); } });Das Resulat ist dann sehr ernüchternd:

Interessant dabei ist, dass ich zwar einen State abfragen kann, indem ich aus der deviceId eine
StateId zusammenbaue. Aber die Channels kann ich nicht abfragen, auch wenn ich das analoge Schema wie für die Device-Id anwende. Auch alle anderen sinnvollen Varianten führen nicht zum Ziel. -
@150d said in API Dokumentation:
wie/wo finde ich heraus, wie eine bestimmte Funktion
Noch eine Info am Rande:
Wenn du VSCode oder einen ähnlichen Editor verwendest, der TypeScript versteht, bekommst du neuerdings Hilfe zu den Funktionen mitgeliefert.Dazu musst du das Paket
@iobroker/adapter-coreeinbinden und deinen Adapter wie folgt instanziieren:const utils = require("@iobroker/adapter-core"); const adapter = utils.adapter( ... );Dann siehst du einerseits, welche Methoden existieren

und bekommst Infos zu den möglichen Aufrufsignaturen und Kontexthilfe:

-
@apollon77
Ja, ich denke es sollten schon channels sein auf zweiter Stufe. Zumindest verwende ich was, was sich "createChannel" nennt zum erstellen. In vereinfachter Form sieht das so aus:this.createDevice(label, {name: label,}, {}, (err: any, obj: any)=>{ this.createChannel(obj.id, 'A', (err: string | null, channel: any) => { this.createState(obj.id, channel.id, "someSwitch", { type: "boolean", role: "switch", read: true, write: true, }, (err: string | null, state: any) => { }); }) } );@AlCalzone
VSCode mit @iobroker/adapter-core verwende ich schon. Hilft auch oft, navgier da oft und gern mit F12 durch die Definitionen durch. Debuggen von VSCode aus schaff ich auch. Der Typescript-Code mit dem ich arbeite basiert hab ich mit ioBroker gemäss Doku generiert.Allerdings simmen die Defintionen nicht unbedingt immer mit der Realität überein.
"getDevices" hat zum Beispiel einen Callback vom Typ "GetObjectsCallback3<DeviceObject>" entsprechnd sollte ich nach Definition im Callback neben einem Error|null auch ein Attribut vom Typ Array<GetObjectsItem<DeviceObject>> zurück kommen. In Tat und Wahrheit bekomm ich aber ein Array<DeviceObject> zurück. -
@apollon77
Ja, ich denke es sollten schon channels sein auf zweiter Stufe. Zumindest verwende ich was, was sich "createChannel" nennt zum erstellen. In vereinfachter Form sieht das so aus:this.createDevice(label, {name: label,}, {}, (err: any, obj: any)=>{ this.createChannel(obj.id, 'A', (err: string | null, channel: any) => { this.createState(obj.id, channel.id, "someSwitch", { type: "boolean", role: "switch", read: true, write: true, }, (err: string | null, state: any) => { }); }) } );@AlCalzone
VSCode mit @iobroker/adapter-core verwende ich schon. Hilft auch oft, navgier da oft und gern mit F12 durch die Definitionen durch. Debuggen von VSCode aus schaff ich auch. Der Typescript-Code mit dem ich arbeite basiert hab ich mit ioBroker gemäss Doku generiert.Allerdings simmen die Defintionen nicht unbedingt immer mit der Realität überein.
"getDevices" hat zum Beispiel einen Callback vom Typ "GetObjectsCallback3<DeviceObject>" entsprechnd sollte ich nach Definition im Callback neben einem Error|null auch ein Attribut vom Typ Array<GetObjectsItem<DeviceObject>> zurück kommen. In Tat und Wahrheit bekomm ich aber ein Array<DeviceObject> zurück.@jobe451 said in API Dokumentation:
Allerdings simmen die Defintionen nicht unbedingt immer mit der Realität überein.
"getDevices" hat zum Beispiel einen Callback vom Typ "GetObjectsCallback3<DeviceObject>" entsprechnd sollte ich nach Definition im Callback neben einem Error|null auch ein Attribut vom Typ Array<GetObjectsItem<DeviceObject>> zurück kommen. In Tat und Wahrheit bekomm ich aber ein Array<DeviceObject> zurück.Ich habe die Definitionen nach bestem Wissen und Gewissen anhand des Quelltextes abgeleitet. Wenn du Unstimmigkeiten findest, bitte ein Issue in https://github.com/ioBroker/adapter-core aufmachen.
Für deinen erwähnten Fall würde ich gern die JSON-Darstellung des zweiten Parameters sehen. Also
adapter.log(JSON.stringify(devices))oder wie dein zweiter Parameter auch heißt. -
@AlCalzone
Vielen Dank für diese Type-Definitionen. Die sind extrem hilfreich, um sich in dem Projekt zurechtzufinden! Ich hab für den getDevice diesen Issue eröffnet:
https://github.com/ioBroker/adapter-core/issues/6Leider löst das nicht das getChannelsOf-Problem. Ich würd immer noch behaupten, dass die Funktion einfach kaputt ist.
-
@jobe451 Das Issue mit den Definitionen sollte demnächst gelöst sein.
Um deinen Fehler mitgetChannelsOfeinzugrenzen, kannst du bitte mal die Funktion ohneparentDeviceaufrufen, also nurthis.getChannelsOf((err, channels) => { ... }) -
Wenn ich in meiner onReady Funktion das hier mache:
this.getChannelsOf((error, channellist?: Array<any>) => { console.log("***************************************"); console.log(JSON.stringify(channellist)); });Krieg ich ein leeres array zurück.
-
@jobe451 Ich habe versucht nachzuvollziehen, was getChannelsOf tut. Bis zum Aufruf von
that.objects.getObjectViewmacht das Sinn. Danach kann ich "offline" nicht testen.Aber jetzt muss ich nochmal ganz dumm fragen... Was steht denn in
error?Und poste doch bitte mal Definitionen der Objekte die du erwartest.
-
Wenn ich in meiner onReady Funktion das hier mache:
this.getChannelsOf((error, channellist?: Array<any>) => { console.log("***************************************"); console.log(JSON.stringify(channellist)); });Krieg ich ein leeres array zurück.
-
Weiter oben habe ich einen Screenshot, von der Struktur wie ich sie in der Objektliste sehe. Ebenfalls weiter oben hab ich eine simplifizierte script-sequenz, die zeigt, wie ich die struktur schaffe.
Im wesentlichen mache ich:
this.createDevice => this.createChannel (mit id aus device callback) => this.createState (mit id aus channel callback)Die Dinger, die ich mit this.createChannel erstelle erscheinen dann auch in der Objektliste. Also ich würd schon sagen, dass es da Channels hat...
-
-
Das bedeute wie vermutet das das keine Objekte sind! Sonst gäbe es in der Spalte wo sonsst "state" steht nämlich "device "und "channel".
Also: Wie vermutet ganz am Anfang: DU hat keine existierenden Objekte vom Type device oder channel für enocean_jobe.0.enocean_jobe_0_tv und enocean_jobe.0.enocean_jobe_0_tv.enocean_jobe_0_tv_A ... und dann ist klar das "getChannelsOf" nichts findet.Man sollte als eher prüfen ob die CreateDevcie und createChannel methoden korrekt aufgerufen werden. An sich gilt auch hier das nichts mit punkten sein sollte sondern man die entsprechenden Namen (also das zwischen den punkten angibt. Das würe ggf auch erklären warum die benahmung so komisch ist weil überall enocean_jobe_0_ dabei ist

