Verbesserte Integration externer Dienste

Aufgrund der externen Integrationsentwicklungen gibt es einige Lücken, die implementiert werden sollten, um die Nutzung externer Integrationen zu verbessern.

  1. Abrufen und Auswählen der Liste der Häuser mit einem Selektor.
    Heute, wenn ich ein Haus der Installation ansprechen möchte, kann ich keine Liste erhalten.
    Zum Beispiel muss ich in dieser Integration den Namen meines Hauses manuell angeben. Mit einer Liste wäre das praktischer.

  2. Hinzufügen eines Dezimalwerts in der Konfiguration.
    Ich wollte einen Preis mit Dezimalstellen angeben können, um den Wert meines Pellets-Vorrats zu berechnen. Das ist heute nicht möglich.
    image

  3. Immer noch mit meinen Preisen, ich möchte die Möglichkeit haben, einen Text-/Numerikbereich in den Widgets der Integrationen zu haben.
    Zum Beispiel, immer noch in meinem Pellets-Vorrat, ändert sich der Preis recht häufig und wenn ich eine neue Palette auf Lager nehme, hat sich der Preis geändert. Um den Preis zu ändern, in die Integration gehen, den Preis ändern, zurück zum Dashboard, um auf eine Schaltfläche zu klicken, um die Lieferung zu bestätigen, ist ein recht umständlicher Weg, finde ich.


    Wenn wir die Möglichkeit hätten, dies direkt im Widget anzugeben, würde dies Hin- und Herlaufen vermeiden.

  4. Geräte in Wetterintegrationen deklarieren können.
    Das Ziel wäre es, zum Beispiel ein Wettergerät mit verschiedenen Funktionen wie Temperatur, Luftdruck usw. zu haben, um es in Szenen zu verwenden, Diagramme zu erstellen usw.

Hallo @Will_71,

Vielen Dank für dieses Feedback, es ist sehr konkret und es freut mich zu sehen, wie deine Pellet-Integration Form annimmt!

Ich möchte klarstellen, dass Claude mir geholfen hat, diese Nachricht zu schreiben, aber ich habe selbst über jeden Punkt nachgedacht :joy:

1. Ein Haus aus einer Liste auswählen

Ja, das ist eine gute Idee. Heute können dynamische Listen (source) nur Geräte der Integration vorschlagen. Wir werden "source": "houses" hinzufügen: Die Liste zeigt die Namen der Häuser an und speichert ihren selector, also die ID, die dir GET /house bereits zurückgibt. Du kannst also direkt die Entsprechung herstellen.

Es wird überall funktionieren, wo dieses Feldformat verwendet wird: Konfiguration, Aktionen, Widget-Einstellungen und Szenen. Ich bereite einen PR vor.

Einziger Nachteil: Du musst die minimale gladys_version deiner Manifest-Datei erhöhen, da ältere Versionen von Gladys eine Quelle ablehnen, die sie nicht kennen.

2. Dezimalwert in der Konfiguration

Es handelt sich tatsächlich um einen Fehler. Der Server akzeptiert bereits Dezimalzahlen, aber das numerische Feld des Formulars hat kein Attribut step: Der Browser akzeptiert daher nur ganze Zahlen und blockiert die Speicherung. Selbst das Beispiel der Dokumentation (eine Breite von 48.85) funktionierte nicht :sweat_smile:

Ich habe ein Ticket eröffnet: Issue · GitHub

Die Korrektur besteht aus einer einzigen Zeile und wird auf alle Formulare der Integrationen angewendet (Konfiguration, Aktionen, Widgets, Szenen).

3. Einen Wert über das Widget eingeben

Der Bedarf ist real, dein aktueller Weg (in die Integration gehen, den Preis ändern, zum Dashboard zurückkehren) ist nicht praktisch.

