proc_creating-a-composite-content-view.adoc

Creating a Composite Content View

Use this procedure to create a composite Content View. To use the CLI instead of the {ProjectWebUI}, see the CLI procedure.

Procedure

1. In the {ProjectWebUI}, navigate to Content > Lifecycle > Content Views.

2. Click Create content view.

3. In the Create content view window, enter a name for the view in the Name field. {ProjectName} automatically completes the Label field from the name you enter.

4. Optional: In the Description field, enter a description of the view.

5. On the Type tab, select Composite content view.

6. Optional: If you want to automatically publish a new version of the Composite Content View when a Content View is republished, select the Auto publish checkbox.

7. Click Create content view.

8. On the Content views tab, select the Content Views that you want to add to the Composite Content View, and then click Add content views.

9. In the Add content views window, select the version of each Content View.

10. Optional: If you want to automatically update the Content View to the latest version, select the Always update to latest version checkbox.

11. Click Add, then click Publish new version.

12. Optional: In the Description field, enter a description of the Content View.

13. In the Publish window, set the Promote switch, then select the lifecycle environment.

14. Click Next, then click Finish.

CLI procedure

1. Before you create the Composite Content Views, list the version IDs for your existing Content Views:

   # hammer content-view version list \
   --organization "My_Organization"

2. Create a new Composite Content View. When the --auto-publish option is set to yes, the Composite Content View is automatically republished when a Content View it includes is republished:

   # hammer content-view create \
   --composite \
   --auto-publish yes \
   --name "Example_Composite_Content_View" \
   --description "Example Composite Content View" \
   --organization "My_Organization"

3. Add a Content View to the Composite Content View. You can identify Content View, Content View version, and Organization in the commands by either their ID or their name. To add multiple Content Views to the Composite Content View, repeat this step for every Content View you want to include.

   • If you have the Always update to latest version option enabled for the Content View:

     # hammer content-view component add \
     --component-content-view-id Content_View_ID \
     --composite-content-view "Example_Composite_Content_View" \
     --latest \
     --organization "My_Organization"

   • If you have the Always update to latest version option disabled for the Content View:

     # hammer content-view component add \
     --component-content-view-id Content_View_ID \
     --composite-content-view "Example_Composite_Content_View" \
     --component-content-view-version-id Content_View_Version_ID \
     --organization "My_Organization"

4. Publish the Composite Content View:

   # hammer content-view publish \
   --name "Example_Composite_Content_View" \
   --description "Initial version of Composite Content View" \
   --organization "My_Organization"

5. Promote the Composite Content View across all environments:

   # hammer content-view version promote \
   --content-view "Example_Composite_Content_View" \
   --version 1 \
   --to-lifecycle-environment "Development" \
   --organization "My_Organization"
   # hammer content-view version promote \
   --content-view "Example_Composite_Content_View" \
   --version 1 \
   --to-lifecycle-environment "Testing" \
   --organization "My_Organization"
   # hammer content-view version promote \
   --content-view "Example_Composite_Content_View" \
   --version 1 \
   --to-lifecycle-environment "Production" \
   --organization "My_Organization"