Udostępnij przez

Wymagania dotyczące publikowania elementów w usłudze Microsoft Fabric

W tym dokumencie opisano wszystkie wymagania dotyczące publikowania elementów usługi Microsoft Fabric (artefaktów specyficznych dla obciążenia).

Wymagania ogólne

Ogólne wymagania dotyczące nazewnictwa elementów, ikon i podstawowych metadanych

1.1 — Element ma czystą nazwę

Element musi mieć wyraźną, opisową nazwę wyświetlaną, która pomaga użytkownikom zrozumieć jego przeznaczenie i typ. Nie można używać nazw ogólnych (na przykład sztucznej inteligencji, agenta,.. ) bez żadnego prefiksu wskazującego specjalizację, firmę lub produkt.

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

1.2 — Element ma wyraźną ikonę

Element musi mieć czytelną, rozpoznawalną ikonę, która wizualnie reprezentuje typ elementu w interfejsie Fabric.

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

Wytyczne:

UX:

Ikony typu pliku składają się z kontenera i wewnętrznej ikony systemu Fluent. Istnieją 3 kształty ogólne: pionowe, poziome i kwadratowe. Niektóre ikony wnętrza działają lepiej w określonych kształtach, więc zbadaj, który kształt jest najlepszy.

Ten szablon siatki wyświetla rozmiary, których używamy: 20 / 24 / 32 / 40 / 48 / 64 Dla obszaru roboczego, strona obciążenia L2 i karty używamy rozmiaru 24x24px.

Ikona wnętrza powinna być wyśrodkowana w kontenerze. Jeśli ikona składa się tylko/głównie z pociągnięć i potrzebuje większej wagi, możesz dostosować się do wagi 1,5 pikseli. Ogólne informacje dotyczące określania rozmiaru ikon wewnątrz kontenera:

  • 12px w kontenerze o wymiarze 20px
  • 14px w kontenerze o wymiarach 24px
  • 20 pikseli w kontenerze 32px
  • 24px w kontenerze 40px
  • 28px w kontenerze o rozmiarze 48px
  • 36px w kontenerze o wymiarach 64px

Upewnij się, że ikony wnętrza są tak wyśrodkowane, jak to możliwe. Wszystkie ikony są rysowane z obrysem o grubości 1 piksela, chyba że określono inaczej. Ikona elementu musi być zgodna z wytycznymi dotyczącymi tworzenia ikon w celu zapewnienia spójności na platformie Fabric.

1.2.1 — Element ma czystą aktywną ikonę

Element musi podać odrębną aktywną ikonę stanu, aby wskazać, kiedy element jest zaznaczony lub w fokusie.

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

1.3 — Element ma jasny tytuł w menu tworzenia

Element musi wyświetlić jasny tytuł w menu tworzenia zgodnym z nazwą wyświetlaną elementu w celu zapewnienia spójności

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

1.4 — Element ma wyraźny podtytuł w menu tworzenia

Element musi podać zwięzły, informacyjny podtytuł w menu tworzenia, który opisuje przeznaczenie lub kluczowe funkcje elementu

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

1.5 — Element można dodać do ulubionych w nowym menu

Element musi obsługiwać funkcje faworyzowania w menu "nowy", aby umożliwić użytkownikom szybki dostęp do często używanych elementów

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

Przepływ tworzenia elementów

Wymagania dotyczące środowiska tworzenia elementów i integracji obszaru roboczego

2.1 — Doświadczenie tworzenia elementów

Przepływ tworzenia elementów musi być zgodny z wytycznymi projektowania Fabric, zapewniającymi spójne i intuicyjne doświadczenie dla użytkowników.

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

2.2 — Element można utworzyć w centrum tworzenia

Element musi być dostępny do utworzenia przez Fabric Creation Hub, aby umożliwić scentralizowane tworzenie elementów.

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

2.3 — Element można utworzyć w menu Obszar roboczy

Element musi być dostępny do utworzenia za pomocą menu "+Nowy" obszaru roboczego na potrzeby tworzenia elementu kontekstowego

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

