--- title: "A funkciók bevált gyakorlatai" slug: "functions-best-practices" updated: 2026-10-22T11:28:30Z published: 2026-10-22T11:28:30Z canonical: "support.tulip.co/functions-best-practices" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # A funkciók bevált gyakorlatai Who can use Functions As of r380, Functions is generally available. **Read more in the [Community thread](https://community.tulip.co/t/functions-production-release-available-for-early-access/15658).** --- ## Használja a Functions szolgáltatást táblákba történő íráshoz ### Ajánlott megközelítés Hozzon létre függvényeket, ha több alkalmazás vagy alkalmazáslépés ír ugyanabba a táblába, és ha a következőket kell érvényesítenie: - Kötelező mezők - Érvényes értékek (például az állapotnak egy jóváhagyott listából kell származnia) - Következetes metaadatok (létrehozó, létrehozás ideje) **Miért fontos ez** Amikor a polgári fejlesztők közvetlenül a triggerekben hoznak létre táblarekordokat, előfordulhat, hogy: - Nem tartják be az azonosítók elnevezési szabályait - Elfelejthetik a kötelező mezőket - Helytelenül írják be a mezőértékeket („in progress” vs. „in-progress”) - Inkonzisztensen töltik ki a metaadatokat A függvény biztosítja az egységes sémát, és megakadályozza ezeket a hibákat. **Példa** Ahelyett, hogy minden alkalmazásfejlesztő következetlen mezőkkel és tartalommal rendelkező „Minta” rekordokat hozna létre, hozzon létre egy **„Minta létrehozása”** funkciót, amely: - Következetes adatokat igényel (munkaazonosító, minta típus, mennyiség, időbélyeg, felhasználó, alkalmazás neve) - Ellenőrzi, hogy a minta típusa szerepel-e a jóváhagyott listán **Funkció**:**CreateSample Bemenetek:** - job_id (szöveg) - sample_type (szöveg) - quantity (szám) - app name (szöveg) - user requesting (felhasználó) **Logika**: 1. Ellenőrizze, hogy a sample_type szerepel-e a ["A", "B", "C"] listában 2. Ha érvénytelen, hibaüzenetet adjon vissza 3. Táblarekord létrehozása a következő adatokkal: - ID: a függvényen belül generálva - Feladat-azonosító: bemenet - Minta típusa: bemenet - Mennyiség: bemenet - Tételszám: bemenet (vagy üres, ha nem adták meg) - Létrehozó: bemenet 4. Sikerüzenet visszaadása **Kimenetek**: - állapot (szöveg): „siker” vagy „hiba” - üzenet (szöveg): a hiba leírása, ha sikertelen Ha táblázati rekordot kell létrehoznia egy mintához, adja át a bemeneti adatokat egy függvénynek, és a függvény elvégzi a többit. ### Kerülendő minta Ne hozzon létre függvényt minden táblába történő írási művelethez, még az egyszerűekhez sem. **Miért okoz ez problémát** - Funkciók elszaporodását eredményezi (több száz egyszer használatos funkció) - Növeli a komplexitást anélkül, hogy az egyszerű írási műveleteknél bármilyen előnyt jelentene - Megnehezíti a hibakeresést (több helyet kell átnézni) **Mikor kerülje el a függvények használatát a táblázati írási műveleteknél** - Meglévő táblázati rekord frissítése (például állapot frissítése vagy mennyiség csökkentése) - Egyetlen alkalmazás írása egy táblába - Nincs szükség irányításra vagy érvényesítésre ## Használjon függvényeket ismétlődő, több lépésből álló logikához ### Ajánlott megközelítés Ha ugyanaz a trigger-műveletsorozat több alkalmazás számos lépésében is előfordul, vonja ki azt egy függvénybe. **Példa: ZPL-kód lekérése címke nyomtatásához** **Funkció**: ZPL**-kód** lekérése**Bemenetek**: - Anyagazonosító (szöveg) **Változók**: - ZPL-kód változó (szöveg) **Kimenetek**: - ZPL-kód (szöveg) **Logika**: 1. Adatok frissítése: „ZPL-kód változó” konfiguráció – Beállítás: [A ZPL-kódra vonatkozó kifejezés, beleértve az @Inputs.Anyagazonosítót] 2. Visszatérési érték: „ZPL-kód” Adatforrás: „ZPL-kód változó” ### Kerülendő minta Ne hozzon létre olyan függvényeket, amelyek logikája az összes alkalmazásban összesen csak 1–2 alkalommal fordul elő. **Miért okoz ez problémát** - A függvény kezelésével járó többletmunkája meghaladja az előnyöket - Az alkalmazásfejlesztőket arra kényszeríti, hogy egy ritka eset miatt megtanulják a függvény interfészét - Megnehezíti a hibakeresést, mivel a funkciók és az alkalmazások között kell váltogatni ## A csatlakozófüggvények beágyazása a függvényekbe ### Ajánlott megközelítés Ha csatlakozó funkciót használ, adja át a csatlakozó funkció bemeneteit annak a funkciónak, amely a csatlakozó funkciót hívja meg. A funkció így egyszerűbb és központosítottabb módon kezelheti az időtúllépés utáni újrakísérleteket és a hibakezelést, ami lehetővé teszi a megoldás egészében az alkalmazáslogika egyszerűsítését. A csatlakozófüggvények beágyazása a függvényekbe minimalizálhatja egy esetleges jövőbeli ERP-migrációval járó munkát is, mivel csökkenti az egyes alkalmazásokban végrehajtandó módosítások számát. **Példa** **Funkció**: Order frissítése**Bemenetek**: - Megrendelés-azonosító (szöveg) - Állapot (szöveg) **Kimenetek**: - Hibaüzenet (szöveg) **Változók**: - HTTP-kód (egész szám) - Időtúllépés utáni újrakísérletek száma (egész szám) - Hibaüzenet (szöveg) **Logika**: 1. Futtassa a csatlakozó funkciót 2. Ha az HTTP-kód sikeres, fejezze be a funkciót 3. Ha az HTTP-kód időtúllépést jelez, és az „Időtúllépés utáni újrakísérletek száma” kisebb vagy egyenlő a megadott értékkel, növelje az „Időtúllépés utáni újrakísérletek számát”, majd térjen vissza a „Futtassa a csatlakozó függvényt” lépéshez. 4. Ha az HTTP-kód olyan, amelyet a függvény logikája nem tud megoldani, adjon vissza egy hasznos üzenetet a „Hibaüzenet” kimeneten ## A rekordazonosítókat adja át, ne az egyes táblarekord-mezőket ### Ajánlott megközelítés Ha egy függvénynek táblarekordból származó adatokra van szüksége, adja át a rekordazonosítót, és töltse be a rekordot a függvényen belül. **Példa** Bár a következő példa logikailag helyes (ahol az „Order ID” az Orders táblából származó azonosító, a többi mező pedig az adott táblában található oszlop), létezik egyszerűbb konfiguráció is. **Funkció**:**Order** feldolgozása**Bemenetek**: - Order ID (szöveg) - Ügyfél neve (szöveg) - Termékazonosító (szöveg) - Mennyiség (szám) - Esedékességi dátum (dátum/idő) - Prioritás (szöveg) **Logika**: 1. [Logika végrehajtása a bemeneti mezők felhasználásával] Az alábbi példa minimális bemeneti adatokkal éri el ugyanazt az eredményt: **Funkció**:**Megrendelés** feldolgozása**Bemenetek**: - Megrendelés-azonosító (szöveg) **Logika**: 1. Táblarekord lekérése: Orders tábla, ahol ID = „Rendelésazonosító” bemenet 2. [Logika végrehajtása a táblarekord mezőinek felhasználásával] **Miért jobb megközelítés a második példa:** - Kevesebb bemenet (1 a 6+ helyett) - A függvény könnyen alkalmazkodik, ha a táblaséma megváltozik - Tisztább függvényhívások az alkalmazásokban - Csökkenti annak esélyét, hogy a rossz mezőt a rossz bemeneti értékhez rendeljük ## A függvényeket és a bemeneti értékeket következetesen nevezzük el és írjuk le ### Ajánlott megközelítés Használjon következetes névadási konvenciót a munkaterület összes függvényénél. **Funkciónevek** - Használjon ige + főnév szerkezetet: Minta létrehozása, Feladatállapot frissítése, Sorozatszám ellenőrzése - Ne használjon csak főnevet: Minta, Feladat, Sorozatszám **Funkcióleírás** - Írjon intuitív leírást a funkció működéséről. Például egy „Hiba létrehozása” nevű funkcióhoz írjon olyan leírást, mint „Új rekordot hoz létre a Hibák táblában, OPEN státusszal”. **Bemeneti nevek** - Használjon következetes terminológiát: mindig „Munkarendelés-azonosító” (ne használja néha „Rendelés-azonosító” vagy „Work_id” kifejezéseket) - Amennyiben lehetséges, illessze össze a táblák mezőneveit **Logikai blokknevek** - Legyen egyértelmű: „Get Job Record” (Munkarecord lekérése), ne „Get Table Record” (Táblarekord lekérése) - Segítsen a jövőbeli olvasóknak: „Minta típusának érvényesítése”, ne pedig „Érték ellenőrzése” **Miért fontos ez?** - Az alkalmazásfejlesztők gyorsan megértik a funkciók célját - Csökkenti a kognitív terhelést több funkció használata esetén - Megkönnyíti a „hol használják” elemzést - Javítja a dokumentációt és a képzést ## Zökkenőmentesen kezeli a bevitel érvényesítését és a felhasználói hibaüzeneteket ### Ajánlott megközelítés A függvények bemeneteit mindig kötelező mezőként jelölje meg, és ahol szükséges, alkalmazzon bemeneti érvényesítési szabályokat. Ne érvényesítse a bemeneteket a függvényekben. **Miért fontos ez** - Az alkalmazás felhasználói egyértelmű visszajelzést kapnak az értékek beírásakor - Egyszerűsíti a függvény logikáját, mivel az alkalmazás kezeli a bevitel érvényesítését, és a függvény ismert, érvényes bemeneti adatokkal fut - Megakadályozza a hibás bevitelekből származó sérült adatokat ### Kerülendő gyakorlat Ne érvényesítsük a bemeneti adatokat a függvényen belül. **Miért okoz ez problémát** - Felesleges, mivel az alkalmazásszerkesztőben már rendelkezésre állnak a bemeneti érvényesítési funkciók - További felesleges késleltetést okoz a bemenetek érvényességének újbóli ellenőrzése a függvényen belül NOTE App builders can bypass the system by passing blank static values in function inputs. For functions where validated data is critical, it may be best practice to validate inputs in the function itself (in addition to marking required fields in the app). ## Minimalizálja a ciklusokon belüli táblakérdezéseket Ha a függvény egy tömbön fut végig, kerülje el, hogy minden iteráció során lekérdezzen táblákat. Ehelyett végezzen egy lekérdezést a hurok előtt, és hivatkozzon az eredményre. ## Használjon függvényeket a logikához, ne egyszerű hivatkozásokhoz Ne hozzon létre olyan függvényeket, amelyek csak egyetlen táblarekordot töltenek be – erre szolgálnak a táblalekérdezések ( record placeholders ). A függvényeket tartsa fenn az adatokat átalakító logikára. ## Korlátozza a kimenet méretét Ha a függvénye nagy objektumokat vagy tömböket ad vissza, fontolja meg, hogy csak az alkalmazás számára szükséges mezőket adja vissza, ne pedig a teljes objektumtömböt. --- ## További források {{snippet.Megtalálta, amit keresett?}}