Przegląd zmiennych środowiskowych dla Power Platform

Zmienne środowiskowe umożliwiają podstawowy scenariusz zarządzania cyklem życia aplikacji (ALM) w zakresie przenoszenia aplikacji między środowiskami Power Platform. W tym scenariuszu aplikacja pozostaje taka sama z wyjątkiem kilku kluczowych odwołań do aplikacji zewnętrznej (takich jak tabele, połączenia i klucze) różniących się między środowiskiem źródłowym a środowiskiem docelowym. W aplikacji wymagana jest struktura tabel lub połączeń, która musi być taka sama między środowiskami źródłowymi i docelowymi, ale może zawierać pewne różnice. Zmienne środowiskowe umożliwiają określenie, które z tych różnych odwołań zewnętrznych powinny być aktualizowane podczas przenoszenia aplikacji do środowisk.

Zmienne środowiska przechowują klucze parametrów i wartości, które następnie służą jako dane wejściowe dla różnych innych obiektów aplikacji. Dzielenie parametrów od obiektów zużywających dane pozwala na zmianę wartości w tym samym środowisku lub migrowanie rozwiązań do innych środowisk. Alternatywa to pozostawienie w składnikach, które z nich korzystają, wartości parametrów zakodowanych „na twardo”. To jest często trudne; szczególnie w sytuacji, gdy wartości trzeba zmieniać podczas operacji zarządzania cyklem życia aplikacji (ALM). Ponieważ zmienne środowiska są składnikami rozwiązania, można transportować odwołania (klucze) i zmieniać wartości podczas migracji rozwiązań do innych środowisk.

Korzyści wynikające z używania zmiennych środowiskowych:

• Podczas importowania rozwiązań do innych środowisk podaj nowe wartości parametrów.
• Przechowuj konfigurację źródeł danych używanych w aplikacjach kanwy i przepływach. Na przykład parametry witryny i listy SharePoint Online mogą być przechowywane jako zmienne środowiskowe. Takie podejście umożliwia łączenie się z różnymi witrynami i listami w różnych środowiskach bez konieczności modyfikowania aplikacji i przepływów.
• Pakuj i transportuj swoje dostosowania oraz konfiguracje razem i zarządzaj nimi w jednym miejscu.
• Sekrety, takie jak poświadczenia używane przez różne komponenty, należy pakować i transportować oddzielnie od komponentów, które je używają.
• Jedna zmienna środowiska może być używana w wielu różnych składnikach rozwiązania — bez względu na to, czy jest to ten sam typ składnika, czy też inny. Na przykład aplikacja kanwy i przepływ mogą używać tej samej zmiennej środowiska. Jeśli wartość zmiennej środowiska musi ulec zmianie, wystarczy tylko zmienić jedną wartość.
• Dodatkowo, jeśli chcesz wycofać źródło danych w środowiskach produkcyjnych, możesz zaktualizować wartości zmiennych środowiskowych o informacje dotyczące nowego źródło danych. Aplikacje i przepływy nie wymagają modyfikacji i zaczynają korzystać z nowego źródła danych.
• Obsługiwane przez narzędzia SolutionPackager i DevOps umożliwiają ciągłą integrację i ciągłą wysyłkę (CI/CD).
• Zmienne środowiska mogą być rozpakowane i przechowywane w kontrolce źródłowej. Można także przechowywać różne pliki wartości zmiennych środowiskowych dla oddzielnej konfiguracji potrzebnej w różnych środowiskach. Solution Packager może następnie zaakceptować plik odpowiadający środowisku, do którym jest importowane rozwiązanie.

Jak działają zmienne środowiskowe?