2.4 — Środowisko tworzenia platformy jest skonfigurowane

Tworzenie elementu musi używać domyślnego systemu nazewnictwa Fabric (createItemDialogConfig w pliku Product.json). Przepływy tworzenia elementów niestandardowych są przestarzałe, jeśli są używane, należy unikać generowania domyślnych nazw, aby zapobiec bałaganowi obszaru roboczego

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

2.5 — Element jest utrwalany w obszarze roboczym

Utworzone elementy muszą być natychmiast utrwalone i widoczne w obszarze roboczym po zakończeniu tworzenia

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

2.6 — Element znajduje się w menu wielozadaniowym i obsługuje zachowanie

Elementy muszą być wyświetlane w menu wielozadaniowym i bezproblemowo obsługiwać przełączanie między wieloma otwartymi elementami

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

2.7 — Tworzenie elementów działa w obszarze *.powerbi.com i *.fabric.microsoft.com

Tworzenie elementu musi działać poprawnie zarówno w domenach powerbi.com, jak i fabric.microsoft.com na potrzeby obsługi wielu platform

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Wstążka i pasek narzędzi

Wymagania dotyczące wstążki edytora elementów i paska narzędzi zgodnie z wytycznymi dotyczącymi projektowania

3.1 — Wstążka edytora elementów istnieje

Edytor elementów musi implementować jeden interfejs wstążki, aby zapewnić spójne doświadczenie użytkownika w Fabric. Ta wstążka powinna zawierać wszystkie akcje i kontrolki niezbędne do edycji elementów i musi być lepka na górze nad kanwą. Nie można używać kart wstążki do przełączania widoku.

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

Wytyczne:

UX:

Edytor elementów musi implementować jeden interfejs wstążki, aby zapewnić spójne doświadczenie użytkownika w Fabric. Ta wstążka powinna zawierać wszystkie akcje i kontrolki niezbędne do edycji elementów i musi być lepka na górze nad kanwą. Nie można używać kart wstążki do przełączania widoku.

3.2 — Akcje wstążki Edytora elementów przestrzegają przewodnika stylu

Akcje na wstążce Edytora elementów muszą używać komponentu przycisku Fabric w trybie subtelnym. Każdy inny składnik powinien mieć maksymalną wysokość 32 pikseli

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

Wytyczne:

UX:

Akcje na wstążce Edytora elementów muszą używać komponentu przycisku Fabric w trybie subtelnym. Każdy inny składnik powinien mieć maksymalną wysokość 32 pikseli.

3.2.10 — Podpowiedzi narzędziowe wstążki Edytora elementów — postępuj zgodnie z przewodnikiem po stylu

Etykiety narzędzi wstążki muszą być zgodne z wytycznymi Fabric dotyczącymi zawartości, czasu włączenia i umiejscowienia, aby ułatwić zrozumienie przez użytkowników.

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

Wytyczne:

UX:

3.3 — wstążka edytora elementów ma kartę "Narzędzia główne"

Wstążka Edytora elementu musi zawierać kartę główną jako główną stronę edytora. Musi być również nazywany "Strona główna" i być pierwszą kartą na wstążce. Jest to pierwsze miejsce, w których użytkownicy lądują podczas otwierania edytora elementów. Karty służą tylko do przełączania kontrolki wstążki i nie mogą być używane do przełączania kanwy.

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

Wytyczne:

UX:

Wstążka Edytora elementów musi zawierać kartę Strona główna jako główną stronę edytora, musi być również nazwana "strona główna" i być pierwszą kartą na wstążce. To jest pierwsze miejsce, do którego użytkownicy trafią podczas otwierania edytora elementów.

3.4 — wstążka Edytora elementów implementuje przycisk zapisywania/ Autozapis

Edytor elementów powinien zapewnić jawną funkcję zapisywania lub autozapis, aby zapobiec utracie danych

Wymagania dotyczące etapu:

