Page History

The Summary widget is used in approval forms. It is used to reduce the number of actions and the time required to get acquainted with the subject of approval. But it can also be added to other forms.

To display summary of records, you need to add the widget to a form layout and configure option schema.

*скрин примера виджета на форме

Add a widget to a form layout

Before adding the widget to a form, check that you can add it to the necessary table. To do this, complete the following steps:

1. Navigate to Portal Structure → Widgets.
2. Find the Summary widget record.
3. Check whether the Tables field refers to the necessary table. 
   • If not, select the table you need to add the widget to.
4. Click Save or Save and Exit.

To add the widget on forms, complete the following steps:

1. Navigate to any table record you need to add the widget.
2. In the hamburger menu, select Configure → Form → Layout.
3. Move the Summary widget from the Available box to the Selected box.

   • You can configure the option schema to override default widget settings. Learn how to do it below.

4. Click Save to apply the changes.

"tableId": "",
"isPortal": false,
"viewName": "",
"columnName": "item",
"columnType": "Document ID",
"widgetName": "Summary",
"isShowEmptyField": true,
"isShowRemAttribute": true

Configure the options schema

Use the Widget Instance window to specify the widget options. Click the widget while configuring the layout to call this window.

In the window, fill in the Schema Option Values field. Enter the widget options in JSON format. If you leave the field empty, the default values will be applied.

1. Define a

table on which to display the widget

2. reference to a record. Specify a column name and its type:
   

   Code Block
   {      "columnName": "column_name" "

tableId

3. columnType": "

table

4. column_

id

5. type.title" }

Add the widget to the portal forms

6. 
   

   • If the column type is Reference, specify the table to which the column refers to:
     

     Code Block
     {

 
   

8. • "

isPortal

9. • tableId": "

true

10. • table_id" }

      
      

11. Define a configured view name with a specific set of fieldsEnable the portal style for the widget:
    

    Code Block
    {      "viewNameisPortal": "view.titletrue" }

    
    

12. Define a

reference to a record. Specify a column name and its type

13. configured view name with a specific set of fields:
    

    Code Block
    {      "

columnName

14. viewName": "

column

15. view_name

" "columnType": "column_type.title

16. " }

    
    

17. Change the default title of the widget by defining the new one: 
    

    Code Block
    {      "widgetName": "Title" }

    
    

    Tip
    It is better to use a title created in the Source Message (source_message) table, so that it has translations.

    
    

18. Exclude empty fields not to display in the widget:
    

    Code Block
    {      "isShowEmptyField": "false" }

    
    

19. Exclude REM attributes not to display in the widget:
    

    Code Block
    {      "isShowRemAttribute": "false" }