OTM Rates Model 101

One of key features in OTM (Oracle Transportation Management) is its rates engine. You can setup OTM rates engine into different model. These are the key tips you can use to build your rating model.

TL and LTL Base

The 2 most common rate types are TL (Truck Load) and (Less than Truck Load). You need to have the majority of masterdata to complete these 2 rates model from end to end. The basic masterdata required are:

  • Service Provider
  • Equipment for TL
  • LTL rating by weight or volume
Testing and Building

With this 2 rate models, you can cover up to 70% of rates out there. The next steps are to setup the processes for these 2 rates model. These processes are grouped by:

  • Update of masterdata
  • Loading of rates
  • Testing of rates
  • Expiry and updates of rates

If you are new to OTM, do focus on these basic rate model and know the rate processes well yourself. This will helps your build your confidence before you add more rates model. The processes are the most difficult for users understand and self service in OTM. Follow these steps and you will be rewarded!

OTM Shipment Planning 101

OTM (Oracle Transportation Management) Shipment Management module have a shipment planning feature which allows you to optimise your load. However, there is a catch that is not known to users. The optimisation is as good as your masterdata. These are some quick tips to have a basic optimisation in shipment planning.

Basic Optimisation

For basic optimisation, you will need the following conditions to get it up and running.

  • Assume a constant settings
  • Obtain a base masterdata

Basic optimisation rule will require some constant settings. The common constant setting to use is time. You will need to assume your shipment planning without time constraint or configuration. With this assumption, you can focus on a base masterdata set. This set of masterdata will consist of :

  • Rates
  • Itinerary
  • Equipment
  • Transport Modes
Advanced Optimisation

The basic optimisation provides the minimum start point for all shipment planning. Advanced optimisation will restore the time duration as a factor for your optimisation. The additional masterdata will include :

  • Distance
  • Transit Time
  • Package count
  • Routes Information

You can provide shipment planning in OTM into two key flavors

  • Basic optimisation
  • Advanced optimisation

The options will determine the amount of masterdata required. Subsequently, this translates to your project scope, time and efforts. If you are new to OTM shipment planning, do go for basic optimisation configuration. This will help you familiarise with the base masterdata. Only then, you can tackle the advanced one.

OTM DD/MM/YYYY or MM/DD/YYYY

Dates format are a nightmare for application if you are handling a global system. Most application provide a certain level of configuration for user preference. OTM (Oracle Transportation Management) is one such application that allows you to configure date format for users. However, this can be quite painful because the date format can vary in each module. These are the OTM portions where you should take note.

OTM Date Configuration

You can configure date format with user preference. The user preference can also be superseded by the preference in contact module. Some of the OTM fields are in date type. There is also attribute date fields as placeholder. Report parameters date format can be overwritten by date format in report library.

Dates to Take Note

You will find many painful points when you are using character field for dates. This can be in the form of refnum or integration xml. Many of the reports required dates filter. You may want to consider the usage of date field for these filter instead of character data type. You will find a lot of conversion format between to_char and to_date in your report query.

Whether you are upgrading or migrating, the impact on date format is very huge. OTM is one such application with flexibility on date format usage. This caused a challenging task for technical team who will be maintaining a global system. Should you standardise your date format instead?

OTM Dilemma

OTM (Oracle Transportation Management) can be a big dilemma if we are moving to cloud or upgrading. It is a configurable system that allows customisation from small degree of change to major one. A major part would be your decision to upgrade or migrate to cloud from the amount of configuration or customisation done to OTM.

Photo by Ethan Kwok
Cloud Dilemma

Many organisations would prefer to migrate to cloud for future support and upgrades. separate the customisation Cloud, like its name, really is cloud. You cannot foresee what will happen in Cloud until you are in Cloud. Your risk appetite will need to be high if you have done a lot of customisation on OTM. Prior your move to Cloud, a major task is to separate the customisation into REST services. How much time and effort will you invest? Should you forgo your customisation instead?

Upgrading Dilemma

Upgrading OTM major version can be quite a slow painful experience. The 6.4.3 is the last available version that is non Cloud based. The decision not to move to Cloud usually lies with the amount of customisation done. The biggest changes from old version to 6.4.3 version are architectural, user interface (UI) and report server. The dilemma comes in the sequence of upgrade you want to take. Report server is now mandatory after the removal of embedded reports. Should you move your embedded report first or do together with upgrade? How much training period should you allow for the new UI? How much time will it take to fix your customisation during the upgrade?

OTM upgrade or migration to cloud is a painful dilemma. There is always a temptation to status quo the version due to the massive efforts to factor risk and change management. In many cases, you need lots of patience and alternate plans while you are upgrading or migrating.

OTM QuickStart Configuration

If you are familiar with OTM (Oracle Transportation Management), you will be overwhelm with the features. Thus, you may want quick way to jumpstart your solution configuration? There are some quick tips that comes with standard OTM solutions.

Basic Start

OTM comes with many default settings that you can quickly use for your setup and testing. Below are 3 basic modules that are used.

  1. Masterdata, the basic setup is itinerary, service provider, dummy rates and locations.
  2. Order Management, create your first orders with the locations.
  3. Shipment Management, you can easily plan your order into shipment with default settings.
Troubleshooting

The default vanilla OTM is the easiest to setup. There is only a few areas that can go wrong. The most common mistakes usually occurs in shipment planning.

  • Itinerary settings does not match the masterdata setup.
  • Rates setup does not match order transport and mode profile.
  • Bulk plan time emphasis is a constraint for your order pickup and delivery dates. You can set it to NONE constraint instead.