Preview Ogólna dostępność
⚠✔ Opcjonalne ⚠✔ Opcjonalne

Dokumentacja:

Wytyczne:

UX:

Edytor elementów powinien zaimplementować przycisk zapisywania lub funkcję automatycznego zapisywania na potrzeby ochrony danych użytkownika. przycisk jest tylko ikoną.

3.6 — Kolor wstążki Edytora elementów — jest zgodny z przewodnikiem po stylu

Kolory wstążki muszą być zgodne z wytycznymi dotyczącymi stylu Fabric przy użyciu zatwierdzonych tokenów i obsługi motywów. Przykład: tabela zmienia się z szarości na czerwoną, gdy stanie się odrzucana tabela.

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

Wytyczne:

UX:

3.7 — Wstążka Edytora elementów: typografia zgodna z przewodnikiem po stylu

Typografia wstążki musi używać czcionek, rozmiarów i wag zatwierdzonych przez framework Fabric, aby zapewnić spójne wyświetlanie tekstu.

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Wytyczne:

UX:

3.8 — Podniesienie wysokości wstążki Edytora elementów — postępuj zgodnie z przewodnikiem po stylu

Elevacja wstążki (cień/głębokość) musi być zgodna z wytycznymi Fabric, aby zachować odpowiednie warstwy wizualne.

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

Wytyczne:

UX:

3.9 — Promień obramowania Wstążki Edytora elementów — według przewodnika po stylu

Promień obramowania wstążki musi być zgodny z wytycznymi Fabric dla spójnego stylu zaokrąglonych rogów

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

Wytyczne:

UX:

3.10 — Odstępy i układy wstążki Edytora elementów — postępuj zgodnie z przewodnikiem po stylu

Odstępy i układ wstążki muszą używać odstępów, marginesów i systemów siatki zatwierdzonych przez system Fabric dla zachowania spójności wizualnej.

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

Wytyczne:

UX:

Odstępy i układ wstążki muszą używać paddingu zatwierdzonego przez Fabric, marginesów i systemów siatki w celu zapewnienia spójności wizualnej. Odstępy między paskami i układy przycisków: w przypadku umieszczania przycisków obok siebie to użyj odstępu 0 pikseli. Podczas dodawania linii obramowania między przyciskami użyj odstępów 4px po lewej i prawej stronie. W przypadku umieszczania różnych składników, np. listy rozwijanej, użyj odstępów 4px między nimi.

Kanwa i edytor

Wymagania dotyczące składników interfejsu użytkownika kanwy elementu i edytora

4.1 — Ramka kanwy — stosuj się do przewodnika stylu

Stylizowanie obramowania canvy musi być zgodne z wytycznymi Fabric dotyczącymi koloru, szerokości i promienia obramowania.

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

Wytyczne:

UX:

Stylizacja obramowania kanwy musi być zgodna z wytycznymi Fabric dotyczącymi koloru, szerokości i promienia obramowania. Kanwa musi implementować odpowiednie style obramowania zgodnie ze standardami projektowania sieci szkieletowej.

4.2 — Kolory — zgodne z przewodnikiem po stylu

Kolory Canvas powinny być zgodne z wytycznymi stylu Fabric, używając semantycznych tokenów kolorów oraz wsparcia motywów.

Wymagania dotyczące etapu:

Preview Ogólna dostępność
⚠✔ Opcjonalne ⚠✔ Opcjonalne

Dokumentacja:

Wytyczne:

UX:

Kolory kanwy powinny być zgodne z wytycznymi stylu Fabric przy użyciu semantycznych tokenów kolorów i obsługi motywów. Kolory kanwy muszą być zgodne z wytycznymi dotyczącymi kolorów systemu projektowego Fabric w celu zapewnienia spójności.

4.3 — Stany puste — postępuj zgodnie z przewodnikiem po stylu

Jeśli stan pusty istnieje (zalecane), należy postępować zgodnie z wytycznymi Fabric, które zapewniają przydatne komunikaty i jasne akcje dla użytkowników.

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

