Sdílet prostřednictvím

Použití dev proxy serveru s řešeními SPFx (SharePoint Framework)

  • Článek

SharePoint Framework (SPFx) je vývojový model pro rozšíření SharePointu, Microsoft Teams, Microsoft Viva a Microsoftu 365. Při sestavování řešení SPFx můžete pomocí dev Proxy zachytit webové požadavky provedené vaším řešením a podívat se, jak zpracovává chyby rozhraní API.

Zachycení webových požadavků provedených řešením SPFx

Řešení služby SharePoint Framework jsou aplikace na straně klienta, které běží ve webovém prohlížeči. Než začnete s dev proxy serverem, musíte ho nakonfigurovat tak, aby zachycoval požadavky provedené vaším řešením SPFx. Často chcete zachycovat požadavky na rozhraní Microsoft Graph a SharePoint REST API. Pokud používáte vlastní rozhraní API, chcete také zachycovat požadavky na ně. Můžete definovat adresy URL, které se mají zachytit ve urlsToWatch vlastnosti v konfiguračním souboru dev proxy.

{
  // [...] trimmed for brevity
  "urlsToWatch": [
    "https://graph.microsoft.com/*",
    "https://*.sharepoint.com/*"
    // other URLs to watch
  ]
}

Tip

Při použití dev proxy serveru se sharepointovým proxy serverem použijte předvolbu SPFx z galerie ukázkových řešení. Obsahuje společnou konfiguraci pro zachycování webových požadavků provedených řešeními SPFx, včetně požadavků na rozhraní MICROSOFT Graph a rozhraní REST API Služby SharePoint.

Když na svém počítači spustíte Dev Proxy, automaticky zachytí webové požadavky provedené řešením SPFx a simuluje nakonfigurované odpovědi. Abyste mohli používat Dev Proxy, nemusíte měnit řešení SPFx.

Konfigurace vývojového proxy serveru pro nezachycování požadavků aplikace SharePoint Framework Workbench

Při vytváření řešení SPFx použijete aplikaci SharePoint Framework workbench k otestování webových částí. Aplikace SharePoint Framework workbench běží ve webovém prohlížeči a k načtení webových částí používá rozhraní API služby SharePoint. Dev Proxy ve výchozím nastavení zachytí všechny webové požadavky z webového prohlížeče, včetně požadavků provedených aplikací SharePoint Framework Workbench. V důsledku toho vám může zabránit v testování webových částí.

Aby vývojový proxy server neblokoval požadavky provedené aplikací Workbench služby SharePoint Framework, nakonfigurujte dev proxy server tak, aby nezachycoval požadavky na rozhraní API webové části. V konfiguračním souboru dev proxy vyloučíte rozhraní API aktualizací urlsToWatch vlastnosti.

{
  // [...] trimmed for brevity
  "urlsToWatch": [
    "!https://*.sharepoint.com/_api/web/GetClientSideComponents*"
    // other URLs to watch
  ]
}

Tip

Pokud použijete předvolbu SPFx z galerie ukázkových řešení, už tuto adresu URL vyloučí z zachycení dev proxy serverem.