Ich möchte jedoch keine Eingabefelder, die ständig in den Widgets angezeigt werden. Wir haben uns dafür entschieden, dass die Widgets im Lesemodus + Tastendruck bleiben: Das ist es, was Gladys ermöglicht, eine saubere Darstellung überall zu garantieren (mobil, Wandtablett, helles oder dunkles Thema).

Mein Vorschlag: Eine Widget-Schaltfläche kann Felder deklarieren. Wenn man darauf drückt, öffnet sich ein kleines Formular in der Karte, das von deiner Integration vorgefüllt wird, und Gladys validiert die Werte, bevor sie dir übermittelt werden.

Auf deinem Widget würde es so aussehen (Mockup):

Wenn ein Wert außerhalb der Grenzen liegt, die du deklariert hast, wird der Fehler unter dem Feld angezeigt:

Und nach dem Speichern wird deine Rückmeldung angezeigt und die Karte wird aktualisiert:

Auf der Integrationsseite erhält die Schaltfläche eine Tabelle fields, im gleichen Format wie die Felder der Aktionen des Manifests. Da der Inhalt des Widgets bei jeder Anfrage aufgebaut wird, kann der Standardwert der zuletzt gespeicherte Preis sein:

{
  "type": "button",
  "label": { "en": "Pallet delivered", "fr": "Palette livrée" },
  "icon": "truck",
  "action": {
    "key": "delivery",
    "fields": [
      { "key": "bags", "type": "number", "required": true, "min": 1, "max": 200, "default": 72,
        "label": { "en": "Bags delivered", "fr": "Sacs livrés" } },
      { "key": "price_per_bag", "type": "number", "required": true, "min": 0, "max": 50, "default": 7.3,
        "label": { "en": "Price per bag", "fr": "Prix par sac" } }
    ]
  }
}

Und du erhältst die eingegebenen Werte, bereits validiert, in values:

gladys.onWidgetAction('pellets', async (actionKey, params, { settings, values }) => {
  if (actionKey === 'delivery') {
    await stock.addDelivery(values.bags, values.price_per_bag);
    return { message: { fr: `+${values.bags} sacs enregistrés` } };
  }
});

Einige geplante Regeln:

  • maximal 4 Felder, vom Typ Zahl, Text, Kontrollkästchen oder Liste;
  • das Formular erscheint erst nach dem Drücken, die Karte im Ruhezustand ändert sich nicht;
  • wie die aktuellen Widget-Schaltflächen ist es für jeden angemeldeten Benutzer verwendbar: Diese Werte sind also wie ein Ereignis (eine Lieferung) zu behandeln, nicht wie eine Änderung der Integrationskonfiguration.

Das ist noch nicht spezifiziert oder entwickelt. Was hältst du davon? Würde das deinen Fall abdecken?

4. Geräte in Wetterintegrationen deklarieren

Für die Verwendung in Szenen ist kein Gerät erforderlich: Seit Gladys 5.1 kann jede Integration, einschließlich einer Wetterintegration, ihre eigenen Szenenauslöser und -aktionen deklarieren (scene_triggers und scene_actions im Manifest). Zum Beispiel:

  • eine Aktion „Aktuelles Wetter abrufen“, die die Temperatur, den Druck, den Wind usw. in outputs zurückgibt. Die folgenden Aktionen der Szene können diese Werte verwenden, und eine Bedingung „Nur fortfahren, wenn“ ermöglicht das Filtern;
  • ein Auslöser, der von deiner Integration ausgelöst wird, wenn etwas passiert („Regen in der Stunde vorhergesagt“, zum Beispiel).

Für Diagramme kann eine Wetterintegration auch ein Widget mit einer Komponente chart deklarieren, die mit ihren eigenen Daten gefüttert wird.