Wytyczne:

UX:

Jeśli stan Pusty istnieje (zalecane), należy postępować zgodnie z wytycznymi Fabric, zapewniając przydatne komunikaty i czytelne działania dla użytkowników. Kanwa musi prawidłowo implementować puste stany, aby wskazywać użytkownikom, gdy nie istnieje żadna zawartość.

4.4 — Szuflada po lewej stronie — zgodnie z przewodnikiem po stylu

Jeśli istnieje panel lewej szuflady, należy postępować zgodnie z wytycznymi Fabric dotyczącymi szerokości, animacji i organizacji zawartości.

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

Wytyczne:

UX:

Jeśli istnieje panel lewej szuflady, powinien on być zgodny z wytycznymi Fabric dotyczącymi szerokości, animacji i organizacji zawartości. Kanwa może wykorzystać panel umieszczony po lewej stronie na potrzeby dodatkowej nawigacji lub narzędzi.

4.5: Dolna szuflada - zgodna z przewodnikiem stylu

Jeśli dolny panel szuflady istnieje, należy postępować zgodnie z zaleceniami Fabric dotyczącymi wysokości, animacji i organizacji zawartości.

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

Wytyczne:

UX:

Jeśli dolny panel szuflady istnieje, należy postępować zgodnie z wytycznymi Fabric dotyczącymi wysokości, animacji i organizacji zawartości. Kanwa może zaimplementować dolną szufladę dla zwiększenia funkcjonalności.

4.6 — Karty — zgodnie z wytycznymi dotyczącymi stylu

Składniki tabulacji powinny być zgodne z wytycznymi Fabric dotyczącymi stylów, interakcji i aktywnego wskazania stanu

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

Wytyczne:

UX:

Składniki tabulacji powinny być zgodne z wytycznymi Fabric dotyczącymi stylizacji, interakcji z użytkownikiem oraz oznaczania aktywnego stanu. Kanwa może implementować karty do organizowania zawartości w edytorze.

4.7 — Elementy sterujące przełącznikami — postępuj zgodnie z przewodnikiem stylu

Jeśli istnieją kontrolki przełącznika/przycisku, powinny one przestrzegać wytycznych Fluent UI dotyczących rozmiaru, koloru i zachowania interakcji.

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

Wytyczne:

UX:

Jeśli są kontrolki przełącznika/przełączania, powinny one przestrzegać wytycznych Fabric dotyczących rozmiaru, koloru i zachowania interakcji. Kanwa może implementować kontrolki przełącznika na potrzeby przełączania funkcji.

4.8 — Kontrolka Canvas Center — przestrzegaj przewodnika stylu

Panel szuflady środkowej powinien być zgodny z wytycznymi dotyczącymi szerokości, animacji i organizacji zawartości

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

Wytyczne:

UX:

Wymagania dotyczące nawigacji między widokami elementów i poziomami

5.1 — nawigacja na wielu poziomach

Jeśli używana jest wielopoziomowa nawigacja między poziomami canvas (L1 do L2), musi ona być zgodna z wytycznymi Fabric dotyczącymi przejść, nawigacji breadcrumb i nawigacji wstecznej.

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

Wytyczne:

UX:

Wymagania dotyczące okien podręcznych i okien modalnych zgodnie z wytycznymi dotyczącymi projektowania

6.1 — okno dialogowe wyskakujące — postępuj zgodnie z przewodnikiem stylu

Jeśli są używane okna dialogowe wyskakujące, muszą przestrzegać wytycznych stylu Fabric dotyczących zachowania modalnego, tła i wzorców zamykania.

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

Wytyczne:

UX:

6.1.5 — Promień obramowania — jest zgodny z przewodnikiem stylu

Promień obramowania okna dialogowego musi być zgodny z wytycznymi Fabric dotyczącymi spójnych zaokrąglonych rogów w modale.

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

Wytyczne:

UX:

6.2 — Kolor — jest zgodny z przewodnikiem po stylu

