新しい輸送管理エンジンの作成

[アーティクル]
11/15/2023

この記事では、Dynamics 365 Supply Chain Management で新しい輸送管理エンジンを作成する方法について説明します。

輸送管理 (TMS) エンジンは、輸送管理で配送率を生成およびプロセスするために使用するロジックを定義します。 Supply Chain Management は、レート、輸送時間、および輸送中に越えるゾーンの数などのさまざまなパラメーターを計算する複数の異なるエンジンタイプを提供します。この記事では、Microsoft Visual Studio 開発環境と Supply Chain Management 開発ツールを使用して新しい TMS エンジンを作成して展開する方法と、次に Operations でエンジンを設定する方法について説明します。エンジンに関する詳細については、輸送管理エンジンを参照してください。

新しい TMS エンジンを作成する

このセクションでは、TMS エンジン実装を持つクラスライブラリを作成する方法と、Supply Chain Management モデルからクラスライブラリを参照する方法について説明します。

新しいエンジンを配置するには、エンジンを含めるモデルが必要です。 Dynamics 365>モデル管理メニューで、モデルの作成をクリックして、新しいモデルを作成します。 モデルの作成ウィザードの最初のページで、モデル名を TMSEngines にします。
次のページで、新しいパッケージの作成を選択します。
次のページで、参照する ApplicationSuite モデルを選択します。 (ApplicationPlatform モデルが事前に選択されています)。
次のページで、完了をクリックして新しいモデルの作成を確認します。
新しいソリューションで、新しい Supply Chain Management プロジェクトを作成し、TMSThirdParty と名前を付けます。プロジェクトプロパティで、プロジェクトのモデルを TMSEngines に設定します。
ソリューションに新しい C# クラスライブラリを追加し、ThirdPartyTMSEngines という名前をつけます。
ThirdPartyTMSEngines プロジェクトで、Supply Chain Management 固有のアセンブリへの参照を追加します。
- X++ タイプの参照を有効にするアプリケーションアセンブリ。これらのアセンブリは、次の場所にあります。 [パッケージルート] は、C:\Packages など、展開されたアセンブリが配置されている場所のパスです。
```
[Packages root]\ApplicationPlatform\bin\Dynamics.AX.ApplicationPlatform.dll
[Packages root]\ApplicationFoundation\bin\Dynamics.AX.ApplicationFoundation.dll
[Packages root]\ApplicationSuite\bin\Dynamics.AX.ApplicationSuite.dll
```
- データ、LINQ、および補助機能へのアクセスを有効にするフレームワークアセンブリ。これらすべてのアセンブリは [パッケージルート]\ 在庫置場で見つけることができます。
```
Microsoft.Dynamics.ApplicationPlatform.Environment.dll
Microsoft.Dynamics.AX.Data.Core.dll
Microsoft.Dynamics.AX.Framework.Linq.Data.AdoNet.dll
Microsoft.Dynamics.AX.Framework.Linq.Data.dll
Microsoft.Dynamics.AX.Framework.Linq.Data.Interface.dll
Microsoft.Dynamics.AX.Framework.Linq.Data.Msil.dll
Microsoft.Dynamics.AX.Server.Core.dll
Microsoft.Dynamics.AX.Xpp.AxShared.dll
Microsoft.Dynamics.AX.Xpp.Support.dll
```
- コア TMS アセンブリ (エンジンを含む) と TMS ベースアセンブリ (ヘルパー、定数、データ転送クラス定義などを含む) これらのアセンブリは、次の場所にあります。
```
[Packages root]\ApplicationSuite\bin\Microsoft.Dynamics.AX.Tms.dll
[Packages root]\ApplicationSuite\bin\Microsoft.Dynamics.AX.Tms.Base.dll
```
ThirdPartyTMSEngines プロジェクトで生成された C# クラスの名前を SampleRatingEngine に変更します。
エンジンを実装します。この例ではレートエンジンを作成しているため、レートエンジンの基本クラスを継承しています。基本クラスは、レートエンジンインターフェイス (TMSFwkIRateEngine) のほとんどを実装します。レート法の実装が必要なだけです。この例を単純にするために、このメソッドではハードコーディングされたレートを 100 として登録します。 TMSFwkIAccessorialEngine などの、任意のエンジンインターフェイスを実装するエンジンを作成することができます。すべてのエンジンインターフェイスは X++ で定義されます。
```
namespace ThirdPartyTMSEngines
{
    using Dynamics.AX.Application;
    using Microsoft.Dynamics.Ax.Tms.Base.Data;
    using Microsoft.Dynamics.Ax.Tms.Base.Utility;
    using Microsoft.Dynamics.Ax.Tms.Bll;
    using System.Xml.Linq;
    public class SampleRatingEngine : BaseRateEngine
    {
        public override RatingDto rate(TmsTransactionFacade transactionFacade, XElement shipment, TMSRateMasterCode rateMasterCode)
        {
           XElement re = shipment.RetrieveOrCreateRatingEntity(this.RatingDto);
           re.AddRate(TmsRateType.Rate, 100);
           return this.RatingDto;
        }
    }
}
```
ソリューションをビルドします。
TMSThirdParty プロジェクトに新しい参照を追加します。参照は、ThirdPartyTMSEngines プロジェクトを指す必要があります。完了したら、ソリューションは次のようになります。
ソリューションをビルドします。アプリケーションエクスプローラーの参照ノードに新しいライブラリが表示されていることを確認します。

