Who can use Functions
As of r380, Functions is generally available.
Read more in the Community thread.
Zmiany w danych wejściowych lub wyjściowych
Breaking change alert:
Adding, removing, or renaming inputs and outputs requires changes to app trigger actions that call the function.
Aby zmienić sygnaturę funkcji, postępuj zgodnie z poniższą procedurą:
- Przed szerokim wdrożeniem funkcji należy starannie zaprojektować strukturę danych wejściowych i wyjściowych.
- Dane wejściowe: Tworząc funkcję służącą do tworzenia nowego rekordu w tabeli, należy uwzględnić wszystkie typowe kolumny, które funkcja powinna wypełnić podczas tworzenia rekordu, a nie tylko kolumny dla pierwszego przypadku użycia.
- Wyniki: Typowe wyniki, które można wbudować w funkcję, obejmują:
- Identyfikatory rekordów tabeli utworzonych przez funkcję
- Komunikaty widoczne dla operatorów (przypisywane do zmiennej przez logikę funkcji)
- Przed wprowadzeniem zmian należy powiadomić wszystkich twórców aplikacji.
- Aktualizuj funkcję w sposób systematyczny:
- Zmodyfikuj funkcję.
- Przetestuj funkcję za pomocą przycisku „Test”, używając reprezentatywnych danych wejściowych.
- Przetestuj funkcję w jednej aplikacji deweloperskiej od początku do końca.
- Zaktualizuj każdą aplikację, aby przyporządkować nowe dane wejściowe i wyjściowe.
- Od wersji r351 dostępność informacji o tym, gdzie dana funkcja jest używana (zarówno w jakich aplikacjach, jak i w jakich miejscach w obrębie aplikacji), jest ograniczona. Na karcie „Wersje” aplikacji można sprawdzić, z jakich funkcji korzysta dana wersja.
- W przypadku aplikacji korzystających z danej funkcji należy kliknąć przycisk „Wyświetl błędy” w edytorze aplikacji. W oknie modalnym wyświetlą się wszystkie uszkodzone odwołania do funkcji w aplikacji.
- Przetestuj każdą aplikację w trybie programisty.
- Opublikuj aplikacje.
Alternatywne podejście w przypadku poważnych zmian
Utwórz nową funkcję ze zaktualizowaną sygnaturą i stopniowo migruj aplikacje:
- Utwórz nową wersję funkcji z nowymi danymi wejściowymi (na przykład CreateSample_v2).
- Przenieś aplikacje o wysokim priorytecie do nowej wersji.
- Z czasem przenieś pozostałe aplikacje.
- Wycofaj i zarchiwizuj starą wersję funkcji.
Zmiana wewnętrznej logiki funkcji
Info
Changes to internal function logic (decision trees, calculations, table operations) do not break apps. However, you need to publish apps with a new version to associate the new function logic.
Postępuj zgodnie z poniższą procedurą:
- Zaktualizuj logikę funkcji.
- Przetestuj funkcję za pomocą przycisku „Test”, używając reprezentatywnych danych wejściowych.
- Przetestuj funkcję w jednej aplikacji deweloperskiej od początku do końca.
- Opublikuj nową wersję aplikacji ( version ), aby powiązać ją ze zaktualizowaną funkcją.
- Monitoruj aplikacje produkcyjne pod kątem nieoczekiwanych zachowań.
Najlepsza praktyka: Należy stosować procedurę zatwierdzania funkcji wykorzystywanych w aplikacjach produkcyjnych.
Dodatkowe zasoby
{{snippet.Czy znalazłeś to, czego szukałeś?}}