Przekazywanie plików do SharePoint za pomocą metadanych z aplikacji opartych na modelu

W tej architekturze referencyjnej opisano sposób używania strony niestandardowej w aplikacji opartej na modelu do przechwytywania metadanych podczas przekazywania dokumentów do SharePoint. Takie podejście usprawnia środowisko użytkownika w aplikacjach opartych na modelu i obsługuje zarządzanie dokumentami i możliwość wyszukiwania w SharePoint przez wymuszanie metadanych w czasie przekazywania.

Wskazówka

Artykuł zawiera przykładowy scenariusz i wizualną reprezentację ilustrujący sposób użycia stron niestandardowych do przekazywania dokumentów obsługujących metadane z aplikacji opartych na modelu do SharePoint. To rozwiązanie jest uogólnioną przykładową architekturą scenariusza, która może być używana dla wielu różnych scenariuszy i branż.

Wykres architektury

Diagram aplikacji opartej na modelu w Power Apps uruchamiającej stronę niestandardową, wyzwalającej przepływ w chmurze Power Automate w celu przesyłania plików do SharePoint i tworzenia rekordów w Dataverse.

Workflow

  1. Użytkownik otwiera aplikację opartą na modelu i przechodzi do rekordu wymagającego przekazania dokumentu (na przykład sprawy, kontaktu lub konta).

  2. Użytkownik wybiera akcję Przekaż dokument (przycisk paska poleceń), która uruchamia stronę niestandardową jako okno dialogowe w aplikacji opartej na modelu.

  3. Strona niestandardowa zawiera:

    1. Wybór pliku (pojedynczy lub wiele plików).
    2. Pola metadanych odpowiadające kolumnom biblioteki dokumentów SharePoint.
    3. Walidacja i wskazówki oparte na regułach biznesowych.
    4. Kontekst rekordu źródłowego za pośrednictwem identyfikatora rekordu w adresie URL aplikacji opartej na modelu.
  4. Gdy użytkownik prześle formularz, strona niestandardowa wywołuje przepływ Power Automate w chmurze.

  5. Power Automate:

    1. Przekazuje pliki do docelowej biblioteki dokumentów SharePoint i/lub folderu na podstawie żądanej logiki lokalizacji w przepływie.

    2. Ustawia metadane SharePoint przy użyciu wartości podanych na stronie niestandardowej.

    3. Tworzy lub aktualizuje odpowiedni rekord lokalizacji dokumentu w usłudze Dataverse, aby zachować zgodność wsteczną z wbudowaną integracją usługi Dataverse i SharePoint.

  6. Przekazane dokumenty to:

    • Skojarzone z źródłowym rekordem Dataverse.
    • Wyszukiwanie i filtrowanie w SharePoint przy użyciu metadanych.

Szczegóły scenariusza

Organizacje często używają SharePoint zarządzania dokumentami za pomocą aplikacji opartych na modelu do przechowywania dokumentów związanych z rekordami biznesowymi. Jednak wbudowana integracja SharePoint nie umożliwia użytkownikom wypełniania wymaganych metadanych podczas przekazywania, co prowadzi do:

  • Niekompletne lub niespójne metadane
  • Zmniejszona możliwość wyszukiwania i zgodność z przepisami
  • Ręczne przeróbki w celu klasyfikowania dokumentów po przekazaniu

Ta architektura rozwiązuje te ograniczenia, wprowadzając niestandardowy system przesyłania oparty na stronie, który przechwytuje metadane w chwili przesyłania. Takie podejście poprawia jakość danych, doświadczenie użytkownika i zgodność, a jednocześnie pozostaje w pełni w ramach ekosystemu Power Platform i Microsoft 365.

Kluczowa wartość biznesowa obejmuje:

  • Ulepszony nadzór nad dokumentami i jakość metadanych
  • Spójne środowisko użytkownika osadzone w aplikacjach opartych na modelu
  • Zmniejszona interwencja ręczna i ponowna klasyfikacja
  • Rozszerzalność złożonych przepływów pracy bez kodu niestandardowego

Składniki

