Add new workspace elements

Configure asset pages with your custom elements.Adding new asset elements to a workspace can be done easily by using the factorial templates of each element, defined in censhare-Server/install/system/required/web/workspace:

• Page: Page.asset.template.xml from /04_pages/
• Container: Container.asset.template.xml from 03_containers
• Widget: Widget.asset.template.xml from /01_widgets

Depending on the type of the development elements should be created in the following areas:

• New development: censhare-Server/install/system/required/web/workspace/{element_type_dir}
• Customizations: censhare-Custom/censhare-Server/{search-path}

The ability to work with customized system module assets in censhare-Custom/ in described in System Module Assets (runtime area).

Main steps

These are the main steps that need to be followed to successfully add new workspace elements:

• Create a new element definition in its corresponding location (as described above)
• Add all appropriate references to other workspace elements (e.g. adding a new page to a workspace asset by asset key reference)
• Execute one of the following server actions from the Admin Client, based on the development type:
  • New development: Synchronize system module assets
  • Customizations: Synchronize system module assets (runtime)
• Re-login to the censhare Web

References within elements

• New page definitions must be added to the Workspace asset definition via resource key reference:

  • Example:

    <?xml version="1.0" encoding="UTF-8"?>
    <asset name="censhare: Standard" type="module.workspace." application="default" domain="root." domain2="root.">
      ...
      <asset_feature feature="censhare:workspace.page" value_string2="censhare:resource-key" value_asset_key_ref="censhare:workspace.page.home"/>
      <asset_feature feature="censhare:workspace.page" value_string2="censhare:resource-key" value_asset_key_ref="censhare:workspace.page.idea"/>
      <asset_feature feature="censhare:workspace.page" value_string2="censhare:resource-key" value_asset_key_ref="censhare:workspace.page.image"/>
      ...
    </asset>

• New container definitions must be added to the corresponding page definition via resource key reference:

  • Example:

    <?xml version="1.0" encoding="UTF-8"?>
      <asset name="Asset award" type="module.workspace.page." application="metadata" domain="root." domain2="root.">
      ...
      <asset_feature feature="censhare:workspace.container" value_string2="censhare:resource-key" sorting="1" value_asset_key_ref="censhare:workspace.container.details-1"/>
      <asset_feature feature="censhare:workspace.container" value_string2="censhare:resource-key" sorting="2" value_asset_key_ref="censhare:workspace.container.communication"/>
      <asset_feature feature="censhare:workspace.container" value_string2="censhare:resource-key" sorting="3" value_asset_key_ref="censhare:workspace.container.history"/>
      ...
    </asset>