Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

Configuring the Attach content control

Updated on December 13, 2022
Applicable to Theme Cosmos applications

Help users attach content to forms by configuring the Attach content control. For example, with this control, users can conveniently upload documents for review, or upload a photo to endorse a claim.

Note: Offline-enabled applications also support the Attach content control. For more information, see Attach content support in offline mode.
Before you begin: Add the Attach content control to a layout. For more information, see Adding UI components to a view.
  1. Open the view with the control that you want to edit.
    For more information, see Accessing views in your application.
  2. In the configuration pane on the right side of the window, hover over the control, and then click the Edit icon.
  3. On the General tab, configure the display settings for the control:
    1. In the Displayed as list, specify whether to display the control as a button, link, or icon.
    2. In the Button caption list, specify the button caption as text or a property reference.
    3. In the Text field, enter a label for the control.
    4. In the Image source list, specify the source of the image that you want to use for the control as either a simple image, property, icon class, or none.
    5. In the Helper text list, specify whether to display a tooltip at run time.
    6. In the Visibility list, choose when you want to display the control.
      For example: For example, you can make visibility dependent on a when rule.
    7. In the Disable list, specify when the control is not editable.
      For example: For example, you can make the control editable based on an expression.
    8. In the Privilege field, press the Down arrow key, and then select a value to authorize specific users to view the control.
  4. Configure attachment settings for the control:
    1. In the File name list, specify whether to use the default file name, or a name based on text or a property reference.
    2. In the Category list, select the File category, or a category based on a property reference.
    3. In the Attach to list, specify whether to attach the file to a work item or a page.
  5. Optional: To configure attachment compression parameters for mobile apps, modify the preset parameter values. For more information, see Configuring file size options for the Attach content control.
  6. On the Presentation tab, in the Control format list, specify a new format for the control.
    For example: Strong format adds boldface to the caption on the button, for greater visibility of the control.
  7. Optional: To set the control button as a floating action button, select the Set as Floating Action Button (FAB) check box.
  8. Set the label value for the control:
    1. Select the Include a label check box.
    2. In the Label value field, press the Down arrow key, and then select a value.
    3. In the Label format field, press the Down arrow key, and then select a value.
  9. Optional: To customize how the control is displayed to users, expand the Advanced Presentation Options section, and then configure the fields.
  10. Optional: To add one or more action sets to the control, above the General and Presentation tabs, click the Add action sets button, and then click the Create an action set button to enter the configuration pane. For more information, see Adding action sets to a control
  11. In the upper-right corner of the Attach content tab, click Apply.
What to do next: Configure the remaining settings. For more information, see Configuring common control settings.
  • Configuring file size options for the Attach content control

    Improve data transfer times by limiting the maximum size of images and videos that users of mobile applications attach to cases. For example, you can conserve bandwidth when a mobile app synchronizes with the server by adjusting the attachment compression parameters, such as the video clip format and duration, or the maximum image size and quality.

Related articles

SectionsHarnessesAdding custom attributes for version 1 DX API to auto-generated controls

Tags

Pega Platform 8.6 User Experience

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Visit the Support Center

Did you find this content helpful?

Yes
No

Want to help us improve this content?
Suggest an edit

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us