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 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 parametry witryny SharePoint i listy w trybie online mogą być przechowywane jako zmienne środowiska, co pozwala na łą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 środowiska mogą być tworzone i modyfikowane w obrębie nowoczesnego interfejsu rozwiązania, tworzone automatycznie podczas łączenia się z pewnymi źródłami danych w aplikacjach kanw lub przy użyciu kodu. Mogą być również importowane do środowiska za pośrednictwem rozwiązań. Gdy zmienne środowiskowe znajdą się w środowisku, można ich używać jako danych wejściowych podczas tworzenia aplikacji kanwy, przepływów Power Automate, tworzenia wtyczek i w wielu innych miejscach, takich jak dodawanie pulpitu nawigacyjnego Power BI do aplikacji opartej 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.

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.

     Uwaga

     • 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. Jednak połączenie nie jest przechowywane jako część zmiennej środowiska. 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ą. W przypadku pewnych parametrów, takich jak listy SharePoint, należy również wybrać nadrzędne zmienną źródło danych, taką jak witryna SharePoint. Po zapisaniu zostaną one powiązane z bazą danych.
     • 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. Jeśli jakaś wartość jest obecna, jest ona używana, nawet jeśli jest również 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ę.

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.

Począwszy od aktualizacji z 7 grudnia 2023 r., wszystkie wartości zmiennych środowiskowych są widoczne podczas importowania rozwiązań (lub podczas używania potoków do wdrażania). Zmienne środowiskowe bez wartości domyślnej zostaną poproszony o podanie wartości, ale w przeciwnym razie zostaną wstępnie wypełnione etykietą pod obszarem tekstowym oznaczającą źródło wartości: wartość rozwiązania, wartość środowiska docelowego lub wartość domyślna.

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.
• Aby pomyślnie używać zmiennych środowiskowych z list SharePoint, nazwa wyświetlana i nazwa logiczna każdej odpowiedniej kolumny w środowisku źródłowym i docelowym muszą być takie same.
• 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łanie konektora wymaga zarówno prawidłowego połączenia, jak i kilku dodatkowych parametrów.

Czy źródło danych środowiska może być używane z połączeniami współużytkowanymi, takimi jak SQL Server z uwierzytelnianiem SQL?

Raczej nie. Udostępnione połączenia z programem SQL Server przechowują parametry wymagane do łączenia się z danymi w ramach 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, które opierają się na uwierzytelnianiu użytkownika, np. Microsoft Entra ID, ponieważ parametrów nie można przejąć z połączenia. Z tych powodów w przypadku uwierzytelniania w programie SQL Server, które jest połączeniem współużytkowym, nie są źródło danych zmiennych środowiska.

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.

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 for Customer Engagement) 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 120 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 podczas importowania inna wartość połączenia jest inna niż ta, która ma być przypisana automatycznie?

W niektórych przypadkach, gdy dla jednej zmiennej środowiskowej (typu źródło danych) dostępnych jest wiele połączeń, to zgodnie z implementacją wybierane jest pierwsze połączenie na liście połączeń dostępnych dla danej zmiennej środowiskowej. 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
Tabela/odwołanie do encji EnvironmentVariableDefinition
Przykłady internetowego interfejsu API
Używanie źródła danych środowiska w aplikacjach kanwy
Używanie zmiennych środowiska w przepływach Power Automate w chmurze
Używanie wpisów tajnych usługi Azure Key Vault
Obsługa zmiennych środowiskowych w łącznikach niestandardowych
Power Apps Blog: zmienne środowiska dostępne w wersji zapoznawczej!