Zmienne środowiskowe mogą być tworzone i modyfikowane za pomocą nowoczesnego interfejsu rozwiązania. Mogą być również tworzone automatycznie podczas nawiązywania połączenia z określonymi źródłami danych w aplikacjach kanwa lub za pomocą kodu. Mogą być również importowane do środowiska za pośrednictwem rozwiązań. Zmienne środowiskowe mogą być używane jako dane wejściowe podczas tworzenia aplikacji kanwy, Power Automate przepływów, wtyczek i dodawania Power BI pulpitów nawigacyjnych do aplikacji opartych na modelu. Kiedy używasz zmiennych środowiskowych, wartości są pobierane z tych zmiennych i można je zmieniać przy imporcie rozwiązań do innych środowisk.

Ręczne tworzenie zmiennej środowiskowej w rozwiązaniu

1. Zaloguj się do Power Apps (make.powerapps.com), a następnie w okienku po lewej stronie wybierz pozycję Solutions. Jeśli elementu nie ma w okienku panelu bocznego, wybierz …Więcej, a następnie wybierz żądany element.
2. Otwórz poszukiwane rozwiązanie lub utwórz nowe rozwiązanie.
3. Na pasku pleceń wybierz opcję Nowe>Więcej, a następnie wybierz opcję Zmienna środowiskowa.
4. W prawym okienku wykonaj następujące kolumny, a następnie wybierz opcję Zapisz:

   • nazwa do wyświetlenia. Wprowadź nazwę dla zmiennej środowiska.

   • Name. Unikatowa nazwa jest generowana automatycznie z Nazwy wyświetlanej, ale można ją zmienić.

   • Typ danych. Wybierz spośród Liczba dziesiętna, Tekst, JSON, Dwie opcje, Źródło danych lub Sekret.

     Notatka

     • Jeśli źródło danych jest wybranym typem, należy również wybrać łącznik, prawidłowe połączenie dla wybranego łącznika i typ parametru. Połączenie nie jest przechowywane jako część zmiennej środowiskowej. Zmienna środowiskowa przechowuje informacje, które są niezależne od połączenia, ale niezbędne do połączenia Power Apps z odpowiednim serwerem i tabelą. Połączenie jest używane tylko do pobierania dostępnych wartości parametrów, takich jak witryny SharePoint, do których masz dostęp, lub listy skojarzone z witryną.
     • Jeśli Secret jest wybranym typem, potrzebne są dodatkowe informacje dotyczące wprowadzenia i konfigurowania Azure Key Vault, aby umożliwić platformie Power Platform dostęp do sekretu.

   • Bieżąca wartość. Również znane jako wartość. Ta właściwość jest opcjonalna i jest częścią tabeli wartości zmiennych środowiskowych. Nawet jeśli istnieje wartość domyślna, używana jest zdefiniowana wartość. Jeśli nie chcesz korzystać z tej wartości w następnym środowisku, usuń ją z rozwiązania. Te wartości są też rozdzielane na oddzielne pliki JSON w wyeksportowanym pliku solution.zip i można je edytować w trybie offline. Więcej informacji: Jak usunąć wartość ze zmiennej środowiska?

   • Wartość domyślna. Ta kolumna jest częścią tabeli definicji zmiennych środowiskowych i nie jest wymagana. Wartość domyślna jest używana w przypadku, gdy nie ma bieżącej wartości.

     Oddzielenie wartości domyślnej i wartości bieżącej umożliwia obsługę definicji i wartości domyślnej niezależnie od wartości. Na przykład wydawca aplikacji może umieścić swoją ofertę na Marketplace z wartością domyślną. Następnie klient może podać nową wartość. Gdy wydawca aplikacji publikuje aktualizacje aplikacji, wartość ustawiona przez klienta nie jest zastępowana.

     

     Notatka

     Wartość nie może istnieć bez definicji. Interfejs umożliwia tylko tworzenie jednej wartości na każdą definicję.

Power Apps może automatycznie tworzyć zmienne środowiskowe

Na karcie Ogólne ustawień Power Apps:

• Włącz opcję Automatycznie twórz zmienne środowiskowe podczas dodawania źródeł danych. Teraz, gdy dodasz nowe źródło danych do aplikacji, zostanie dodana zmienna środowiskowa.

  

