次の方法で共有

Dynamics 365 Finance + Operations へのアップグレード時の PreSync および PostSync アップグレード スクリプトのトラブルシューティング

  • [アーティクル]

この記事では、Microsoft Dynamics AX 2012 から Dynamics 365 Finance + Operations (on-premises) へのアップグレードの一部として実行する PreSync および PostSync アップグレード スクリプトのトラブルシューティングについて説明します。

シナリオ 1: 次のようなエラーが発生しました: "オブジェクト名 'dbo.INVENTDIM' とインデックス名 'I_XXXSHA1HASHIDX' に重複するキーが見つかりました。"

最終同期中に、ダウンロードした同期ログの次の例のようなエラーが表示される場合があります。 (インデックス内のテーブル ID が異なる場合があります。)

オブジェクト名 'dbo.INVENTDIM' およびインデックス名 'I_698SHA1HASHIDX' の重複キーが検出されたため、CREATE UNIQUE INDEX ステートメントが終了しました。 重複キーの値は (5637144576、gsmp、B92BAF2504FD67FC15A56F2DFACE09127715B54B) です。 明細書は終了しました。 CREATE UNIQUE INDEX I_698SHA1HASHIDX ON DBO.INVENTDIM(PARTITION,DATAAREAID,SHA1HASHHEX) WITH (MAXDOP = 1) ;

原因

この問題には、いくつかの原因が考えられます:

  • このエラーは通常、Dynamics AX 2012 で InventDim テーブルの分析コード フィールドの 1 つの文字列サイズが拡張されているが、同じフィールドが Dynamics 365 で拡張されていない場合に表示されます。 拡張子はテーブル上で直接作成されたか、フィールドが派生する拡張データ型 (EDT) で作成された可能性があります。

    次のフィールドがハッシュ値を作成するのに使用されます:

    • ConfigId、InventBatchId
    • InventColorId
    • InventGtdId_RU
    • InventLocationId
    • InventOwnerId_RU
    • InventProfileId_RU
    • InventSerialId
    • InventSiteId
    • InventSizeId
    • InventStatusId
    • InventStyleId
    • LicensePlateId
    • WMSlocationId

    テーブルのデータは切り詰められません。 ただし、実行時にハッシュ値が作成されると、バッファー内のデータが切り詰まれます。

    たとえば、InventSizeId フィールドの既定のサイズは 10 文字ですが、お客様が Dynamics AX 2012 でサイズを 12 文字に増やしたとします。 この場合、フィールド値 1234567890AA と 1234567890BB は、実行時にバッファーに読み込まれると、両方とも 1234567890 に短縮されます。 したがって、ランタイム バッファーに重複する値が生じ、新しいハッシュ値を生成する ReleaseUpdateDB72_Invent::updateSHA1HashHexInInventDim アップグレード メソッドでは、すべてのハッシュ値が一意として生成されません。

  • データ アップグレード ジョブは期待通り実行されなかったか、期待通りに完了しませんでした。

    まず次の SQL クエリを実行します。

    SELECT PARTITION, DATAAREAID, SHA1HASHHEX, COUNT(*)
FROM INVENTDIM
GROUP BY PARTITION, DATAAREAID, SHA1HASHHEX
HAVING COUNT(*) > 1

    SHA1HASHHEX が空白の場合、ジョブは実行されませんでした。 この場合、次のコマンドを使用して、データ アップグレード ジョブを確認します。

    select * from RELEASEUPDATESCRIPTSLOG
where METHODNAME = 'updateSHA1HashHexInInventDim'

    ソリューション

    1. Dynamics AX 2012 InventDim テーブルのフィールド サイズを Dynamics 365 のフィールド サイズと比較します。 差異がある場合は、カスタマイズ拡張機能を使用して、関連するフィールドの文字列サイズを拡張することで、差異を調整する必要があります。
    2. ジョブが実行されなかった場合は、Dynamics 365 用 AX 2012 データベース アップグレード ツールキットからアップグレードを再開するか、またはレベル-1 開発環境の場合は Runbook の手順を再実行するようにしてください。

シナリオ 2: ReleaseUpdateDB72_FixedAssets::postSyncUpgradeAssetDepBookJournalTransDimResolve ジョブを実行すると、エラーが発生します

ReleaseUpdateDB72_FixedAssets::postSyncUpgradeAssetDepBookJournalTransDimResolve 転記の同期ジョブを実行すると、次のエラーが表示されることがあります:

ビュー DimAttributeAssetTable 経由のテーブル AssetTable にレコードが存在しないため、法人 USMF で、値 ASSET00001 を持つ分析コード SystemGeneratedAttributeFixedAsset の DimensionAttributeValue レコードを返すことができません。 バッチ タスクが失敗しました: ビュー DimAttributeAssetTable 経由のテーブル AssetTable にレコードが存在しないため、法人 USMF で、値 ASSET00001 を持つ分析コード SystemGeneratedAttributeFixedAsset の DimensionAttributeValue レコードを返すことができません。

原因

このエラーは、Dynamics AX 2012 AssetTable ーブルから資産が削除されたものの、ledgerjournaltrans_asset テーブルの関連レコードが残っているために発生します。

これらの孤立レコードについては、次の SQL スクリプトを使用して確認できます。

select * from ledgerjournaltrans_asset
where assetid not in (select assetid from assettable)

ソリューション

重要

データを削除する前に、データベース バックアップがあることを確認してください。

次の SQL ステートメントを実行することで、レコードを削除できます。

