Ustawienia PowerBox

Przegląd

PowerBox wymaga jednorazowej konfiguracji w celu włączenia integracji Power Apps z Business Central. Proces konfiguracji obejmuje skonfigurowanie identyfikatora Power App, parametrów specyficznych dla obszaru oraz kompleksowych ustawień okna Power Apps, które określają sposób interakcji aplikacji z różnymi encjami Business Central i reakcję na różne rozmiary ekranu oraz ograniczenia układu.

Informacja

Czym jest "okno Power Apps" w PowerBox?
Okno Power Apps to kontener iframe wewnątrz factbox'a Business Central, który wyświetla Twoją aplikację Power Apps. Ustawienia okna określają wymiary i zachowanie tego kontenera, nie zawartości samej aplikacji Power Apps.

Kroki konfiguracji

1. Podstawowa konfiguracja aplikacji

Wyszukaj "Ustawienia PowerBox" w Business Central
Dla każdego obszaru, który chcesz włączyć (Nabywca, Dostawca):
- Wybierz Obszar z listy rozwijanej
- Wprowadź identyfikator aplikacji Power App w polu AppId
- AppId można znaleźć w portalu twórców Power Apps
- Użyj pola wyboru Włączone, aby aktywować/dezaktywować integrację PowerApps dla tego konkretnego obszaru

2. Wymiary okna Power Apps

Skonfiguruj podstawowe wymiary okien PowerApps:

Wysokość okna: Ustaw domyślną wysokość okien PowerApps (domyślnie: 400px, zakres: 200-2000px)
Szerokość okna: Ustaw domyślną szerokość okien PowerApps (domyślnie: 425px, zakres: 200-2000px)

3. Konfiguracja parametrów

Skonfiguruj parametry do przekazywania danych do Power Apps:

Nazwa parametru: Zdefiniuj nazwę parametru, który zostanie przekazany do Power Apps
Etykieta pola: Użyj wyszukiwania, aby wybrać wartość którego pola zostanie przekazana do Power App
System automatycznie ustawi Nr pola i Nr tabeli na podstawie Twojego wyboru

4. Skalowanie i responsywność

Kontroluj sposób reakcji okien PowerApps na zmiany rozmiaru ekranu:

Podstawowe skalowanie

Włącz skalowanie: Włącz zaawansowane funkcje skalowania (gdy wyłączone, używa podstawowych stałych wymiarów)
Włącz rozciąganie pionowe: Pozwól oknom PowerApps rozciągać się w pionie
Włącz rozciąganie poziome: Pozwól oknom PowerApps rozciągać się w poziomie
Włącz kurczenie pionowe: Pozwól oknom kurczyć się gdy przestrzeń pionowa jest ograniczona
Włącz kurczenie poziome: Pozwól oknom kurczyć się gdy przestrzeń pozioma jest ograniczona

Ograniczenia rozmiaru

Minimalna wysokość: Ustaw dolną granicę, aby zapobiec zbyt małym oknom (domyślnie: 300px, zakres: 100-1000px)
Maksymalna wysokość: Ustaw górną granicę, aby zapobiec zbyt dużym oknom (domyślnie: 400px, zakres: 400-3000px)
Minimalna szerokość: Ustaw dolną granicę szerokości (domyślnie: 200px, zakres: 100-800px)
Maksymalna szerokość: Ustaw górną granicę szerokości (domyślnie: 425px, zakres: 300-2000px)

5. Optymalizacja wydajności

Dostrajaj wydajność i responsywność:

Opóźnienie zmiany rozmiaru (ms): Opóźnienie przed zastosowaniem zmian rozmiaru (domyślnie: 300ms, zakres: 100-2000ms)
- Wyższe wartości redukują wpływ na wydajność, ale sprawiają, że zmiana rozmiaru jest mniej responsywna
Min zmiana szerokości (px): Minimalna zmiana szerokości wymagana do wywołania zmiany rozmiaru (domyślnie: 5px, zakres: 1-50px)
- Wyższe wartości redukują czułość na małe zmiany
Margines okna (px): Margines do odjęcia od szerokości FactBox (domyślnie: 70px, zakres: 20-100px)
- Zapobiega rozszerzaniu okna poza kontener

Szczegóły techniczne

Konfiguracja PowerBox składa się z kompleksowego systemu konfiguracyjnego z następującymi kluczowymi funkcjami:

Struktura tabeli konfiguracji PowerBox

Każdy obszar (Klient, Dostawca) ma własny rekord konfiguracyjny zawierający:

Podstawowa konfiguracja

Obszar - Obszar integracji (Klient lub Dostawca)
AppId - Unikalny identyfikator Twojej aplikacji Power App, która zostanie osadzona w factboxach
Włączone - Kontroluje czy integracja PowerApps jest aktywna dla tego obszaru (domyślnie: true)
Nazwa parametru - Nazwa parametru, który zostanie przekazany do Power Apps
Nr pola - Numer pola z tabeli źródłowej, którego wartość zostanie przekazana
Tytuł pola - Nazwa wyświetlana wybranego pola (wypełniana automatycznie)
Nr tabeli - Numer tabeli (ustawiany automatycznie na podstawie obszaru)