Różne źródła danych

Różne źródła danych umożliwiają korzystanie z różnych typów zmiennych środowiskowych.

Microsoft Dataverse

Power Apps łączy się natywnie z usługą Dataverse. Zmienna środowiskowa nie jest potrzebna dla tabel w bieżącym środowisku. Po nawiązaniu połączenia z Dataverse, aplikacja automatycznie szuka dokładnie tej samej nazwy tabeli w każdym środowisku, do którego ją przeniesiesz. Tak długo, jak struktura nazw tabel jest taka sama w środowisku docelowym, jak w środowisku oryginalnym, działa.

Jeśli używasz tabeli zewnętrznej z innego środowiska (za pośrednictwem funkcji Zmień środowisko), Power Apps zakłada, że zawsze chcesz odwoływać się do dokładnie tej samej tabeli. Potrzebujesz zmiennej środowiskowej, jeśli ta tabela zewnętrzna ma być inną tabelą zewnętrzną podczas przechodzenia od dewelopera do testowania lub do wersji prod. Najłatwiej jest zezwolić Power Apps na automatyczne tworzenie zmiennej środowiskowej. (Jeśli tabela została wcześniej dodana do aplikacji, włącz przełącznik ustawień, upuść tabelę zewnętrzną, a następnie dodaj ją ponownie).

Po dodaniu tabeli zewnętrznej do aplikacji wybierz kartę Zaawansowane, aby wybrać zmienną środowiskową.

SharePoint

SharePoint obsługuje tylko połączenia Microsoft Entra. Dlatego w przypadku SharePoint oprócz prawidłowego połączenia wymagana jest oddzielna zmienna środowiskowa dla witryny i listy.

Aby pomyślnie użyć zmiennych środowiskowych z listami SharePoint:

• Nazwa wyświetlana i nazwa logiczna dla każdej odpowiedniej kolumny w środowisku źródłowym i docelowym muszą być zgodne.
• Zmienne środowiskowe dla SharePoint muszą mieć pasujące metadane. SharePoint ma identyfikatory wewnętrzne, które mogą nie być zgodne między środowiskami docelowymi. Jeśli na przykład utworzysz listę o tej samej nazwie i kolumnach w środowisku docelowym, nazwy wewnętrzne nie będą zgodne. Metadane są zawsze zgodne, jeśli zduplikujesz witrynę SharePoint i skopiujesz ją do środowiska docelowego.

SQL Server

SQL Server obsługuje wiele różnych typów uwierzytelniania i połączeń. Użyj zmiennych środowiskowych dla połączeń Microsoft Entra. Oddzielna zmienna środowiskowa jest wymagana dla serwera i bazy danych. Aplikacja jest powiązana z określonymi nazwami tabel, więc zakłada się, że są one takie same w różnych środowiskach.

Nie używaj zmiennych środowiskowych dla połączeń udostępnionych, takich jak podstawowe uwierzytelnianie SQL z SQL Server. Użyj odwołań do połączeń, aby uzyskać informacje, które są tradycyjnie przekazywane w ramach ciągu połączenia. Podstawowe parametry uwierzytelniania SQL są częścią connection string. Na przykład podczas tworzenia połączenia są podane nazwy serwera i bazy danych, które zawsze pochodzą z połączenia.

Zmienne środowiskowe dla źródła danych są używane w łącznikach z uwierzytelnianiem, takich jak Microsoft Entra. W przypadku tych typów połączeń Power Apps ma tylko zidentyfikowanego użytkownika. Power Apps nie może ustalić, z jakiej usługi lub tabeli zamierzasz korzystać na podstawie połączenia.

Wprowadź nowe wartości podczas importowania rozwiązań

Interfejs importu nowoczesnych rozwiązań zawiera możliwość wprowadzania wartości zmiennych środowiskowych. Spowoduje to ustawienie właściwości wartości w tabeli environmentvariablevalue.

