Håndtering af proxysupport

Denne artikel beskriver, hvordan du kan aktivere proxy-understøttelse i din Power Query brugerdefinerede connector ved hjælp af Power Query SDK'en.

Windows proxy-indstillinger

Først skal du sætte proxy-indstillingerne op i Windows. Der er to måder at opsætte proxyen på, enten via Internet Options eller Network & internet-indstillingen.

Internetmuligheder

1. Fra Windows startmenu søger du efter og åbn Internetindstillinger.
2. Vælg fanen Forbindelser .
3. Vælg LAN-indstillinger.
4. I Proxy-serversektionen konfigureres proxyserveren.

Netværk og internet

1. Fra Windows startmenu skal du vælge Indstillinger-ikonet .
2. I Indstillinger vælger du Netværk & Internet (Windows 10), eller vælger ikonet Åben Navigation og derefter Netværk & internet (Windows 11).
3. Vælg Proxy.
4. Under afsnittet Manuel proxy-opsætning skal du slå knappen Brug en proxyserver (Windows 10) fra, eller vælge Opsætningsknappen og slå knappen Brug en proxyserver til (Windows 11).
5. Konfigurer adressen og porten.

Aktivering af proxy-understøttelse

En Web.DefaultProxy funktion er blevet tilføjet til udvidelsesmodulet. Tredjeparts M-connectorer kan bruge denne funktion til at hente webproxy-indstillingerne, der skal sættes i driver-egenskaberne (når proxyen er aktiveret som beskrevet i Windows proxy-indstillinger).

Proxy-informationen kan sættes i forbindelsesstrengen mod forbindelsesparameteren, som kan variere afhængigt af forbindelserne. Proxy-oplysninger (brugernavn og adgangskode) understøttes ikke. Web.DefaultProxy tager serverUri/host som parameter og returnerer en post, der indeholder proxy-URI'en, som ProxyUri feltet for en post. For at få de bestanddele af URI'en (for eksempel: skema, vært, port) inde i stikket, brug Uri.Parts.

Hvis proxyen ikke er konfigureret, Web.DefaultProxy returnerer den en tom post.

Eksempel på brug

Eksempel 1

For at bruge Web.DefaultProxy i connector-koden kan en boolesk type variabel bruges til at vælge ind eller fra denne funktionalitet. I dette eksempel kaldes i connector-koden, Web.DefaultProxy hvis den valgfrie booleanske parameter UseWebDefaultProxy sættes til sand (standard til falsk).

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

Når sat er UseWebDefaultProxy sand og ProxyUriRecord hentes, kan der oprettes en post til at sætte Proxy (konfigurationsparameteren understøttet af driveren, som kan variere) med ProxyUri feltet returneret af Web.DefaultProxy. Den kan hedde noget i retning af ProxyOptions. Denne post kan derefter tilføjes basen ConnectionStringog inkludere proxy-detaljerne sammen med den.

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

Eksempel 2

Hvis der er flere konfigurationsparametre, som driveren bruger til at indstille proxy-detaljer (som at værts- og portdetaljer håndteres separat), Uri.Parts kan de bruges.

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 [],
    ...