Dlaczego tworzenie aplikacji Power Apps warto oprzeć o dobre praktyki? Wyobraź sobie, że Citizen Developer w twojej firmie zbudował rozwiązanie na tyle dobre, że realizuje kluczowy proces lub po prostu ułatwia codzienne zadania dużej liczbie pracowników. Jednak sama aplikacja Power Apps ma jakieś niedociągnięcia, błędy czy wymaga częstych aktualizacji. Co więcej, jakakolwiek ingerencja w kod będzie bardzo czasochłonna.
Jak możesz temu zapobiec? Popularyzuj wśród użytkowników narzędzi Power Platform dobre praktyki Power Apps w wytwarzaniu rozwiązań. Sama wiedza techniczna to za mało.
Dobre praktyki Power Apps
W tym poście przyjrzymy się bliżej dobrym praktykom Power Apps, które zaoszczędzą ci sporo czasu i nerwów. Sprawią, że sposób działania aplikacji Power Platform będzie bardziej zrozumiały i czytelny. Niezależnie od tego, czy to oryginalny autor aplikacji zagląda do niej po dłuższym czasie, czy aplikacja została przekazana do innej osoby lub działu do dalszego rozwoju i utrzymania.
Podstawy tworzenia aplikacji Power Apps
Świadomy wybór środowiska
Aplikacja Power Apps powinna znajdować się na odpowiednim środowisku Power Platform. Dla wersji produkcyjnej aplikacji ogólnofirmowej będzie to środowisko typu Production. Do scenariuszy związanych z produktywnością osobistą – środowisko domyślne (Default). Dopasuj środowisko do typu zastosowania aplikacji Power Platform!
Tytuł, opis i ikona aplikacji
Jeżeli wymyśliłeś jakąś chwytliwą nazwę dla Twojej aplikacji, koniecznie jej użyj! W przeciwnym wypadku, w tytule opisz w kilku słowach jej zastosowanie. Niech to nie będzie słowo „Test”! Kolejnym kluczowym elementem aplikacji jest opis – będzie przydatny administratorom Power Platform i zwykłym użytkownikom, którzy na przykład chcą dodać aplikację do Teams. Ustaw ikonę dla aplikacji, wybierając jedną z dostępnych w Power Apps lub dodając własną.
Power Platform lubi porządek
Odpowiednie nazewnictwo aplikacji Power Apps
Przyjmij spójną konwencję nazewnictwa poszczególnych ekranów, kontrolek, zmiennych, kolekcji, komponentów i się jej trzymaj – zanim rozpoczniesz dodawanie elementów interfejsu użytkownika.
Przykładowa konwencja nazewnictwa aplikacji:
- Nazwy ekranów: użyj dopisku Screen na końcu, np. HomeScreen
- Nazwy zmiennych, kolekcji, kontrolek oraz komponentów: użyj camel case, rozpoczynając nazwę od prefiksu, a następnie dopisując każdy kolejny wyraz wielką literą
- Nazwy kontrolek: skrócona informacja o typie kontrolki oraz jej przeznaczeniu np. lblUserEmail
- Nazwy zmiennych: zacznij od prefiksu var varExampleOfVariable, varMessage
- Nazwy kolekcji: zacznij od prefiksu col colExampleOfCollection, colItems
- Nazwy komponentów: zacznij od prefiksu cmp cmpExampleOfComponent
- Nazwy źródeł danych: użyj Pascal Case, to znaczy każdy wyraz powinien zaczynać się wielką literą np. EmployeeOrders
⚠ Uwaga: Nazw źródeł danych dodanych do aplikacji nie da się zmienić z poziomu Power Apps. Nazwy są dziedziczone z konektora lub tabel dodanych do aplikacji. Zasady nazewnictwa należy więc stosować w momencie konfiguracji źródła danych, na przykład tworzenia tabeli lub listy.
Zadbaj o kod w aplikacji
Komentarze w kodzie
Pamiętaj o komentarzach pomiędzy linijkami kodu. Komentarze pomagają zrozumieć aplikację nie tylko osobom, które ją edytują, ale również autorowi po dłuższej przerwie. Komentarze można zapisywać na dwa sposoby:
- Rozpoczynając komentarz jednolinijkowy od znaków //
- // to jest komentarz jednolinijkowy
- Zagnieżdżając w komentarzu jedną lub więcej linijek za pomocą znaków /* i */
- /* to jest komentarz,
który ma
więcej linijek */
- /* to jest komentarz,
Grupuj elementy i twórz komponenty
Zbiorowiska kontrolek na ekranie, które tworzą spójną całość, można organizować w grupy. Przykładem grupy może być pasek w górnej części aplikacji zawierający przyciski, etykiety tekstowe, logo itp. Elementy galerii i formularzy są domyślnie zorganizowane w grupach.
Alternatywą dla grup mogą być komponenty, które są niestandardowymi elementami wielokrotnego użytku. Możesz stworzyć własny element aplikacji składający się z wielu kontrolek, a następnie umieszczać go na różnych ekranach lub nawet w różnych aplikacjach. Warto również zaznaczyć, że komponent może przyjmować zdefiniowane przez nas dane wejściowe i na ich podstawie zmieniać swoje właściwości.
Formatuj kod
- Pamiętaj o formatowaniu kodu i o wcięciach zwiększających czytelność.
- Podając argumenty funkcji, przenoś każdy z nich do osobnych linijek z dodatkowymi wcięciami.
- Można również skorzystać z funkcji „Formatuj kod” znajdującej się pod obszarem wprowadzania kodu, która za pomocą jednego kliknięcia uczyni kod bardziej czytelnym.
Im prościej, tym lepiej
Korzystaj z uproszczonej składni
Niektóre formuły można zapisać w uproszczony sposób. Korzystaj z tego, aby zwiększyć czytelność kodu. Przykładem jest funkcja If.
Zamiast zagnieżdżać funkcje If w sposób przedstawiony poniżej:
skorzystaj z następującej, uproszczonej składni:
Używaj funkcji delegowalnych
Podczas komunikacji ze źródłami danych niektóre funkcje mogą być oddelegowane do źródła danych, a inne – niedelegowalne – będą obliczane lokalnie. Korzystając z funkcji delegowalnych, unikniesz problemu z limitem pobieranych do aplikacji danych oraz poprawisz swoich wydajność aplikacji.
Zarządzanie aplikacjami Power Apps
Rozwiązania i zarządzanie cyklem życia aplikacji
Dla lepszego zarządzania aplikacjami, składnikami budującymi z aplikacją spójną całość oraz do zarządzania cyklem życia aplikacji zalecane jest korzystanie z mechanizmu Rozwiązań.
Rozwiązania pozwalają na umieszczenie wszystkich składników (takich jak aplikacja, automatyzacje, schematy tabel Dataverse) w jednej paczce. Taką paczkę łatwo wyeksportujesz i zaimportujesz np. na innym środowisku w ramach organizacji lub u klienta.
Nadawaj odpowiednie uprawnienia
Należy pamiętać, że oprócz udostępnienia aplikacji kanwy Power Apps użytkownikom, należy nadać im również uprawnienia do źródeł danych. Warto nad tym tematem pochylić się bardziej i udostępnić użytkownikom tylko i wyłącznie te uprawnienia, których rzeczywiście potrzebują.
Dla przykładu, jeżeli wykorzystujemy SharePoint jako źródło danych, należy skonfigurować odpowiednie grupy oraz poziomy uprawnień w witrynie SharePoint. To znacznie ułatwia zarządzanie aplikacjami Power Apps i pozwala trzymać porządek w obszarze uprawnień aplikacji.
Napisz dokumentację techniczną
Może zdarzyć się tak, że autor aplikacji będzie musiał przekazać zarządzanie nią komuś innemu. W tym przypadku niezwykle pomocna będzie dokumentacja techniczna aplikacji, pozwalająca na lepsze zrozumienie mechanizmów jej działania.
Dokumentacja powinna zawierać m.in.
- szczegółowe informacje o jej zastosowaniu,
- sposobie działania,
- funkcjonalnościach,
- licencjonowaniu,
- dostępach,
- użytych źródłach danych,
- poszczególnych elementach interfejsu,
- dodawaniu nowych użytkowników,
- typowych problemach i ich rozwiązaniach,
- instrukcje użytkowania,
- informacje o wykorzystywanych przepływach,
- a także szczegóły dotyczące integracji z innymi usługami i platformami.
Im więcej szczegółów, tym lepiej dla kolejnych jej administratorów czy użytkowników. Pisanie dokumentacji technicznej nie zawsze należy do „ulubionych” zajęć twórców oprogramowania, ale w tym przypadku zdecydowanie się opłaca.
Tworzenie aplikacji Power Apps podsumowanie
Czy warto stosować dobre praktyki? Zdecydowanie warto. Dzięki temu zarządzanie aplikacjami Power Apps jest lepsze i bardziej efektywne. Na początku wymaga to trochę nauki, ale przede wszystkim uważnej obserwacji konsekwencji ich stosowania lub niestosowania.
Lista praktyk na dobry początek obejmuje wybór środowiska, odpowiednie nazewnictwo, komentarze w kodzie, grupowanie elementów i tworzenie komponentów, formatowanie kodu, uproszczoną składnię, użycie funkcji delegowalnych oraz zarządzanie cyklem życia aplikacji, nadanie odpowiednich uprawnień i napisanie dokumentacji technicznej.
Każda z opisanych praktyk pomaga ulepszać aplikacje i w dłuższej perspektywie oszczędzać czas oraz unikać kłopotów. Znajdzie zastosowanie w każdej aplikacji Power Apps.
Zachęcam do śledzenia innych wpisów na temat technologii na stronie Asseco Cloud Publikacje – Wdrożenia i migracje do chmury, Modern Workplace i bezpieczeństwo dostarczane przez ekspertów (asseco.cloud)
Jeśli planujesz zastosowanie platformy Power Apps w swojej organizacji i potrzebujesz eksperckiej wiedzy i doświadczenia, skontaktuj się z nami!
Rafał Świątkowski, Konsultant Power Platform, Rozwiązania Chmurowe & Centrum Danych
