As of r380, Functions is generally available.
Read more in the Community thread.
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éseBemenetek: - 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éseBemenetek: - 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ásaBemenetek: - 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ásaBemenetek: - 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
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?}}

