BeyondERP.Newsletter
Menu

Setup page · Transportation management

Generic engine

A setup page where you define generic engines, the simple auxiliary engines that other transportation management engines use, such as an apportionment engine.

Used by
Logistics manager, Transportation coordinator
Business process
Manage freight and transportation
Menu item
TMSGenericEngine
Main table
TMSGenericEngine
Data entity
TMSTransportationGenericEngineEntity
Setup steps
1 on this page
Show what matters for
PAGE GUIDEWhat the page does and how to use it8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA setup page where you define generic engines, the simple auxiliary engines that other transportation management engines use, such as an apportionment engine.
What you do hereUse this page to set up auxiliary engines, such as apportionment engines, that spread the final transportation costs over specific orders and lines based on dimensions such as volume and weight.
Generic engine page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

Business processManage freight and transportation
Menu pathTransportation management › Setup › Engines › Generic engine
Related pagesRate engine Microsoft Learn
End user · Functional consultant

3How to do it

About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.

Setup steps on this page

Set up Generic engine

Use this page to set up auxiliary engines, such as apportionment engines, that spread the final transportation costs over specific orders and lines based on dimensions such as volume and weight.

How to use it

  1. Go to Transportation management > Setup > Engines > Generic engine.
  2. On the Action Pane, select New to add a line.
  3. Enter the Generic engine code and Name, and select the Engine type.
  4. Enter the Engine assembly and Engine class, select the Source Type and set the Default option.
  5. On the Action Pane, select Parameters to enter the engine's parameters.

Source: Checked in Dynamics 365

Test checklist

  1. Create the generic engine and set its engine assembly and class.
  2. On the rate engine, set the ApportionmentEngine parameter to this engine's code.
  3. Rate and confirm a load with several order lines.
  4. Check the freight charge is apportioned to the order lines as miscellaneous charges.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Generic engineSet up an apportionment engine as a generic engine and reference it from the rate engine's ApportionmentEngine parameterGeneric engines are auxiliary engines used by other engines; the apportionment engine spreads final freight cost over orders and lines by volume or weight.Leaving the rate engine without an apportionment engine reference, so freight cost is not spread to the order lines as expected.
Solution architect

5Design impact

Shared or per companyPer company: each legal entity has its own records. Microsoft data model
Can it be undoneReversible: The engine system lets you change calculation strategies at run time. Freight already apportioned to confirmed loads is not recalculated. Microsoft Learn
Technical architect

6Technical

Menu itemTMSGenericEngine Checked in Dynamics 365
FormTMSGenericEngine Checked in Dynamics 365
TableTMSGenericEngineShown as “GENERIC ENGINE” in Record infoKey field: GenericEngineCodeChecked in Dynamics 365
Data entitiesTMSTransportationGenericEngineEntityTransportation generic engines Microsoft data model
Who can open itPrivilegesMaintain generic engines TMSGenericEngineMaintainView generic engine information TMSGenericEngineViewDutiesMaintain transportation management engine details configuration TMSEngineConfigurationDetailMaintainInquire into transportation management engine configuration TMSEngineConfigurationInquireMaintain transportation management engine configuration TMSEngineConfigurationMaintainInquire into transportation management policies TMSTransportationMgmtPoliciesInquire
2 security rolesLogistics manager TMSLogisticsManagerTransportation coordinator TMSTransportationCoordinator
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itLogistics manager TMSLogisticsManagerTo use itTransportation coordinator TMSTransportationCoordinatorGive people one of these roles. On this system, 2 roles can open this page.Checked in Dynamics 365
Actions on the page(Action Pane without tabs): ParametersChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=TMSGenericEngine
Integrate withTMSTransportationGenericEngineEntity data entity Microsoft data model
Data migrationTMSTransportationGenericEngineEntity (Transportation generic engines): loaded for each company, in Microsoft's default template 405 - Transportation management.Load order: Microsoft's default template 405 - Transportation management loads Transportation generic engines at execution unit 1, level 30, sequence 10. Lower levels load first, and entities at the same level load in sequence order.Load first: the default templates at lower levels (System setup to General ledger)Microsoft Learn
Table definitionTMSGenericEngine columns and relations Microsoft data model
Everyone

8Sources