Wartości zmiennych środowiskowych są widoczne podczas importowania rozwiązań lub przy wdrażaniu przy użyciu Potoków. Zmienne środowiskowe, które nie mają wartości domyślnej, wyświetlają żądanie o wartość, ale w innych przypadkach są automatycznie uzupełniane etykietą pod obszarem tekstowym, wskazującą źródło wartości: wartość rozwiązania, wartość środowiska docelowego lub wartość domyślną.

Notatka

• W niektórych przypadkach w przypadku określonych wartości zmiennych środowiskowych źródła danych może zostać wyświetlone ostrzeżenie o odmowie dostępu, jeśli twórca importu nie ma dostępu do połączenia lub źródła używanego dla zmiennej środowiskowej. Jest to ostrzeżenie nieblokujące, ale należy zwrócić uwagę w zależności od tego, jak planujesz używać zmiennej środowiskowej w środowisku docelowym.
• Możesz usunąć tę wartość z rozwiązania przed wyeksportowaniem rozwiązania. Dzięki temu istniejąca wartość pozostanie w środowisku developmentu, ale nie zostanie wyeksportowana w rozwiązaniu. Ta metoda umożliwia tworzenie nowej wartości podczas importowania rozwiązania do innych środowisk. Więcej informacji: Jak usunąć wartość ze zmiennej środowiska?

Powiadomienia

Powiadomienie jest wyświetlane, kiedy zmienne środowiskowe nie zawierają żadnych wartości. Ustaw wartości, żeby składniki zależne od zmiennych środowiska nie zawiodły.

Zabezpieczenia

Właścicielem tabeli environmentvariabledefinition jest użytkownik lub zespół. Podczas tworzenia aplikacji, która używa zmiennych środowiskowych, należy przypisać użytkownikom odpowiedni poziom uprawnień do tej tabeli. Uprawnienie do tabeli environmentvariablevalue dziedziczy się po tabeli nadrzędnej environmentvariabledefinition i dlatego nie wymaga osobnych uprawnień. Uprawnienia do tabel environmentvariabledefinition są domyślnie przypisane do ról zabezpieczeń: Twórcy środowiska i Podstawowego użytkownika. Więcej informacji: Zabezpieczenia w Dataverse.

Nazewnictwo

Upewnij się, że nazwy zmiennych w środowisku są unikatowe, aby można było się do nich dokładnie odwoływać. Zduplikowane nazwy wyświetlane zmiennych środowiska utrudniają rozróżnianie i używanie zmiennych środowiska. Upewnij się, że nazwy zmiennych w środowisku są unikatowe, aby można było się do nich dokładnie odwoływać. Nazwy $authentication i $connection są specjalnie zarezerwowanymi parametrami dla przepływów i należy ich unikać. Zapisywanie przepływu jest blokowane, jeśli używane są zmienne środowiskowe o tych nazwach. Jeśli w przepływie używana jest zmienna środowiskowa i wyświetlana nazwa zmiennej środowiskowej zostanie zmieniona, projektant wyświetla zarówno stare, jak i nowe tokeny nazw wyświetlanych, aby pomóc w identyfikacji. Podczas aktualizowania przepływu zalecamy Ci usunięcie odniesienia do zmiennej środowiskowej i dodanie go ponownie.

Bieżące ograniczenia

• Sprawdzanie poprawności wartości zmiennych środowiska odbywa się w obrębie interfejsów użytkownika i składników, które z nich korzystają, ale nie w ramach Dataverse. Dlatego należy upewnić się, że odpowiednie wartości zostały ustawione w przypadku ich modyfikacji w kodzie.
• Zadania narzędzi budowania Power Platform nie są jeszcze dostępne do zarządzania zmiennymi środowiskowymi źródła danych. Nie powoduje to jednak blokowania ich używania w ramach narzędzi firmy Microsoft oraz w systemach kontroli źródłowej.
• Interakcja ze zmiennymi środowiskowymi za pomocą niestandardowego kodu wymaga wywołania interfejsu API w celu pobrania wartości; nie ma pamięci podręcznej udostępnionej do wykorzystania przez kod inny niż kod Microsoft.
• Zmienne środowiskowe mogą mieć maksymalnie 2000 znaków.

