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 jest wymagana struktura tabel lub połączeń tak samo między środowiskami źródłowymi i docelowymi z pewnymi różnicami. 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 i przepływach kanw. Na przykład SharePoint parametry witryny i listy 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.
• Dostosowania i konfiguracje można pakować i zarządzać nimi w jednej lokalizacji.
• Wpisy tajne, takie jak poświadczenia używane przez różne składniki, należy pakować i transportować oddzielnie od składników, które ich 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 nie wymagają korzystania z nowych źródło 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 zarządzane za pośrednictwem nowoczesnego interfejsu lub dzięki użyciu kodu. 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 kanwa aplikacji, Power Automate przepływów, dodatków plug-in i dodawania Power BI pulpitów nawigacyjnych do aplikacji opartych na modelu. Jeśli w takich typach obiektów są używane zmienne środowiska, wartości są następnie uzyskiwane od zmiennych środowiska i można je zmieniać, gdy rozwiązania są importowane do innych środowisk.

Ręczne tworzenie zmiennej środowiskowej w rozwiązaniu

1. Zaloguj się do Power Apps (make.powerapps.com), a następnie w lewym okienku wybierz opcję Rozwiązania. 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 wyświetlana Wprowadź nazwę dla zmiennej środowiska.

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

   • Typ danych. Wybierz jedną z opcji Liczba dziesiętna, Tekst, JSON, Dwie opcje, Źródło danych lub Dane.

     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 zawarte w połączeniu, które są 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 użytkownik ma dostęp lub listy skojarzone z witryną.

     • Jeśli wybranym typem jest Wpis tajny, do ustawienia i skonfigurowania magazynu Azure Key Vault potrzebne są dodatkowe informacje umożliwiające usłudze Power Platform dostęp do tego wpisu tajnego.

   • Current Value. Również znane jako wartość. Ta właściwość jest opcjonalna i jest częścią tabeli wartości zmiennych środowiskowych. Gdy wartość jest obecna, będzie używana, nawet jeśli istnieje także wartość domyślna. 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 AppSource 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.

     

     Uwaga

     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 w Power Apps ustawieniach:

• 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 Dataverse. Zmienna środowiskowa nie jest potrzebna dla tabel w bieżącym środowisku. Po nawiązaniu połączenia Dataverse aplikacja automatycznie szuka dokładnie tej samej nazwy tabeli w każdym środowisku, w którym zostanie przeniesiona. 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 polecenia Zmień środowisko), założono Power Apps , że chcesz zawsze odwoływać się do dokładnie tej samej tabeli. Zmienna środowiskowa jest potrzebna, jeśli chcesz, aby ta tabela zewnętrzna była inną tabelą zewnętrzną podczas przechodzenia z dev do test lub do prod. Najprościej 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. W związku z tym, oprócz prawidłowego połączenia SharePoint, wymagana jest oddzielna zmienna środowiskowa dla witryny i listy.

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

• 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 wewnętrzne identyfikatory, które mogą nie pasować do różnych docelowych środowisk. 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 Microsoft Entra połączeń. 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 środowiska dla połączeń współużytkowanych, takich jak SQL Server z uwierzytelnianiem SQL. Użyj odwołań do połączeń, aby uzyskać informacje, które są tradycyjnie przekazywane jako część parametrów połączenia. Podstawowe SQL parametry uwierzytelniania są częścią parametrów połączenia. Na przykład podczas tworzenia połączenia są podane nazwy serwer i baza danych, które są zawsze pochodzących z połączenia.

Zmienne środowiskowe źródła danych są używane w przypadku łączników z uwierzytelnianiem, takim jak Microsoft Entra. W tego typu połączeniach Power Apps ma tylko zidentyfikowanego użytkownika. Power Apps nie jest w stanie wywnioskować, z którą usługą lub tabelą zamierzasz pracować 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 podczas wdrażania przy użyciu potoków. Zmienne środowiskowe bez wartości domyślnej lub wartości monitują o wartość, ale w przeciwnym razie są wstępnie wypełnione etykietą pod obszarem tekstowym oznaczającą źródło wartości: wartość rozwiązania, docelową wartość środowiskową lub wartość domyślną.

Uwaga

• 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. To przypomnienie, aby ustawić wartości, żeby składniki zależne od zmiennych środowiska nie zakończyły się niepowodzeniem.

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 dołączone do ról zabezpieczeń Twórca środowiska i Użytkownik podstawowy. 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 zmieniony, projektant wyświetla zarówno stary, jak i nowy token wyświetlanej nazwy, 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 tworzenia narzędzi Power Platform nie są jeszcze dostępne do zarządzania źródłem danych zmiennych środowiska. 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ązanie zarządzane, nie będziesz w stanie zobaczyć jej wartości, chyba że zajrzysz do Rozwiązania domyślnego. 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 źródła danych środowiska są takie same jak połączenia?

Nie Chociaż są powiązane połączeniami, reprezentuje poświadczenia lub uwierzytelnianie wymagane do współpracy z łącznikiem. Źródła danych — zmienne środowiska przechowują parametry wymagane przez jedną lub więcej akcji w łączniku i często różnią się w zależności od akcji. Na przykład połączenie z SharePoint Online nie zawiera ż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 Podczas używania łączników ALM Dataverse (czyli usługi Dynamics 365) nie jest wymagane używanie łączników najwyższej klasy. Jednym z nich jest użycie łącznika Dataverse do współpracy ze zmiennymi środowiska, tak 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 i przepływach kanw.

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 konfiguracji migracji, lepiej jest przystosować do migracji relacyjnych danych konfiguracyjnych 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. Na przykład, aby pobrać przyjazne nazwy dla list SharePoint powiązanych z pracownikiem witryny. 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 unikalny 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 źródła danych środowiska w aplikacjach kanw
Używanie zmiennych środowiska w przepływach Power Automate w chmurze
EnvironmentVariableDefinition table/entity reference
Próbki Web API
Używanie zmiennych środowiskowych źródła danych w aplikacjach opartych na kanwie
Używanie zmiennych środowiskowych w przepływach w chmurze rozwiązania Power Automate
Używanie wpisów tajnych usługi Azure Key Vault
Obsługa zmiennych środowiskowych w niestandardowych łącznikach
Power Apps Blog: Zmienne środowiskowe dostępne w wersji zapoznawczej!