12.1.2.1.1.33. User Signature

With the user signature control, user signatures can be dynamically displayed on forms.

*User signatures are set up in the Users tab of the Organization Management (Admin) application.

When a user signature control is selected in the design environment, its associated properties are displayed in the Control Properties panel.

*To access the Control Behavior category, users must first create the form behavior.

1. Binding: In this category, users can link a control to its corresponding attribute.
   • Attribute: This field allows users to select the attribute associated to the control.
     • To access the list of relevant attributes, click on the ellipses () inside the field.
       

       **In the Object Browser window, users can access a list of the associated entity’s attributes—specifically, the attributes relevant to the control. To select an attribute, either click on the Select button or double-click on the entry from the list.

     • Once an attribute has been selected, it will populate the Attribute field.
       

!To enable user signature controls to retrieve and display user signatures in the system, a reference attribute must be created linking the control to all user accounts in the database. For more information on creating this type of attribute, click here.

2. Name: In this category, users can access basic properties required for the control’s identification and proper referencing in the code.
   • Control Type: This field displays the control type. It cannot be modified.
   • Server ID: This is a text field that allows users to input the Server ID for the control.
     • Server ID refers to the name used to call the control in the code.
3. Control Behavior: In this category, users can configure the behavior of the control and define how it interacts with the form or application.

   • User Signature Initial Value

     An option for the user signature control is to set the initial value to the current user’s signature. This means that when the form is opened, the control will automatically display the signature for the user associated with the current session.
     

   • For more information on these properties and how to configure them, click here.

     !!Please note that the linked section contains information on control governance properties that are not applicable to user signature controls and can be disregarded.

4. Appearance: In this category, users can customize the visual appearance of the control.
   • Height: This is a numeric updown field that allows users to set the height of the control.
     • By default, the height is set to 128. To adjust this size, users can enter numbers into the field either manually or by clicking the increment/decrement arrows.
5. Misc: In this category, users can define additional properties for the control.
   • Location: This is a single-select dropdown field that allows users to choose the location of the control.
     • Location Options: Right, Center, or Left.
       • Right: This option places the control on the right-hand side of the screen.
       • Center: This option centers the control in the middle of the screen.
       • Left: This option places the control on the left-hand side of the screen.

User Signature Control Preview: Web View

• If the initial value is set to the current user’s signature, the user signature control will function in the following manner:
• If the user signature is instead set to be dependent on another control, such as a dropdown, its function will vary based on the user’s selection.