Power Apps (aplikacja oparta na modelu): hostuje podstawowe środowisko biznesowe i udostępnia kontekst przekazywania dokumentów.

Niestandardowa strona Power Apps: zapewnia elastyczny, niskokodowy interfejs użytkownika do przesyłania plików i przechwytywania metadanych, wyświetlany jako modalne okno dialogowe w aplikacji opartej na modelu.

Power Automate: Orkiestruje przekazywanie plików, przypisywanie metadanych i opcjonalne procesy podrzędne przy użyciu natywnych łączników SharePoint i Dataverse.

SharePoint: Działa jako repozytorium dokumentów, zapewniając zarządzanie dokumentami, metadane, przechowywanie wersji i zabezpieczenia.

Microsoft Dataverse: Przechowuje rekordy danych biznesowych i lokalizacji dokumentów, które łączą SharePoint dokumenty z rekordami aplikacji opartymi na modelu.

Rozważane alternatywy (wyższy nakład pracy w zakresie programowania i konserwacji):

Considerations

Te rozważania wdrażają filary Power Platform Well-Architected, zestaw zasad przewodnich, które poprawiają jakość obciążenia. Dowiedz się więcej w Microsoft Power Platform Well-Architected.

Reliability

Ta architektura zapewnia niezawodne przekazywanie dokumentów i trwałość metadanych między składnikami platformy.

  • Oddzielony interfejs użytkownika i przechowywanie: strona niestandardowa obsługuje interakcję użytkownika i przechwytywanie danych. SharePoint zarządza magazynem plików oraz trwałością metadanych, a Dataverse łączy rekordy między SharePoint a aplikacjami opartymi na modelu.

  • Obsługa dokumentów transakcyjnych: przekazywanie dokumentów i przypisywanie metadanych to pojedyncza operacja logiczna. Jeśli zastosowanie metadanych nie powiedzie się, proces ponawia próbę lub cofa przekazywanie, aby dokumenty nie pozostawały osierocone ani częściowo sklasyfikowane.

  • Trwałość natywna platformy: SharePoint zapewnia wbudowaną trwałość, wersjonowanie i nadmiarowość w przechowywaniu dokumentów. Usługa Dataverse zapewnia niezawodną trwałość lokalizacji dokumentu i danych biznesowych.

  • Obsługa prób ponownych i błędów: Power Automate korzysta z natywnych zasad ponawiania prób oraz obsługi błędów, aby zarządzać przejściowymi problemami podczas interakcji z SharePoint lub Dataverse. Takie podejście zwiększa odporność bez wprowadzania infrastruktury niestandardowej.

Zabezpieczenia

Zabezpieczenia są konsekwentnie wdrażane w warstwach środowiska użytkownika, orkiestracji i magazynu.

  • Kontrola dostępu oparta na tożsamości: Użytkownicy uwierzytelniają się za pośrednictwem Microsoft Entra ID. Zabezpieczenia oparte na rolach i uprawnienia SharePoint zarządzają dostępem do aplikacji opartej na modelu, niestandardowej strony i dokumentów SharePoint.

  • Projekt z najmniejszymi uprawnieniami: użytkownicy mogą przekazywać i wyświetlać dokumenty tylko dla rekordów, do których mają uprawnienia dostępu w usłudze Dataverse.

  • Nie bezpośredniego narażenia na SharePoint: Użytkownicy nigdy nie wchodzą w interakcje bezpośrednio z bibliotekami SharePoint. Wszystkie przesyłane dane odbywają się za pośrednictwem strony dostosowanej w aplikacji napędzanej modelem, co zmniejsza ryzyko obejścia reguł biznesowych lub wymagań dotyczących metadanych.

  • Bezpieczne użycie łącznika: połączenia w Power Automate używają tożsamości zarządzanych lub obiektów zasad usługi, jeśli jest to wymagane.

  • Spójność granic danych: Metadane przechwycone na stronie niestandardowej są weryfikowane względem schematów usługi Dataverse i SharePoint, uniemożliwiając wstrzykiwanie nieautoryzowanych lub źle sformułowanych wartości.