Configurations can be easily setup for vanilla OTM with the above basic settings. This is very useful for migration or upgrade purposes to test that OTM are setup properly.

OTM Templates Design

Templates design is a common solution in many Cloud applications. After all, why do you need to reinvent the wheel? This approach is also commonly used in OTM (Oracle Transportation Management). While there are advantages to the template, this approach also have certain drawbacks.

Template Quick Guides

The type of templates will determine how duration of your customer onboarding. You can follow these quick guides in your templates approach.

  • Keep your templates to less than 8.
  • Look to data auto assignment rules.
  • Collect enough masterdata but not too much of it.
  • Prefill templates data as much as possible.
  • Use API to automate data collection in templates.
  • Provide auto validation checks.
Things to Avoid

Templates have some drawbacks which we need to take note and mitigate.

  • Do not over invest in your templates. It is a means to an end.
  • Templates cover common scenarios. Remember to provide options to templates design.
  • If there are a constant increase of your templates, look to refactoring and harmonise your templates.

Using templates in OTM greatly speed up your customer onboarding time. However, templates are just a tool and should not complicate your OTM configuration.

OTM VPD Tips

Oracle VPD (Virtual Private Database) is a quick security policy design for the database. This is also one of the features in OTM (Oracle Transportation Management) application. The setup of VPD can be quite painful if you are new to Oracle and OTM. In OTM, this can be a great struggle as you seek to maintain the VPD configured by your predecessor.

OTM VPD Error

OTM is notoriously famous for many VPD errors when things goes wrong. Many log errors will flag as policy violations. In some cases, your OTM UI screen (User Interface) will just freeze or give a weird error if you try to edit the object. There is another instance where you find your changes cannot be committed to database.

OTM VPD Tips

These are some common VPD tips to speed up your understanding in OTM.

  • Test out your issue with or without VPD.
  • Always consider VPD as one of the possible root cause of reported issue.
  • VPD may not work well if your SQL contain too many relational tables.
  • Keep your SQL in VPD short and simple.
  • If your VPD is complex, consider ways to simplify it by using a column field on the object.
  • Do not implement VPD for the sake of VPD.

VPD in OTM is quite a pretty neat extension of Oracle database. You will usually need some advanced knowledge of SQL to maintain and decipher the VPD. As a rule of thumb, it is good practice to keep VPD simple to spare your future headaches.!

OTM Screen Issue

The slowness of OTM screen loading is a known issue. This is worst in Asia with some offices having lower internet speed and network. As a result, OTM is not suitable for deployment for such areas. Have you ever wonder how to solve it? A common approach is to increase the server CPU or network bandwidth. You may even try to upgrade the user laptop or proposed faster browser.

Root Cause

The root cause is due to the SQL used to generate the screen. You can turn on your logs and include the SQL option for the log file. Get the SQL used in the slow screen and run explain plan for it. From the results, you will notice the root cause is caused by the usage of sub tables like status and refnum.

Simple Ways to Fix

Before you go and upgrade your server and network, you can try the following simple ways to improve the screen loading.

  1. Reduce usage of status and refnums in screenset.
  2. Use VPD. This will constraint the query data.
  3. Add domain name in Screenset criterion.

If you have any other good ideas to speed up the screen loading, drop me a DM.

Lesson from OTM LTL Error

Last week, we hit a weird default OTM (Oracle Transportation Management) error whereby LTL (Less Than Truckload) transport mode shipment does not tender out with the standard secure resources status. Instead, secure resources status was changed to SECURE RESOURCE_PICKUP NOTIFICATION. As a result, the service provider cannot accept the tender for this status. Thankfully, OTMFAQ forum give us the clue to resolve this. I will explain the rationale here instead.

OTM Default Workflow

The “issue” is actually due to a default business scenario in United States (US). In layman terms, LTL means loose cargo. Thus, service provider is expected to pickup the loose cargo rather than the need to accept the tender request. This is why the status is called SECURE RESOURCE_PICKUP NOTIFICATION. In a way, the request is auto accepted. The way to fix it is to amend the workflow configuration by adding LTL into the TENDER%MODES values.

OTM and its Culture

Debugging in OTM is a challenging task and can consume lots of unproductive hours. Historically, this product was tested widely in US and Europe and very less for Asia. There are many default values that are catered to the American and European audiences. The key tip is to understand and know which are defaulted. If you manage to find this configuration, we usually cross our fingers and hope that the default values can be amended.

All product are designed by humans. Unknowingly, cultures are factored into its design. A good product should always configuration of these default cultural values. One way to do so is to test its localisation features.

OTM Status Inital Value

Today I have an shocking discovery on a configuration of an initial value setting for OTM (Oracle Transportation Management) status. The initial value is set as Error! It is really amazing to think how this could be an initial value. Of course, valuable hours are wasted to debug an initial value which is actually correct by its initial“error state”.

Happy Path Design Approach

The state diagram is fundamental of engineering and software lifecycle if you are familiar. There should never be an initial value as error or exception. One must alway think of happy path and start with a perfect flow. Starting with an erroneous state gives confusion to users and SME (Subject Matter Expert), as we do not know what is wrong when nothing have started. Be Optimistic and always go for Happy Path Design Approach.

Design by Norms, Think like a Traffic Light

The best solution design is design by Norms and thinking like a Traffic Light. Green is a Go, Red is Stop and Yellow is proceed with caution. Thinking like traffic light greatly reduce learning curve from users and have high system adoption rate. It is one of the best design where users can easily learn with no user manual or training. Do not break the norms and do fanciful solution. You will end up confusing and these type of solution always get discarded due to its complexity.