ACAP 2.0 Cropping Calendar
Introduction
This section describes methods for uploading cropping calendars for the latest ACAP 2.0, whose latest stable version is Release/Tag version v10.1.0-alpha.10,Ā accessible in theĀ acap-v2Ā repository.
Follow thisĀ link to view cropping calendar upload instructions for the older ACAP 1.0.
Data Format
The latest updates for ACAP 2.1, starting with @commit 95a97cd in the acap-v2 dev branch, use a new Cropping Calendar Excel template different from the ones mentioned on this page.
These Cropping Calendars are only compatible up to @commit ee49568 in the acap-v2 dev branch.
Kindly chat the ACAP group chat for more information about the new Cropping Calendar Excel file for ACAP 2.1. Alternatively, you may use the temporary workaround (opens in a new tab) until a final update to ACAP's ongoing items (opens in a new tab) becomes available.
ACAP 2.0 uses cropping calendars with two (2) groups/rows of crop stages for each municipality supporting one (1) or more types of crops. View its raw EXCEL data files in the /server/src/scripts/data/dataset_v2.0 directory for more information about its contents and data structure.
- rice_cropping_calendar.xlsx
- corn_cropping_calendar.xlsx
Crop Stage Codes and Labels
This section only displays the ACAP 2.0 crop stage codes and labels for the Rice and Corn crops.
The crop stage codes should match those defined in the ACAP 2.0 crop recommendations raw Excel files crop stage labels specific to target crops to ensure the correct association of crop stages with target recommendations.
Support for Multiple Crops
Developers can add crop stages and labels for other crops, following the crop stages code and label format in theĀ /client/src/utils/constants.jsĀ file and by creating cropping calendars similar to the sample cropping calendar Excel files described in theĀ Data FormatĀ section as a reference.
Rice
| Crop Stage Code | Crop Stage Label |
|---|---|
| prep | Preparation Stage |
| seed | Seedling Stage |
| plant | Newly Planted |
| vegat | Vegetative (Active Tillering) |
| vegpi | Reproductive (Panicle Initiation) |
| repro | Reproductive (Flowering) |
| mat | Maturing |
Corn
| Crop Stage Code | Crop Stage Label |
|---|---|
| prep | Preparation Stage |
| seed | Seedling Stage |
| vegleaf | Vegetative (Leaf Stages) |
| vegtass | Vegetative (Tasseling) |
| repro | Reproductive |
| mat | Maturing |
Upload Crop Calendar Data
ACAP 2.0 uploads its cropping calendars using an upload form on the Cropping Calendars page, requiring Admin login.
The crop stage codes should match those defined in the ACAP 2.0 crop recommendations raw Excel files crop stage labels specific to target crops to ensure the correct association of crop stages with target recommendations.
*Each municipality should have two (2) rows of crop stages each, following the format of the new cropping calendar Excel templates in the /server/src/scripts/data/dataset_v2.0 directory.
Prepare the frontend / backend
Update the frontend and backend codes with necessary data for supporting other crops, with data formats described in the Data Format and Crop Stage Codes and Labels section.
Overwrite and commit the sample cropping calendar Excel template files rice_cropping_calendar.xlsx and corn_cropping_calendar.xlsx in the server directory with the correct regional cropping calendar files to change the default sample Excel templates during live deployment.
Also, change the values of the environment variables (CROPPING_CALENDAR_RICE_EXCEL_FILE, CROPPING_CALENDAR_CORN_EXCEL_FILE) associated with its file names in the client .env file and GitHub Secrets if there is a need to use different file names or add new templates.
NOTE: This step is compatible until @commitĀ 95a97cdĀ (latest updates) in theĀ acap-v2 devĀ branch. However, the default cropping calendar Excel templates inside the repository only work until the previous updates @commit ee49568 (pre-ACAP 2.1). Kindly chat the ACAP group chat for more information about the new Cropping Calendar Excel file format and management for ACAP 2.1 if it's missing in the online documentation.
Login as Admin
Login as an ACAP admin, then, navigate to the Cropping Calendar Management page in the /admin/cropping-calendars route.
Upload Cropping Calendars
- Upload Cropping Calendar: Select aĀ "Crop Type"Ā from the availableĀ crops list and select options.
- Upload an Excel file: Press the SEARCH icon.
- Browse for a cropping calendar that corresponds to the selectedĀ Crop TypeĀ inĀ step #1.
- Press the UPLOAD button.
- Wait for the upload success or fail status response to appear.