Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Content Layer
namePage Info
id278129461
classwatermark-layer
Content Column
namePage Body
width100.00001%
id278129463
Content Block
background-colortransparent
namePrompt
id494677873
classtight manual-prompt-flex

Let users choose from a fixed set of values when creating a page or space from a Blueprint. 

Content Block
nameOutcome
rich-link-hoverstrue
id1042866408
classtight manual-outcome-flex

Replace me with a more complete explanation of what this how-to accomplishesIn addition to user-entered text and file attachments, you can now use a picklist of options inside the Blueprint Wizard. This is a great way to further control the output of a blueprint, and provide greater ease-of-use to your content creators. This guide describes how to set up  picklist of options.

If using:

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

    .

    Content Block
    nameSteps
    rich-link-hoverstrue
    id494842117
    classsteps-block numbered manual-steps-flex tight-bottom

    Use h4 for section headings

    If you don't want numbers in the section headings, simply remove the "numbered" class from this block.

    Note/Tip/Warning/Info blocks below are collapsed by default. If you want to use any of these, try to keep to just one per page. You may use two if necessary, but in general, try to limit these.

    Create your Page Blueprint

    Learn about creating a Page Blueprint. Use a substitution field in the place where you want your user's picklist selection to go. For example, let's say our Blueprint is an Employee Profile page and we want users to select from a given list of titles. We might then add a [[employee-title]] substitution field under their name and image on the blueprint.

    Access your Blueprint JSON Definition

    Read more about Accessing and Editing the JSON File.

    Set the "type" to "list", and add the "values" attribute to the blueprintField object

    Add a new line to your Blueprint Field object definition, as seen in the code snippet below. The values for the "values" attribute will be the options displayed to the user. This is an array of items in quotations. Inside the quotes can be any set of characters including special characters, but note that you may need to "escape" slashes, apostrophes, and quotations using a "\" character in front of it.

    Code Block
    languagejs
    "blueprintFields" : [
    		{
    			"id"			: "employee-title",
    			"name"			: "Employee Title",
    			"type"			: "list",
    			"required"		: true,
    			"helpText"		: "Select an employee title from the list.",
    			"values"		: [ "Magician", "Pipe Fitter", "Systems Analyst", "Knacker", "Shark Tamer", "Saxophonist", "Other" ],
    		},
    		...
    ]

    Re-Upload your JSON to the Blueprint Definition Page

    That's It!

    Test your Blueprint by creating a page from it. The options shown should be those defined in the "values" array (in our example: "Magician", "Pipe Fitter", etc.). The selected option should display on your page wherever its substitution field was placed

    Content Block
    nameNote
    rich-link-hoverstrue
    id495965127
    classmanual-note-flex
    collapsiblecollapse
    Note
    Content Block
    nameTip
    rich-link-hoverstrue
    id894522670
    classmanual-tip-flex
    collapsiblecollapse
    Tip

    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.
    Content Block
    nameWarning
    rich-link-hoverstrue
    id894530759
    classmanual-warning-flex
    collapsiblecollapse
    Warning

    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.
    Content Block
    nameInfo
    rich-link-hoverstrue
    id894537203
    classmanual-info-flex
    collapsiblecollapse
    Info

    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.
    Content Layer
    background-color$lightGrayColor
    nameRelated
    id888168050
    Content Column
    nameRelated
    width100%
    id888168051
    Content Block
    rich-links-hide-descriptiontrue
    rich-link-hoverstrue
    rich-links-columns4
    rich-links-verticaltrue
    rich-links-image-height100px
    rich-links-hide-site-icontrue
    rich-links-details-padding10px
    nameRelated
    rich-links-enabletrue
    border-width0
    rich-links-details-alignmentleft
    rich-links-margin20px 30px 0 0
    id496234544
    classrelated-block clean manual-related-flex