Doskonałość operacyjna

Architektura podkreśla łatwość utrzymania, wglądu i łatwość zmian.

  • Rozszerzalność rozwiązań niskodowych: za pomocą stron niestandardowych i Power Automate można zmienić wymagania dotyczące metadanych, reguły weryfikacji lub zachowanie przekazywania bez ponownego wdrażania kodu niestandardowego.

  • Jasne rozdzielenie kwestii:

    • Aplikacja oparta na modelu: kontekst biznesowy i nawigacja
    • Strona niestandardowa: przekazywanie dokumentów i przechwytywanie metadanych
    • Power Automate: Orkiestracja i integracja
    • SharePoint: Zarządzanie dokumentami i zgodność
  • Monitorowanie i diagnostyka: historia uruchomień Power Automate i audyt usługi Dataverse zapewniają wgląd w błędy przekazywania, problemy z metadanymi i zachowanie użytkownika. W razie potrzeby możesz rozszerzyć to monitorowanie do użycia z usługą aplikacja systemu Azure Insights.

  • Zrównywanie strategii środowiska: Rozwiązanie obsługuje standardowe strategie środowiska platformy Power Platform (programowanie, testowanie, produkcja) przy użyciu rozwiązań zarządzanych i zmiennych środowiskowych dla celów SharePoint.

  • Izolacja zmian: możesz odzwierciedlić zmiany schematu metadanych w SharePoint w interfejsie użytkownika strony niestandardowej bez wpływu na strukturę aplikacji opartej na modelu.

Wydajność operacyjna

Zagadnienia dotyczące wydajności koncentrują się na zminimalizowaniu czasu oczekiwania użytkownika i niepotrzebnego przetwarzania.

  • Przekazywanie pojedynczej interakcji: początkowe przekazywanie przechwytuje i stosuje metadane, dzięki czemu unikniesz pomocniczych aktualizacji ręcznych lub ponownego przetwarzania w tle.

  • Modalny, kontekstowy interfejs użytkownika: strona niestandardowa jest uruchamiana jako modalne okno dialogowe w aplikacji opartej na modelu. Takie podejście zmniejsza nawigację po stronie i poprawia postrzeganą szybkość reakcji.

  • Przetwarzanie asynchroniczne: Niekrytyczne akcje po przesłaniu, takie jak powiadomienia lub klasyfikacja, są obsługiwane asynchronicznie, zapewniając, że użytkownik nie jest blokowany.

  • Optymizowany transfer danych: Pliki są przesyłane bezpośrednio do SharePoint przy użyciu łączników natywnych, a nie tymczasowego przechowywania ich w usłudze Dataverse.

  • Scalable platform services: SharePoint i Power Automate automatycznie skalują się, aby obsługiwać różne ilości dokumentów bez ręcznego planowania pojemności.

Optymalizacja doświadczeń

Ta architektura zapewnia spójne, intuicyjne środowisko użytkownika.

  • Kontekstowe przesyłanie dokumentów: użytkownicy przesyłają dokumenty bezpośrednio z odpowiedniego rekordu biznesowego, dzięki czemu system automatycznie prawidłowo kojarzy dokumenty.

  • Nadzorowane przechwytywanie metadanych: strona niestandardowa wymusza wymagane metadane, zapewnia walidację i może dynamicznie dostosowywać pola na podstawie typu dokumentu lub kontekstu rekordu.

  • Mniejsze obciążenie poznawcze: interakcja modalna pozwala użytkownikom skoncentrować się na zadaniu bez przechodzenia z aplikacji opartej na modelu.

  • Spójność z interfejsem użytkownika Power Platform: Rozwiązanie korzysta z natywnych kontrolek i wzorców Power Apps, zapewniając dostępność, responsywność i łatwość użytkowania.

  • Natychmiastowa informacja zwrotna: użytkownicy otrzymują potwierdzenie, że dokumenty i metadane zostały pomyślnie zapisane, co zwiększa zaufanie do systemu.

Contributors

Microsoft utrzymuje ten artykuł. Następujący współautorzy napisali ten artykuł.

Główni autorzy: