Overview
This n8n node, Fproject, retrieves KPI (Key Performance Indicator) data for a specified month and year from the Fproject system. It fetches a KPI report, processes the results for a predefined list of users, and outputs their performance metrics. This node is useful for automating the extraction and evaluation of team member KPIs, enabling integration with dashboards, notifications, or further workflow automation.
Practical examples:
- Automatically collect monthly KPI scores for your development team.
- Trigger alerts if a user's performance does not meet expectations.
- Aggregate KPI data for reporting or visualization in other tools.
Properties
| Name | Meaning |
|---|---|
| Month | The month for which to retrieve KPI data (required). |
| Year | The year for which to retrieve KPI data (required). |
Output
The node outputs an array of objects, each representing a user’s KPI summary for the selected period. Each object contains:
{
"name": "<username>",
"currentPoint": <number>, // The user's total KPI points for the period
"performancePoint": "<percent>%", // The user's performance as a percentage of the target
"performanceResult": "OK" | "NOT OK" // Whether the user's performance meets the expected threshold
}
name: Username (in lowercase).currentPoint: Numeric value of the user's total KPI points.performancePoint: Percentage string showing how close the user is to the target.performanceResult: "OK" if the user meets/exceeds the current month's progress threshold, otherwise "NOT OK".
Dependencies
- External Service: Requires access to the Fproject system at
http://fproject.fpt.vn/userskpi. - Authentication: Uses hardcoded session cookies and Basic Auth credentials in the request headers.
- n8n Configuration: No special configuration required, but network access to the Fproject endpoint is necessary.
Troubleshooting
Common issues:
- Invalid Credentials: If the session cookie or Basic Auth credentials are invalid or expired, the node will fail to fetch data.
- Network Errors: If n8n cannot reach the Fproject server, the node will throw connection errors.
- Unexpected Data Format: If the HTML table structure changes on the Fproject site, parsing may fail or return incorrect results.
- User Not Found: Only users in the predefined list are processed; others are ignored.
Error messages and resolutions:
- "responseData undefined or empty" – Check network connectivity and authentication details.
- "Cannot read property 'forEach' of undefined" – The expected table was not found in the response; verify that the Fproject page structure has not changed.