TMS エンジンをパッケージとして配置する

サードパーティの TMS エンジンを配置する 1 つの方法は、配置パッケージを介することです。運用環境では、この方法をお勧めします。開発環境では、次のセクション「Supply Chain Management で TMS エンジンを設定する」で説明するように手動でアセンブリをコピーできます。エンジンをパッケージとして展開するには、次の手順を実行します。

Dynamics 365>配置メニューで、配置パッケージの作成をクリックします。
配置パッケージの作成ダイアログボックスで、TMSEngines モデルを選択し、パッケージファイルを格納する場所のパスを入力します。
パッケージをターゲット環境に展開することができるようになりました。チュートリアルについては、配置可能パッケージのインストールを参照してください。

Supply Chain Management での TMS エンジンの設定

このセクションでは、TMS エンジンを使用するために Supply Chain Management を設定する方法、および作成した新しいエンジンをレートショッピングで使用する方法を示します。このセクションの例では、USMF デモデータ会社を使用しています。

「新しい TMS エンジンの作成」の説明に従って、新しいエンジンを作成します。
ソリューションを構築します。
結果のアセンブリを Supply Chain Management サーバーのバイナリの場所、[AOSWebRoot]bin にコピーします。 注記: このステップは、開発環境にのみ関連します。運用環境では、配置パッケージを介して配置する必要があります。手順については、前のセクションの「パッケージとして TMS エンジンを配置する」を参照してください。
Supply Chain Management では、レートエンジン ページで新しい評価エンジンを作成します。エンジンは、実装したエンジンクラスライブラリとエンジンクラスを作成して生成されたエンジンアセンブリを指す必要があります。
サンプルレートエンジンを使用する配送業者を作成します。当社のエンジンはいかなるデータも使用しないため、レートマスターを割り当てる必要はありません。
工順ワークベンチの評価ページで、レートショップをクリックします。次のスクリーンショットに示すように、SampleCarrier から 100.00 のレートが表示されます。この例では、倉庫 24 から顧客 US-004 へのルートの輸送料を検索しています。ただし、料金がハードコーディングされているために、100.00 の料金が常に表示されます。

ヒントや秘訣

Supply Chain Management の開発ツールを使用している場合、ソリューションに新しいプロジェクトを追加すると便利です。このプロジェクトをスタートアッププロジェクトとして設定した場合、デバッグセッションを開始すると、同じデバッグセッションで X++ と C# コードの両方のコードをデバッグできます。
ThirdPartyTMSEngines プロジェクトを変更して再コンパイルするたびに、アセンブリの結果をバイナリの場所に手動でコピーするか、展開パッケージを通じて展開する必要があります。それ以外の場合、古いアセンブリを使用して実行される場合があります。
Supply Chain Management で TMS 固有の操作を実行した後、Internet Information Services (IIS) ワーカープロセスによって ThirdPartyTMSEngines アセンブリが、ロックされアセンブリを更新することができなくなることがあります。この場合、w3svc プロセスを再起動します。

ホワイトペーパー

詳細については、次のホワイトペーパー (AX2012 をサポートするように記述されているが、Dynamics 365 Supply Chain Management にも適用される) をダウンロードしてください

輸送管理エンジンの実装と展開