Kolory okien dialogowych muszą być zgodne z wytycznymi Fabric, używając tokenów kolorów semantycznych dla tła, tekstu i obramowań.

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

Wytyczne:

UX:

6.3 — Typografia — postępuj zgodnie z przewodnikiem po stylu

Typografia okna dialogowego musi używać czcionek, rozmiarów i hierarchii zatwierdzonych przez system projektowy Fabric dla nagłówków, tekstu głównego i akcji.

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

Wytyczne:

UX:

6.4 — Eskalacja uprawnień — zgodnie z przewodnikiem stylu

Dialog musi być zgodny z wytycznymi Fabric, aby zapewnić właściwe warstwowanie wizualne nad zawartością strony.

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

Wytyczne:

UX:

6.6 — Odstępy i układy — postępuj zgodnie z wytycznymi dotyczącymi stylu

Odstępy i układ okien dialogowych muszą używać zatwierdzonych przez Fabric wzorców rozplanowania, marginesów i organizacji zawartości

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

Wytyczne:

UX:

Inne wymagania dotyczące środowiska użytkownika

Inne wymagania, w tym monitorowanie, ustawienia i menu kontekstowe

7.1 — Integracja centrum monitorowania

Element powinien opcjonalnie zintegrować się z Platformą Monitorowania Fabric, aby uwidocznić dane dotyczące realizacji zadań i wydajności

Wymagania dotyczące etapu:

Preview Ogólna dostępność
⚠✔ Opcjonalne ⚠✔ Opcjonalne

Dokumentacja:

7.2 — Akcje w obszarze roboczym muszą działać

Jeśli są używane akcje w obszarze roboczym, wszystkie akcje elementu (zmiana nazwy, usuwanie, udostępnianie itp.) muszą działać poprawnie

Wymagania dotyczące etapu:

Preview Ogólna dostępność
✅ Wymagane ✅ Wymagane

Dokumentacja:

7.3 — Środowisko wersji próbnej

Element powinien udostępnić przykładowe środowisko lub wersję próbną, aby ułatwić użytkownikom eksplorowanie funkcji przed zatwierdzeniem zakupu.

Wymagania dotyczące etapu:

Preview Ogólna dostępność
⚠✔ Opcjonalne ⚠✔ Opcjonalne

Dokumentacja:

Wytyczne:

UX:

Doświadczenie monetyzacji

Element powinien udostępnić przykładowe środowisko lub wersję próbną, aby ułatwić użytkownikom eksplorowanie funkcji przed zatwierdzeniem

Wymagania dotyczące etapu:

Preview Ogólna dostępność
⚠✔ Opcjonalne ⚠✔ Opcjonalne

Dokumentacja:

Wytyczne:

UX:

7.5 — Zadania do wykonania

Element powinien definiować typy zadań w manifeście, aby umożliwić śledzenie zadań i monitorowanie integracji

Wymagania dotyczące etapu:

Preview Ogólna dostępność
⚠✔ Opcjonalne ⚠✔ Opcjonalne

Dokumentacja:

7.6 — używane są ustawienia elementu

Element powinien implementować panel ustawień dla konfiguracji użytkownika według wzorców Fabric.

Wymagania dotyczące etapu:

Preview Ogólna dostępność
⚠✔ Opcjonalne ⚠✔ Opcjonalne

Dokumentacja:

7.7 — Akcje elementów niestandardowych

Element powinien definiować akcje niestandardowe dla elementu w obszarze roboczym. Wszystkie akcje muszą działać, jeśli zostały zdefiniowane.

Wymagania dotyczące etapu:

Preview Ogólna dostępność
⚠✔ Opcjonalne ⚠✔ Opcjonalne

Dokumentacja:

Dodatkowe informacje

Historia wersji

Ten dokument jest generowany automatycznie.

Generowane przez system weryfikacji obciążenia usługi Microsoft Fabric
© 2025 Microsoft Corporation. Wszelkie prawa zastrzeżone.

  • Last updated on