Używanie zmiennych środowiskowych źródła danych w aplikacjach kanwy

W tym artykule dowiesz się więcej o korzystaniu ze zmiennych środowiskowych źródła danych w aplikacjach kanwy. Możesz albo użyć wcześniej istniejących zmiennych środowiskowych źródła danych, albo utworzyć zmienne środowiskowe źródła danych automatycznie podczas łączenia z danymi.

Używanie istniejących zmiennych środowiskowych źródła danych

Zmienne środowiskowe można używać ponownie w różnych aplikacjach, a nawet w różnych typach zasobów, takich jak przepływy w chmurze. Możesz najpierw utworzyć je w ramach rozwiązania, a później użyć ich podczas tworzenia aplikacji kanwowych i przepływów w chmurze. W poniższych krokach jako przykład użyto SharePoint Online.

  1. Wykonaj powyższe kroki, aby ręcznie utworzyć zmienną środowiskową w rozwiązaniu.
  2. Edytuj lub utwórz aplikację kanwy z rozwiązania.
  3. Dodaj nowe źródło danych dla SharePoint Online.
  4. Wybierz kartę Zaawansowane. Zostanie wyświetlona filtrowana lista dostępnych zmiennych środowiskowych, do których masz dostęp i które odpowiadają ustawianemu parametrowi. Na przykład po wybraniu witryny SharePoint lista zawiera zmienne środowiskowe źródła danych z łącznikiem jako SharePoint i typ parametru jako witryna. To samo dzieje się podczas wybierania list SharePoint dla danej witryny. Jeśli istniejąca zmienna nie jest wyświetlana, zobacz Ograniczenia i rozwiązywanie problemów.
  5. Wybierz żądane zmienne środowiska, a następnie wybierz opcję Połącz.

Ważne

  • Jeśli zostanie wybrana zmienna środowiska innego rozwiązania, w rozwiązaniu zawierającym zmienną środowiska będzie istnieć zależność. W związku z tym należy pamiętać o następujących elementach:
    • Dodaj zmienną środowiska do bieżącego rozwiązania przed wyeksportowania.
    • Upewnij się, że rozwiązanie zawierające zmienną środowiskową zostanie zaimportowane do środowiska docelowego przed zaimportowaniem bieżącego rozwiązania.

Automatycznie twórz zmienne środowiskowe źródeł danych podczas ich łączenia z danymi

Ta opcja zapewnia prostotę i zapewnia, że zmienne środowiskowe są zawsze używane dla źródeł danych, takich jak SharePoint Online. Jednak niektórzy klienci chcą podać własne nazwy schematów i dlatego powinni je utworzyć z rozwiązań.

Notatka

Wstępnie istniejące aplikacje kanwy nie używają automatycznie źródła danych zmiennych środowiskowych. Usuń źródło danych aplikacji i dodaj je z powrotem, używając powyższych kroków w celu uaktualnienia tych aplikacji, aby używały zmiennych środowiska.

  1. Edytuj lub utwórz aplikację kanwy z rozwiązania.

  2. Wybierz opcję Ustawienia>Ogólne i włącz ustawienie Automatycznie twórz zmienne środowiskowe podczas dodawania źródeł danych.

  3. Dodaj nowe źródło danych do SharePoint Online.

  4. Wybierz witrynę, jedną lub więcej list programu SharePoint, a następnie pozycję Połącz.

    Notatka

    Aby zapobiec tworzeniu zduplikowanych zmiennych środowiskowych, podczas identyfikowania duplikatów zostanie wyświetlony monit o użycie istniejącej zmiennej środowiskowej. Użytkownik może wyczyścić opcję używania istniejącej zmiennej środowiska w przypadku potrzeby utworzenia duplikatu.

  5. Wybierz pozycję Zapisz.

Ograniczenia i rozwiązywanie problemów

Zmienna środowiskowa może istnieć w środowisku bez wyświetlania w selektorze źródła danych programu Canvas Studio. Sprawdź następujące ograniczenia, gdy nie można znaleźć zmiennej.

Ograniczenia selektora Canvas Studio

To ograniczenie dotyczy wybierania zmiennych środowiskowych źródła danych dla obsługiwanych łączników, w tym SharePoint i SQL Server. W przypadku SQL Server dotyczy typów połączeń, które obsługują zmienne środowiskowe źródła danych, takie jak połączenia Microsoft Entra.

Selektor źródła danych programu Canvas Studio pobiera tylko pierwszą stronę definicji zmiennych środowiskowych i wartości pasujących do wybranego łącznika i typu parametru. Nie pobiera kolejnych stron. Każde żądanie dataverse zwraca do 5000 pasujących rekordów, więc niektóre zmienne mogą nie być wyświetlane na karcie Zaawansowane lub w wynikach wyszukiwania. Wyszukiwanie brakującej zmiennej nie znajduje jej na późniejszej stronie.

To ograniczenie dotyczy selektora, a nie limitu 5000 zmiennych środowiskowych w usłudze Dataverse. Odpowiednia liczba to liczba pasujących definicji lub wartości dla każdego żądania, a nie całkowita liczba zmiennych we wszystkich łącznikach w środowisku.

Aby wyeliminować to ograniczenie, użyj ponownie istniejących zmiennych i usuń przestarzałe zmienne po sprawdzeniu ich zależności. Nie usuwaj zmiennych, których nadal używają aplikacje lub przepływy. Jeśli nie możesz zmniejszyć liczby zmiennych, rozważ mniejsze środowisko zawierające potrzebne zmienne i aplikacje. Przenoszenie zmiennych do różnych rozwiązań w tym samym środowisku nie zmniejsza liczby zmiennych w tym środowisku.

kontrole konfiguracji specyficzne dla programu SharePoint

Oprócz ograniczenia stronicowania, które ma zastosowanie w obsługiwanych łącznikach, zmienne programu SharePoint muszą spełniać następujące wymagania dotyczące konfiguracji:

  • Zmienna witryny wymaga niepustej wartości bieżącej lub wartości domyślnej zawierającej adres URL witryny SharePoint. Selektor nie wyświetla zmiennych witryny na liście, gdy obie wartości są puste.
  • Wartość zmiennej listy musi być zgodna z unikatowym identyfikatorem (GUID) listy zwróconej dla wybranej witryny i połączenia, a nie nazwą wyświetlaną listy. Sprawdź, czy połączenie ma dostęp do listy i czy zmienna zawiera jej identyfikator.

Zobacz też

Utwórz aplikację kanwy od podstaw za pomocą Dataverse.
Używanie zmiennych środowiskowych w przepływach w chmurze rozwiązania Power Automate
Przegląd zmiennych środowiskowych

  • Ostatnia aktualizacja o