# Report widgets for the Incoming Payments workspace

> [HTML Version](income-reports-widgets.html)

The [Incoming Payments](cash-flow.md) workspace includes preconfigured pages with the [All Incoming Payments](income-report.md) and [My Incoming Payments](my-incomes-report.md) reports. They consist of separate [tabs](tabs.md) and widgets.

You can configure these pages to meet your company’s specific requirements. For example, you can change widget settings, delete widgets, and use them multiple times to display different data. You can also add other system widgets to the report page. 

The **All Incoming Payments** and **My Incoming Payments **reports include the following widgets: 

- [Revenue Items](#income-items). 

- [Estimated and Received Payments](#plan-fact). 

- [My Incoming Payments](#my-incomes). 

- [Receipts](#incomes). 

- [Distribute Sales Goals](#goals).   

These widgets can be reconfigured and added to other system pages. 

````
Начало внимание

````
Only users of the [Administrators](360006871932.md#administrators) group can change the pages with the reports and set up the widgets.

````
Конец внимание 

## ````
Configure the report page 

To change the current settings, follow these steps: 

1. Go to the **Incoming Payments** workspace and in the left menu, select **All Incoming Payments** or **My Incoming Payments** page.

2. Click the gear icon next to the page name and select the **Widget Builder **option.

3. In the opened [interface designer](interface_designer.md), select the required tab: **Metrics**/**My Metrics**, **Incoming Payments** or **Sales Goals**.

You can configure properties that control data filtering in reports, as well as widgets.

(income-reports-widgets-1.png)

4. Select a widget and click the gear icon next to its name. 

5. In the window that opens, you can change the following settings: 

- Fields defined by default and required to build the report correctly. 

- Options that define how the built graphs and lists look like.  

The options in preconfigured widget settings are linked to variables added to the widget context by default. Variable values depend on the data specified in the corresponding filters when the report is built. 

You can change the settings by selecting other variables that were manually added in the interface designer on the [Context](designer-tabs.md#context-tab) tab. To do this, click the field value and select a property from the list. Data type requirements for the variables of each widget are provided below.

6. To finish configuring the widget, click **Save**.

7. To make the configured page available to users, click **Save** and **Publish** on the top toolbar of the interface designer.

Let’s take a closer look at the widgets that make up the report pages.

### Revenue Items widget

The widget is placed on the [All Incoming Payments](income-report.md#incomes-data) and [My Incoming Payments](my-incomes-report.md#my-incomes-data) pages on the **Metrics** and **My Metrics **tabs. It displays the number of estimated or received payments grouped by revenue item. 

For example, using this widget on the **All Incoming Payments** page, a sales rep can see which revenue item the selected sales team used most often for transactions in the current month.

(income-reports-widgets-2.png)

- **Show\***. This option is linked to the **Build Metrics Report** variable of the [Yes/No switch](360009707032.md#yes-no-switch) type. When the user clicks the **Build Report** button on the report page, the variable value changes, and the widget automatically displays statistics based on the parameters specified in the filters. 

- **Show only current user's performance indicators**. This option builds the chart using the current employee’s data. 

- **Assigned to**. This option is linked to a variable of the [Users](360009707032.md#users) type. When a sales rep fills in the **Assigned to** filter on the report page and clicks **Build Report**, the variable value changes. The widget automatically displays statistics for the selected employees. 

In the settings of widgets placed on the **My Incoming Payments** page, the **Assigned to** field can be left empty.

- **Start of the period**, **End of the period**. These options are linked to variables of the [Date/time](360009707032.md#date-time) type. 

- **Sales team**, **Responsibility center**, **Revenue item**. These options are linked to variables of the [App](app-data-type.md) type which reference the [Sales Teams](crm_objects.md), [Responsibility Centers](cash-flow-items.md) and [Revenue Items](cash-flow-items.md) apps. 

- **Contractor**. This option is linked to a variable of the [App](app-data-type.md) type which reference the [Companies](360012584980.md) app in the **CRM **workspace.

- **Payment status**. This option is linked to a variable of the [Category](360009707032.md#category) type which contains two values: **Received** with the `received` code and **Not received** with the `missed` code.

### Estimated and Received Payments widget 

The widget is placed on the [All Incoming Payments](income-report.md#incomes-data) and [My Incoming Payments](my-incomes-report.md#my-incomes-data) pages on the **Metrics** and **My Metrics **tabs. This widget displays a chart comparing scheduled payments with received payments. Statistics for the entire specified period can be displayed by day, week, or month. 

(income-reports-widgets-3.png)

The data type requirements for this widget’s variables are the same as those described for the [Revenue Items](#income-items) widget.

### My Incoming Payments widget 

The widget is placed on the [My Incoming Payments](my-incomes-report.md#my-incomes-data) page on the **My Metrics **tab. It displays a report for the current employee showing target, planned, and actual amounts. Based on a comparison of these figures, the widget calculates and displays the percentage of completion for both the plan and the current target. It also shows the current status of the target and the remaining income amount needed to achieve it.

- **Show\***. This option is linked to the **Build Metrics Report** variable of the [Yes/No switch](360009707032.md#yes-no-switch) type. When the user clicks the **Build Report** button on the report page, the variable value changes, and the widget automatically displays statistics based on the parameters specified in the filters. 

- **Start of the period**, **End of the period**. These options are linked to variables of the [Date/time](360009707032.md#date-time) type.

### Receipts widget 

The widget is placed on the [All Incoming Payments](income-report.md#all-incomes) and [My Incoming Payments](my-incomes-report.md#my-incomes) page on the **Receipts **tab. It is a table of estimated and received payments from contractors. You can filter data in the table and create new received payments without opening the [Register of Incoming Payments](income-register.md) app.

Note that the widget can also be added to the forms of payment allocation apps. In this case, the widget uses a different set of settings. For more information, see [Receipts](income-widget.md).

Settings of the widget added to the page:

(income-reports-widgets-5.png)

- **Payment allocation\***. The field automatically contains the **Register of Incoming Payments** app used as the data source for the report. 

- **Show properties\***. Select the fields from the **Register of Incoming Payments** app that you want to display in the widget table. Fields selected by default cannot be removed from the table, for example: **Payment allocation**,** Name**, **Scheduled payment date**, **Payment amount**.

- **Filter fields**. Select the fields from the **Register of Incoming Payments** app that you want to use to filter data in the table. The **Actual payment date** and **Status** fields cannot be removed from the filter.

- **Show in summary row**. Select the fields from the **Register of Incoming Payments** app for which total amounts will be displayed at the bottom of the table. By default, the **Received payment** and **Payment amount **fields are set by default. You can add custom fields of the **Number** and **Money **types.

- **Only show incoming payments on the current user**. Enable this option to let users view only the payments for which they are responsible in the table.

### Distribute Sales Goals widget 

The widget is placed on the [Incoming Payments](income-report.md#all-incomes) and [My Incoming Payments](my-incomes-report.md#my-incomes) page on the **Sales Goals **tab. It displays a table with income targets and planned and actual payment data. Target completion percentages are calculated based on a comparison of these indicators. 

Users with [permission to create and edit](360007527512.md) items of the [Sales Goals](sales-goals.md) app can add new goals or edit existing ones directly in the table. 

(income-reports-widgets-6.png)

Enable the **Show data for the current user only\*** option to let users view only the targets for which they are responsible in the table.

## Settings on the Events and System tabs

These tabs are the same for all widgets and contain system settings. They let you control widget visibility and access, configure widget behavior when the pointer hovers over it, and more. For more information, see [System widget settings](common_widget_settings.md).