User Manual

Month Picker Usage Scenario

Month Picker Usage Scenario

Kuika's Month Picker element allows users to select only the month. Users can either enter the month manually or select it using the month picker. This element is ideal for month-based planning, reporting, and filtering operations.

The Month Picker element is only supported in web applications.

Usage Areas

  • Filtering monthly sales reports,
  • Calendar-based task planning,
  • Selecting subscription start and end months,
  • Monthly KPI or performance tracking, etc.

Monthly Sales Report Selection

Static Usage Scenario – Fixed Month Selection

A fixed month is assigned to the user on a sales reporting screen. For example, the system may display September 2023 by default.

Using the Features

  • Value → 2023-10 (October 2023)
  • Placeholder → “Select Month”
  • Allow Clear → The user can clear the selection with the (X) icon if desired.
  • Disable Before Date → If, for example, 2023-01 is entered, months prior to January 2023 cannot be selected.

When the Scenario Step is Complete

  • The user is assigned September 2023 by default.
  • The selected month appears on the screen in YYYY-MM format (e.g., 2023-10).
  • If desired, the user can clear the selection by clicking the (X) icon.
  • Since past months are disabled, the user can only see months from 2023 onwards.

Dynamic Usage Scenario – Monthly Sales Report

On a sales reporting screen, the user selects the month for which they want to receive a report. This information links to monthly sales data from the database or API.

Connecting the Data Source

  • Go to the Datasources module.
  • Then click the + icon next to the Tables heading and name the table “SalesData”.
  • Create the following table.
  • Then click SQL Actions and name the action “SalesData”. You can also create it with C#.
  • Enter the following SQL command.
SELECT2025-07AS SalesMonth, 1200 AS SalesCount, 150000.00 AS SalesRevenueUNION ALLSELECT ‘2025-08’, 1400, 170000.00UNION ALLSELECT ‘2025-09’, 1600, 200000.00

UI Design Module operations

  • Click the Add Action button on the right side of the application screen.
  • Then select Custom > SalesData.

Using the Properties

  • Value → SalesData.SalesMonth (connected from the Symbol Picker)
  • Placeholder → “Select Month”
  • Allow Clear → The user can clear their selection.
  • Disable Before Date → For example, if 2025-01 is entered, months before January 2025 cannot be selected.

When the Scenario Step is Complete

  • The user selects the desired month from the pop-up window.
  • The selected month appears on the screen in YYYY-MM format (e.g., 2025-09).
  • The user can clear it by clicking the (X) icon if desired.
  • The system links the selected month to the SalesData.SalesMonth column and retrieves the relevant sales reports.
  • Past months are disabled; only current and future months can be selected.

Limitations

  • Only available in web applications.
  • The format is limited to month/year information only (days cannot be selected).

Tips and Best Practices

  • In reporting scenarios, set the default value to the current month.
  • To enhance user experience, make the Placeholder value descriptive (e.g., “Select Report Month”).
  • For performance, disable unnecessary month ranges using Disable Before Date.
No items found.

Other Related Content

No items found.

Glossary

No items found.

Alt Başlıklar