Standards The Statistical Data and Metadata eXchange (SDMX) is a global initiative to foster common international standards for the exchange of statistical information. Common international standards facilitate the sharing of statistical data and metadata, allowing for more efficient data exchange mechanisms as well as easier access by all stakeholders to internationally comparable statistical data and metadata. The Standards module contains the following four utilities which allow you to exchange data between DevInfo files and SDMX-ML format files: DX DES to SDMX-ML DX SDMX Export DX SDMX Import DX SDMX-ML to DES Each of these utilities will be explained below. Note: Key families and code lists in SDMX-ML format files In SDMX-ML format files, database dimensions are grouped according to keys, which allow for the identification of a particular data set. Keys are categorized under key families. Each possible value for a database dimension is defined in a code list. DX DES to SDMX-ML The DX DES to SDMX-ML.exe utility allows you to convert a DevInfo Data Entry Spreadsheet into an SDMX-ML format file. This utility is a one-step process. Step 1 - Select File In Step 1, select the DevInfo Data Entry Spreadsheet which you wish to convert into an SDMX-ML format file (Fig. 13.1). Fig 13.1 Selecting the DevInfo Data Entry Spreadsheet Click to browse for a file in another location. Then select the file by double-clicking it to transfer it from the Available pane to the Selected pane. Click Finish to convert the selected DevInfo Data Entry Spreadsheet into an SDMX-ML format file. Specify the location and the name of the new file in the Save As window. By default, the utility saves the file under the original filename with an .xml extension (Fig 13.2). Fig 13.2 Saving the SDMX-XL format file The utility also generates a log file displaying details of the conversion process (Fig. 13.3). Fig 13.3 DX DES to SDMX-ML Log File DX SDMX Export The DX SDMX Export.exe utility allows you to export a DevInfo database or template to one or more SDMX-ML format files. This utility is a four-step process. Step 1 - Select File In Step 1, select the file which you wish to export to one or more SDMX-ML format files. Indicate whether you wish to export a database or a template by selecting the desired file type below the toolbar (Fig 13.4). Fig 13.4 Selecting the file you wish to export Click to browse for a file in another location. Then select the file by double-clicking it to transfer it from the Available pane to the Selected pane. Click Next to go to Step 2. Step 2 - Options In Step 2, select the data elements for which you wish to export data to one or more SDMX-ML format files. Note the six tabs below the toolbar representing six categories of data elements to be selected: Indicator, Unit, Subgroup, Time, Area and Source (Fig. 13.5). Click these tabs to select data element categories Fig 13.5 Selecting data elements to export Click each of these six tabs and select the desired data elements for which you wish to export data by transferring them from the Available pane to the Selected pane. Note: Selecting data elements If you are exporting a database file, then data elements in each of the six tabs Indicator, Unit, Subgroup, Time, Area and Source - must be selected. However, if you are exporting a template file, then the Time and Source tabs will be disabled as these elements are not available in DevInfo templates. Step 3 - Data In Step 3, you can specify more details about the SDMX-ML format file(s) to be created (Fig. 13.6). Fig 13.6 Specifying additional details In the Location box just below the toolbar, the default location for saving the SDMX-ML format file(s) is displayed. Click to browse and specify a different location. Below the Location box, select the desired export options as explained below. SDMX-ML Data Exports the data based on the criteria specified in Step 2. If the Separate Indicator Files check box is selected, then the utility will generate separate SDMX-ML files for each of the selected indicators. Key Families Exports the list of the data dimensions, such as indicators, area names, etc. Code Lists Exports the master code list of all selected database elements. Metadata Exports the metadata for indicators, areas and sources. Step 4 - Process In Step 4, the utility exports the contents of the selected file to one or more SDMX-ML format file(s), which are displayed in a list in the window (Fig 13.7). Fig 13.7 Exporting the data to SDMX-ML format file(s) Click Finish to save the files. The utility generates a log file displaying details of the export process (Fig. 13.8). Fig 13.8 DX SDMX Export log file DX SDMX Import The DX SDMX Import.exe utility allows you to import an SDMX-ML format file created using the DevInfo User or Data Admin applications into a DevInfo database. This utility is an eight-step process. Step 1 - Select File In Step 1, select the source file(s) to be imported (Fig. 13.9). Fig. 13.9 Selecting the source file(s) Click to browse and specify the location of the desired file(s). Then select the file(s) by doubleclicking to transfer them from the Available pane to the Selected pane. Note that multiple source files can be selected. Click Next to go to Step 2. Step 2 - Select Database In Step 2, select the reference file against which you wish to import the data. The data will be imported based on the indicators, units, subgroups and areas defined in the reference file. Note: Selecting the reference file If you select a template as the reference file, a new database will be created. If you select a database as the reference file, the source data will be appended to the reference database. Indicate whether you wish to import the data against a template or a database by selecting the desired file type below the toolbar (Fig. 13.10). Fig. 13.10 Selecting the reference file Click to browse for a file in another location. Select a file by double-clicking it to transfer it from the Available pane to the Selected pane. Steps 3 to 7 - Map Data Elements Steps 3 to 7 involve matching the different elements of the SDMX-ML source file(s) with those of the reference file. In each step, you can view the unmatched elements. See Import in Chapter 4, “Tools” for detailed instructions on these steps. Step 8 - Process In Step 8, the utility imports the data from the source file(s) against the selected reference template or database. Click Finish to complete the process and save the database (Fig. 13.11). Fig. 13.11 Saving the database A log file will be generated displaying details of the import process. DX SDMX-ML to DES The DX SDMX-ML to DES.exe utility allows you to import an SDMX-ML format file created using the DevInfo User or Data Admin applications into a DevInfo Data Entry Spreadsheet. This utility is a seven-step process. Step 1: Select File In Step 1, select the source file to be imported (Fig. 13.12). Fig. 13.12 Selecting the source file Click to browse and specify the location of the desired file. Then select the file by double-clicking it to transfer it from the Available pane to the Selected pane. Click Next to go to Step 2. Step 2 - Select Database In Step 2, select the reference file against which you wish to import the data. The data will be imported based on the indicators, units, subgroups and areas defined in the reference file. Indicate whether you wish to import the data against a template or a database by selecting the desired file type below the toolbar (Fig. 13.13). Fig. 13.13 Selecting the reference file Click to browse for a file from another location. Select a file by double-clicking it to transfer it from the Available pane to the Selected pane. Steps 3 to 7 - Map Data Elements Steps 3 to 7 involve matching the different elements of the SDMX-ML source file with those of the reference file. In each step, you can view the unmatched elements. See Import in Chapter 4, “Tools” for detailed instructions on these steps. When you have finished mapping all data elements, click Finish in Step 7 to import the data from the source file against the selected reference template or database and save the output as a DevInfo Data Entry Spreadsheet (Fig. 13.14). Fig. 13.14 Saving the Data Entry Spreadsheet The utility will generate a log file displaying details of the import process.