INTEGRATION
IRP
Common Tasks (1)
Interventions (1)
Languages (1)
Questions & Answers (1)
Reviews (1)
Site Scripts (1)
Web Services (1)
Training Videos
Peer Support

Overview - Legacy (Integration)

How Tos (5)

You can find this section under Integration > Overview - Legacy in the IRP Admin left navigation menu.

The screen presents you with an overview of ‘legacy’ integrations on the IRP. The screen also provides you with summary log files that show what integration actions have been carried out and when they occurred, whether or not those actions were successful and details such as the name and IP address of the IRP Admin users who performed the integrations.

This is useful information because, if you notice that some data has been incorrectly formatted or that it is wrong in some way or other on your website, you need to know when the integration was carried out and by whom. You can then proceed to contact the user for more details, if necessary. You can then go on to correct the errors.

The overview screen for legacy integrations appears as follows:

Legacy Integration Overview screen

The information is grouped into the following sections:

  • Product Integration Overview
  • You use Product Integration to format and create recurring bulk imports of product data.

    This section includes the following summary information:

    • Is Integration Active: (Yes or No) This indicates whether product integration is ready to run, based on field mapping prerequisites and the presence of a product integration SQL query. If Integration is active, you will see a summary of information displayed in the lower part of the section (see ‘Integration Details’) below.
    • Product Data Last Integrated: This shows the date and time when the product integration was last performed. If not applicable, this will state ‘Not Integrated’. Click the Edit button to go to the Product section.

    When setting up your Legacy Product Integration for the first time you should follow these steps:

    • Set Data Manipulation Steps using the Manipulate Imported Data tab. See the Legacy Integrations: How To Add or Edit Data Manipulation Steps article for details.
    • Set Data Field Mappings using the Map Imported Fields tab. See the Legacy Integrations: How To Edit Field Mappings for Product Integrations article for details.
    • Create Integration SQL Query using the Integration Query tab. See the Legacy Integrations: How To Add or Edit an Integration Query article for details.
    • After these steps have been completed, you do not need to perform them again unless the import file format changes.

    • Perform the integration as described in the Legacy Integrations: How To Perform an Integration article.
  • Stock Integration Overview
  • Stock Integration is used to format and create recurring bulk imports of stock data. The section can also be used to update any value contained in the Stock table of your IRP database including Part Codes, EAN Codes, Postage Weights, prices, RRPs, etc.

    This section includes the following summary information:

    • Is Integration Active: (Yes or No) This indicates whether stock integration is ready to run, based on field mapping prerequisites and the presence of a stock levels integration SQL query. If Integration is active, you will see a summary of information displayed in the lower part of the section (see ‘Integration Details’) below.
    • Stock Data Last Integrated: This shows the date and time when the stock integration was last performed. If not applicable, this will state ‘Not Integrated’. Click the Edit button to go to the Stock section.

    When setting up your Legacy Stock Integration for the first time you should follow these steps:

    • Set Data Manipulation Steps using the Manipulate Imported Data tab. See the Legacy Integrations: How To Add or Edit Data Manipulation Steps article for details.
    • Set Data Field Mappings using the Map Imported Fields tab. See the Legacy Integrations: How To Edit Field Mappings for Stock Integrations article for details.
    • Create Integration SQL Query using the Integration Query tab. See the Legacy Integrations: How To Add or Edit an Integration Query article for details.
    • After these steps have been completed, you do not need to perform them again unless the import file format changes.

    • Perform the integration as described in the Legacy Integrations: How To Perform an Integration article.
  • Custom Integration Overview
  • You can use this section for any type of custom integration, for example you may want to use it for Orders Integration — you could upload a file to the IRP from your EPOS system then run SQL on it to update your Order statuses.

    This section includes the following summary information:

    • Is Integration Active: (Yes or No) This indicates whether custom integration is ready to run, based on the presence of a stock integration SQL query. If Integration is active, you will see a summary of information displayed in the lower part of the section (see ‘Integration Details’) below.
    • Custom Data Last Integrated: This shows the date and time when the custom integration was last performed. If not applicable, this will state ‘Not Integrated’. Click the Edit button to go to the Custom section.

    When setting up your Legacy Custom Integration for the first time you should follow these steps:

    • Set Data Manipulation Steps using the Manipulate Imported Data tab. See the Legacy Integrations: How To Add or Edit Data Manipulation Steps article for details.
    • Create Integration SQL Query using the Integration Query tab. See the Legacy Integrations: How To Add or Edit an Integration Query article for details.
    • After these steps have been completed, you do not need to perform them again unless the import file format changes.

    • Perform the integration as described in the Legacy Integrations: How To Perform an Integration article.

Legacy Integration Details

If Integration is active, you will see a summary of information displayed in the lower part of the section. The details include:

  • File Last Uploaded: The date and time of the last Integration File Upload.
  • Number of Rows in Import Table: The Number of Rows in the Integration Import table following the Upload of a delimited file.
  • Data Last Staged: The last date and time that Integration data was staged prior to Integration.
  • Number of Rows in Staging Table: The Number of rows in the Integration staging table.
  • Pre-Requisite Field Mappings Assigned: Have the Pre-Requisite Field Mappings been set up for the Integration (Yes/No)?
  • Field Mappings: The Number of Field Mappings between Integration Import Fields and Integration Staging Fields (including the Pre Requisite Field Mappings).
  • Data Manipulation Steps: The Number of Active Manipulation Steps to be performed on Imported Integration data prior to it being Staged.
  • Integration SQL Query Set Up: Is there a Integration SQL Query set up for the Integration (Yes/No)?

