Add data point to Bar chart

Function: Add data point to Bar chart

This function allows you to dynamically update a Bar chart on your application screen by adding new data points. It's useful for visualizing data that changes over time or based on user interactions, without needing to refresh the entire chart. This action helps keep your charts current and responsive to new information.

Input

• Bar chart ui element: This is the specific Bar chart component on your application page where you want to add the data point. You select this directly from your user interface.
• Code: This is a unique identifier (a piece of text) for a specific set of data within your chosen Bar chart. For example, it could be a product name, a region, or a team member's name. If a dataset with this code already exists in the chart, the new data point will be added to it. If not, a new dataset will be created using this code, and the data point will be added there.
• Point: This is the actual data value you want to add. It can be a number, a label, or any piece of text that represents a data point for your chart.

Output

This function does not return a specific value. Instead, it directly updates the specified Bar chart on your application screen, adding the new data point to the relevant dataset and refreshing the chart's display.

Execution Flow

Real-Life Examples

Example 1: Tracking Daily Sales for a New Product

• Scenario: You have a Bar chart displaying daily sales for different product categories. A new product line just launched, and you want to add its first day's sales figure to the chart.
• Inputs:
  • Bar chart ui element: Product Sales Dashboard (the Bar chart component on your sales overview page)
  • Code: New Gadget Pro (the identifier for the new product line's sales data)
  • Point: 750 (the sales figure for the new gadget today)
• Result: The "Product Sales Dashboard" chart will be updated. A new bar representing "New Gadget Pro" with a value of 750 will appear on the chart, showing its initial sales performance.

Example 2: Monitoring Website Sign-ups by Region

• Scenario: Your website has a Bar chart showing the number of new user sign-ups from various geographical regions. A new marketing campaign in a specific region just started, and you want to add the first batch of sign-ups.
• Inputs:
  • Bar chart ui element: User Sign-ups by Region (the Bar chart showing regional sign-up breakdown)
  • Code: Europe - West (the identifier for sign-ups from Western Europe)
  • Point: 320 (the number of new sign-ups from Western Europe today)
• Result: The "User Sign-ups by Region" chart will update. A new bar or an updated bar for "Europe - West" will appear, showing 320 new sign-ups, providing an immediate visual update of the campaign's impact.

Example 3: Project Task Completion Status for a Team Member

• Scenario: You are managing a project and have a Bar chart visualizing the number of completed tasks per team member. As a team member finishes a task, you want to update their progress in real-time on the chart.
• Inputs:
  • Bar chart ui element: Team Task Progress (the Bar chart showing tasks completed by each team member)
  • Code: John Doe (the team member's name)
  • Point: 1 (representing one task completed by John Doe)
• Result: The "Team Task Progress" chart will update. If "John Doe" is a new team member on the chart, a new bar for him will appear with a value of 1. If "John Doe" already has a bar, its value will be updated to reflect the newly completed task (e.g., if it was 5, it might become 6, or if the chart is configured for single values, it might replace the previous value).