Connectors → Oracle Warehouse Management Software
About Oracle WMS
The Oracle Warehouse Management Software (WMS) connector brings your logistics data into Incorta so you can start investigating your data and building insights. Oracle WMS Cloud is the logistics system in the Oracle Supply Chain Management and Manufacturing system.
Oracle WMS Connector Updates
This section is to explore the updates in the newer versions of the Oracle WMS connector available on the Incorta connectors marketplace.
In order to get the newer version of the connector, please update the connector using the marketplace.
| Version | Updates |
|---|---|
| 2.0.1.1 | With the 2.0.1.1 update, the Oracle WMS connector now supports the following: ● Chunking ● The ability to extract the nested “relation” entities as a foreign key or a JSON text. Note: By default Incorta discovers the nested objects “relation” as a foreign key (long). During the extraction the id attribute of this object is only extracted. If the nested object does not have an id attribute or does not represent a foreign key, you need to discover this object as string to extract the JSON of this object. |
About Oracle WMS connector
The Oracle WMS connector supports the following Incorta-specific functionality:
| Feature | Supported |
|---|---|
| Chunking | ✔ (starting version 2.0.1.1) |
| Data Agent | |
| Encryption at Ingest | |
| Incremental Load | ✔ |
| Multi-Source | ✔ |
| OAuth | |
| Performance Optimized | ✔ |
| Remote | |
| Single-Source | ✔ |
| Spark Extraction | |
| Webhook Callbacks | ✔ |
Steps to connect Oracle WMS and Incorta
To connect Oracle WMS and Incorta, here are the high level steps, tools, and procedures:
- Create an external data source
- Create a schema with the Schema Wizard
- or,Create a schema with the Schema Designer
- Load the schema
- Explore the schema
Create an external data source
Here are the steps to create a external data source with the Oracle WMS connector:
| Property | Control | Description |
|---|---|---|
| Name your connector | text box | Enter a name for your data source |
| Domain | text box | Enter the URL for the Oracle WMS services API in the following form: https://<SERVICE_NAME>.wms.ocs.oraclecloud.com/ |
| Username | text box | Enter the username for the data source |
| Password | text box | Enter the password for the data source |
| Pagination Mode | drop-down | Select the pagination mode required from the following available values: ● Paged ● Sequenced |
| Timeout in seconds | text box | Enter the time in seconds to wait for a response from the Oracle WMS server. The default is 30 seconds. |
| Max number of concurrent calls | text box | Enter the maximum number of concurrent calls that Incorta sends to the Oracle WMS server. The default is 5 calls. |
| Max number of requests per minute | text box | Enter the maximum number of requests done per minute to the Oracle WMS server. The default is 30 requests. |
Create a schema with the Schema Wizard
Here are the steps to create an Oracle WMS schema with the Schema Wizard:
- Sign in to the Incorta Direct Data Platform™.
- In the Navigation bar, select Schema.
- In the Action bar, select + New → Schema Wizard.
- In (1) Choose a Source, specify the following:
- For Enter a name, enter the schema name.
- For Select a Datasource, select the Oracle WMS data source.
- Optionally create a description.
- In the Schema Wizard footer, select Next.
- In (2) Manage Tables, in the Data Panel, first select the name of the Data Source, and then check the Select All checkbox.
- In the Schema Wizard footer, select Next.
- In (3) Finalize, in the Schema Wizard footer, select Create Schema.
Create a schema with the Schema Designer
Here are the steps to create an Oracle WMS schema using the Schema Designer:
- Sign in to the Incorta Direct Data Platform.
- In the Navigation bar, select Schema.
- In the Action bar, select + New → Create Schema.
- In Name, specify the schema name and select Save.
- In Start adding tables to your schema, select Oracle WMS.
- In the Data Source dialog, specify the Oracle WMS table data source properties.
- Select Add.
- In the Table Editor, in the Table Summary section, enter the table name.
- To save your changes, select Done in the Action bar.
Oracle WMS table data source properties
For a schema table in Incorta, you can define the following Oracle WMS specific data source properties as follows:
| Property | Control | Description |
|---|---|---|
| Type | drop down list | The default is Oracle WMS |
| Data Source | drop down list | Select the Oracle WMS external data source |
| Data Store Entry Method | drop down list | You can either select to Enter Fully Qualified Data Store Name or Select from List. |
| Top-Level Application Module | drop down list | Choose Select from List in Data Store Entry Method to configure this property. Select your catalogue name. |
| Intermediate Application Module | drop down list | Choose Select from List in Data Store Entry Method to configure this property. Select your schema name. |
| Data Store | text box | Enter Fully Qualified Data Store name. |
| Incremental | toggle | Enable the incremental load configuration for the schema table |
| Irregular Pattern | toggle | Toggle if Fully Qualified Data Store name does not follow conventional pattern of file_<schema>_<catalog>_<table> or if it contains uppercase letters |
| Which Batches to Load | drop down list | For full-load-always tables, control which batches you want to load into Incorta. Select one of the options: Load Last Batch Only option (the default) Load All Batches |
| Data Type Discovery Policy | drop down list | Metadata Definition files must be uploaded first to Incorta data files, and must have .csv extension. |
| Load Only Files Created Since | text box | Filter which files to load based on the file creation timestamp. Use either a fixed date in the format yyyy-MM-dd HH:mm (example: 2019-05-31 15:30), or a look-back period expressed as the number of years, months or days before the loading starts (example: use the value 90d to load files that have been created since 90 days) |
| Date Format | drop down list | Choose the suitable date format from the list provided. Or, you can choose Other and provide your own format in the Other field that will appear. |
| Timestamp Format | drop down list | Choose the suitable timestamp format from the list provided. Or, you can choose Other and provide your own format in the Other field that will appear. |
| Character Set | drop down list | Select the character set |
| Callback | toggle | Enable this option to call back on the source data set |
| Callback URL | text box | Enable Callback to configure this property. Specify the URL. |
View the schema diagram with the Schema Diagram Viewer
Here are the steps to view the schema diagram using the Schema Diagram Viewer:
- Sign in to the Incorta Direct Data Platform™.
- In the Navigation bar, select Schema.
- In the list of schemas, select the Oracle WMS schema.
- In the Schema Designer, in the Action bar, select Diagram.
Load the schema
Here are the steps to perform a Full Load of the Oracle WMS schema using the Schema Designer:
- Sign in to the Incorta Direct Data Platform™.
- In the Navigation bar, select Schema.
- In the list of schemas, select the Oracle WMS schema.
- In the Schema Designer, in the Action bar, select Load → Full Load.
- To review the load status, in Last Load Status, select the date.
Explore the schema
With the full load of the Oracle WMS schema complete, you can use the Analyzer to explore the schema, create your first insight, and save the insight to a new dashboard.
To open the Analyzer from the schema, follow these steps:
- In the Navigation bar, select Schema.
- In the Schema Manager, in the List view, select the Oracle WMS schema.
- In the Schema Designer, in the Action bar, select Explore Data.
Additional Considerations
Types of Incremental Loads
You can enable Incremental Load for a Oracle WMS data source. There are two types of incremental extracts:
Last Successful Extract Time
Fetch updates since the last time the tables were loaded. It is determined by the difference between the current time and the database timestamp.
Maximum Value of a Column
The column-based strategy depends on an extra column called Incremental Column in each table. The Oracle WMS connector supports both timestamp and numeric columns. A timestamp column is of the type date or timestamp. A numeric column is of the type int or long.
Changing the incremental load strategy requires a full load to ensure data integrity.