# Resource Management: Charts (cf.cplace.resourceManagement.resourceManagementChart)

## Overview

The Resource Management: Charts app enables you to create custom charts for the "Resource Planner" widget. These charts can then be selected in the Resource Planner widget to provide custom visualizations of resource allocation and utilization data.

This app provides a configuration type for defining chart visualizations using cplaceJS scripts, which are then rendered within the Resource Planner widget from the base Resource Management app.

## Dependencies

| App | Qualified Name | Auto-Installed |
|-----|----------------|----------------|
| cplace Basis | `cf.cplace.platform` | Yes (always present) |

**Note:** This app has no additional dependencies beyond the platform. However, it is designed to work **in conjunction with** the Resource Management app (`cf.cplace.resourceManagement`), which provides the Resource Planner widget where these charts are displayed.

## Types Provided

### cf.cplace.resourceManagement.chart (Chart)

A configuration type for defining custom chart visualizations that can be selected and displayed within the Resource Planner widget.

| Attribute | Internal Name | Type | Required | Description |
|-----------|---------------|------|----------|-------------|
| Order | `cf.cplace.resourceManagement.order` | Number | No | Determines the display order of charts in the Resource Planner widget selection |
| Activated | `cf.cplace.resourceManagement.isActive` | Boolean | Yes | If activated, the chart is available in the "Resource Planner" widget |
| Script | `cf.cplace.resourceManagement.script` | Text (cplaceJS) | No | The cplaceJS script that generates the chart visualization |

**Type Properties:**
- Icon: `fa-chart-bar`
- Names are unique: Yes
- Show in Explorer: No
- Show in Global Search: Yes

## Widgets Provided

This app does **not** provide any widgets directly. The charts defined using this app's type are rendered within the **Resource Planner** widget (`cf.cplace.resourceManagement.resourcePlannerDefinition`), which is provided by the base Resource Management app (`cf.cplace.resourceManagement`).

## Usage Notes

### When to Use This App

- When you need custom chart visualizations in the Resource Planner widget
- When the standard Resource Planner visualizations do not meet your requirements
- When you want to provide multiple chart options for users to select from

### Typical Usage Pattern

1. Install both the Resource Management app (`cf.cplace.resourceManagement`) and this Charts app
2. Create Chart pages with cplaceJS scripts that define your visualizations
3. Set the "Activated" attribute to true for charts you want to make available
4. Use the "Order" attribute to control the selection order in the Resource Planner widget
5. Configure the Resource Planner widget to allow users to select from available charts

### Relationship to Resource Management App

This app is a **companion app** to Resource Management (`cf.cplace.resourceManagement`). While it can be installed independently, its functionality is only useful when combined with the base Resource Management app, which provides:
- The Resource Planner widget where charts are displayed
- The resource allocation data model that charts visualize

### Script Development

The Script attribute accepts cplaceJS code that generates chart configurations. Refer to the cplace Low-Code documentation for details on:
- Chart APIs available in cplaceJS
- Accessing resource allocation data
- Supported chart types and configurations

## Investigation Details

- **Investigation Date:** 2026-02-02
- **Investigation Workspace:** `[App Investigation] cf.cplace.resourceManagement.resourceManagementChart`
- **Workspace ID:** `kaixv5s7w1nhym4xh3ar3gqpv`