Obsługa obsługi serwera proxy

W tym artykule opisano sposób włączania obsługi serwera proxy w łączniku niestandardowym dodatku Power Query przy użyciu zestawu POWER Query SDK.

Ustawienia serwera proxy systemu Windows

Najpierw należy skonfigurować ustawienia serwera proxy w systemie Windows. Istnieją dwa sposoby konfigurowania serwera proxy za pośrednictwem opcji internetowych lub ustawienia Sieć i Internet.

Opcje internetowe

1. W menu Start systemu Windows wyszukaj i otwórz opcje internetowe.
2. Wybierz kartę Połączenie ions.
3. Wybierz pozycję Ustawienia sieci LAN.
4. W sekcji Serwer proxy skonfiguruj serwer proxy.

Sieć i Internet

1. Z menu Start systemu Windows wybierz ikonę Ustawienia.
2. W Ustawienia wybierz pozycję Sieć i Internet (Windows 10) lub wybierz ikonę Otwórz nawigację, a następnie wybierz pozycję Sieć i Internet (Windows 11).
3. Wybierz pozycję Serwer proxy.
4. W sekcji Ręczne konfigurowanie serwera proxy przełącz przycisk Użyj serwera proxy (Windows 10) lub wybierz przycisk Skonfiguruj i przełącz przycisk Użyj serwera proxy (Windows 11).
5. Skonfiguruj adres i port.

Włączanie obsługi serwera proxy

Funkcja Web.DefaultProxy została dodana do modułu rozszerzalności. Łączniki M innych firm mogą używać tej funkcji do pobierania ustawień internetowego serwera proxy, które mają być ustawiane we właściwościach sterownika (gdy serwer proxy jest włączony zgodnie z opisem w ustawieniach serwera proxy systemu Windows).

Informacje o serwerze proxy można ustawić w parametry połączenia względem parametru połączenia, który może różnić się od łączników. Poświadczenia serwera proxy (nazwa użytkownika i hasło) nie są obsługiwane. Web.DefaultProxy przyjmuje identyfikator serverUri/host jako parametr i zwraca rekord zawierający identyfikator URI serwera proxy jako ProxyUri pole rekordu. Aby uzyskać części składowe identyfikatora URI (na przykład schemat, host, port) wewnątrz łącznika, użyj polecenia Uri.Parts.

Jeśli serwer proxy nie jest skonfigurowany, Web.DefaultProxy zwraca pusty rekord.

Przykładowe użycie

Przykład 1

Aby użyć Web.DefaultProxy w kodzie łącznika, zmienna typu logicznego może służyć do rezygnacji z tej funkcji lub korzystania z niej. W tym przykładzie jest wywoływany w kodzie łącznika, Web.DefaultProxy jeśli opcjonalny parametr UseWebDefaultProxy logiczny ma wartość true (domyślnie ma wartość false).

UseWebDefaultProxyOption = options[UseWebDefaultProxy]?,
ProxyUriRecord = if UseWebDefaultProxyOption then Web.DefaultProxy(Host) else null,
ProxyOptions = if Record.FieldCount(ProxyUriRecord) > 0 then
      [
            Proxy = ProxyUriRecord[ProxyUri]
      ]
      else [],
      ...

Po ustawieniu UseWebDefaultProxy wartości true i ProxyUriRecord pobraniu rekordu można utworzyć w celu ustawienia parametru Proxy (parametr konfiguracji obsługiwany przez sterownik, który może się różnić) ProxyUri przy użyciu pola zwróconego przez Web.DefaultProxy. Może mieć nazwę podobną do ProxyOptions. Ten rekord można następnie dołączyć do bazy ConnectionStringi dołączyć do niego szczegóły serwera proxy.

Databases = Odbc.DataSource(ConnectionString & ProxyOptions, Options)

Przykład 2

Jeśli sterownik używa wielu parametrów konfiguracji do ustawiania szczegółów serwera proxy (takich jak obsługiwane oddzielnie szczegóły hosta i portu), Uri.Parts może być używany.

UseWebDefaultProxyOption = options[UseWebDefaultProxy]?,
ProxyRecord = if UseWebDefaultProxyOption then Web.DefaultProxy(Host) else null,
UriRecord = if ProxyRecord <> null then Uri.Parts(ProxyRecord) else null,
ProxyOptions = if UriRecord <> null then
    [
        ProxyHost = UriRecord[Scheme] & "://" & UriRecord[Host],
        ProxyPort = UriRecord[Port]
    ]
    else [],
    ...