Share via

Part Object (Part Discovery Service)

  • Article

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

The Part object is the encapsulation of the services the Digital Dashboard Services Component (DDSC) provides for Web Parts in the current dashboard. The Part object is what is returned from the Part Discovery service and used to set and retrieve Web Part state.

The Part object provides the following properties:

  • **WebPartQualifier   **This uniquely identifies a Part object on the current dashboard page. It is generated automatically by the dashboard factory when the dashboard is rendered and is registered with the Web Part.

  • **WebPartID   **This uniquely identifies a part in the store (typically a URL) specified when the Web Part is registered on the page. If StateServiceURL is specified during the call to the DDSC object's Init method, then this value will be supplied as an argument in the calls to the methods POST and GET.

  • **DOMObject   **This is the default property of the Part object and provides a handle to the HTML DOM node for the part.

    Note   Often, you might want to get a handle to a Part object within the body of a Web Part. This is useful especially when using the Part State Management features. During page creation, the dashboard factory defines a set of page variables that provide access to all Part objects. You use the string "varPart_WPQ_" when referencing the Web Parts themselves in script.

Example

<SCRIPT LANGUAGE=VBSCRIPT>
   dim MyPart, Dashboard
   Set Dashboard = DDSC.Dashboard
   Set MyPart = varPart_WPQ_ 
   MyPart.InnerHTML = …
…
</SCRIPT>

When the page is constructed, the string "_WPQ_" is replaced by a unique qualifier for the Web Part.

See Also

Part Discovery Service | DDSC Object (Part Discovery Service) | Dashboard Object (Part Discovery Service) | PartCollection Object (Part Discovery Service) | Part Discovery Service Example