Creating alternative forms for page types

The alternative forms allow you to create alternative representations of existing forms, which you can then use in different situations. You will find more information in Creating alternative forms. In Code names of automatically used alternative forms, you can learn about special code names of alternative forms. If you create an alternative form with one of these names, it will be used automatically in the given situation.

You can also create alternative forms for other objects in the following Forms application and in the Custom tables application:

This example will show you how to create an alternative form for the File page type and use it in a properties dialog.

Adding an alternative form

In this example, you modify the field displayed in the Properties dialog used with the Document library web part. For this purpose, you can create an alternative form of the File page type and modify its fields.

1. Open the Page types application.
2. Edit () the File page type.
3. Switch to the Alternative forms tab.
4. Click Create new form.
5. Type the name of the new form.
6. Click Save.

The system creates a new alternative form.

Configuring the alternative form

After you create an alternative form, you can change its fields using the field editor.

1. Switch to the Fields tab.
2. Modify the fields as you desire. For example:

   1. Select the FileAttachment field.

   2. Disable the Display field in the editing form check-box.

      

   3. Click Save.

   4. Select the FileDescription field.

   5. Change the Form control type to Text box.

   6. Click Save.

The alternative form is ready to be used.

Using the alternative form on the live site

You can use the alternative form to change the appearance of the Properties dialog used with the Document library web part.

1. Open the Pages application.

2. Place the Document library web part.

   1. You can also use the example on the Corporate site -> Examples -> Web parts -> Document library -> Document library page.

3. Switch to the Design tab.

4. Configure the Document library web part.

   

5. Click Select next to the Document form field.

6. Choose the CMS.File class and the alternative form you have created and click Select.

   

7. Click Save & Close.

If you now click (...) next to a file and select Properties, the system displays the Properties dialog without the file selection field.