ICPAPSS UserManual v34
ICPAPSS UserManual v34
ICPAPSS UserManual v34
version 3.4
Contents
System Overview 5
Technical Specifications 5
Data Processing and Flow 6
1 GETTING STARTED 7
1.1 Minimum System Specifications 7
1.2 Recommended System Specifications 7
1.3 Installing the application 9
1.4 Initial Configuration 10
1.5 Logging in 10
2 SYSTEM CONFIGURATION 11
2.1 Configuring database 11
2.2 Creating an administrator account 13
2.3 Identifying country and labels 14
2.4 Validating existing locations 15
3 SYSTEM LAYOUT 21
3.1 System interface familiarization 21
3.2 Accessing user menu 22
4 DATABASE MIGRATION 23
4.1 Accessing data migration 23
4.2 Importing data 23
4.3 Exporting database 24
5 HOUSEHOLD
5.1 DASHBOARD 26
5.2 PRODUCTS 27
5.2.1 Products layout 27
5.2.2 Product availability and importance 28
5.2.3 Product frequency 28
5.2.4 Updating multiple products 29
5.2.5 Downloading product templates 30
5.2.6 Features of a product template 31
5.3 OUTLETS 35
5.3.1 Outlets layout 35
5.3.2 Adding an outlet 36
5.3.3 Editing an outlet 37
5.3.4 Deleting Outlets 37
5.3.5 Downloading an outlet template 38
5.3.6 Features of an outlet template 39
5.3.7 Uploading the outlet template 41
5.4 MAPPING 42
5.4.1 Selecting an outlet 42
5.4.2 Mapping available products 43
5.4.3 Downloading the mapping template 44
5.4.4 Using the mapping template 44
5.4.5 Uploading the mapping template 46
5.8 REPORTS 63
6.5 REPORTS 80
6.6 FREQUENTLY ASKED QUESTIONS 81
7 TROUBLESHOOTING 87
7.1 Missing vcruntime140.dll issue 87
7.2 Bad vcruntime140.dll image 87
7.3 Determining your computer specifications 88
7.4 Consolidating data from different geographical locations 88
The enhanced version of ICP APSS derives major features and functions from the previous
version used in 2011 and 2017 while leveraging modern technologies to improve usability.
Specifically, the new version addresses compatibility issues and accommodates the data
processing requirements of the 2020 ICP.
By making it easier to encode and access statistical information about prices, the ICP APSS
contributes to the formulation of evidence-based policies and program administration.
Technical Specifications
The primary architectural requirements for the tool is that it is compatible with various
operating systems, capable of offline data processing with the possibility of online
integration in the near future, and highly compatible with Microsoft Excel. The primary
users of the application are statisticians and data encoders from member countries
participating in ICP.
The web application was built with PHP version 7.1, an open-source web scripting language.
Data is stored in a local SQLite database, also open source. The user interface is primarily
developed in HTML5, CSS3, and JavaScript. The application also employs components from
standard and commonly accepted frameworks and libraries such as Laravel for PHP,
Bootstrap for CSS, and jQuery for Javascript. PHP dependencies are managed via the
Composer package manager. The application uses Apache version 2.4 as the web server but
will be able to run on any web server that supports PHP 7 and has a SQLite database.
The entire application is packaged into an executable (.exe) file which allows the user to
install the web server and corresponding components into specified directories using
Windows shell scripts through a Windows packaging tool called NSIS installer. Once
installed, the application can then be run by through a Windows desktop shortcut. The
application code uses Git version control, and all commits are archived in a designated
repository available to the ADB ICP team.
SURVEY QUESTIONNAIRE
Questionnaires for price collectors are
generated based on mappings
DATA VALIDATION
Data is validated and analyzed
according to defined parameters
STEP 1
Open the ICPAPSS2020_Installer.exe file
then click on the Install button
STEP 2
Once the installation is complete
click on the Start ICP APSS or Finish button Image: ICP APSS installer screen
STEP 3 (optional)
To start the application, go to the
C:/ICPAPSS2020 folder in your computer and
click on the ICPAPSS Launcher icon to start the
system
NOTE:
Some systems may require you to confirm that
the application is not harmful, as
indicated in the image below.
1.5 Logging in
If the system was already properly configured, user will see a login screen where they will be
able to enter their account details to log in.
For individual users who wish to keep their data private and save all data on their own computer
only, this does not need to be changed. Clicking the proceed button will take you to the next step.
On the other hand, multiple users may also opt to transfer the database into a shared local
network drive, so that multiple users can connect to the same database and benefit from shared
and consolidated ICP data. An overview of steps are outlined below.
1. Install and open ICP APSS 1. Install and open ICP APSS
2. Click on configure system 2. Click on configure system
3. Create administrator account 3. On the database path field, enter the
4. Identify country and location data correct file location for the local
5. Create user accounts shared network drive database file
6. Close the ICP APSS system (e.g.: G:/sharedfiles/icpapss/
7. Go to the folder ICPDB.sqlite)
C:/ICPAPSS2020/www2/database 4. Click ‘proceed’ to connect to the
8. Copy the ICPDB.sqlite file shared database.
9. Paste the copied ICPDB.sqlite file into
your preferred local shared network
folder (e.g.: G:/sharedfiles/icpapss)
10. Open the ICP APSS system and login to
your account
11. Click on the top right menu, and click on
the ‘system configuration’ option
12. On the database path field, enter the
correct file location for the local shared
network drive database file (e.g.:
G:/sharedfiles/icpapss/ ICPDB.sqlite)
13. Click ‘proceed’ to connect to the shared
database.
STEP 1
Select country from dropdown list.
Image: Before (left) and after (right) - clicking on the country dropdown box
STEP 2
Identify location levels and their
corresponding label names.
STEP 3
Click on the Proceed button Image: Auto-generated location labels
Note: You can proceed and return to this at a later time even without changing anything
4 1
3 Data table
Contains location data listed per row.
Rows can be selected for Edit and
Delete functionality.
STEP 1
Click on the Add button
STEP 2
Select the level where you want
to add a location to
STEP 3
Enter a location code and location name
STEP 4
Click on the Save button
STEP 1
Click on a row to select location.
STEP 2
Click on the Edit button
STEP 3
Enter changes into the input fields
displayed
STEP 4
Click on the Save button
STEP 1
Select a location by clicking on the row.
Note: The row will be highlighted with a light blue color once selected.
STEP 2
Click on the yellow “delete” button
STEP 3
Confirm deletion by clicking on the “OK” button
The downloaded template is an Excel file that can be used to make multiple changes
simultaneously. This can be downloaded by clicking on the Download & Edit button.
To enter data in the template, users must input specific location details on each row in
the data entry section. Sample data is provided in the diagram below.
STEP 1
Click on the Upload Data button
STEP 2
Locate and select the locations
template from your system
STEP 3
Wait for the system to finish uploading
TIP: You can clear the entire location table by uploading a blank template
USER MANUAL
Download the most updated version of
this system’s user manual
USER MANAGEMENT
Manage user accounts and roles
DATA MIGRATION
Upload databases from the previous system Accessing the user menu
(see section 4)
SYSTEM CONFIGURATION
Access the system configuration page
(see section 2)
SYSTEM LOGS
Contains transactions or events that are logged
by the operating system components
LOGOUT
Used to log out of the system and require the user
to enter a password before being able to use the
system again
1 3 5
2 4
2 4
6 5
2 Availability update
Selecting availability codes (see
section 6.2) will change the
availability of all selected products
1. Download template with data – Downloads a template file with a list of products
and values for availability and frequency based on what is encoded in the system.
2. Download product catalog – Downloads the product catalog which contains
products and corresponding specifications.
To select and download any of these template types, click on the Download button then
select your preferred product template option.
3 5
2
4
STEP 1
Click on the Upload button
Image: Upload button
STEP 2
Locate and select the product
template from your system
STEP 3
Wait for the system to finish uploading
• Product Code
• Product Name
• Structured Product Descriptions
• List Group
• Image
To download the product catalogue, click on the Download button then select your
Download product catalogue.
3 5
2 6
STEP 1
Enter the outlet information in the
data fields provided
STEP 2
Click on the Save Outlet button
STEP 1
Click on the edit icon on the left
side of a row for a specified outlet.
STEP 2
Enter the outlet information in the
data fields provided
STEP 3
Click on the Save Outlet button
STEP 1
Click on the delete icon on the left
side of a specified row
STEP 2
To confirm the deletion,
click on the Yes button
Download template with data – Downloads a template file with column headers
including rows with actual data based on what is already encoded in the system.
Location level 2: 1 to 99
Location levels 3-4: 0 to 99
Location level 5: 0 to 999
STEP 1
Click on the Upload Template button
Image 42: Upload template button
STEP 2
Locate and select the outlet
template from your system
STEP 3
Wait for the system to finish uploading
It is highly recommended that this process of mapping outlets and products is done on a national
level. The purpose of this is to avoid any conflicts when consolidating data from different
geographical locations (see section 14.4).
2
4
4
2
Download template with data – Downloads a template file with column headers
including actual location codes outlet code, and product code data based on what is
already encoded in the system.
STEP 1
Click on the Upload button
Image 46: Upload template button
STEP 2
Locate and select the mapping
template from your system
STEP 3
Wait for the system to finish uploading
3 4
1
5
STEP 1
Click on a row(s) to select an
individual or multiple outlet(s).
STEP 2
Click on the Generate Survey
Questionnaire button
Image: Clicking the Generate Survey button
STEP 3
On the window that appears,
specify the survey coverage period,
reference year and reference month
by selecting an option from the
dropdown menus.
STEP 4
Click on the Generate Questionnaire button
STEP 1
Click on the
Upload Questionnaire button Image : Upload Questionnaire button
STEP 2
Locate and select the locations
template from your system
STEP 3
Wait for the system to finish uploading
Data entry using the system interface is described in section 10.1 while uploading of excel
template is described in section 10.2.
3 Proceed button
Used to proceed to the next step of
outlet selection
1 3
4
2
2 3 4 5 6
STEP 1
Click on the
Upload button
Image : Upload button
STEP 2
Locate and select the quotation
template from your system
STEP 3
Wait for the system to finish uploading
2
1
1 2
Downloadable reports:
Report 1: Data validation report – Lists all products that do not meet required parameters
Report 2: Summary statistics by Product – Disaggregation by location and outlet type
Report 3: Number of products by classification, availability and importance
Report 4: Number of outlets by location and outlet type
Report 5: Number of quotations by product and outlet
Report 6: Number of quotations by product, location, and location type
Report 7: Summary statistics by Location - Contains the national average prices with corresponding
number quotations, minimum price, maximum price, min/max ratio and coefficient of variation in
individual sheets)
1 3 5
2 4
1 6
3
7
4
To change a product’s availability, simply click on the code value found in the Product
Availability Panel shown below. Note that a product must first be selected for the panel to
become clickable.
0 Relevant
1 Not-Relevant
3. Download template with data – Downloads a template file with a list of products
and values for availability and relevancee based on what is encoded in the system.
4. Download product catalog – Downloads the product catalog which contains
products and corresponding specifications.
5. Download PCT – Downloads the Price Collection Tool (PCT) which contains the Excel
based survey questionnaire for Construction type products.
To select and download any of these template types, click on the Download button then
select your preferred product template option.
2 3 4
STEP 1
Click on the Upload button
Image: Upload button
STEP 2
Locate and select the product
template from your system
STEP 3
Wait for the system to finish uploading
Data entry using the system interface is described in section 15.2 while uploading of excel
template is described in section 15.3.
1 2
4
3
5
Step 1: Complete the respondent’s information (Outlet name, Outlet address, etc.) of the
specified available product. Note that information on asterisks (*) are required.
Step 2: Under the price information, specify the reference month or the month for which price is
observed, the date of price collection, the source of the price information, and the unit price of
the specified available product. Note that the date of price collection should not occur before the
reference month specified and after the date of data entry.
Step 3: Under product specification, indicate whether there is a difference/deviation from the
product specifications required for ICP. The observed data column will change into a yellow-filled
text box when there are differences from the described product specification. Leaving the
observed data column blank assumes that there are no differences between the observed and
preferred product specifications.
Step 4: Indicate comments/remarks, if there are any, under the additional specifications section.
STEP 1
Click on the Upload Template button
Image 42: Upload template button
STEP 3
Image 43: Template file selection
Wait for the system to finish uploading
Required Parameters:
5. Number of observed quotations >= 15
6. Coefficient of Variation <= 30%
7. Min/Max Price Ratio >= 0.3
8. FOR Converted Prices (CP) RANGE
[AVG(CP) - STDEV(CP)] <= CP <= [AVG(CP) + STDEV(CP)]
Downloadable Reports:
3. Data validation report by Products – Summary statistics by products
4. Data validation report by Locations – Summary statistics by locations
1 2 3
1
2
3
4
Downloadable reports:
Report 1: Data validation report – Lists all products that do not meet required parameters
Report 2: Summary statistics
Report 3: List of relevant material inputs by sub-heading
Report #2 can be also be filtered by date of price observation by selecting start and end dates as
shown in the image below.
In the Products tab, click the near the product code to view item
specifications. Click to hide item specifications.
Answer: In the latest ICP APSS, you will not be able to add items in the Products
tab to ensure that the same 986 items are compared across different
economies in Asia and the Pacific.
10 Question: Why am I getting a “Location code does not exist” error when I try to
. upload the Excel Outlets template?
Answer: There may be additional location levels specified in the Outlets
template. Check with your supervisor whether the additional location
levels in the Outlets template need to be deleted or the additional
13 Question: What would happen if an outlet included in the Excel Outlets template
. was not included in the Excel Mappings template?
Answer: It will be considered as an outlet without mapped products.
15. Question: How can I use the backup sqlite file instead of my current database?
17 Question: I have already installed the ICP APSS, can I reconfigure the locations or
. (validation) can I edit the locations such as add another level in the existing
locations?
Answer: Yes, but please edit or add locations only if you are authorized to do so,
since this should be done by the headquarters and the codes should be
the same within a country. Note that only up to 4 location levels can be
added. Go to Users/System configuration to open the Configure
database path screen. Click to open Configure country and location
labels screen then specify a label for location level you want to add.
Click to edit/add locations.
18 Question: What should I do when I get a quantity range error when I upload the
. (validation) Excel Quotations template?
Answer: This can only happen when data entry is done outside ICP APSS since
the system will not allow an observed quantity outside the allowed
range for an item. Verify if the correct observed quantity is inputted. If
19 Question: Can I specify an observed quantity that is outside the allowed quantity
. (validation) range for an item in the ICP APSS?
Answer: No, the ICP APSS will not allow you to input an observed quantity that
is outside the allowed range for an item. If the item is important in your
country and is only available in the observed quantity, please price the
item, convert the prices outside the ICP APSS, input the converted price
in the ICP APSS and include a Remark specifying conversion done.
20. Question: The exact item specified for the ICP is not available in my country, but
(validation) we have a similar item that is outside the ICP specifications (e.g. Basmati
rice only available in 2kg packs), can I change the maximum quantity in
ICP APSS? Do I still need to record the price for this item?
Answer: The range values (Min and Max) are uneditable in the Products tab. If
the item is important in your country, please price the item and include
a Remark to note the deviation when inputting prices in the Data Entry
tab (e.g. convert the price outside ICP APSS and include “converted
price from 2kg packs” as Remark)
21 Question: What should I do when I get the message “The uploaded file is invalid.
. (validation) Please check that you are uploading the correct _______ template”?
Answer: Check that you are uploading the correct template in its corresponding
upload screen. For the Household Module, there are five modules that
can be uploaded.
The issue is a result of a missing windows update (universal C runtime library) to your
computer. Fortunately, this can easily be resolved by installing a minor windows update and
will not affect your existing programs or files. The steps on how to install this update are
described below.
Consolidating user
For users consolidating price data from different users assigned to different locations, it is
recommended that the location data and product data is coordinated on the national level and
cascaded down to different geographical location levels so that when consolidating data later on,
the location codes and product availabilities do not conflict each other. This is important to
ensure locations and codes from one location (user) will not overwrite another’s.
If the above conditions are met, consolidation can be done through the following steps:
1. Users from different locations will download and export their data for the following
modules: outlets (see section 5.2.5), mappings (see section 5.3.3), data entry (see
section 5.5.2).
2. Users from different locations will then send these excel files to the consolidating user.
3. The consolidating user will then upload the Excel files received into a single database
using the upload function for the following modules: outlets (see section 5.2.7),
mappings (see section 5.3.5), data entry (see section 5.5.3). There will be no duplicates
or conflicts if each user is sending unique data sets with different locations and outlet
codes.