--
-- This source code or script is freeware and is provided on an "as is" basis without warranties of any kind, 
-- whether express or implied, including without limitation warranties that the code is free of defect, 
-- fit for a particular purpose or non-infringing. The entire risk as to the quality and performance of 
-- the code is with the end user.
--
delete from ledgerjournaltrans_asset
where assetid not in (select assetid from assettable)

シナリオ 3: ReleaseUpdateDB10_CaseManagement::updateCaseCategoryTypeMajor ジョブを実行すると、エラーが発生します

ReleaseUpdateDB10_CaseManagement::updateCaseCategoryTypeMajor 転記の同期ジョブを実行すると、ReleaseUpdateScriptsErrorLog テーブルからの次のエラーが表示されることがあります:

=== 'PostSync' ステップで失敗した x++ データ アップグレード スクリプトの開始。 ===
{ ClassName: "ReleaseUpdateDB10_CaseManagement"、MethodName: "updateCaseCategoryTypeMajor"、会社: "DAT"、DataParition: "initial"、ErrorCount: "1"、ErrorMessage: " ロール別ケース カテゴリ セキュリティ (CaseCategoryRole) のレコードを編集できません。 カテゴリ タイプ: なし。
レコードが既に存在します。 バッチ タスクが失敗しました: ロール別ケース カテゴリ セキュリティ (CaseCategoryRole) のレコードを編集できません。 カテゴリ タイプ: なし。
レコードが既に存在します。"}
{ ClassName: "ReleaseUpdateDB72
=== 'PostSync' ステップで失敗した x++ データ アップグレード スクリプトの開始。 ===
{ ClassName: "ReleaseUpdateDB10_CaseManagement"、MethodName: "updateCaseCategoryTypeMajor"、会社: "DAT"、DataParition: "initial"、ErrorCount: "1"、ErrorMessage: " ロール別ケース カテゴリ セキュリティ (CaseCategoryRole) のレコードを編集できません。 カテゴリ タイプ: なし。
レコードが既に存在します。 バッチ タスクが失敗しました: ロール別ケース カテゴリ セキュリティ (CaseCategoryRole) のレコードを編集できません。 カテゴリ タイプ: なし。
レコードが既に存在します。"}
DBSync のモニタリングを停止しました。 Microsot.Dynamics.Ax.Xpp.ErrorException: セッションの作成に失敗しました。ユーザーに Microsoft Dynamics 365 Finance にログオンするための適切な権限があることを確認してください。

原因

Dynamics AX 2012 では、Web タイプの CaseCategoryType 列挙 (enum) で、ほとんどの場合に値 "9" が使用されているため、このエラーが発生します。 ただし、Dynamics 365 では、Web 値は使用されなくなり、同じ値が列挙値 CaseCategoryType::FMLA で使用できます。 列挙は拡張可能であるため、同じ値を割り当てることができます。

列挙値を確認するには、次の SQL ステートメントを実行します。

select t1.name as enumvaluename, t1.enumvalue
from enumvaluetable  t1
join enumidtable t2 on t2.id = t1.enumid
where t2.name = 'CaseCategoryType'

ソリューション

  1. CaseCategoryRole テーブルで、Web タイプのレコードを削除します。
  2. Dynamics AX 2012 の列挙の値を確認します。 前述のとおり、ほとんどの場合にこの値は "9" になります。
  3. 次の SQL ステートメントを使用して、CaseCategoryRole テーブルのレコードを削除します。 (必要に応じて値を編集します。)
--
-- This source code or script is freeware and is provided on an "as is" basis without warranties of any kind, 
-- whether express or implied, including without limitation warranties that the code is free of defect, 
-- fit for a particular purpose or non-infringing. The entire risk as to the quality and performance of 
-- the code is with the end user.
--
delete from CaseCategoryRole
where CaseCategoryType = 9 --Edit to be the enum value of CaseCategoryType::Web in AX2012

シナリオ 4: 次のエラーが表示されます: "テーブル名 (TableName) のレコードを編集できません - 列名 'COLUMNNAME' が無効です。"

PreSync または PostSync アップグレード ジョブを実行すると、次の例に似たエラーが表示されることがあります。 参照フィールドが Dynamics 365 に存在しない場合は、レガシ テーブル トリガーに関連したエラーである可能性があります。

テーブル名 (TableName) のレコードを編集できません。
SQL データベースによってエラーが出されました。 オブジェクト サーバー DataUpgrade_Batch: [Microsoft][SQL Server の ODBC ドライバー 17][SQL Server] 列名 'DEPRACATEDCOLUMNNAME' が無効です。 UPDATE T1 SET VALUE=?,RECVERSION=? FROM TABLENAME セッション 10 (管理者) バッチ タスクに失敗しました: 銀行口座 (TableName) のレコードを編集できません。
SQL データベースによってエラーが出されました。"

ソリューション

  1. SQL Management Studio (SSMS) を使用してデータベースに接続します。
  2. オブジェクト エクスプローラーで、データベースとテーブルを展開し、エラー メッセージで参照されているテーブルを検索します。
  3. そのテーブルでトリガーをレビューし、カスタム トリガーがあるかどうかを確認します。 Dynamics 365 で作成されるほとんどの標準トリガーには、SysDbLog、SysEvenCud、または AIF などの接頭語が付けられます。
  4. 問題の原因と思われるカスタムトリガーをスクリプト化するには、各トリガーを選択したまま (または右クリック) にしてから、トリガーのスクリプト名 > 作成先 > 新規クエリ編集ウィンドウの順に選択します。
  5. スクリプトの完了後、編集 > 検索に移動して、エラー メッセージで参照されるフィールドがスクリプトに存在するかどうかを特定します。 トリガー内で一致が見つかった場合は、トリガーを無効またはドロップする必要があります。