Introduction to the Embedding SDK

The Embedding SDK allows you to quickly integrate a MicroStrategy dossier into a web application in a responsive manner. It also provides resources to add functionality such as controlling navigation, retrieving and applying filters, setting properties, and managing events, and supports several different authentication environments.

There are three basic steps for embedding a dossier.

  1. In the initial page of your web application, add a link to the MicroStrategy JavaScript Embedding API library.

    <script src="http://{host}:{port}/{Library}/javascript/embeddinglib.js"></script>

  2. Create a <div> as the placeholder where you want to embed the dossier.

    <div id="dossierContainer"></div>

  3. Call the microstrategy.dossier.create(props) method when the application has finished loading.

    var placeholderDiv = document.getElementById("dossierContainer");

    microstrategy.dossier.create({

      placeholder: placeholderDiv,

      url: http://{host}:{port}/{Library}/app/{ProjectID}/{DossierID}

    });

To help you get started, we have provided a number of simple applications with sample code and explanations.

If the application server is different from the server running the MicroStrategyLibrary application, you may need to perform additional configuration to support Cross-Origin Requests (CORS).

   To see changes to the Embedding SDK in the current release, refer to What's New.

To maintain your current customizations and take advantage of new features, refer to Upgrading to a newer version of MicroStrategy.

For earlier versions of the Embedding SDK, refer to Previous Releases.

Did you find this helpful?