How to create a blueprint at the space level.

Prerequisites

Before you begin building your space blueprint, you'll want to: 

  • Make sure Brikit Blueprint Maker is installed and enabled
  • Confirm that you have administrative permissions 
  • Familiarize yourself with the json file, substitution fields, and the basics of blueprints
  • Consider the substitution fields you'll want to employ
  • Consider what pages will exist in the space


Create a set of pages (space) that will become a space blueprint

MORE DETAIL HERE

Navigate to the Blueprint Definitions Page and download the JSON File

See Accessing and Editing the JSON File for instructions on how to download the file.

Define the blueprint in the spaceBlueprints object in the json file

    1. Name (A human-readable name)
    2. Description (Appears below the blueprint name in the Blueprint Menu)
    3. blueprintSpace Key (The key of the space where the space blueprint pages reside)
    4. blueprintFields (List of the substitution fields used in the blueprint)
      1. Both built-in and custom fields
        1. Not required, but useful
        2. Sets the order the fields will appear in the Wizard
    5. spaceName  (A name for the new space)
    6. spaceKey (A key for the new space)
    7. spaceCategories (One or more words to categorize the space)
      1. Will be added as space labels
    8. spaceDescription (A description of the space)
    9. access (a permission scheme for the new space)

In the JSON file, add and define your substitution fields

In the same JSON file, you must define each of the substitution fields; again with helpful information to the users creating a space from this blueprint.

For each substitution field, you must define the:

    1. ID (The unique ID for the field–that is, what is between the [[ ]] brackets in your space blueprint)

    2. Name (A human-readable name for the field)

    3. Required (A toggle for whether the field is required)

    4. Type (Defines the display length of the field)

    5. Help Text (Additional text to assist the user in filling out the field - appears below the data-entry field in the creation process)

    6. Placeholder (Default text inside the field)

Save and upload the JSON File

See again Accessing and Editing the JSON File for how to upload the file.

Create a space from this Blueprint

  1. Click the 'Blueprints' button in the Confluence Header (not the 'Create' button). 
  2. Select the space blueprint you created
  3. You are now in the "Wizard" which walks you through entering the substitution fields (if there are any) and the creation of the space from this blueprint.
  4. Enter values for each of the substitution fields
  5. Click next
  6. Verify where you want this page created
  7. Click Create

If using:

  1. Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  2. Add the tight-bottom class to the Steps block above to narrow the gap between the two blocks.

If using:

  1. Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  2. Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.

If using:

  1. Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  2. Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.

If using:

  1. Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  2. Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.