General Ledger > Setup > Import Exchange Rates

Import Exchange Rates

You use this program to import history of currency exchange rates that have been created using third party application software. You would typically obtain this information from your bank.

Toolbar

Field Description
Import Validates the contents of the import file and import records if there are no errors.
Save Form Values This option is only enabled in Design mode (Automation Design). Your selections are saved and applied when the program is run in automated mode.

Form values and defaults are applied at operator level. They are not saved at role or group level.

Options

Data source

Field Description
Import method  
From file Select this to import data from a file.
Use data grid Select this to enter the import data directly into the grid of the Details pane

You can paste the contents of an Excel spreadsheet into the grid. A blank line is created as the first line in the grid because by default, focus is set on the first editable line for all import program grids.

File location  
Server Indicates the import file resides on the server.
Client Indicates the import file resides on the client.
File name Indicate the name of the import file (include the full path).
Review file This loads the contents of the import file into the Details pane, which lets you validate the lines on the grid prior to importing the file. The Import button is enabled only when all lines are valid.
[Note]

The import file is deleted if you enable the Delete file after use option.

Options

Field Description
Import only if all rows are valid When enabled, the entire import file must be valid before any records can be imported. The import aborts if any errors are encountered.

When not enabled, valid records are imported and invalid records are ignored when the import is performed.

Reason for change Enter a remark (if required) pertaining to the import. This could be a reason for changing the exchange rate history with the rates on the import file.
Import rates outside GL period

Ignore the current period GL dates and write all rates on the import file to the Currency History file.

If you do not select this option, then only those rates whose date falls within the current ledger period are written to the Currency History file.

The date defined for each currency on the import file is compared to the dates for your current GL period (General Ledger Setup).
Override entries already on file Replace the information in the Currency History file with the information on the import file if the currency and date are the same but the exchange rate differs (i.e. the exchange rate on the Currency History file will be replaced by the exchange rate on the import file).

After processing completed

Field Description
Print the Details Generate a report of the contents of the Details entry grid.
Email the Details Generate an email of the contents of the Details entry grid.
Print the Import Results Generate a report of the contents of the Import Results pane.
Email the Import Results Generate an email of the contents of the Import Results pane.
Email recipients Indicate the email addresses of recipients to whom you want to email the information displayed in the output panes.
Delete file after use Indicate whether you want to delete the import file after all records are successfully imported.
[Note]

The file is also deleted if you enable this option and select the Review file function.

In a client/server environment, both the import file on the server and the temporary import file created on the client are deleted.

Close the application Exits the program once processing is complete. Do not select this if you want to be able to view the information on screen when processing is complete or you want to print or email the contents of the Details and Import Results panes.

Details

Toolbar

Field Description
Validate This verifies whether there are any errors in the grid, without actually importing records.

Exclamation marks in the Validation status column indicates that one or more fields in the line are invalid. An explanatory error message is displayed when you hover your mouse pointer over the exclamation marks.

Print Prints the contents of the import file, or changes made in the grid.
Export to Excel Outputs data from the Details pane to an Excel spreadsheet.
Search text  
Clear Clears the contents in the search text field.
Edit  
Copy Copies the lines in the Details pane.
Paste (all columns) Ensure that you have data for all the columns that can appear in the data grid before selecting this option.

When you select to Paste (all columns) the date you are pasting must be in the format CCYYMMDD. Although no validation errors are displayed, the date is not converted into your SYSPRO date format.

Paste (visible columns only) Pastes data into the columns that currently appear in the data grid, in the sequence that they appear.

When you select to Paste (visible columns only) and the date you are pasting is not in CCYYMMDD format, you are prompted for the date format. The program correctly inserts it into the grid in the SYSPRO date format.

Duplicate Copies the current row to the end of the data grid.
Find and Replace  

Import Results

Displays a summary of the results of the validation/import.

This information can be printed or emailed providing you did not select to Close the application in the After processing completed section.

File layout for 7

The table below indicates the structure of the import file that must be defined to successfully import exchange rate entries. All fields are alphanumeric except for the Date field.

Field Start Position Field length and description
Header   ;SYSPRO IMPORT - Version=001 - GENP16

Mandatory entry of this comment on the first line of the import file to distinguish it from a SYSPRO 6.1 layout file. This comment is not case-sensitive.

Currency 1 3

Mandatory. Indicates the code for the exchange rate and must exist in the Currencies table

Date 4 6

Indicates the date for the rate for this currency.

Rate 10 13

Mandatory. Indicates the exchange rate for the currency.

Indicator 23 1

Indicates whether the rate entered must be divided (D) or multiplied (M) to convert the foreign currency to the local currency. Must be either D or M.

Triangulation 24 1

Indicates whether triangulation is required for this currency. Must be either Y or N or blank. If blank, it equates to N.

Triangulation currency code 25 3

Indicates the currency code to be used for currency triangulation. May be left blank if triangulation is not required.

File layout for 6.1

Field Start Position Field length and description
Currency 1 3

Mandatory. Indicates the code for the exchange rate and must exist in the Currencies table

Date 4 6

Indicates the date for the rate for this currency.

Rate 10 13

Mandatory. Indicates the exchange rate for the currency.

Indicator 23 1

Indicates whether the rate entered must be divided (D) or multiplied (M) to convert the foreign currency to the local currency. Must be either D or M.

Triangulation 24 1

Indicates whether triangulation is required for this currency. Must be either Y or N or blank. If blank, it equates to N.

Triangulation currency code 25 3

Indicates the currency code to be used for currency triangulation. May be left blank if triangulation is not required.

Notes and warnings

Date entry considerations

  • All dates in the import file are entered as six digits in either DDMMYY or MMDDYY format, depending on the date format defined in the System Setup program.

Activity considerations

Operator access to the following activities within this program can be restricted. You configure this using the Operators program.

Activity Description
Listview/Forms - Export or print data Controls whether an operator can print the contents of a listview and/or output the contents of a listview to an HTML page, XML document or Excel spreadsheet.
Maintain data in import programs Controls whether an operator can maintain import data in a data grid within any SYSPRO import program before the import is performed.
Allowed to import from client Controls whether an operator can use a SYSPRO import program to import data from a client machine (in a client/server environment).
File Browse on server (C/S system) Controls whether an operator use the browse function to load the Browse on Files and Folders program to locate files on the server in a client/server environment. Operators can still navigate to a file or folder on the server by typing in the full path name in the entry field.

Inserting Application Help

You would typically follow this procedure to display help for the current program in a customized pane that can be pinned to the program window.

Information includes step-by-step instructions for the various functions available within the program, including a brief overview of what the program does, what setup options are required and how to personalize the program.

  1. Open the program for which you want to insert application help into a customized pane.

    This functionality is only available for a program that has panes.

  2. Right-click any form field.

    You can also click the triangle menu icon that appears in the title area of a pane.

  3. Select Insert Application Help from the context-sensitive menu.

    The application help appears in a pane within your program. You can reposition the pane using the docking stickers or pin it to the program window.

Removing the Application Help pane

If you no longer want to display application help in a pane for your current program, you can simply remove it.

  1. Select the Close icon in the right-hand corner of the application help pane.

  2. Confirm that you want to delete the pane.