Często zadawane pytania

Dlaczego nie widzę wartości mojej zmiennej środowiskowej?

Jeśli zmienna środowiskowa znajduje się w rozwiązaniu zarządzanym, nie będziesz w stanie zobaczyć jej wartości, chyba że sprawdzisz w Rozwiązaniu domyślnym. To zachowanie jest zgodne z projektem, ponieważ wartość zmiennej środowiskowej jest dostosowaniem niezarządzanym.

Jak wyświetlić miejsce, w którym są używane zmienne środowiska?

Wybranie opcji Pokaż zależności w interfejsie rozwiązania podczas tworzenia składników albo w kontrolce źródłowej i w pliku rozwiązania pozwala wyświetlić aplikację lub metadane przepływu.

Czy zmienne środowiskowe źródeł danych są takie same jak połączenia?

Nie Chociaż są ze sobą powiązane, połączenie reprezentuje poświadczenie lub uwierzytelnienie wymagane do interakcji z łącznikiem. Zmienne środowiskowe źródeł danych przechowują parametry wymagane przez jedną lub więcej akcji w łączniku, a te parametry często różnią się w zależności od akcji. Na przykład połączenie SharePoint Online nie przechowuje żadnych informacji o witrynach, listach ani bibliotekach dokumentów. Dlatego wywoływanie łącznika wymaga zarówno prawidłowego połączenia, jak i pewnych dodatkowych parametrów.

Czy w przypadku zautomatyzowanego potoku ALM w różnych środowiskach mogą być przetwarzane różne wartości?

Tak. Pakiet plików rozwiązania akceptuje nazwę pliku jako parametry wejściowe, dzięki czemu potok może pakować do rozwiązania różne wartości, w zależności od typu środowiska, w którym jest wykonywane.

Czy powinienem uwzględnić tę wartość w moim rozwiązaniu?

Nie Zmienne środowiskowe są przeznaczone do użytku przez aplikacje, które muszą mieć różne wartości w różnych środowiskach, w których rozwiązanie jest wdrażane. Definicje zmiennych środowiskowych powinny być zawarte w rozwiązaniu, ale wartości powinny być dostarczone dla środowiska docelowego podczas wdrażania. Takie zachowanie powoduje, że definicja zmiennej środowiskowej jest zarządzanym obiektem rozwiązania w środowisku docelowym, podczas gdy zmienna środowiskowa jest niezarządzanym rekordem.

Dlaczego nie mogę usunąć wartości w moim środowisku?

Jeśli wartość została uwzględniona w rozwiązaniu zarządzanym, jedynym sposobem na jej usunięcie jest aktualizacja rozwiązania w środowisku źródłowym w celu wykluczenia wartości, a następnie wyeksportowanie nowej wersji rozwiązania. Ta nowa wersja może następnie zostać zaimportowana do środowiska przy użyciu operacji uaktualnienia (nie aktualizacji), co spowoduje usunięcie rekordu wartości.

Co zrobić, jeśli ktoś przypadkowo usunie wartość?

Jeśli nie uniemożliwia tego system zależności, środowisko wykonawcze używa ostatniej znanej wartości jako rezerwy.

Jeśli wartość zostanie zmieniona, kiedy nowa wartość zostanie użyta w aplikacjach kanw i przepływach w chmurze?

Pełne opublikowanie zaktualizowanych zmiennych środowiskowych może zająć nawet godzinę, ponieważ wartość jest asynchronicznie wypychana do aplikacji i przepływów.

Czy są wymagane licencje premium?

Nie Chociaż ALM wymaga Dataverse (lub aplikacji Dynamics 365), korzystanie z łączników Premium nie jest wymagane. Jednym z zastrzeżeń jest użycie łącznika Dataverse do interakcji ze zmiennymi środowiska, podobnie jak w przypadku innych rekordów danych, takich jak konta czy kontakty. Wcześniej był to jedyny sposób na używanie zmiennych środowiska w aplikacjach typu Canvas i przepływach zadań.

