Versions Compared

Version Old Version 1 New Version Current
Changes made by

Shane Smith

Mariela Mihaylova

Saved on

Key

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

Overview

This document explains the feature differences between scaffolding forms and templates.

Overview

In Confluence Data Center, there were not many restrictions on how macros could be used together. In Confluence Cloud, a macro with a body can’t be nested inside another macro.

This limitation affects the Scaffolding macros, so some work differently, and some are not available in the new Cloud editor.

Before migrating your Confluence Data Center spaces with Scaffolding data to the cloud, it is important to understand the feature differences and anticipate what is not migratable. 

On this page:

Table of Contents
minLevel1
maxLevel6
outlinefalse
styledisc
typelist
printabletrue

Migration Path

Original Platform

Target Platform

Available App Migration Path

License Migration

Notes/Consideration

Server/DC

Cloud

Migration Path is available

Needed
understand the Scaffolding Forms & Templates

Feature Differences

including the macro differences between the application for Confluence Server and Confluence Cloud

  • allocate time for a test migration to understand the steps required to migrate data and complete re-configuration

    • This guide assumes you have successfully migrated your  Confluence Server data into Confluence Cloud, per Atlassian's instructions (CCMA)

    InfoMore Atlassian resources are available here.

    Feature Differences

    Supported Server

    Migration Focus Area

    Feature

    PlatformServer

    Data Center

    Cloud

    Versioning/License

    Version SupportMin version support

    Migration of Scaffolding data is supported for Scaffolding 8.25.0 and later.

    Note

    In Scaffolding 8.30.0 and 9.1.0, we introduce partial support for Repeating Data macro migration.

    Migrate to the Scaffolding cloud using the steps at Migration Path  /wiki/spaces/DEVSCAFC/pages/1534263741.

    License

    Available through Atlassian Marketplace

    Available through Atlassian Marketplace only. Monthly subscriptions are the default option, however, discounted annual subscriptions are available upon request to our Atlassian Sales team.

    Access/Security

    Authentication Typetype

    Authentication will be is based on your current setup.

    Confluence Cloud protects your data with encryption in transit and at rest and provides administrative controls to enforce organization-wide protection such as SAML SSO, enforced 2FA, and SCIM. 

    Info

    This describes how Atlassian helps with security and encryption in Confluence Cloud.

    Confluence Differences

    Structure editing

    • calling Field inserting input field macros

    Field Input field macros are called directly on a page.
    Some macros interact with each other and have to be nested inside other macros.

    Field macros Input fields are drag-and-dropped after adding a Field Group macro on a page. You build the structure of the page inside this macro by choosing the Field macros input fields from the left-hand panel and drag-and-dropping them into the Editing editing area.

    Content editing

    • filling up the forms

    Clicking "Edit Content" will pop-up opens a separate Scaffolding Edit Content content editor.

    Info

    Depending on the Scaffolding field macro type, editing values can be done on directly in this directly, area or on in a separate popup editor area.

    Clicking Edit Content will change changes the Page View to become an editable area. 

    Scaffolding settings

    Scaffolding includes an administrator setting, which allows Confluence administrators to set the default setting for the Edit Contents mode.

    For details, see Accessing Scaffolding's Administrator Settings

    All limit settings are handled by the app internallypreconfigured. No further configuration is needed in Cloudthe cloud.

    Previous Scaffolding XML versions

    Scaffolding allows users with the proper permissions to view Scaffolding data history on a page that contains Scaffolding metadata.

    Info

    Users may can compare versions or restore older versions using this feature.

    All changes made to pages with Scaffolding macros will be are recorded in the Page History, be it including Scaffolding structure or changes and data changes. Users are able to restore page data to an earlier version through the Confluence Page History.

    Note

    Due to the feature difference between Server and Cloud, only the current version of Scaffolding data will be migrated to Cloud. 

    Integration with other macros

    Since Field macros are called directly on a page as macros, this means that users can add any other Confluence macros inside this page along Scaffolding macros.

    Confluence server supports nested macros as well which means Scaffolding macros can easily be nested and integrated with other Confluence macros.

    Expand
    titleExample of how Scaffolding macros are nested with other macros...
    Image Modified

    Scaffolding supports integration with most reporting macros/apps, including

    • page property report macros (Atlassian Confluence macros)

    • Reporting app (Appfire app)

    Field Group macro is a standalone macro that reveals a separate editor where you can build your page structure. While this editor supports most Confluence page functions, it does not support other complex macros and third-party macros

    Confluence Cloud currently does not support nested macro macros (See CONFCLOUD-68323), which means integration with other apps by way of nesting will be via nesting is limited.

    Note

    Due to this limitation, pages and templates that contain Scaffolding macros nested with other macros (such as the one highlighted in the Server column on the left side) will fail to be migrated to Cloud. We suggest simplifying the page structure and removing any complex third-party macros in the page/template before performing the migration to the Cloud. Feel free to contact our support team to get for further advice about this.

    Currently, Scaffolding Cloud does not support integration with reporting apps such as page property report macro. 

    Macro Differences Overview

    Server Data Center Macros 

    Cloud Macros

    We have simplified our cloud Scaffolding application to focus on some key macros. This means that data migrated will be handled totally differently in Cloud.

    Review and understand the following: 

    • look out for icons highlighting how the data will be migrated

      • (error)  – Unavailable

      • (warning)  – Partially available

    We suggest you thoroughly test all the main data that you are migrating, keeping in mind which category they fall into. Include this as a part of the pre-migration tests.

    • for macros that are migrated but are unsupported, the following applies

      • Overall unsupported Macro

        • You may might see a blank space where the macros were originally positioned in the documents

      • Unsupported Macro parameters

        • migration will contain the data

        • your parameter values are available in the Content Properties

        • the function of those parameters is not available

        • the macros will behave differently in View & Edit content mode 

          • for example, if you have a page with Number Data with decimal and minValue set, that data in cloud

            • will lose its decimal value on View content mode

            • upon Edit content mode, no minValue is set

    Info

    Find details of migration for each macro below and the differences in terms of behaviour behavior once migrated to the cloud.

     Naming conventions have been changed to suit new macro behavior.

    Macro Differences Breakdown

    Macro Differences Breakdown

    Data Center Macro

    Cloud Macro

    (or closest equivalent)  

    Key Differences

    ServerData Center

    Cloud

    Attachment Data

    Allows users to specify an attachment to upload , or to select a previously - uploaded attachment.

    Attachment Upload/wiki/spaces/DEVSCAFC/pages/1534298107

    • accepts required, include and exclude as filter criteria for the attachments

    • the Required, Include, and Exclude parameters are supported , and work similarly to the Server version

    Attachment Options

    Creates a set list of list options linking linked to the attachments on the specified content. Must be contained inside a  a List Data macro.

    Files List/wiki/spaces/DEVSCAFC/pages/1534624735 

    • accepts  content, include and exclude as filter criteria for the attachments

    • supports the Page parameter: the location of the page with the attachment(s)

    Content Options

    Generates a set of options linking to Confluence content (e.g. pages, blog posts, etc).

    May be filtered in several ways. Must be contained inside a  List Data macro.Dropdown List

    /wiki/spaces/DEVSCAFC/pages/1534264104

    • accepts space, parent ancestor, labels, etc as filter criteria for the content to be displayed as option

    • accepts space as filter criteria for the content to be displayed as option.

    Date Data

    Allows editing of dates with a date picker pop-up menu, or via keying in directly into the fixed format field.

    Date Field/wiki/spaces/DEVSCAFC/pages/1534788296

    • accepts minDate, maxDate & Display format as Date field criteria.

    • accepts no parameter

    Group Data

    Allows data to be grouped within a named data set.

    Field Group /wiki/spaces/DEVSCAFC/pages/1534297985

    • acts as a bucket of Field macros to be easily referred to later. The name field is required.

    • acts as the main macro to do Structure editing. Field group name is required.

    Repeating Data

    Label Options

    Creates a list of labels to attach to the current page.

    Must be contained inside a List Data macro.Labels List

    /wiki/spaces/DEVSCAFC/pages/1534559026

    • the name field is required

    • must be contained inside a List Data macro

    • accepted parameter: Labels

    You can add labels which are currently being used in the Confluence instance by selecting them from the dropdown list.

    You can also add new labels to the list by typing or pasting them in.

    List Data

    Allows selection of one or more options from a specific list.

    Must contain option-generating sub-macros, for example  List Option, Content Options,  User Options,  Attachment Options or  Label Options.

    Available as a combination of 

    • define output to be a dropdown list. Requires other Field macros to work

    • dropdown settings are defined here, such as Required, Allow multiple, Separator, etc.

    • list data that contains multiple types of options
      Image RemovedImage Added

    • all dropdown macros are called individually depending on their function

    • allow Multiple and Required setting is set in each individual macros

    Note

    Unsupported server scenarios upon migration.

    • in cloud, the type of options is its own separate macros and therefore cannot be combined. 

    • if this scenario happens, only the topmost option will be migrated. In this example, only User Options will be migrated to cloud.

    List Option

    Generates a single, simple, list option.

    Must be contained inside a  List Data  macro.Dropdown List

    /wiki/spaces/DEVSCAFC/pages/1534264104

    • accepts text value in the dropdown options, can be modified to output other rich text formats such as Status or Emojis

    • have sorting mechanism

    • accepts custom texts (that may contain emoji) or Statuses as value and output of the dropdown list.

    Live Template 

    Anchor
    MacroDiff_LiveTemplate
    MacroDiff_LiveTemplate

    Live Templates use either Confluence Global templates, Space templates or even other regular Confluence pages as templates. Live Template

    /wiki/spaces/DEVSCAFC/pages/1534558873

    • accepts Page, Space or Global Templates, and Scaffolding Blueprint as templates

    • location of pages are assigned manually with the following format (SPACEKEY:Page_Title)

    • accepts Page, Space, or Global Templates, and any Confluence Blueprint as templates

    • location of Page/Template/Blueprint is chosen from a dropdown field. Space name and Page name field are separated

    Note

    Unsupported server scenarios upon migration

    Find Limitations at Limitation for Live Template in Confluence Cloud

    Expand
    titleClick here to expand for more details...
    Include Page
    SCAFS:Limitation for Live Template in Confluence Cloud
    SCAFS:Limitation for Live Template in Confluence Cloud

    Number Data

    Allows editing of numbers in either a text box or a list item.

    Number /wiki/spaces/DEVSCAFC/pages/1534624873

    • accepts decimal, minValue, maxValue, format display, etc as filter criteria for the number value

    • does not have further criteria for the number value

    Repeating Data

    Allows the dynamic addition and deletion of repeating sections.

    /wiki/spaces/DEVSCAFC/pages/1534329704

    • accepts Initial Rows and Order as parameters for the repeating data

    • does not take any further parameters

    Info

    Partially available migration, introduced in Scaffolding 8.30.0 and 9.1.0.

    During the migration, the Repeating Data macro converts to a one-column Table field within a Field Group macro. The heading of the resulting table column is empty. In the Field Group macro editor, you can edit the Table field to add a heading to the column.

    Note

    Due to the architectural differences between Confluence Data Center and Confluence Cloud, there are some unavailable migration scenarios.

    • A Repeating Data macro cannot be nested inside another macro. A Repeating Data macro must be at the root level of the page structure.

    • A Repeating Data macro cannot contain a nested:

      • Repeating Data macro

      • Table Data macro

      • Live Template macro

      • Non-migratable Scaffolding macro - an Eval Data, Excerpt Data, Get Data, Hidden Data, or Set Data macro.

      • Non-Scaffolding third-party macro.

      • Confluence macros, including a Confluence table

    • A Repeating Data macro can contain only migratable Scaffolding macros - Attachment Data, Attachment Options, Content Options, Date Data, Group Data, Label Options, List Data, List Option, Number Data, Text Data, and User Options.

    Table Data

    Allows dynamic addition or deletion of rows in a table.

    Table Field 

    		accepts initialRows and order 

    /wiki/spaces/DEVSCAFC/pages/1534329704

    • accepts Initial Rows and Order as parameters for the Table table data

    • does not take any further parameters

    Note

    Unsupported server data center scenarios upon migration.:

    • nesting table data does not work in Cloud

      • in server the following table appears as a nested table 
        Image RemovedImage Added

      • Confluence Cloud does not support nested macro related functions.

      • If this scenario happens, the data inside the table will not be migrated. I.e Agenda, Notes, Status, and Actions column will not be migrated.

    Text Data

    Allows editing of free text data. 

    Short Text, Paragraph /wiki/spaces/DEVSCAFC/pages/1534788366, /wiki/spaces/DEVSCAFC/pages/1534329599

    • accepts area, line, or password as Type, and richtext, text, etc as the content type

    • accepts language, minLength, maxLength, etc as parameters for the Text data

    Info

    Text input is divided into short text and paragraph. The paragraph macro accepts rich text while short text accepts the shorter length of texts

    • text data: accepts Placeholder to help users input their data

    • paragraph: does not take any further parameter

    • migrating text data with type area will be migrated as paragraph while type line and password will be migrated as text data

    Note

    Unsupported server scenarios upon migration.

    • text data with type Password will be migrated as Short Text macro and will not have masked view on page view

    • rich Text content is only partially supported

    User Options

    Creates a set of list options linking to users matching the filter options. Must  Must be contained inside a List Data macro. User List

    /wiki/spaces/DEVSCAFC/pages/1534755224

    • accepts groups, spaces, users etc , to scope the list of users as options

    • accepts user groups to scope the list of users as options