Web.Contents

Szintaxis

 
Web.Contents(url as text, optional options as nullable record) as binary

Névjegy

Bináris fájlként letöltött tartalmat ad url vissza. További tulajdonságok megadásához megadható egy opcionális rekordparaméter options. A rekord a következő mezőket tartalmazhatja:

• Query: Programozott módon adjon hozzá lekérdezési paramétereket az URL-címhez anélkül, hogy a meneküléssel kellene foglalkoznia.
• ApiKeyName: Ha a célhelyen van egy API-kulcs fogalma, ez a paraméter az URL-ben használandó kulcsparaméter nevét (nem az értékét) adhatja meg. A tényleges kulcsértéket a hitelesítő adatok adják meg.
• Headers: Ha rekordként adja meg ezt az értéket, további fejléceket fog megadni egy HTTP-kéréshez.
• Timeout: Ha ezt az értéket időtartamként adja meg, az megváltoztatja a HTTP-kérések időtúllépését. Az alapértelmezett érték 100 másodperc.
• ExcludedFromCacheKey: Ha ezt az értéket listaként adja meg, az kizárja, hogy ezek a HTTP-fejléckulcsok az adatok gyorsítótárazási számításának részei legyenek.
• IsRetry: Ha ezt a logikai értéket igaz értékként adja meg, az adatok beolvasásakor figyelmen kívül hagyja a gyorsítótárban lévő összes meglévő választ.
• ManualStatusHandling: Ha ezt az értéket listaként adja meg, az megakadályozza azoknak a HTTP-kéréseknek a beépített kezelését, amelyek válasza az alábbi állapotkódok egyikével rendelkezik.
• RelativePath: Ha ezt az értéket szövegként adja meg, a kérés előtt hozzáfűzi az alap URL-címhez.
• Content: Ennek az értéknek a megadása megváltoztatja a webes kérést a GET-ről a POST-ra, és a beállítás értékét használja a POST tartalmaként.

A HTTP-kérés get (ha nincs megadva tartalom) vagy POST (ha van tartalom). A POST-kérések csak névtelenül adhatók meg.

A HTTP-válasz fejlécei metaadatokként érhetők el a bináris eredményen. Az egyéni adatösszekötő-környezeten kívül csak a válaszfejlécek egy részhalmaza érhető el (biztonsági okokból).

1. példa

A beállítások és Query a beállítások használatának tartalmának lekérése."https://bing.com/search?q=Power+Query"RelativePath Ezekkel a beállításokkal dinamikusan kérdezhetők le statikus alap URL-címek.

Használat

let
    searchText = "Power Query"
in
    Web.Contents(
        "https://www.bing.com",
        [
            RelativePath = "search",
            Query = [q = searchText]
        ]
    )

Hozam

binary

2. példa

Hajtson végre egy POST-t egy URL-címen, adjon át egy bináris JSON hasznos adatokat, és elemezze a választ JSON-ként.

Használat

let
    url = ...,
    headers = [#"Content-Type" = "application/json"],
    postData = Json.FromValue([x = 235.7, y = 41.53]),
    response = Web.Contents(
        url,
        [
            Headers = headers,
            Content = postData
        ]
    ),
    jsonResponse = Json.Document(response)
in
    jsonResponse

Hozam

table

3. példa

Csatlakozás egy biztonságos URL-címre, amely a lekérdezési sztring részeként elfogad egy hitelesítési kulcsot. A titkos kulcs M-ben történő kemény kódolása helyett (amely biztonsági kockázatot jelentene), a kulcs biztonságosan biztosítható a neve (nem az értéke) megadásával az M-ben, a webes API-hitelesítés kiválasztásával, valamint a kulcs értékének a webes API-hitelesítő adatok részeként történő beírásával. Ha így használják, az alábbi példa létrehoz egy kérést a következőhöz "https://contoso.com/api/customers/get?api_key=******": .

Használat

Web.Contents("https://contoso.com/api/customers/get", [ApiKeyName="api_key"])

Hozam

binary

További információ

Állapotkód kezelése a Web.Contents használatával egyéni összekötőkben