Versions Compared

Old Version 30

changes.mady.by.user Katie Price

Saved on

compared with

New Version 31

changes.mady.by.user Katie Price

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Note

Order Lookup requires implementation from the solutions team to enable/customize the app functionality. Below are the steps to install the file collection service on a local device/server. 

Overview

The Message Transformer Windows Service is the client service that will run on the customer premise/infrastructure to read the files and load them into our middle-ware for review & transformation. It is best to install this service in on a device that will have access to these files.

Warning

Before proceeding with the below procedure please ensure you have met the Order Lookup - Technical Requirements

Installation Procedure

Access the Directory of your "Order Files" & provide to your EFM Contact

e.g. C:\Users\My_Name\Documents\Oneflo\Order_lookup\

NoteYou will configure where the files are placed.However EFM configures

Table of Contents
stylenone

Pre-requisites

Set up the order file pick up location

Create the file location where the order files will be sent for Order Lookup to pick up the files from. efm will configure the service to collect these files. Once the location is set, please provide the location to your efm contact.

  • It is up to you where the files are placed but this location needs to be communicated with EFM.

  • Ideally please provide efm with the full UNC path of the files.

Download MT.Transformer.Installer.msi 

Tip

Example: 

C:\Users\Despatch\Documents\Oneflo\Order_lookup\

Adding an archive file location

Create a Sub-folder titled "Archive"

Note

Installing the service will create this for you, if you haven’t set it up before hand

Tip

Example: 

C:\Users\Despatch\Documents\Oneflo\Order_lookup\Archive\

Please move any files created prior to today's date to archive

Warning

Before installing

  • Ensure this is on a machine or Server that is always running. 

  • Prepare your Windows Service User (or a user

whose password WILL NOT EXPIRE)
  • YOUR USER SHOULD HAVE FULL READ/WRITE/DELETE ACCESS TO THE PROVIDED DIRECTORY

    • with a password that will not expire)

    • Your user should have full read/write/delete access to the provided directory. This is needed as the Service will move the files into an "Archive" sub-directory once processed.

    • Ensure you are running the latest version of  Microsoft .NET

    Step 1: Download the installer

    Download the installer by clicking here: MT.Transformer.Installer.msi

    Step 2: Run the

    Installation FileNext
    Select Directory for Installation

    installer

    Find the installer file. This can usually be found in the Downloads folder on your PC if it does not show in the web browser.

    Note

    You will need to set the installation folder. Ensure this is on a machine or

    Server

    server that is always

    running Next

    running

  • Next
    • Image Added

    Step 3: Set the Message Transmitter Credentials

    .

    This step will ask you for the Client Id and Token. This is provided to you by efm.

    • ClientID: <client_id>

    • Client Token: <client_token>

  • Next
    • Close
    Image Added

    Step 4: Confirm the service has been set up correctly

    Access the directory of your files to confirm they have been migrated to the "Archive Folder"

    Once the service has been installed,

    this windows service Image Removed

    it will show up in the Services console under the name Message Transformer and is started automatically.

    Only Required If Directory Already contains Order Files

    1. Create a Sub-folder titled "Archive"
      1. e.g. C:\Users\My_Name\Documents\Oneflo\Order_lookup\Archive\
        1. Please move any files created prior to today's date to archive\

    Image Removed

    Image Added

    Flow Chart

    Image Modified