Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Warning
titleImportant

Make sure you published the solution before proceeding to following steps.

You can upload your data file into the region after you publish the solution. There are several ways to upload (ingest) your data file into the region. This section describes two ways to do so.

Option 1: Using Run button.

  1. Click Run button in the ribbon.

Image Removed

...

The first option described uses the Run option to upload (ingest) your data file into the region. This method is useful during the development stages. The second option described assumes that data files will be uploaded to the region automatically, and then the load gets triggered by sending a control message, also called a Run Task Request message, to Message Center.

On this page

Table of Contents

Option 1: Use the Run Option

You can use the Run option to upload (ingest) your data file into the region. This method is very useful for testing the workflow in the development stages.

Before you upload your data file, make sure you published the solution. For more information, see Publish the IWS Solution for CSV.

To upload your data file using the Run option:

  1. In the Raw Service tab, click Run.

    Raw Service tab - Run optionImage Added

    You see the Run RDS Process dialog box. The Run Parameters tab is selected by default. 

  2. Select the data file from a local folder by

...

  1. clicking the ellipsis button (

...

  1. in the Run RDS Process dialog box.)

...

  1. Run RDS Process dialog box - Ellipsis (...) buttonImage Added

     

...

  1. Click the Run button in

...

  1. the Run RDS Process dialog box.

Image Removed

4. View load details in the EJM Processes tab.

  1. Run RDS Process dialog box - Run butotnImage Added

    After you click the Run button, a new tab

...

  1. named EJM Processes

...

  1. appears. It

...

  1. contains the processing details of the solution.

  2. Review the EJM Processes tab to view the load details.

  3. You may need to click

...

  1. the Refresh button to update the information during the execution.

Image Removed

...

  1. You can access this information later by running the Monitoring Tool application.

...

  1. You can

...

  1. open it from IWS's Solution tab.

Option 2.

...

Use the File Name in the Run Task Request (RTR)

...

Message

Option 1, described above, is very useful for testing the workflow in development stages.

...

However, after your workflow

...

is developed, tested, and deployed to the PROD region, the way you deliver data to your application

...

changes.

...

 It is expected that data files will be uploaded to the region automatically, and then the load gets triggered by sending a control message (also called a

...

Run Task Request message) to Message Center.

The default location for data files in this case is tpe/data/msgcenter/cmw/in,

...

In Automation Center

...

, you can use helper stream eagle_ml-2-0_default_cm_data_

...

load_cmw_in to upload your data file into this folder.

Note

Make sure you published the solution before you upload your data file. For details, see Publish the IWS Solution for CSV.

To upload your

...

data file

...

using the Run Task Request Message:

  1. In Automation Desk, click Events in the left navigation. 
    You see the Events workspace.

  2. Search for the message stream helper stream named eagle_ml-2-0_default_cm_data_load_cmw_in

...

Follow these steps:

...

  1. to upload your data file into this folder.
    The following figure shows how you can search for the helper stream event by searching for an event name of *_cmw_in.

  2. Select the eagle_ml-2-0_default_cm_data_load_cmw_in event row in

...

  1. the grid, right-click

...

  1. the

...

Select your file in dialog window and click send. And after those actions your file will be uploaded on the region.

Warning

Run the Load process for XML only from IWS. Do not start it from Message Center!

...

You can set the parameters of load process. 

Fancy Bullets

Delivery method – where is your data file:
FILE – on current region (should be located in "/cmw/in/" folder);
FTP/SFTP – on FTP/SFTP server (should be located in folder which was set in parameter: FTP_FILES_LOCATION/SFTP_FILES_LOCATION in "w_config_custom.inc" file).
File Name – name of data file.

Image Removed

...

  1. row, and then click Send Data.
    Now you need to tell Message Center to start processing this file. You can use same Send Data option, but this time for the eagle_ml-2-0_default_cm_control_message stream. 

  2. Search for the message stream named eagle_ml-2-0_default_cm_control_message.
    The following figure shows how you can search for the event by searching for an event name of *_control_message.

  3. Select the eagle_ml-2-0_default_cm_control_message event row in the grid, right-click the row, and then click Send Data.

  4. Review the RTR message content.
    The content of the RTR message should look like the following:

    RTR message

    Code Block
    languagexml
    <EagleML xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="RunTaskRequestSync" xmlns="http://www.eagleinvsys.com/2011/EagleML-2-0" eaglemlVersion="2-0" xsi:schemaLocation="http://www.eagleinvsys.com/2011/EagleML-2-0 eagleml-main-2-0.xsd" eaglemlType="RunTaskRequest">
      <header>
        <messageId>5EDA26591AB784</messageId>
        <sentBy>http://www.client.com/eagleadmin</sentBy>
        <sendTo>http://www.eagleinvsys.com/eagle_ml-2-0_default_cm_control_message</sendTo>
        <replyTo>http://www.client.com/Eagle Control Messages</replyTo>
        <creationTimestamp>2020-07-06T11:43:08-04:00</creationTimestamp>
      </header>
      <taskIdentifier>
        <correlationId correlationIdScheme="correlationIdScheme">5EDA26591AB784a</correlationId>
        <businessTaskId correlationIdScheme="businessTaskIdScheme">5EDA26591AB784a</businessTaskId>
      </taskIdentifier>
      <taskTypeEnum>NEW</taskTypeEnum>
      <taskParameters>
        <taskParameter>
          <name>StreamName</name>
          <dataType>S</dataType>
          <value>eagle_ml-2-0_default_cm_execwkfl</value>
        </taskParameter>
        <taskParameter>
          <name>ActionType</name>
          <dataType>S</dataType>
          <value>EXECUTE</value>
        </taskParameter>
        <taskParameter>
          <name>WorkflowName</name>
          <dataType>S</dataType>
          <value>testvendor_feed_1_raw_data</value>
        </taskParameter>
        <taskParameter>
          <name>WorkflowData</name>
          <dataType>S</dataType>
          <value>example_buildingtable.csv</value>
        </taskParameter>
      </taskParameters>
    </EagleML>
  5. There are three values which you may need to adjust: 
    - correlationId. This should be a unique value for the region. Messages with duplicate correlation Ids are rejected by the system.
    - workflowName. This value should reflect the workflow name. You can see it in the Publish screen.
    - WorkflowData. This is the name of data file which you uploaded to the cmw/in folder.