Inventory Planning > Inventory Forecasting > Setup > Import Demand History

Import Demand History

You use this program to add sales transactions history to the IOP transient transaction table for later automatic inclusion in the forecasting sales history tables IopSales and IopSalesReturns.

You would typically use this program if you have insufficient inventory movement history for forecasting purposes. After an initial take-on of sales history movements, SYSPRO maintains the sales figures automatically.

The update from the transient file is done using the Inventory Forecasting Pareto Analysis program (Pareto Analysis).

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.
Ignore warnings Select this if you do not want to display any warnings on the screen during the import process.
Calculate cost values

Enable this to calculate the cost values for lines in the grid against which the Calculate cost option is enabled. The current cost of the item from the Inventory warehouse file is used to update the cost. The calculated cost overwrites any Cost value entered in the grid for these lines.

This only applies when importing using the data grid.
Calculate sales values

Enable this to calculate the sales values for lines in the grid against which the Calculate sales option is enabled. The current list price for the item in the Stock code master table is used to update the sales value. The calculated cost overwrites any Sales value entered in the grid for these lines.

This only applies when importing using the data grid.

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

This pane displays a summary of the completed import.

XML File Layout

Following is a sample XML import file for two transactions for stock code A100:

  <SetupIOSales>
  <Item>
  <Warehouse>FG</Warehouse> 
  <StockCode>A100</StockCode> 
  <Version /> 
  <Release /> 
  <Date>2006-10-31</Date> 
  <Quantity>100</Quantity> 
  <UnitOfMeasure /> 
  <Units /> 
  <Pieces /> 
  <CostValue>305.00</CostValue> 
  <SalesValue>552.80</SalesValue> 
  <TransactionCount /> 
  <CalcCostValue/>
  <CalcSalesValue/>
  </Item>
  <Item>
  <Warehouse>FG</Warehouse> 
  <StockCode>A100</StockCode> 
  <Version /> 
  <Release /> 
  <Date>2005-11-30</Date> 
  <Quantity>100</Quantity> 
  <UnitOfMeasure /> 
  <Units /> 
  <Pieces /> 
  <CostValue>305.00</CostValue> 
  <SalesValue>552.80</SalesValue> 
  <TransactionCount /> 
  <CalcCostValue/>
  <CalcSalesValue/>
  </Item>
  </SetupIOSales>
Element Remarks
<Warehouse> This element is mandatory.
<StockCode> This element is mandatory. The stock code must be stocked in the specified warehouse.
<Version> This element is mandatory if the stock code is ECC controlled at version (revision) or release level.
<Release> This element is mandatory if the stock code is ECC controlled at release level.
<Date> This element indicates the date of the sale. If left blank, this defaults to the current system date. If entered, then the date format must be CCYY-MM-DD.
<Quantity> Integer value. Enter the quantity of the sales transaction.

This element is mandatory if the stock item is not defined as a unit quantity type stock item. If the stock item is a unit quantity type stock item, then the quantities must be entered in the Units and Pieces elements, not in this element.
<UnitOfMeasure> If the quantity entered was supplied in an alternate unit of measure, then you enter that alternate unit of measure in this element.
<Units> This element is mandatory if the stock item is defined as a unit quantity type stock item.

Enter the unit quantity (cases and pieces) of the sales transaction.
<Pieces> This element is mandatory if the stock item is defined as a unit quantity type stock item.

Enter the pieces quantity (cases and pieces) of the sales transaction.
<CostValue> Enter the cost value of the sale. See also <CalcCostValue>.

When entered, this value must have the same sign as the quantity. The value format is 12.2
<SalesValue> Enter the sales value of the sale. See also <CalcSalesValue>.

When entered, this value must have the same sign as the quantity. The value format is 12.2
<TransactionCount> Enter the number of individual sales transactions that make up this posting. If this is not supplied, then this element defaults to 1.
<CalcCostValue> Set this to Y to calculate the cost value of the sale using the current cost of the item from the Inventory Warehouse file irrespective of whether or not a value is entered at the <CostValue> element. When set to N, the value entered in the <CostValue> element is used.
<CalcSalesValue>

Set this to Y to calculate the sales value of the sale using the current list price for the item irrespective of whether or not a value is entered at the <SalesValue> element. When set to N, the value entered in the <SalesValue> element is used.

Notes and warnings

Import file considerations

  • The import file must be a valid XML file.

  • The import file is used by the IOPSSL business object.

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.