Ugrás a fő tartalomhoz
Ön a fejlesztői dokumentációt nézi
Ez a dokumentáció a Base44 fejlesztői platformmal dolgozó fejlesztőknek szól. Az alkalmazásszerkesztőben használható munkafolyamatokról a Munkafolyamatok létrehozása oldalon olvashat.
Az alkalmazás automatizálásának új módja a munkafolyamatok. Új automatizálásokat már nem hozhat létre. A meglévő automatizálások tovább futnak, és továbbra is módosíthatja vagy törölheti őket. Új ütemezéshez vagy eseményindítóhoz hozzon létre inkább egy munkafolyamatot. Ha olyan function.jsonc fájlt telepít, amely új automatizálást ad hozzá, a függvény települ, de az automatizálás nem jön létre.
Az automatizálásokkal a backend-függvények automatikusan futhatnak ütemezés szerint, adatbázis-eseményekre reagálva, vagy amikor egy csatlakoztatott integráció webhookeseményt küld. Az automatizálásokkal rendszeres időközönként dolgozhat fel adatokat, kezelheti az entitásváltozásokat, reagálhat külső szolgáltatások eseményeire, vagy egyszeri feladatokat futtathat meghatározott időpontokban. Minden backend-függvényhez több automatizálás is tartozhat, amelyeket a függvény function.jsonc fájljában konfigurál. Ha csak entry.ts vagy entry.js fájlja van, az automatizálások használatához hozzá kell adnia ezt a konfigurációs fájlt. Az automatizálások a függvény kódjával együtt, atomikusan települnek, amikor a deploy vagy a functions deploy parancsot futtatja.
A munkafolyamatokat használó alkalmazások nem telepíthetik ezeket az automatizálásokat. Ha az alkalmazásban engedélyezve vannak a munkafolyamatok, az automatizálásokat tartalmazó function.jsonc telepítése HTTP 409 hibával meghiúsul. Hozza létre inkább ugyanazt az ütemezést vagy eseményindítót munkafolyamatokkal, és a függvényt automations blokk nélkül telepítse.

Automatizálástípusok

A Base44 4 automatizálástípust támogat:

Közös mezők

Minden automatizálás közös mezői

Minden automatizálástípus a következő mezőket használja:

Az ütemezett automatizálások közös mezői

A cron és az egyszerű ütemezésű automatizálások a következő további mezőket is használják:

Az automatizálás konfigurálása

Az automatizálásokat a function.jsonc fájlban konfigurálja az alábbi megközelítések egyikével. Minden automatizálás a fent felsorolt közös mezőket használja, valamint az adott típusra jellemző mezőket.

Cron

Használja a minden automatizálás közös mezőit és az ütemezett automatizálások közös mezőit, valamint az itt felsorolt cron-specifikus mezőket. A type értékét állítsa "scheduled", a schedule_type értékét pedig "cron" értékre, hogy cron-kifejezésekkel pontosan szabályozhassa az ütemezést. A cron-automatizálások a szabványos 5 mezős szintaxist használják: minute hour day-of-month month day-of-week. Interaktív cron-kifejezés-szerkesztőt és szintaxisreferenciát a crontab.guru oldalon talál.

Cron-példa

Ez a példa minden nap éjfélkor (UTC) futtat egy függvényt:

Egyszerű ütemezés

Használja a minden automatizálás közös mezőit és az ütemezett automatizálások közös mezőit, valamint az itt felsorolt egyszerű ütemezési mezőket. Egyszerű ütemezési igényekhez a type értékét állítsa "scheduled", a schedule_type értékét pedig "simple" értékre. Ismétlődő feladatokat időköz, például percek, órák, napok, hetek vagy hónapok szerint konfigurálhat, cron-kifejezések írása nélkül.

Példák egyszerű ütemezésre

Az alábbi példák az automatizálások egyszerű ütemezésének különböző módjait mutatják be:

Entitásesemények

Használja a minden automatizálás közös mezőit, valamint az itt felsorolt entitásesemény-mezőket. A type értékét állítsa "entity" értékre, hogy a függvények automatikusan elinduljanak adatbázisrekordok létrehozásakor, frissítésekor vagy törlésekor. Az entitásautomatizálások egy adott entitás 1 vagy több eseménytípusát figyelhetik.
Az entitásautomatizálások csak az entities API-n keresztül végzett egyrekordos létrehozási, frissítési és törlési hívásoknál indulnak el. A tömeges műveletek, például a bulkUpdate(), és a lekérdezés alapú műveletek, például az updateMany(), nem indítanak entitásautomatizálást, akkor sem, ha az entitás nevének megfelelő rekordokat érintenek. Egy helyreállítható módon törölt rekord visszaállítása vagy végleges törlése sem indít automatizálást. Ha az automatizálásnak minden változásra reagálnia kell, kerülje a tömeges vagy lekérdezés alapú írást az adott entitáson, vagy indítsa el kézzel az automatizálás logikáját.

Példák entitáseseményekre

Az alábbi példák bemutatják, hogyan indíthat függvényeket entitásesemények alapján:

Összekötő-automatizálások

