Embedded Resources

we registered our scripts and themes manually in application level to render our Dashboard Viewer component. Now you can also embed the resources from assembly to reduce the work. Hence forth user can render Dashboard platform SDK Dashboard Viewer component without any manual configuration.

How it works?

The Dashboard platform SDK Dashboard Viewer resources and dependent scripts are encapsulated as embedded in our assembly and registered those resources in ASP Script Manager. Afterwards ASP Script Manager will take appropriate process to access the resources from assembly as usual once components loaded on that page.

For themes, necessary stylesheets will be added in header section of current page dynamically to render theDashboard platform SDK Dashboard Viewer component. To get the embed resources in your application, you should register an App Key in Web.Config file.

Access Embedded Resource

The following key settings will configure in web.config file. Please refer below code snippet:

  • XAML
    • <appSettings>
            <add key="LoadDashboardResourcesFromAssembly" value="true" />
            <add key="DashboardResources" value="jqueryeasing:true;themes:true;" />
      </appSettings>

    Where ‘LoadDashboardResourcesFromAssembly’ key denotes that whether resources are referred from assembly or not and ‘DashboardResources’ key used to get scripts and themes from assembly.

    NOTE

    The above key setting we should configure it manually in web.config file.

    What are the resources will embed from assembly?

    By default, the following resources shipped as embedded resources from assembly.

    • jQuery Easing v1.3
    • Default Theme

    And component related scripts will embed dynamically from assembly in your application.

    CDN integration with Embedded Resources

    You can get these embedded resources from CDN (Content Delivery Networks) also. To achieve this behavior you should enable the EnableCdn property in ASP script manager control. Please refer below code snippet:

  • ASPX-CS
    • <asp:scriptmanager id="ScriptManager1" runat="server" EnableCdn="true">
      </asp:scriptmanager>

    You can embed the resources from assembly when CDN (Content Delivery Network) is unavailable. To achieve this behavior you should enable EnableCdnFallback property in script manager. Please refer the below code snippet:

  • ASPX-CS
    • <asp:ScriptManager runat="server" EnableCdn="true" EnableCdnFallback="true">
      </asp:scriptmanager>

    NOTE

    1. EnableCdnFallback property is supported from 4.5 and above frameworks.
    2. EnableCdnFallback is not applicable for theme file.
    3. Both script and style resources can also be accessed through HTTPS (secure connection ) from CDN