Integration Log

The Integration Log section includes the following summary information. You can use the search bar to find particular files and if you expand Other Options under the Search bar, you can search by Integration Type (Product, Stock or Custom):

  • Username: This shows the username of the IRP Admin user who carried out a stock levels integration.
  • Type: This shows the type of integration — Product, Stock or Custom.
  • Detail: This shows the action that the user carried out, for example, “Field Mappings Deleted”.
  • Success: This shows whether the action was successful (True) or unsuccessful (False).
  • IP Address: This shows the user’s IP address.
  • TimeStamp: This shows the date and time when the user carried out the action.

You can add Integrations by clicking the Add Product Integration, Edit Stock Integration, Add Custom Integration or Add New Dynamic Integration buttons at the top of the screen.

Also you can click the Dynamic Integrations button to go to the main IntegrationOverview.aspx screen where you can see an overview of dynamic integrations, as described at the start of this topic.



How To Guides (5)

Data Manipulation steps are used to manipulate/edit the data you are uploading into a compatible format so that it can be imported into your IRP database successfully. This section allows you to set the step/s which will be performed on the import data. They will be repeated automatically, each time a Stock Integration is performed. There are a number of different manipulations which can be performed on an import file:

Setting Description
Custom Manipulation This allows you to execute a SQL Script. This option should be used if you cannot manipulate data using the following Data Manipulations. In the example below, the Price value is being changed to the Price plus 10% where the original Price value is less than £5.
Add New Field This allows you to add a new field to the import file. You can provide the Name, Data Type, Size and Default values as well as enable/disable Null values. In the example below, the EntryDate value is being added to record the date that the data was entered. A default value of the current date is being set using the GETDATE() command.
Remove Field This allows you to remove an existing field from the import file. In the example below, the ManufacturerCode field will be removed from the import file.
Rename Field This allows you to rename an existing field in the import file. You must supply the Field you wish to rename and the new name value. In the example below, the ManufacturerCode field will be renamed PartCode in the import file.
Change Field Type This allows you to change the Data Type and/or Size of an existing field in the import file. In the example below, the Data Type of the Price Field will be changed to Money.
Replace Text This allows you to replace text in an existing field with a different value in the import file. In the example below, the text 'Size 8' is being replaced with 'Small' in the Option field.
Remove Text This allows you to remove text from an existing field in the import file. In the example below, the text 'Brand X' will be removed from anywhere in the Model field.
Append Text This allows you to append text to an existing field in the import file. In the example below, the text 'Brand Y' will be added to the beginning of the Model field.
Split Field This allows you to split the value held in one field into two separate fields. In the example below, the ManufacturerCode field contains values such as 'CAT01-15895'. This value contains the Category ID of 'CAT01' and the product PartCode of '15895'. The values are separated by the '-' character. This will split these two values into separate fields called Category and PartCode.
Remove Quotation Marks This allows you to remove quotation marks from an existing field in the import file. In the example below, quotation marks will be removed from the Model field.
Set Field Value This allows you to set a default value for all records in an existing field, in the import file. In the example below, a default value of '1' will be set against all records of the StockHeldExternally field.
Capitalize Field This allows you to capitalize the first character of an existing field in the import file. In the example below, the first letter of the value stored in the Brand field will be capitalized in each record of the import file.
Remove Whitespace This allows you to remove all whitespace from an existing field in the import file. In the example below, all whitespace in the PartCode field will be removed in each record of the import file.

Add Data Manipulations

To add a Data Manipulation Step, follow these steps:

  1. Go to Integration > Overview in the IRP left navigation menu.
  2. Click the Edit button for the type of legacy integration that you want to perform (Product, Stock or Custom).
  3. Click the Manipulate Imported Data tab.

    There are three sections here:

    Setting Description
    Add Data Manipulation Step Allows you to add a new Data Manipulation Step.
    Edit Data Manipulation Steps Allows you to edit an existing Data Manipulation Step.
    Sample of Imported Stock Data Displays a sample data set of the previously imported data.
  4. To add a Data Manipulation Step, select the Manipulation from the drop down and enter the required values discussed above.

    Please note that further information on each value is displayed by hovering the mouse pointer over the corresponding text field:

  5. Once you are satisfied with the manipulation, click the Add Step button to save it.
  6. Repeat points 3 and 4 for each Data Manipulation required in the Stock Integration.

Edit Data Manipulations

Once a Data Manipulation Step has been added, you can edit the following details:

Setting Description
Execution Order The order in which the manipulations will occur. This will be important in certain cases. For example, if you are adding a new Field upon which you plan to perform another data manipulation on. The column must exist with its values before any further manipulations can be carried out on it.
Notes Admin Notes can be used to inform other users of the purpose of the Data Manipulation Step.

Once changes have been made, click the Update Data Manipulation Steps button to save them.


CONNECT
UK 02890 78 5869
Ireland 01 513 4969
International +44(0)2030 96 03 95
STAY CONNECTED WITH IRP COMMERCE
  Sign Up
Copyright © 2019 IRP Commerce. Use of this website constitutes acceptance of the IRP World Terms of Use, IRP Privacy Policy and IRP Cookie Policy
IRP Commerce is a Trading Name of Export Technologies Limited, Concourse 2, Catalyst, Belfast, BT3 9DT, UK. Registered in Northern Ireland, Number: NI 041856. VAT Number: GB 888249658
A Deloitte Fast 50 Company six times: 2010, 2011, 2012, 2013, 2014 & 2018