Czy w usłudze istnieje ograniczenie liczby zmiennych środowiskowych, które można utworzyć?

Nie Jednak maksymalny rozmiar rozwiązania to 95 MB. Więcej informacji: Tworzenie rozwiązania

Czy nazwy wyświetlane i opisy zmiennych środowiska mogą być zlokalizowane?

Tak.

Czy zamiast przechowywać dane konfiguracji w tabelach niestandardowych należy użyć zmiennych środowiska?

Tak, jeśli dane konfiguracji nie są relacyjne. Zmienne środowiska powinny być używane w przypadku kluczy: par wartości i sytuacji, w których prawdopodobnie powinna się różnić w innych środowiskach. Inne narzędzia, takie jak narzędzie do migracji konfiguracji, są lepiej przystosowane do migracji danych konfiguracyjnych relacyjnych przechowywanych w tabelach niestandardowych. W przeciwieństwie do innych danych konfiguracyjnych zmienne środowiska są migrowane w ramach rozwiązań, przez co można nimi zarządzać w o wiele prostszy sposób i lepiej importować.

Dlaczego moje połączenie nie jest zapisywane dla zmiennych środowiskowych źródła danych?

Połączenia są używane tylko do generowania interfejsu użytkownika. Aby na przykład pobrać przyjazne nazwy list SharePoint powiązanych z witryną. Podczas edycji zmiennej środowiskowej źródła danych należy wybrać połączenie z dostępem do źródła danych. Jeśli nie masz już dostępu do połączenia, możesz ręcznie wprowadzić wartość. Na przykład wprowadź adres URL witryny SharePoint lub unikatowy identyfikator (GUID) dla listy.

Gdy istnieje wiele połączeń dostępnych dla pojedynczej zmiennej środowiskowej (typu źródła danych), istnieje implementacja zaprojektowana w celu wybrania pierwszego połączenia z listy połączeń. Ponieważ występuje zwykle tylko jedno połączenie skojarzone ze zmienną środowiskową, nie jest to element, który zwykle należy weryfikować. Co więcej, dzięki ostatnim zmianom wartości zmiennej środowiskowej łatwiej sprawdzić poprawność importu.

Jak usunąć wartość ze zmiennej środowiska?

Możesz chcieć usunąć wartość zmiennej środowiskowej ze swojego rozwiązania przed jego wyeksportowaniem. Następnie istniejąca wartość pozostanie w środowisku programistycznym, ale nie zostanie wyeksportowana do rozwiązania. Takie podejście pozwala na dostarczenie nowej wartości podczas importu rozwiązania do innego środowiska.

Aby usunąć wartość, wykonaj następujące czynności:

1. W rozwiązaniu, w którym znajduje się zmienna środowiskowa, wybierz zmienną środowiskową, aby wyświetlić jej właściwości.

2. W obszarze Bieżąca wartość wybierz ...>Usuń z tego rozwiązania.

   

Czy mogę używać zmiennych środowiskowych w łącznikach niestandardowych?

Tak. Obsługa zmiennych środowiskowych w łącznikach niestandardowych

Zobacz też

Używanie zmiennych środowiskowych dla źródeł danych w aplikacjach canvas
Użyj zmienne środowiskowe w przepływach chmury rozwiązania Power Automate
Odniesienie do tabeli/obiektu EnvironmentVariableDefinition
Przykłady Web API
Użyj zmiennych środowiskowych źródła danych w aplikacjach kanwy
Użyj zmiennych środowiskowych w przepływach w chmurze rozwiązania Power Automate
Użyj tajemnic Azure Key Vault
Obsługa zmiennych środowiskowych w łącznikach niestandardowych
Power Apps Blog: zmienne środowiskowe dostępne w wersji zapoznawczej!