Udostępnij za pośrednictwem

Używanie zmiennych środowiskowych w łącznikach niestandardowych, które wchodzą w skład rozwiązania

  • Artykuł

Aplikacje często wymagają różnych ustawień konfiguracyjnych lub parametrów wejściowych podczas wdrażania w różnych środowiskach. Zmienne środowiskowe przechowują klucze i wartości parametrów, które mogą następnie służyć jako dane wejściowe dla różnych innych obiektów aplikacji. Możesz również używać zmiennych środowiskowych w łącznikach niestandardowych rozwiązania w celu zaktualizowania kluczowych właściwości łącznika niestandardowego, takich jak Host, Base URL, Client ID, Client Secret, Login Url i Refresh Url. Szczegółowy samouczek można znaleźć w tym blogu.

Używanie zmiennej środowiskowej w łączniku niestandardowym

Podczas tworzenia lub aktualizowania łącznika niestandardowego do utworzenia lub zaktualizowania łącznika niestandardowego zostaną użyte wartości zmiennych środowiskowych. W czasie zapisywania łącznik niestandardowy używa wartości zmiennych środowiskowych. Podczas aktualizowania zmiennej środowiskowej należy ponownie zapisać łączniki niestandardowe, aby użyć zaktualizowanej wartości zmiennej środowiskowej.

  1. Zaloguj się w Power Apps lub Power Automate.

  2. Wybierz rozwiązanie z listy.

    or

    Jeśli w rozwiązaniu trzeba utworzyć nowy łącznik niestandardowy, przejdź do tematu Tworzenie łączników niestandardowych w rozwiązaniach.

  3. Z listy wybierz nowo utworzone lub istniejące rozwiązanie.

  4. Wybierz opcję Zmienne środowiskowe.

  5. Wybierz kolejno pozycje Nowy > Więcej > Zmienna środowiskowa.

  6. Wprowadź Nazwę zmiennej środowiskowej, która zawiera prefiks identyfikatora wydawcy. (Nie należy używać nazwy z pola Wyświetlana nazwa).

    W poniższym przykładzie jest używana opcja Adres URL witryny programu SharePoint. Możesz utworzyć inne wartości zmiennych środowiskowych dla innych ustawień, takich jak identyfikator klienta OAUTH, zasób i inne.

    Zrzut ekranu przedstawiający wartość zmiennej środowiskowej.

    Zmienne środowiskowe mogą używać następującej składni w polach łącznika niestandardowego:
    @environmentVariables("environmentVariableName")

    Przykład
    @environmentVariables("cr49f_SharePointSiteURL_7weem")

    Zrzut ekranu przedstawiający ekran Zmienne środowiskowe.

  7. (Opcjonalnie) Aby użyć wartości ze zmiennych środowiskowych w polach Host i Podstawowy adres URL, wykonaj następujące czynności:

    1. Wybierz kolejno pozycje Nowy > Automatyzacja > Łącznik niestandardowy.

      Zrzut ekranu menu nowego łącznika niestandardowego.

    2. Na karcie Ogólne wprowadź składnię zmiennej środowiskowej, aby odwoływać się do zmiennej środowiskowej.

      Zrzut ekranu przedstawiający kartę Ogólne.

  8. (Opcjonalnie) Aby użyć wartości ze zmiennych środowiskowych w dowolnych polach karty Zabezpieczenia, wykonaj następujące czynności:

    1. Wybierz kolejno pozycje Nowy > Automatyzacja > Łącznik niestandardowy.

    2. Na karcie Zabezpieczenia wprowadź składnię zmiennej środowiskowej, aby odwoływać się do zmiennej środowiskowej.

    Aby dowiedzieć się więcej, przejdź do tematu Określanie typu uwierzytelniania.

    Zrzut ekranu przedstawiający kartę Zabezpieczenia.

    Zmienne środowiskowe o typie danych Wpis tajny mogą być teraz używane w łącznikach niestandardowych. Musisz skonfigurować usługę Azure Key Vault, korzystając z przedstawionych tutaj kroków. W interfejsie użytkownika konfiguracji zabezpieczeń wartość jest zamaskowana. Konieczne będzie użycie następującej składni: @environmentVariables("environmentVariableName")

    Ważne

Zmienna środowiskowa utworzona dla klucza tajnego klienta w typie danych Tekst nie jest zabezpieczona. Te wartości nie są szyfrowane. Zaleca się użycie usługi Azure Key Vault.

  1. (Opcjonalnie) Na karcie Definicja dodaj wszystkie wymagane akcje, wyzwalacze lub zasady. Obecnie zmienne środowiskowe nie są obsługiwane w akcjach, wyzwalaczach ani zasadach.

Używanie nowych wartości zmiennych środowiskowych podczas importowania rozwiązań

Jeśli chcesz używać nowych wartości zmiennych środowiskowych podczas importowania rozwiązań, możesz usunąć wartość z rozwiązania przed wyeksportowaniem rozwiązania. Dzięki temu ta istniejąca wartość pozostanie w środowisku projektowym, ale nie zostanie wyeksportowana w rozwiązaniu. Ta metoda umożliwia tworzenie nowej wartości podczas importowania rozwiązania do innych środowisk.

Używanie nowych wartości dla zmiennych środowiskowych

  1. Wyeksportuj rozwiązanie. W tym kroku usuniesz wartość, jak wspomniano w poprzednim akapicie.

  2. Zaimportuj rozwiązanie do nowego środowiska.

    Podczas importowania rozwiązania nie zostanie wyświetlony monit o nowe wartości, jeśli zmienne środowiskowe mają już wartość domyślną lub jakąkolwiek ustawioną wartość. Zdarza się to, jeśli wartości są częścią rozwiązania lub są już obecne w środowisku docelowym.

    Aby dowiedzieć się więcej, przejdź do tematu Jak usunąć wartość ze zmiennej środowiskowej?.

Przekazywanie opinii

Jesteśmy wdzięczni za opinie na temat problemów z platformą łączników oraz pomysły na nowe funkcje. Aby przekazać opinię, przejdź na stronę Przesyłanie problemów lub uzyskiwanie pomocy dotyczącej łączników i wybierz typ opinii.