Ich bin jedoch nicht sehr dafür, die Konzepte von Geräten und Wetter zu mischen. In Gladys ist ein Gerät etwas Physisches: eine Ausrüstung, die man steuert, oder ein Sensor, der bei dir misst. Das Wetter sind Daten, die von einem Dienst bereitgestellt werden, mit eigenem Format (aktuelle Bedingungen, stündliche und tägliche Vorhersagen, Warnungen) und eigenem Widget. Wenn wir die Vorhersagen in Geräte umwandeln, landen wir mit falschen Sensoren, die mit den echten vermischt sind (in den Räumen, Diagrammen, Szenen…), und jeder Wetteranbieter würde seine eigenen auf seine Weise erstellen.

Wenn du eine echte gemessene Außentemperatur benötigst, bleibt ein physischer Sensor die richtige Lösung, und er wird definitiv ein Gerät sein.

Nochmals vielen Dank für dieses Feedback!

Hallo zusammen!

Dieses Thema ist nun in Entwicklung.

Ein Pull Request wurde eröffnet, um Dezimalzahlen in den Number-Feldern der externen Integrationen zu akzeptieren:

Zögert nicht, dem PR zu folgen, es zu testen (optional, besonders bei kleinen Anfragen) und euer Feedback hier zu hinterlassen, falls nötig.

Danke für dein Feedback @pierre-gilles.
Alle deine Vorschläge decken meine Bedürfnisse ab.

Für den Wetterteil mache ich das persönlich schon so, über Szenen, aber es war eine Anfrage eines Nutzers, der das einfach über Geräte abrufen wollte, um Szenen zu vermeiden.

Hallo zusammen!

Dieses Thema ist nun in Entwicklung.

Ein Pull Request wurde eröffnet, um einem Widget-Aktionsbutton zu ermöglichen, ein Formular zu öffnen:

Zögert nicht, dem PR zu folgen, zu testen (optional, besonders bei kleinen Anfragen) und euer Feedback hier zu hinterlassen, falls nötig.

Hallo zusammen!

Dieses Thema ist nun in Entwicklung.

Ein Pull Request wurde eröffnet, um es externen Integrationen zu ermöglichen, ein Haus aus einer Liste auszuwählen (source: "houses"):

Zögert nicht, dem PR zu folgen, es zu testen (optional, besonders bei kleinen Anfragen) und euer Feedback hier zu hinterlassen, falls nötig.

@Will_71 Was hältst du von diesem PR: External integration widgets: let an action button open a form by Pierre-Gilles · Pull Request #3168 · GladysAssistant/Gladys · GitHub ? :slight_smile:

Ich schau mir das heute Abend an und sag dir dann Bescheid.

@pierre-gilles, für mich ist das okay. :star_struck: :clap:

Ich habe meine externe Integration geändert und auf deinem Bild bestätigt.

.

@pierre-gilles Ich verstehe nicht, warum man keine „Wetter“-Geräte erstellen könnte, denn bei den Integrationen „Luftqualität“, „Vigieau“, „UV-Index“, „Speedtest“, „Kraftstoffpreise“, „Fernsehprogramme“ usw. werden doch auch Geräte erstellt, die man in Szenen verwenden kann?

Super, ich baue das in die nächste Version von Gladys ein :slight_smile:

Dazu habe ich hier geantwortet :slight_smile:

@pierre-gilles: Meine Frage war viel präziser:
Ich verstehe nicht, warum man keine „Wetter“-Geräte erstellen könnte, da bei den Integrationen „Luftqualität“, „Vigieau“, „UV-Index“, „Speedtest“, „Kraftstoffpreise“, „Fernsehprogramme“ usw. Geräte erstellt werden, die man in Szenen verwenden kann?

Die Geräte dieser externen Integrationen entsprechen keinen physischen Geräten, sondern Anbietern: Warum könnte die externe Wetterintegrationsfunktion von Météo-France nicht dasselbe tun?

Welchen Anwendungsfall schaffst du aktuell nicht?

Huch, ich habe gerade bemerkt, dass ich im falschen Thema bin: Das betrifft keine Änderungen am Kern.