Használja a minden automatizálás közös mezőit, valamint az itt felsorolt összekötő-specifikus mezőket. A type értékét állítsa "connector" értékre, hogy a függvények elinduljanak, amikor egy csatlakoztatott integráció webhookeseményt küld. Ezekkel valós időben reagálhat a külső szolgáltatások tevékenységére. Feldolgozhat például egy új e-mailt, szinkronizálhat egy naptárváltozást, vagy reagálhat egy Google Drive-fájl frissítésére. Opcionálisan eseményindítási feltételeket is megadhat az események szűréséhez, így a függvény csak akkor fut, ha a hasznos adat megfelel az Ön által meghatározott szabályoknak. Amikor egy összekötő-automatizálás elindul, a függvény strukturált webhook-hasznos adatot kap, amely tartalmazza az eseménytípust, az integráció adatait és a külső szolgáltatástól érkező nyers adatokat.
Az összekötőt a telepítés előtt konfigurálni kell a projektben, és engedélyezni kell. A beállítási útmutatót a Megosztott összekötők oldalon találja.

Támogatott integrációk és események

A Gmail mailbox eseménye bármely postafiókváltozáskor elindul, nem csak új üzeneteknél. Ha csak új e-mailek érkezésekor szeretné futtatni a függvényt, adjon hozzá egy eseményindítási feltételt: { "field": "has_new_messages", "operator": "equals", "value": true }.
A Slack (slack) és a Slack Bot (slackbot) összekötő-automatizálásokhoz eseményindítási feltételek szükségesek. Ha ezeknél az összekötő-automatizálásoknál nincsenek feltételek megadva, a telepítés meghiúsul.

Erőforrás-azonosító formátumok

A resource_id várt értéke összekötőnként eltér:
  • Google Drive: A fájlazonosító. A fájlszintű eseményekhez (file, file.update, file.trash, file.untrash, file.delete) kötelező.
  • Gmail: A figyelt címkeazonosítók vesszővel elválasztott listája. Ha elhagyja, alapértelmezés szerint "INBOX".
  • Microsoft Teams: {chatId} egy adott csevegés figyeléséhez.
  • SharePoint: {siteId}/{listId} egy adott lista figyeléséhez.

Eseményindítási feltételek

A trigger_conditions segítségével szűrheti a webhookeseményeket, így a függvény csak akkor fut, ha a hasznos adat megfelel az Ön által meghatározott szabályoknak. Ha nincsenek feltételek megadva, a függvény minden beérkező eseményre lefut. Teljes konfigurációkat az Összekötő-automatizálási példák részben talál.
string
A feltételek összekapcsolásának módja. Lehetséges értékek: "and" (mindegyiknek teljesülnie kell), "or" (bármelyiknek teljesülnie kell). Alapértelmezett érték: "and".
array
kötelező
Egy vagy több feltételobjektum vagy beágyazott feltételcsoport. Legfeljebb 20 levélfeltétel és 5 beágyazási szint.

Webhook-hasznos adat

Amikor egy összekötő-automatizálás elindítja a függvényt, a kérés törzse egy payload objektumot tartalmaz a következő szerkezettel. A hasznos adatot olvasó függvényt az Összekötő-automatizálási példák részben talál.

Összekötő-automatizálási példák

Függvényargumentumok

Az automatizálás konfigurációjában a function_args mező megadásával adatokat adhat át a függvénynek az indításkor. Ez akkor hasznos, ha egy függvény több, eltérően viselkedő automatizálást kezel, például egy szinkronizáló függvény, amely 15 percenként növekményesen, naponta pedig teljes szinkronizálással fut. Ezeket az argumentumokat a függvény kódjában a kérés törzsén keresztül érheti el.

Példa függvényargumentumokra

Ez a példa egy olyan függvényt mutat be, amely az automatizálás konfigurációja alapján növekményes és teljes szinkronizálási módot is kezel:

Automatizálások telepítése

A backend-függvényeket automatizálásaikkal együtt a CLI functions deploy parancsával vagy az egységes deploy paranccsal telepítheti. A functions deploy <names...> paranccsal név szerint telepíthet konkrét függvényeket. A telepítés függvényenként atomikus. Egy függvény csak akkor számít telepítettnek, ha a Deno-telepítés és az összes automatizálása is sikeres. Ha bármelyik automatizálás telepítése meghiúsul, a teljes függvénytelepítés visszagörgetésre kerül. A telepítés után a CLI függvényenként mutatja az állapotot: deployed, unchanged vagy error.

Automatizálások kezelése az irányítópulton

Az irányítópulton végzett módosításokat a functions deploy következő futtatása felülírja. Az irányítópult és a helyi fájlok között nincs kétirányú szinkronizálás. A helyi function.jsonc fájlokban definiált automatizálások az irányadók.Ha módosítani szeretné az automatizálásokat, frissítse a helyi function.jsonc fájlokat, és telepítse újra őket. Az irányítópultot a futtatási naplók figyelésére és az automatizálások szükség szerinti kézi indítására használja.
Az automatizálásokat a Base44 irányítópultján, az Automations lapon tekintheti meg és kezelheti. Az irányítópulton a következőket teheti:
  • Megtekintheti a futtatási naplókat és előzményeket
  • Tesztelés céljából kézzel futtathatja az automatizálásokat
  • Figyelheti az automatizálások állapotát

Lásd még

Ezt az oldalt MI segítségével fordítottuk. A legpontosabb és legfrissebb információkért tekintse meg az angol nyelvű változatot.