Toggle menu

Copy, Create, Edit, Delete and Export Forms

This article describes the basic actions available when you are working with forms. For a detailed guide to using the Forms Designer, see Using the Forms Designer.

Copy a Form

Copying an existing form can be a useful way to try out changes while leaving the existing form in place.

To copy a form, right-click on it and select "Copy this form". A copy will open in the Forms Designer. The name and description of your copy will include the word "copy" and should be updated before you publish your form.

Your copy will be created in the same form group as the original.

Creating and Editing Forms

To create a new form, right-click on an existing group and select "Create a form". To edit an existing form, double-click on it.

The "Create a form" menu has four options, one for each of the different form types. If your form is going to be published on your site, or used in an iCM Form App, select "Public form".

Private forms are only used within iCM as article extras or for subsite configuration.

Blueprints and snippets are described Form Blueprints, Snippets and Smart Snippets.

Form Properties

These properties are found on the "Text" tab of the Forms Designer.

Text PropertyDescription
Form nameEvery form must have a name and every name must be unique. Form names must begin with a letter. The names of published forms cannot be edited. It is possible to unpublish a form and then edit its name.

Care should be taken when renaming a form. If an existing form has saved form submissions (form data) to the iCM database, renaming the from will not rename that saved data, so it could become orphaned
Form descriptionThe description is displayed around iCM, in the explorer menu, search results and article related content tab. It may also appear on your website in some circumstances
External typeExternal types are an advanced feature of the Forms Designer. They allow multiple forms to write data to the same underlying object definitions, which are used when the form saves its data as an iCM object.

For most forms, this field should be left blank so that the form creates its own object type definition. See Forms and External Type Definitions for more information
Access typeEither Public or Private, depending upon the type of form you are creating. Once a form has been saved, even if only as work in progress, its access type can't be changed. If you do need to change the access type, you can make a copy of the form and change it prior to saving.
FamilyThe form family this form is using. The current GOSS-developed family is called DEFAULTV2. If you have developed your own form family, select it from the drop-down. This drop-down lists all form families found in the iCM form family definitions

These properties are found on the "Properties" tab of the Forms Designer.

PropertyDescription
Parent groupThe group this form is in. Use the "Select" button to pick a new group and move the form
Created/Created byWho created this form and when
Last Modified/Modified byWho last edited this form and when
Last Published/Published byWho last published this form and when
Live Form IDAll forms have two IDs. The live form ID identifies the published form when it is used on your website (the standard ID, visible in the top right of the Forms Designer) is only used within iCM
Unpublished changesEither "Yes" or "No" if there are changes to the form that have not yet been published

Form Design

The design tab of a form is the work area where you build your form. It is described in full in Using the Forms Designer.

Deleting a Form

To delete a form, right-click on it and choose "Delete this form". If the form that is about to be deleted is being used (ie related to an article or used in an iCM Form App) you'll see a warning which lists the items using it.

Deleted forms can be restored using Form Version History.

If you delete a form that has written data to the iCM database (using the "Database Save" form action), the saved data is not deleted when the form is. Saved data will become orphaned and inaccessible if you delete the form that created it. You may want to delete the data first, using the Form Data Browser, or create a second form to view the data.

Exporting a Form

To export a form, right-click on it and choose "Export this form". Exported forms can be imported into another iCM, but should not be imported into an iCM with a lower release version than the one they were created in.

When you export a form it's parent group structure is exported too. This structure can be maintained when you perform an import.

Last modified on May 11, 2023

Share this page

Facebook icon Twitter icon email icon

Print

print icon