Wymiary okna Power Apps

Wysokość/Szerokość okna - Podstawowe wymiary dla iframe PowerApps
Minimalna/Maksymalna wysokość/szerokość - Ograniczenia rozmiaru dla responsywnego zachowania

Ustawienia responsywności

Włącz skalowanie - Główny przełącznik dla zaawansowanych funkcji skalowania
Włącz rozciąganie w pionie/poziomie - Pozwól oknom rozszerzać się poza podstawowe wymiary
Włącz kurczenie w pionie/poziomie - Pozwól oknom kurczyć się poniżej podstawowych wymiarów

Ustawienia wydajności

Opóźnienie zmiany rozmiaru - Ograniczanie zdarzeń zmiany rozmiaru w celu optymalizacji wydajności
Min. zmiana szerokości - Próg czułości dla wyzwalaczy zmiany rozmiaru
Margines okna - Przestrzeń buforowa zapobiegająca przepełnieniu układu

Obsługiwane obszary

PowerBox obecnie obsługuje integrację z:

Klient - Stronami listy klientów i karty klienta
Dostawca - Stronami listy dostawców i karty dostawcy

Każdy obszar może mieć własną niezależną konfigurację obejmującą:

Unikalny identyfikator Power App (pozwalający na różne aplikacje Power Apps dla różnych obszarów)
Niestandardową konfigurację parametrów do przekazywania danych
Indywidualne ustawienia okna i responsywne zachowanie
Optymalizację wydajności specyficzną dla obszaru

Obsługa typów danych

Następujące typy pól są obsługiwane dla mapowania parametrów:

Tekst
Kod
Liczba całkowita
Duża liczba całkowita
Liczba dziesiętna
Wartość logiczna
Data
Czas
Data i czas
Opcja

Walidacja

Po konfiguracji:

Otwórz dowolną obsługiwaną stronę (np. Kartę klienta, Listę klientów, Kartę dostawcy lub Listę dostawców)
Sprawdź, czy factbox Power Apps jest widoczny po prawej stronie
Factbox powinien wyświetlać Twoją osadzoną aplikację Power App ze skonfigurowanymi wymiarami
Przetestuj responsywność zmieniając rozmiar okna Business Central
Sprawdź, czy skonfigurowane parametry są przekazywane prawidłowo do Twojej aplikacji Power App
Sprawdź, czy zachowania skalowania działają zgodnie z oczekiwaniami na podstawie Twojej konfiguracji

Najlepsze praktyki

Zarządzanie obszarami

Używaj pola Włączone, aby szybko aktywować/dezaktywować integrację PowerApps dla konkretnych obszarów bez usuwania konfiguracji
Zachowaj konfiguracje dla wyłączonych obszarów w stanie nienaruszonym, aby łatwo je ponownie włączyć później

Optymalizacja wydajności

Używaj odpowiednich opóźnień zmiany rozmiaru (zalecane 300ms), aby zrównoważyć responsywność i wydajność
Ustaw minimalne progi zmian szerokości (zalecane 5px), aby uniknąć nadmiernych zdarzeń zmiany rozmiaru
Skonfiguruj odpowiednie marginesy (zalecane 70px), aby zapobiec problemom z układem

Responsywny design

Włączaj funkcje skalowania tylko gdy jest to potrzebne, aby zachować wydajność
Ustaw rozsądne ograniczenia min/max, aby zapewnić dobre doświadczenie użytkownika na różnych urządzeniach
Testuj dokładnie na różnych rozmiarach ekranu i poziomach powiększenia przeglądarki

Konfiguracja parametrów

Wybieraj odpowiednie pola do przekazywania parametrów na podstawie wymagań Twojej aplikacji Power App
Rozważaj klasyfikację danych i bezpieczeństwo podczas wybierania pól
Używaj znaczących nazw parametrów, które pasują do oczekiwanych danych wejściowych Twojej aplikacji Power App

Informacja

Factbox automatycznie się ukryje, jeśli nie jest skonfigurowany AppId dla obszaru lub jeśli obszar jest wyłączony
Używaj pola Włączone, aby tymczasowo wyłączyć integrację PowerApps przy zachowaniu wszystkich ustawień konfiguracji
Każdy obszar musi być prawidłowo skonfigurowany i włączony, aby przekazywanie danych działało
Wybór pola jest ograniczony do odpowiednich typów danych i klasyfikacji ze względów bezpieczeństwa
Maksymalna wysokość nie może przekraczać wysokości okna, gdy obie są ustawione
Wszystkie zmiany konfiguracji wchodzą w życie natychmiast bez konieczności ponownego uruchomienia