Azure Power BI Embedded Management ügyfélkódtár JavaScripthez – 2.0.2-es verzió

Ez a csomag egy izomorf SDK-t tartalmaz (Node.js és böngészőkben egyaránt fut) az Azure Power BI Embedded Management-ügyfélhez.

Ügyfél a Power BI Embedded munkaterület-gyűjtemények kezeléséhez és a munkaterületek lekéréséhez.

Forráskód | Csomag (NPM) | API-referenciadokumentáció | Minták

Első lépések

Jelenleg támogatott környezetek

• A Node.jsLTS-verziói
• A Safari, a Chrome, az Edge és a Firefox legújabb verziói.

További részletekért tekintse meg támogatási szabályzatunkat .

Előfeltételek

• Egy Azure-előfizetés.

Telepítse a(z) @azure/arm-powerbiembedded csomagot

Telepítse a JavaScripthez készült Azure Power BI Embedded Management ügyfélkódtárat a következővelnpm:

npm install @azure/arm-powerbiembedded

Hozzon létre és hitelesítsen egy PowerBIEmbeddedManagementClient

Az Azure Power BI Embedded Management API eléréséhez ügyfélobjektum létrehozásához szüksége lesz az endpoint Azure Power BI Embedded Management-erőforrásra és egy credential. Az Azure Power BI Embedded Management-ügyfél az Azure Active Directory hitelesítő adatait használhatja a hitelesítéshez. Az Azure Portalon megtalálhatja az Azure Power BI Embedded Management-erőforrás végpontját.

Az Azure Active Directoryval hitelesítést végezhet a @azure/identitástárból vagy egy meglévő AAD-jogkivonatból származó hitelesítő adatokkal.

Az alább látható DefaultAzureCredential szolgáltató vagy az Azure SDK-hoz biztosított egyéb hitelesítőadat-szolgáltatók használatához telepítse a @azure/identity csomagot:

npm install @azure/identity

Emellett regisztrálnia kell egy új AAD-alkalmazást, és hozzáférést kell biztosítania az Azure Power BI Embedded Managementhez úgy, hogy hozzárendeli a megfelelő szerepkört a szolgáltatásnévhez (megjegyzés: az olyan szerepkörök, mint például "Owner" nem biztosítják a szükséges engedélyeket). Állítsa be az AAD-alkalmazás ügyfélazonosítójának, bérlőazonosítójának és titkos ügyfélkulcsának értékeit környezeti változókként: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET.

Az Azure AD-alkalmazások létrehozásával kapcsolatos további információkért tekintse meg ezt az útmutatót.

const { PowerBIEmbeddedManagementClient } = require("@azure/arm-powerbiembedded");
const { DefaultAzureCredential } = require("@azure/identity");
// For client-side applications running in the browser, use InteractiveBrowserCredential instead of DefaultAzureCredential. See https://aka.ms/azsdk/js/identity/examples for more details.

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new PowerBIEmbeddedManagementClient(new DefaultAzureCredential(), subscriptionId);

// For client-side applications running in the browser, use this code instead:
// const credential = new InteractiveBrowserCredential({
//   tenantId: "<YOUR_TENANT_ID>",
//   clientId: "<YOUR_CLIENT_ID>"
// });
// const client = new PowerBIEmbeddedManagementClient(credential, subscriptionId);

JavaScript-csomag

Ahhoz, hogy ezt az ügyfélkódtárat a böngészőben használhassa, először egy kötegelőt kell használnia. Ennek részleteiért tekintse meg a csomagküldő dokumentációt.

Fő fogalmak

PowerBIEmbeddedManagementClient

PowerBIEmbeddedManagementClientaz Azure Power BI Embedded Management ügyfélkódtárat használó fejlesztők elsődleges felülete. Az ügyfélobjektum metódusainak megismerése az Azure Power BI Embedded Management szolgáltatás különböző funkcióinak megismeréséhez.

Hibaelhárítás

Naplózás

A naplózás engedélyezése segíthet a hibákról szóló hasznos információk feltárásában. A HTTP-kérések és válaszok naplójának megtekintéséhez állítsa a környezeti változót a AZURE_LOG_LEVEL értékre info. A naplózás futásidőben is engedélyezhető a következő hívással setLogLevel@azure/logger:

const { setLogLevel } = require("@azure/logger");
setLogLevel("info");

A naplók engedélyezésére vonatkozó részletesebb útmutatásért tekintse meg a @azure/logger csomag dokumentációt.

Következő lépések

A kódtár használatára vonatkozó részletes példákért tekintse meg a mintakönyvtárat.

Közreműködés

Ha hozzá szeretne járulni ehhez a kódtárhoz, olvassa el a közreműködői útmutatót , amelyből többet is megtudhat a kód összeállításáról és teszteléséről.

Kapcsolódó projektek

• JavaScripthez készült Microsoft Azure SDK