Ugrás a fő tartalomhoz
Hasznos volt ez az oldal?

Kiváltó-referencia

Az összes érvényes triggerType érték, amely elérhető automatizálási szabályok építésekor a PrimeCal-ban.

Kiváltótípusok​

Enum értékVezetéki karakterláncLeírástriggerConfig szükséges
EVENT_CREATEDevent.createdKiváltódik, amikor új esemény jön létre bármelyik felhasználói naptárban.Nincs
EVENT_UPDATEDevent.updatedKiváltódik, amikor egy meglévő eseményt módosítanak.Nincs
EVENT_DELETEDevent.deletedKiváltódik, amikor egy eseményt törölnek.Nincs
EVENT_STARTS_INevent.starts_inX perccel az esemény kezdete előtt kiváltódik.{ minutesBefore: szám }
EVENT_ENDS_INevent.ends_inX perccel az esemény vége előtt kiváltódik.{ minutesBefore: szám }
RELATIVE_TIME_TO_EVENTrelative_time_to_eventAz esemény kezdetéhez vagy végéhez viszonyított időpontban kiváltódik (pozitív vagy negatív eltolással).{ offsetMinutes: szám, anchor: 'start' | 'end' }
CALENDAR_IMPORTEDcalendar.importedKiváltódik, amikor egy külső naptárszinkronizálási import befejeződik.Nincs
SCHEDULED_TIMEscheduled.timeCron-ütemezés szerint kiváltódik, konkrét eseménytől függetlenül.{ cronExpression: karakterlánc }
WEBHOOK_INCOMINGwebhook.incomingKiváltódik, amikor POST kérés érkezik a szabály egyedi webhook URL-jére.Nincs
TASK_STATUS_CHANGEDtask.status_changedKiváltódik, amikor egy feladat status mezője megváltozik (pl. todo → done). Még nem választható ki a szabályépítő felületén — hozz létre szabályokat vele az Automatizálás API segítségével.Nincs
TASK_SCHEDULED_STARTtask.scheduled_startKiváltódik, amikor egy feladat eléri az ütemezett kezdési időpontját, beleértve a rutinsablonból létrehozott feladatokat is. Jelenleg szintén csak API-n keresztül.Nincs
NOTIFICATION_DISPATCHEDnotification.dispatchedKiváltódik, amikor egy értesítés kiküldésre kerül a szabály tulajdonosának, bármely csatornán keresztül — pl. egy event.reminder push értesítés, egy reservation.due riasztás, vagy egy másik szabály send_notification művelete.Nincs

Megjegyzések​

  • event.starts_in / event.ends_in: Az ütemező 1 perces felbontással pollingol. Az 1 alatti minutesBefore értékek megbízhatatlanok.

  • scheduled.time: A cronExpression-nek érvényes 5 mezős cron kifejezésnek kell lennie (perc óra nap hónap hét napja). Az ütemező percenként kiértékeli a jogosult cron kifejezéseket.

  • webhook.incoming: Minden szabályhoz, amely ezt a kiváltótípust használja, egyedi webhookToken van rendelve (64 karakteres hexadecimális). A token elérhető a szabály részletes nézetében, és regenerálható a POST /api/automation/rules/:id/webhook/regenerate végponton keresztül.

  • relative_time_to_event: Finomabb szemcsézettségű időeltolásokhoz vezették be, amiket az event.starts_in/event.ends_in nem fed le. Az offsetMinutes mezőt használja (negatív = előtte, pozitív = utána).

  • task.status_changed / task.scheduled_start: A háttérrendszer által felismert kiváltótípusok, amik még nincsenek kitéve a szabályépítő kiváltó-választójában. A task.scheduled_start hajtja azt a mintát, ahol "egy rutinfeladat az ütemezett időpontjában elindít egy smart home REST hívást" — lásd: Smart-home automatizálás.

  • notification.dispatched: A send_notification művelet fordított iránya — ahelyett hogy egy szabály küldene egy értesítést, egy szabály reagálhat egy kiküldött értesítésre (bármilyen forrásból: az emlékeztető-ütemezőből, egy másik automatizálási szabályból, egy foglalási riasztásból stb.). Használd a notification.type és notification.channel feltételmezőket (lásd: Feltétel-referencia), hogy szűkítsd, mely értesítésekre reagáljon a szabály. Ez lehetővé teszi, hogy egy értesítés egy külső rendszert vezényeljen, ne csak a felhasználót riassza — például egy 5 perces event.reminder alkalmazáson belüli értesítés kiválthat egy webhook-műveletet, ami aktivál egy smart-home "meeting mode" jelenetet:

    {
      "triggerType": "notification.dispatched",
      "conditionLogic": "AND",
      "conditions": [
        { "field": "notification.type", "operator": "equals", "value": "event.reminder" },
        { "field": "notification.channel", "operator": "contains", "value": "inapp" },
        { "field": "notification.data.minutesBefore", "operator": "equals", "value": "5" }
      ],
      "actions": [
        { "type": "webhook", "config": { "url": "https://smarthome.local/api/scene/meeting-mode" } }
      ]
    }

    Mivel ez a kiváltó a megosztott DomainEventBus-ból tüzel, nem közvetlen szolgáltatáshívásból, bármely értesítés-eventType-nál működik a katalógusban (lásd: Értesítések API) — nem csak eseményemlékeztetőknél.

Csomagkövetelmény​

Az automatizálási végpontokhoz olyan PrimeCal csomag szükséges, amely tartalmazza az automatizálási funkciót. Lásd: Csomagok és árak a csomagrészletekért.