0
edits
Changes
Created page with "===How to Export Approved Field Reports=== <p>The export feature allows you to save field report(s) that meet criteria that you specify to a file. This file can then be import..."
===How to Export Approved Field Reports===
<p>The export feature allows you to save field report(s) that meet criteria that you specify to a file. This file can then be imported into another IMSMA system so that field reports can be shared.</p>
<p>To export approved field report(s):</p>
<ol>
<li>From the File menu, select Export.</li>
<li>From the Export menu, select Field Reports.</li>
:The Field Report Export window displays ([[:Image:fig179.png|Figure 179]]).
</ol>
[[Image:fig179.png|center|''Figure 179. Field Report Export Window'']]
<div align="center">
''Figure 179. Field Report Export Window''
</div>
<ol start="3">
<li>Enter your name in the '''Exported by''' field or leave it blank.</li>
<li>Click the [[Image:StrucInfoIcon.png]] button to select the country structure for the field report(s) you would like to export.</li>
:The Country Structure Selection window displays.
<li>From the Country Structure Selection window:</li>
<ol start="a">
<li>Click the country structure on which you would like to generate the report.</li>
<li>Click the '''OK''' button.</li>
</ol>
<li>Select one of the following date options for the field report:</li>
*''Date Approved'' – Applies the date range to the date that the field report was approved.
*''Date Reported'' – Applies the date range to the date that the field report was reported.
*''Last Updated Date'' – Applies the date range to the date that the field report was last updated.
<li>Select the date range that a field report must fall within:</li>
<ol type="a">
<li>Click the [[Image:DataInfoIcon.png]] button beside the Begin Date field to select the starting date.</li>
<li>Click the [[Image:DataInfoIcon.png]] button beside the End Date field to select the ending date.</li>
</ol>
<li>Click the '''Export''' button.</li>
:The Field Report Export Summary window displays a list of the field reports that match the criteria ([[:Image:fig180.png|Figure 180]]).
[[Image:fig108.png|center|''Figure 180. Field Report Export Summary Window'']]
<div align="center">
''Figure 180. Field Report Export Summary Window''
</div>
{| style="border:2px solid lightgray; float:center; margin:10px;"
|align="left" style="padding: 5px 10px 5px 10px"|[[Image:bulb2.png|25px|Represents a tip or note for using IMSMA Mobile.]]
|align="left" style="padding: 5px 10px 5px 10px"| The greater the number of field reports that meet the criteria specified in the Field Report Export window, the longer it will take the Field Report Export Summary window to display.
|}
<ol start="9">
<li>Do one of the following:</li>
*To export the field report(s), click the '''OK''' button.
:The Save window displays.
*To cancel the export operation, click the '''Cancel''' button.
<li>From the Save window:</li>
<ol type="a">
<li>Navigate to the directory where you would like to save the file.</li>
<li>Enter the name of the file in the File Name field.</li>
<li>Click the '''Save''' button.</li>
:The field report(s) are saved to the file and directory that you specified. When the export has completed, the Export Complete window displays.
</ol>
<li>Click the '''OK''' button.</li>
:The Export Complete window closes. An .XML file of the exported field reports is created in the directory that you specified.
</ol>
==How to Import Field Reports===
<p>The import feature allows you to import field reports from another IMSMA system into your IMSMA system.</p>
{| style="border:2px solid lightgray; float:center; margin:10px;"
|align="left" style="padding: 5px 10px 5px 10px"|[[Image:bulb2.png|25px|Represents a tip or note for using IMSMA Mobile.]]
|align="left" style="padding: 5px 10px 5px 10px"| Before you import field reports, ensure that:
*The field report templates, custom defined fields, and option selection values have been imported into the receiving IMSMA system.
*The field report template name is exactly the same as the field report template name used by the field report that you are importing.
*The country structure levels and areas exist in the system.
|}
<p>Data will only be imported for attributes represented on your field report template. For example, if the field report(s) that you are importing use a template with 50 attributes, but your template only contains 20 of the 50 attributes, data will only be imported for the 20 attributes.</p>
<p>To import a field report:</p>
<ol>
<li>From the File menu, select Import.</li>
<li>From the Import menu, select Field Reports.</li>
:The Field Report Import window displays ([[:Image:fig181.png|Figure 181]]).
</ol>
[[Image:fig181.png|center|''Figure 181. Field Report Import window'']]
<div align="center">
''Figure 181. Field Report Import window''
</div>
<ol start="3">
<li>Click the '''Browse''' button.</li>
:The Open window displays.
<li>From the Open window:</li>
<ol type="a">
<li>Navigate to the directory where the file that you would like to import is located.</li>
<li>Select the file name.</li>
<li>Click the '''Open''' button.</li>
:In the Field Report Import window, the number of field reports and the number of objects associated with the reports are displayed in the XML Summary section of the window. The contents of the file are displayed in the Raw XML View section.
</ol>
[[Image:fig182.png|center|''Figure 182. Field Report Import window'']]
<div align="center">
''Figure 182. Field Report Import window''
</div>
<ol start="5">
<li>Click the '''Import''' button.</li>
:The Field Report Import Options window displays.
<li>In the Field Report Import Options window, select one of the options listed in Table 52.</li>
:If you do not want to import the field reports, click the Cancel button.
</ol>
<center>
{| class="wikitable" width="500"
|-
| align="center" colspan="2" | '''Table 52. Description of Import Options'''
|-
| width="125pt" | '''If you choose to…'''
| width="375pt" | '''The field reports...'''
|-
| Approve all field reports || <p>With no import errors and complete reconciliation are imported and marked as Approved.</p>
<p>With import errors and/or incomplete reconciliation are imported, marked as Needs Approval, and added to the Workbench.</p>
|-
| Import only || <p>Are imported, marked as Needs Approval, and added to the Workbench.</p>
|}
</center>
<ol start="7">
<li>Click the '''OK''' button.</li>
:The Information window displays a message stating that the field report import is complete.
<li>Click the '''Close''' button.</li>
<li>If you chose the '''Approve all field reports''' option, the Approval Results window displays.</li>
</ol>
[[Image:fig183.png|center|''Figure 183. Approval Results Window'']]
<div align="center">
''Figure 183. Approval Results Window''
</div>
<p>Field reports that were approved appear in the Approved Field Reports section of the Approval Results window. The Approval Date column lists the date and time the reports were approved.</p>
<p>Reports that were not approved appear in the Non-Approved Field Reports section. The Non-Approval column lists the reasons they were not approved. Possible reasons include ''Reconciliation Incomplete'', ''Import Error'', and ''Unknown Error''.</p>
<ol>
<ol type="a">
<li>Click the '''Done''' button.</li>
<li>If a field report was not approved, open the Workbench window and double-click the row associated with the unapproved field report.</li>
:The Field Report Editor window displays.
<li>Resolve the error on the Reconciliation tab if applicable. See the ''Field reports – [[Reconciling Items]]'' section for additional information.</li>
<li>Resolve the error on the Import Issues tab if applicable. When complete, check the '''All Import Issues have been resolved''' checkbox.</li>
<li>Click the '''Approve''' button.</li>
:The Information window displays confirming the field report was approved.
</ol>
</ol>
<ol start="10">
<li>If you chose the '''Import Only''' option, the Field Report Import Results window displays.</li>
</ol>
[[Image:fig184.png|center|''Figure 184. Field Report Import Results Window'']]
<div align="center">
''Figure 184. Field Report Import Results Window''
</div>
<p>The Imported Items section of the window lists the items that were imported. Any errors that occurred during the import are noted in the Error Log section of the window. You can save the error log to a file by clicking the Save Log button. You can also view import errors on the Import Issues tab of the Field Report Editor window.</p>
<ol>
<ol type="a">
<li>Click the '''Done''' button.</li>
:The imported field reports will be listed in the Workbench. You will need to reconcile the item records in the field reports.
</ol>
</ol>
[[Category:Maintaining IMSMA]]
[[Category:How To]]
<p>The export feature allows you to save field report(s) that meet criteria that you specify to a file. This file can then be imported into another IMSMA system so that field reports can be shared.</p>
<p>To export approved field report(s):</p>
<ol>
<li>From the File menu, select Export.</li>
<li>From the Export menu, select Field Reports.</li>
:The Field Report Export window displays ([[:Image:fig179.png|Figure 179]]).
</ol>
[[Image:fig179.png|center|''Figure 179. Field Report Export Window'']]
<div align="center">
''Figure 179. Field Report Export Window''
</div>
<ol start="3">
<li>Enter your name in the '''Exported by''' field or leave it blank.</li>
<li>Click the [[Image:StrucInfoIcon.png]] button to select the country structure for the field report(s) you would like to export.</li>
:The Country Structure Selection window displays.
<li>From the Country Structure Selection window:</li>
<ol start="a">
<li>Click the country structure on which you would like to generate the report.</li>
<li>Click the '''OK''' button.</li>
</ol>
<li>Select one of the following date options for the field report:</li>
*''Date Approved'' – Applies the date range to the date that the field report was approved.
*''Date Reported'' – Applies the date range to the date that the field report was reported.
*''Last Updated Date'' – Applies the date range to the date that the field report was last updated.
<li>Select the date range that a field report must fall within:</li>
<ol type="a">
<li>Click the [[Image:DataInfoIcon.png]] button beside the Begin Date field to select the starting date.</li>
<li>Click the [[Image:DataInfoIcon.png]] button beside the End Date field to select the ending date.</li>
</ol>
<li>Click the '''Export''' button.</li>
:The Field Report Export Summary window displays a list of the field reports that match the criteria ([[:Image:fig180.png|Figure 180]]).
[[Image:fig108.png|center|''Figure 180. Field Report Export Summary Window'']]
<div align="center">
''Figure 180. Field Report Export Summary Window''
</div>
{| style="border:2px solid lightgray; float:center; margin:10px;"
|align="left" style="padding: 5px 10px 5px 10px"|[[Image:bulb2.png|25px|Represents a tip or note for using IMSMA Mobile.]]
|align="left" style="padding: 5px 10px 5px 10px"| The greater the number of field reports that meet the criteria specified in the Field Report Export window, the longer it will take the Field Report Export Summary window to display.
|}
<ol start="9">
<li>Do one of the following:</li>
*To export the field report(s), click the '''OK''' button.
:The Save window displays.
*To cancel the export operation, click the '''Cancel''' button.
<li>From the Save window:</li>
<ol type="a">
<li>Navigate to the directory where you would like to save the file.</li>
<li>Enter the name of the file in the File Name field.</li>
<li>Click the '''Save''' button.</li>
:The field report(s) are saved to the file and directory that you specified. When the export has completed, the Export Complete window displays.
</ol>
<li>Click the '''OK''' button.</li>
:The Export Complete window closes. An .XML file of the exported field reports is created in the directory that you specified.
</ol>
==How to Import Field Reports===
<p>The import feature allows you to import field reports from another IMSMA system into your IMSMA system.</p>
{| style="border:2px solid lightgray; float:center; margin:10px;"
|align="left" style="padding: 5px 10px 5px 10px"|[[Image:bulb2.png|25px|Represents a tip or note for using IMSMA Mobile.]]
|align="left" style="padding: 5px 10px 5px 10px"| Before you import field reports, ensure that:
*The field report templates, custom defined fields, and option selection values have been imported into the receiving IMSMA system.
*The field report template name is exactly the same as the field report template name used by the field report that you are importing.
*The country structure levels and areas exist in the system.
|}
<p>Data will only be imported for attributes represented on your field report template. For example, if the field report(s) that you are importing use a template with 50 attributes, but your template only contains 20 of the 50 attributes, data will only be imported for the 20 attributes.</p>
<p>To import a field report:</p>
<ol>
<li>From the File menu, select Import.</li>
<li>From the Import menu, select Field Reports.</li>
:The Field Report Import window displays ([[:Image:fig181.png|Figure 181]]).
</ol>
[[Image:fig181.png|center|''Figure 181. Field Report Import window'']]
<div align="center">
''Figure 181. Field Report Import window''
</div>
<ol start="3">
<li>Click the '''Browse''' button.</li>
:The Open window displays.
<li>From the Open window:</li>
<ol type="a">
<li>Navigate to the directory where the file that you would like to import is located.</li>
<li>Select the file name.</li>
<li>Click the '''Open''' button.</li>
:In the Field Report Import window, the number of field reports and the number of objects associated with the reports are displayed in the XML Summary section of the window. The contents of the file are displayed in the Raw XML View section.
</ol>
[[Image:fig182.png|center|''Figure 182. Field Report Import window'']]
<div align="center">
''Figure 182. Field Report Import window''
</div>
<ol start="5">
<li>Click the '''Import''' button.</li>
:The Field Report Import Options window displays.
<li>In the Field Report Import Options window, select one of the options listed in Table 52.</li>
:If you do not want to import the field reports, click the Cancel button.
</ol>
<center>
{| class="wikitable" width="500"
|-
| align="center" colspan="2" | '''Table 52. Description of Import Options'''
|-
| width="125pt" | '''If you choose to…'''
| width="375pt" | '''The field reports...'''
|-
| Approve all field reports || <p>With no import errors and complete reconciliation are imported and marked as Approved.</p>
<p>With import errors and/or incomplete reconciliation are imported, marked as Needs Approval, and added to the Workbench.</p>
|-
| Import only || <p>Are imported, marked as Needs Approval, and added to the Workbench.</p>
|}
</center>
<ol start="7">
<li>Click the '''OK''' button.</li>
:The Information window displays a message stating that the field report import is complete.
<li>Click the '''Close''' button.</li>
<li>If you chose the '''Approve all field reports''' option, the Approval Results window displays.</li>
</ol>
[[Image:fig183.png|center|''Figure 183. Approval Results Window'']]
<div align="center">
''Figure 183. Approval Results Window''
</div>
<p>Field reports that were approved appear in the Approved Field Reports section of the Approval Results window. The Approval Date column lists the date and time the reports were approved.</p>
<p>Reports that were not approved appear in the Non-Approved Field Reports section. The Non-Approval column lists the reasons they were not approved. Possible reasons include ''Reconciliation Incomplete'', ''Import Error'', and ''Unknown Error''.</p>
<ol>
<ol type="a">
<li>Click the '''Done''' button.</li>
<li>If a field report was not approved, open the Workbench window and double-click the row associated with the unapproved field report.</li>
:The Field Report Editor window displays.
<li>Resolve the error on the Reconciliation tab if applicable. See the ''Field reports – [[Reconciling Items]]'' section for additional information.</li>
<li>Resolve the error on the Import Issues tab if applicable. When complete, check the '''All Import Issues have been resolved''' checkbox.</li>
<li>Click the '''Approve''' button.</li>
:The Information window displays confirming the field report was approved.
</ol>
</ol>
<ol start="10">
<li>If you chose the '''Import Only''' option, the Field Report Import Results window displays.</li>
</ol>
[[Image:fig184.png|center|''Figure 184. Field Report Import Results Window'']]
<div align="center">
''Figure 184. Field Report Import Results Window''
</div>
<p>The Imported Items section of the window lists the items that were imported. Any errors that occurred during the import are noted in the Error Log section of the window. You can save the error log to a file by clicking the Save Log button. You can also view import errors on the Import Issues tab of the Field Report Editor window.</p>
<ol>
<ol type="a">
<li>Click the '''Done''' button.</li>
:The imported field reports will be listed in the Workbench. You will need to reconcile the item records in the field reports.
</ol>
</ol>
[[Category:Maintaining IMSMA]]
[[Category:How To]]