Difference between revisions of "Importing and Exporting Data with IMSMANG"

From IMSMA Wiki
Jump to: navigation, search
Line 1: Line 1:
{{Rewrite| This page is being rewritten. }}
 
 
{{TOC right}}
 
{{TOC right}}
 
__NOEDITSECTION__
 
__NOEDITSECTION__
Line 79: Line 78:
  
 
{{Note| In order to import data in XLS format, scripts files that specify how the data fields contained in the XLS file(s) should be processed e.g. the import order, import logic, reconciliation rules and any error handling must be developed. Contact your [[Information Management Team | GICHD IM advisor]] for help.}}
 
{{Note| In order to import data in XLS format, scripts files that specify how the data fields contained in the XLS file(s) should be processed e.g. the import order, import logic, reconciliation rules and any error handling must be developed. Contact your [[Information Management Team | GICHD IM advisor]] for help.}}
 
{{ Note | To use import XLS-file, you must have [[Defining Roles, Permissions and Users | XLS Import permission]]. Contact your IMSMA administrator if you have questions on permissions.}}
 
 
The import functionality has three parameters:
 
* Import Ordering File - defines which script files to be run and in what order
 
* Processing Directory - where are the script files
 
* Import Data Directory - where are the Excel file(s)
 
 
<p>To import an XLS file:</p>
 
 
<ol>
 
<li>From the '''File''' menu, select '''Import'''.</li>
 
<li>From the '''Import''' menu, select '''XLS File'''.</li>
 
:The XLS Import window displays.
 
 
[[Image:XLSImport.png|500px|center|''XLS Import window'']]
 
<div align="center">
 
''XLS Import window''
 
</div>
 
 
<li>Click the '''Browse''' button next to the Import Ordering File field.</li>
 
<ol type="a">
 
<li>The Open window displays.</li>
 
<li>Navigate to the folder where the Import Ordering File is located.</li>
 
<li>Select the file (.txt or mtxt).</li>
 
<li>Click the '''Open''' button.</li>
 
:In the XLS Import window, the folder and file name are displayed in the Import Ordering File field in the Import window.
 
</ol>
 
<li>Click the '''Browse''' button next to the Processing Directory field.</li>
 
<ol type="a">
 
<li>The Open window displays.</li>
 
<li>Navigate to the folder where the script file(s) are located.</li>
 
<li>Click the '''Open''' button.</li>
 
:In the XLS Import window, the folder name is displayed in the Processing Directory field in the Import window.
 
</ol>
 
 
<li>Click the '''Browse''' button next to the Import Data Directory field.</li>
 
<ol type="a">
 
<li>The Open window displays.</li>
 
<li>Navigate to the directory where the Excel file(s) that you would like to import is located.</li>
 
<li>Click the '''Open''' button.</li>
 
:In the XLS Import window, the folder name is displayed in the Import Data Directory field in the Import window.
 
</ol>
 
 
<li>Click the '''Import''' button.</li>
 
:The Import Results window displays with the contents of the migration.log, migration_errors.log, and migration_dataissues.log. The log files are generated in the Processing Directory specified during the import.
 
<li>Verify that the import was successful, and click the '''Done''' button.</li>
 
 
[[Image:XLSImportResults.png|500px|center|''XLS/CSV Import Results window'']]
 
<div align="center">
 
''XLS/CSV Import Results window''
 
</div>
 
 
</ol>
 
  
 
==Translations==__NOEDITSECTION__
 
==Translations==__NOEDITSECTION__

Revision as of 18:20, 26 May 2017

IMSMA allows you to import and export various types of data, including map files, auxiliary data files, geospatial points, translations, and data entry forms. The sections below describe how and from where you can import/export data in IMSMA.

Map Data

Importing Map Data

Note.jpg The .mxd of the map file and corresponding shapefiles should be located on a local drive on your computer. The .mxd should have an unique name and has never been imported into IMSMANG before. Recommended size of the file should not exceed 2 GB.

To import an IMSMA map:

  1. From the File menu, select Import.
  2. From the Import menu, select Map.
  3. The Map Manager window displays.
  4. Navigate to the location of the .mxd file that you would like to import.
  5. Select the .mxd file.
  6. Click the Import button.
  7. A message stating that the map import was successful displays.

Exporting Map Data

Note.jpg Before you export the map, you should zoom in as close as possible to the area on the map that you would like to export. The further out you are zoomed from your map, the longer it will take to export the map.

The export map feature allows you to save a copy of the map extent either to an .apm format so that it can be imported into ArcPad for more advanced geoprocessing, or to a .pdf file as an un-editable visual snapshot.

Map Manager Export window

Map Manager Export window

Exporting Map Data For Use in ArcPad

To export the IMSMA map extent for use in ArcPad for more advanced geoprocessing:

  1. From the File menu, select Export.
  2. From the Export menu, select Map.
  3. The Map Manager: Export window displays.
  4. Enter the file name in the Name field.
  5. Select the .apm, ESRI Arc Pad Map option from the Format menu.
  6. Click the Browse button.
  7. Navigate to the folder where you would like to save a copy of the map.
  8. Click the Open button.
  9. Click the Export button.
  10. The map is saved in .apm format. The Map Export Complete window displays.
  11. Click the OK button.
  12. The Map Export window closes.

Exporting Map Data as a PDF File

To export the map in a .pdf format:

  1. From the File menu, select Export.
  2. From the Export menu, select Map.
  3. The Map Manager: Export window displays.
  4. Enter the file name in the Name field.
  5. Select the .pdf, Adobe PDF option from the Format menu.
Note.jpg Selecting the .pdf option creates a visual snapshot of the map as it displays in the Map pane, and this image cannot be manipulated further. Before exporting, you should display the map exactly as you want it to look (show or hide icons, shapes, and pins, recentre the map, zoom in or out, and so on).
  1. Click the Browse button.
  2. Navigate to the folder where you would like to save a copy of the map.
  3. Click the Open button.
  4. Click the Export button.
  5. The map is saved in the .pdf format. The Map Export Complete window displays.
  6. Click the OK button.
  7. The Map Export window closes.

Geospatial Data

Note.jpg Find information on how to import geospatial data from Excel and shapefile to Task, Auxiliary data or to a Data Entry Form.

XLS Import

The XLS Import feature allows you to import data into IMSMANG using an Excel file. This allows large amount of data being imported in another format than xml.

Note.jpg In order to import data in XLS format, scripts files that specify how the data fields contained in the XLS file(s) should be processed e.g. the import order, import logic, reconciliation rules and any error handling must be developed. Contact your GICHD IM advisor for help.

Translations

See Language and Translations.

Data Entry Forms (xml)

Data Entry Forms may be export in four different ways to xml file(s):

  1. from the Advanced search functionality
  2. from the Workbench
  3. from the Summary Window
  4. from the Data Entry Form Editor Window

Import of Data Entry Forms is started from Workbench, see Import a Data Entry Form from a xml File.