Composites are widgets which can be created by an advanced story designer. They typically contain other widgets and data sources that are grouped together into a single widget, allowing for consistency in your story design. In the following example, an image and text widget are grouped to create a basic header widget.
Because composites exist as entities independent from a specific story, they can be shared with other users and be re-used among many different stories. A story can contain several composites, but a composite cannot be part of another composite.
Composites are available only in Optimized Story Design and only within a canvas page.
Creating a composite is only possible if you have specific permission within SAP Analytics Cloud to do so. You access the creation area via the Stories option from the main menu. Composites can be saved just like any other resource in SAP Analytics Cloud, so you can create specific folders to organize them.
To use a composite in a story, you must first import it. You can use either the Assets area of the left side panel or simply add it from the Insert area of the toolbar. A dialog appears where you can select the composite, and you simply browse to the composite you want.
Once the composite is imported to the story, it is listed under Composites in the Assets pane with other available widgets. If any imported composites are not added to or actively used in your story, when the story is transported to another system, they will not be transported with it.
To add a composite to your story, simply drag and drop it from Assets to the page. The composite is then listed in the Outline panel, with the default ID Composite_#, and you can change the ID if you choose.
Once a composite is added, you can configure it as any other widgets in your story. The actions apply to the composite as a whole, rather than the individual widgets that make up the composite. However, theme preferences can apply to the individual widgets.
Currently, there are limitations to creating and using composites, but these limitations will change over time. For a complete and current list, please see the SAP Analytics Cloud User Guide.