Web

  • Articolo

Riepilogo

Articolo Descrizione
Stato di rilascio Disponibilità generale
Prodotti Excel
Power BI (modelli semantici)
Power BI (flussi di dati)
Infrastruttura (Dataflow Gen2)
Power Apps (flussi di dati)
Dynamics 365 per Customer Insights
Tipi di autenticazione supportati Web.Contents:
Anonimo
Windows
Di base
API Web
Account dell'organizzazione
Entità servizio

Web.BrowserContents:
Anonimo
Windows
Di base
API Web

Web.Page:
Anonimo
Windows (solo credenziali dell'utente corrente)
API Web
Documentazione di riferimento sulle funzioni Web.Contents
Web.BrowserContents
Web.Page

Nota

Il tipo di autenticazione dell'entità servizio non è supportato quando si usa un gateway dati locale o un gateway dati di rete virtuale.

Nota

Le richieste POST possono essere effettuate in modo anonimo solo quando si usa Web.Contents.

Nota

Alcune funzionalità possono essere presenti in un prodotto, ma non altre a causa di pianificazioni di distribuzione e funzionalità specifiche dell'host.

Prerequisiti

  • Web.Page richiede Internet Explorer 10.
  • Web.BrowserContents richiede il runtime WebView2 di Microsoft Edge.

Capacità supportate

  • Connessione a un URL
  • Avanzate
    • Uso di una combinazione di costanti di testo e parametri per costruire l'URL
    • Specifica di un timeout del comando
    • Definizione dei parametri di intestazione della richiesta HTTP (solo Web.Contents )

Caricare dati Web con Power Query Desktop

Per caricare dati da un sito Web con Power Query Desktop:

  1. Selezionare Recupera dati > Web in Power BI o Da Web nella barra multifunzione Dati in Excel.

  2. Scegliere il pulsante Basic e immettere un indirizzo URL nella casella di testo. Ad esempio, immettere https://en.wikipedia.org/wiki/List_of_states_and_territories_of_the_United_States. Selezionare OK.

    Selezione file di testo.

    Se l'indirizzo URL immesso non è valido, accanto alla casella di testo URL verrà visualizzata un'icona Icona di avviso. di avviso.

    Se è necessario creare un URL più avanzato prima di connettersi al sito Web, passare a Carica dati Web usando un URL avanzato.

  3. Selezionare il metodo di autenticazione da usare per questo sito Web. In questo esempio selezionare Anonimo. Selezionare quindi il livello a cui applicare queste impostazioni, https://en.wikipedia.org/in questo caso . Selezionare Connetti.

    Selezione delle credenziali Web.

    I metodi di autenticazione disponibili per questo connettore sono:

    • Anonimo: selezionare questo metodo di autenticazione se la pagina Web non richiede credenziali.

    • Windows: selezionare questo metodo di autenticazione se la pagina Web richiede le credenziali di Windows.

    • Basic: selezionare questo metodo di autenticazione se la pagina Web richiede un nome utente e una password di base.

    • API Web: selezionare questo metodo se la risorsa Web a cui ci si connette usa una chiave API a scopo di autenticazione.

    • Account aziendale: selezionare questo metodo di autenticazione se la pagina Web richiede le credenziali dell'account aziendale.

    Il livello selezionato per il metodo di autenticazione determina a quale parte di un URL verrà applicato il metodo di autenticazione. Se si seleziona l'indirizzo Web di primo livello, il metodo di autenticazione selezionato verrà usato per tale indirizzo URL o per qualsiasi indirizzo all'interno di tale indirizzo. Tuttavia, potrebbe non essere necessario impostare l'indirizzo URL principale su un metodo di autenticazione specifico perché diversi subaddresses potrebbero richiedere metodi di autenticazione diversi. Ad esempio, se si accede a due cartelle separate di un singolo sito di SharePoint e si desidera utilizzare account Microsoft diversi per accedere a ognuno di essi.

    Dopo aver impostato il metodo di autenticazione per un indirizzo del sito Web specifico, non sarà necessario selezionare di nuovo il metodo di autenticazione per tale indirizzo URL o per qualsiasi indirizzo di subaddress. Ad esempio, se si seleziona l'indirizzo https://en.wikipedia.org/ in questa finestra di dialogo, qualsiasi pagina Web che inizia con questo indirizzo non richiederà di nuovo di selezionare il metodo di autenticazione.

    Nota

    Se è necessario modificare il metodo di autenticazione in un secondo momento, passare a Modifica del metodo di autenticazione.

  4. Nella finestra di dialogo Strumento di navigazione è possibile selezionare una tabella, quindi trasformare i dati nell'editor di Power Query selezionando Trasforma dati oppure caricando i dati selezionando Carica.

    Selezione tabella Web.

    Il lato destro della finestra di dialogo Strumento di navigazione visualizza il contenuto della tabella selezionata per trasformare o caricare. Se non si è certi della tabella contenente i dati a cui si è interessati, è possibile selezionare la scheda Visualizzazione Web. La visualizzazione Web consente di visualizzare l'intero contenuto della pagina Web ed evidenzia ognuna delle tabelle rilevate in tale sito. È possibile selezionare la casella di controllo sopra la tabella evidenziata per ottenere i dati da tale tabella.

    Sul lato inferiore sinistro della finestra di dialogo Strumento di navigazione è anche possibile selezionare il pulsante Aggiungi tabella usando esempi . Questa selezione presenta una finestra interattiva in cui è possibile visualizzare in anteprima il contenuto della pagina Web e immettere i valori di esempio dei dati da estrarre. Per altre informazioni sull'uso di questa funzionalità, vedere Ottenere i dati della pagina Web fornendo esempi.

Caricare dati Web con Power Query Online

Per caricare dati da un sito Web con Power Query Online:

  1. Nella finestra di dialogo Recupera dati selezionare la pagina Web o l'API Web.

    Selezionare la pagina Web o il connettore API Web.

    Nella maggior parte dei casi, è consigliabile selezionare il connettore di pagine Web. Per motivi di sicurezza, è necessario usare un gateway dati locale con questo connettore. Il connettore pagina Web richiede un gateway perché le pagine HTML vengono recuperate usando un controllo browser, che comporta potenziali problemi di sicurezza. Questo problema non è un problema con il connettore API Web, perché non usa un controllo browser.

    In alcuni casi, è possibile usare un URL che punta a un'API o a un file archiviato sul Web. In questi scenari, il connettore API Web (o connettori specifici dei file) consente di procedere senza usare un gateway dati locale.

    Si noti anche che se l'URL punta a un file, è consigliabile usare il connettore di file specifico anziché il connettore di pagine Web.

  2. Immettere un indirizzo URL nella casella di testo. Per questo esempio, immettere https://en.wikipedia.org/wiki/List_of_states_and_territories_of_the_United_States.

    Immettere l'URL della pagina Web.

  3. Selezionare il nome del gateway dati locale.

    Immettere il gateway dati locale.

  4. Selezionare il metodo di autenticazione che verrà usato per connettersi alla pagina Web.

    Selezionare il metodo di autenticazione.

    I metodi di autenticazione disponibili per questo connettore sono:

    • Anonimo: selezionare questo metodo di autenticazione se la pagina Web non richiede credenziali.

    • Windows: selezionare questo metodo di autenticazione se la pagina Web richiede le credenziali di Windows.

    • Basic: selezionare questo metodo di autenticazione se la pagina Web richiede un nome utente e una password di base.

    • Account aziendale: selezionare questo metodo di autenticazione se la pagina Web richiede le credenziali dell'account aziendale.

    Dopo aver scelto il metodo di autenticazione, selezionare Avanti.

  5. Nella finestra di dialogo Strumento di navigazione è possibile selezionare una tabella, quindi trasformare i dati nel editor di Power Query selezionando Trasforma dati.

    Finestra di dialogo Strumento di navigazione che mostra gli stati della pagina Web.

Caricare dati Web usando un URL avanzato

Quando si seleziona Recupera dati > dal Web in Power Query Desktop, nella maggior parte dei casi si immetteranno gli URL nell'impostazione Di base. In alcuni casi, tuttavia, è possibile assemblare un URL dalle relative parti separate, impostare un timeout per la connessione o fornire dati di intestazione URL individuali. In questo caso, selezionare l'opzione Avanzate nella finestra di dialogo Da Web .

Assembly URL avanzato Web.

Usare la sezione parti URL della finestra di dialogo per assemblare l'URL da usare per ottenere i dati. La prima parte dell'URL nella sezione delle parti URL è probabilmente costituita dallo schema, dall'autorità e dal percorso dell'URI ,ad esempio http://contoso.com/products/. La seconda casella di testo può includere query o frammenti che è possibile usare per filtrare le informazioni fornite nel sito Web. Se è necessario aggiungere più di una parte, selezionare Aggiungi parte per aggiungere un altro frammento url casella di testo. Quando si immette ogni parte dell'URL, l'URL completo che verrà usato quando si seleziona OK viene visualizzato nella casella anteprima URL.

A seconda del tempo impiegato dalla richiesta POST per elaborare i dati, potrebbe essere necessario prolungare il tempo in cui la richiesta continua a rimanere connessa al sito Web. Il timeout predefinito per POST e GET è 100 secondi. Se questo timeout è troppo breve, è possibile usare il timeout del comando facoltativo in minuti per estendere il numero di minuti di connessione.

È anche possibile aggiungere intestazioni di richiesta specifiche al post inviato al sito Web usando la casella di riepilogo a discesa facoltativa intestazione richiesta HTTP. Nella tabella seguente vengono descritte le intestazioni di richiesta che è possibile selezionare.

Intestazione richiesta Descrizione
Accept Specifica i tipi di supporti di risposta accettabili.
Accept-Charset Indica quali set di caratteri sono accettabili nel contenuto della risposta testuale.
Accept-Encoding Indica quali codifiche del contenuto della risposta sono accettabili nella risposta.
Accept-Language Indica il set di linguaggi naturali preferiti nella risposta.
Cache-Control Indica i criteri di memorizzazione nella cache, specificati dalle direttive, nelle richieste client e nelle risposte del server.
Content-Type Indica il tipo di supporto del contenuto.
If-Modified-Since Determina in modo condizionale se il contenuto Web è stato modificato dopo la data specificata in questo campo. Se il contenuto non è stato modificato, il server risponde solo con le intestazioni con un codice di stato 304. Se il contenuto è stato modificato, il server restituirà la risorsa richiesta insieme a un codice di stato 200.
Preferire Indica che determinati comportamenti del server sono preferiti dal client, ma non sono necessari per il completamento della richiesta.
Intervallo Specifica uno o più intervalli secondari dei dati di rappresentazione selezionati.
Referer Specifica un riferimento URI per la risorsa da cui è stato ottenuto l'URI di destinazione.

Importare file dal Web

In genere, quando si importa un file locale in Power Query Desktop, si userà il connettore di tipo file specifico per importare tale file, ad esempio il connettore JSON per importare un file JSON o il connettore CSV per importare un file CSV. Tuttavia, se si usa Power Query Desktop e il file da importare si trova sul Web, è necessario usare il connettore Web per importare tale file. Come nel caso locale, verrà visualizzata la tabella caricata dal connettore per impostazione predefinita, che sarà quindi possibile caricare o trasformare.

I tipi di file seguenti sono supportati dal Connessione or Web:

Ad esempio, è possibile usare la procedura seguente per importare un file JSON nel https://contoso.com/products sito Web:

  1. Nella finestra di dialogo Recupera dati selezionare il connettore Web.

  2. Scegliere il pulsante Basic e immettere l'indirizzo nella casella URL , ad esempio:

    http://contoso.com/products/Example_JSON.json

    Importare un file JSON dal Web.

  3. Seleziona OK.

  4. Se è la prima volta che si visita questo URL, selezionare Anonimo come tipo di autenticazione e quindi selezionare Connessione.

  5. editor di Power Query si aprirà ora con i dati importati dal file JSON. Selezionare la scheda Visualizza nella editor di Power Query, quindi selezionare Barra della formula per attivare la barra della formula nell'editor.

    Aprire la barra della formula.

    Come si può notare, il connettore Web restituisce il contenuto Web dall'URL specificato e quindi esegue automaticamente il wrapping del contenuto Web nel tipo di documento appropriato specificato dall'URL (Json.Document in questo esempio).

Vedi anche