Prerequisites

This tip assumes that readers are familiar with the tip Supply Documents.

Create the Service Document

This time we need to add the service document first.

Add a property called Configurations with Child Documents Macro as value.

Note that for this example we do not add a hide control, so the property will be shown, once a configuration has been added.

Next add the Document Properties Supplier From Documents Macro to a section of the service document. Point the Properties parameter to the Configurations property on the same page by leaving the Documents parameter empty.

Save the page!

Add HTTP Configuration

Create a new child document for the HTTP configuration of the service.

Add the following property with the supply control.

Save the page!

Click on the service document!

Add a Memory Configuration

Add a new child document for the memory configuration.

Add the following property with the supply control.

Save the page!

Click on the service document!

Change Memory Configuration

Now make a change! For example change the memory requirement from 1 GB to 8 GB:

Click on the service document and see the change there, too.

Be more selective

The example assumes that any document an authors adds to the service document is treated as configuration. Authors can control which properties a document must have to be considered a configuration.

Authors can require child documents to have a specific doctype or match certain constraints.

For more information please refer to the documentation of the Child Documents Macro.

Summary

With the Child Documents Macro it is easy to bind a document to its parent. Adding child documents is like adding additional aspects to a document. Therefore we call this feature Aspects light.

Currently we work on getting Aspects as a new feature to the projectdoc Toolbox. Aspects will not only include the properties, but also sections. Stay tuned! 

Resources