Microsoft Dynamics AX 2009 アップグレード...

Microsoft Corporation 1

Microsoft Dynamics AX 2009 アップグレード

ガイド

Microsoft Corporation

発行 : 2008 年 11 月


Microsoft Dynamics は、統合された適合性の高いビジネス管理ソリューションであり、経営者や

従業員がビジネスに関する決定をより確実に行えるようにします。Microsoft Dynamics の動作は

使い慣れた他の Microsoft ソフトウェアと似ており、他の Microsoft ソフトウェアと連携します。

Microsoft Dynamics によって、財務、顧客関係、およびサプライチェーンの各プロセスを自動

化および合理化し、ビジネスの成功を導くことができます。

米国およびカナダ (通話料無料) 1-888-477-7989

他の国 +1-701-281-6500

www.microsoft.com/dynamics

このドキュメントに記載された内容は情報提供のみを目的としており、これらの情報について

マイクロソフトは明示、黙示、あるいは法律上のいかなる責任も負わないものとします。

URL およびその他のインターネット Web サイトの参照を含む、このドキュメントの情報は、予告

なしに変更することがあります。このドキュメントの使用上のリスクや使用による結果は、すべ

てユーザーが負うものとします。特に断りのない限り、このドキュメントで使用している会社、

組織、製品、ドメイン名、電子メールアドレス、ロゴ、人物、場所、出来事などの名称は架空

のものです。実在する名称とは一切関係ありません。

お客様ご自身の責任において、適用されるすべての著作権関連法規に従ったご使用を願います。

このドキュメントのいかなる部分も、米国 Microsoft Corporation の書面による許諾を受けること

なく、その目的を問わず、どのような形態であっても、複製または譲渡することは禁じられてい

ます。ここでいう形態とは、複写や記録など、電子的な、または物理的なすべての手段を含みま

す。ただしこれは、著作権法上のお客様の権利を制限するものではありません。

マイクロソフトは、このドキュメントに記載されている内容に関し、特許、特許申請、商標、著作

権、またはその他の無体財産権を有する場合があります。別途マイクロソフトのライセンス契約

上に明示の規定のない限り、このドキュメントはこれらの特許、商標、著作権、またはその他の

無体財産権に関する権利をお客様に許諾するものではありません。

© 2008 Microsoft Corporation. All rights reserved.

Microsoft、Microsoft Dynamics、Microsoft Dynamics のロゴ、SQL Server、Active Directory、

SharePoint、Visual C++、Windows、Windows Server、Navision、および Axapta は、米国

Microsoft Corporation、FRx Software Corporation、または Microsoft Business Solutions ApS の

米国ならびにその他の国における登録商標または商標です。Microsoft Business Solutions ApS

および FRx Software Corporation は米国 Microsoft Corporation の子会社です。


目次

アップグレードの概要 ............................................................................................................. 7

サポートされるアップグレードパス ............................................................................... 8

システム要件 ........................................................................................................................... 9

クイックスタート : Microsoft Dynamics AX 3.0 からのアップグレード ............ 10

クイックスタート : Microsoft Dynamics AX 4.0 からのアップグレード ............ 11

アップグレードプロセスの改良 ..................................................................................... 12

アップグレードのベストプラクティス ........................................................................ 14

アップグレードの前に ........................................................................................................... 16

サポートされているアップグレードパスのアップグレードタスク ................... 17

適切なユーザーアクセス許可の設定 ............................................................................. 18

データのバックアップ ........................................................................................................ 20

データのクリーンアップ .................................................................................................... 21

既存のアプリケーションファイルのコピー ................................................................ 22

Dynamics AX 2009 にアップグレードするための Axapta 3.0 データの準備.... 23

64 ビットのレコード ID フィールドへのアップグレード .................................... 24

データベース列の左揃え ................................................................................................ 25

新しいデータベースの作成 ............................................................................................ 27

Microsoft Dynamics AX DB アップグレード準備ツール ....................................... 28

チームサーバーのアップグレード ................................................................................. 31

Microsoft Dynamics AX 2009 へのアップグレード ....................................................... 32

アップグレード前の Microsoft Dynamics AX のインストール ............................... 33

アップグレードのチェックリスト .................................................................................. 36

データアップグレードコックピット............................................................................ 37

アップグレードの準備 ........................................................................................................ 41

アプリケーションのコンパイル (アップグレード) ................................................. 42

ライセンス情報の指定 ..................................................................................................... 43

タイムゾーンとアップグレード .................................................................................. 45

アップグレードされたデータのタイムゾーンの設定 ........................................... 46

顧客フィードバックオプションの設定 ..................................................................... 47

カスタマイズの競合の検出 ............................................................................................ 48

比較ツール .......................................................................................................................... 50

2 つのアプリケーションオブジェクトを比較する方法 .................................... 51

オブジェクトのバージョンを比較する方法 .......................................................... 52

方法 : アプリケーションオブジェクトレイヤの比較 ....................................... 53


コードのアップグレード後のシステムのテスト ..................................................... 55

グローバルアドレス帳用の仮想会社の作成 ............................................................ 56


データのアップグレード .................................................................................................... 58

データアップグレードのパフォーマンスの向上 .................................................... 59

データベースの事前同期 ................................................................................................ 60

データベースの同期 ......................................................................................................... 61

データベースの事後同期 ................................................................................................ 62

データアップグレード後のシステムのテスト ........................................................ 63

アップグレードの終了処理 ............................................................................................... 64

システムアカウントのコンフィギュレーション .................................................... 65

エンタープライズポータルのアップグレード ........................................................ 67

ロールセンター Web サイトの指定 ........................................................................... 70

AIF のアップグレード ..................................................................................................... 71

追加のアップグレードタスク .......................................................................................... 72

アプリケーションのアップグレードの注意事項 ............................................................ 74

すべてのモジュールに影響するアップグレードの注意事項 .................................. 75

特定のモジュールに影響するアップグレードの注意事項 ....................................... 81

特定のロケールに影響するアップグレードの注意事項 ........................................... 94

アップグレードのトラブルシューティング .................................................................... 97

Microsoft Dynamics AX DB アップグレード準備ツールのトラブルシューティ

ング ....................................................................................................................................... 98

アップグレード中の AOS または Microsoft Dynamics AX クライアントの起動

に関する

トラブルシューティング .................................................................................................. 101

Microsoft Dynamics AX のコンパイルに関するトラブルシューティング ........ 103

データアップグレードコックピットのトラブルシューティング ..................... 104

コードのアップグレードの競合の検出ツールのトラブルシューティング ...... 113

アップグレード中のエラーメッセージ ...................................................................... 114

比較ツールのトラブルシューティング ........................................................................ 116

アップグレードガイドの付録 ........................................................................................... 117

開発アクセスライセンス ................................................................................................ 118

チュートリアル : 日付と時刻のテーブルフィールドのペアを UtcDateTime に

アップグレードする .......................................................................................................... 120

セットアップによってインストールされる前提条件となるソフトウェア ...... 134

AIF アップグレードプロセス......................................................................................... 135

コードのアップグレード : 例 .......................................................................................... 149

コードのアップグレードに関する追加情報 ............................................................... 153

データアップグレードに関する追加情報 .................................................................. 157

Microsoft Dynamics AX


アップグレードの概要

アップグレードガイドには、Microsoft Dynamics AX 2009 に正しくアップグレードするために

役立つ情報が記載されています。このセクションには次のトピックが含まれます。

サポートされるアップグレードパス

システム要件

クイックスタート : Microsoft Dynamics AX 3.0 からのアップグレード

クイックスタート : Microsoft Dynamics AX 4.0 からのアップグレード

アップグレードプロセスの改良

アップグレードのベストプラクティス



サポートされるアップグレードパス

ブラジル以外のすべての国では、Microsoft Dynamics AX 4.0 およびサポートされるサービスパ

ックが適用された Microsoft Dynamics AX 3.0 (以前は Microsoft Business Solutions - Axapta 3.0) か

ら Microsoft Dynamics AX 2009 に直接アップグレードできます。それよりも前のバージョンの

場合は、サポートされるサービスパックが適用された Microsoft Dynamics AX 3.0 または

Microsoft Dynamics AX 4.0 に段階的にアプグレードしてから、Microsoft Dynamics AX 2009 に

アップグレードできます。

メモ :

国固有の DIS/DIP レイヤが存在する、サポートされないバージョンの Microsoft

Dynamics AX からアップグレードする場合や、サポートされていないバージョンと

Microsoft Dynamics AX 2009 の間のいずれかのバージョンでテーブルまたはフィールド

(あるいはその両方) の ID が変更された場合は、データの損失が発生する可能性がありま

す。この状況が存在する場合を特定し、その状況を自動的に処理するアップグレードス

クリプトを作成するか、アップグレード後にデータを古いデータベースから Microsoft

Dynamics AX 2009 データベースに手動でコピーします。

ブラジルの場合は、Microsoft Dynamics AX 4.0 SP2 から Microsoft Dynamics AX 2009 へのみ直

接アップグレードできます。

メモ :

ブラジルの個々のレイヤは、このドキュメントの発行時にリリースされていない可能性

のある Microsoft Dynamics AX 2009 統合 GLS レイヤに含まれます。



システム要件

Microsoft Dynamics AX の最新のハードウェア要件とソフトウェア要件については、システム要

件に関する Web ページ (http://go.microsoft.com/fwlink/?LinkId=107378) を参照してください。

前提条件となる一部のソフトウェアは、セットアップによって自動的にインストールされます。

詳細については、「セットアップによってインストールされる前提条件となるソフトウェア」

を参照してください。

http://go.microsoft.com/fwlink/?LinkId=107378



クイックスタート : Microsoft Dynamics AX 3.0

からのアップグレード

このトピックでは、Microsoft Dynamics AX 3.0 から Microsoft Dynamics AX 2009 へのアップグ

レードに伴う手順の概略を示します。

1. 既存のデータベースとアプリケーションファイルをバックアップします。

2. データアップグレードを支援する 2 つの .xpo ファイルを、インストールメディアからインポートします。

UpgradeColumnList.xpo は、RecId フィールドの 32 ビットから 64 ビットへの変換用

です。

LeftJustified.xpo は、フィールド末尾のスペースの削除用です。

メモ :

Microsoft Dynamics AX DB アップグレード準備ツールを使用した後、Microsoft

Dynamics AX 2009 AOS を起動する前に、手順 4. で作成するデータベースに

LeftJustified.xpo を適用すると、パフォーマンスの向上に役立ちます。手順 8.


3. (オプション) パフォーマンスを向上させるため、Microsoft Dynamics AX 3.0 のすべてのユー

ザーデータとログを削除します。たとえば、SysDatabaseLog テーブルをクリーンアップし

ます。

4. SQL Server 2005 で Microsoft Dynamics AX 2009 用に空のデータベースを作成します。

5. (オプション) パフォーマンスを向上させるため、初期データとログファイルのサイズを設定して、データアップグレードプロセスの実行中に増大しないようにします。

6. (オプション) パフォーマンスを向上させるため、Microsoft Dynamics AX 2009 データベースの復旧モデルを [簡易] に設定します。

7. AXDBUpgrade.exe (Microsoft Dynamics AX DB アップグレード準備ツール) を実行します。

メモ :

パフォーマンスを向上させるため、このツールをマルチスレッドモードで実行する

こともできます。たとえば、このツールを 10 個のスレッドで実行するには、コマン

ドプロンプトで「AxDbUpgrade.exe P/10」と入力します。

8. (オプション) 手順 2. でインポートした LeftJustify ファイルを、手順 4. で作成した Microsoft

Dynamics AX 2009 データベースに適用します。

9. Microsoft Dynamics AX データベースをバックアップします。データベースをアップグレー

ドする準備ができました。

10. インストールメディアから Microsoft Dynamics AX 2009 Setup ファイルを実行します。イン

ストール中に、手順 4. で作成したデータベースを選択します。

11. アップグレードされたカスタマイズファイルを、適切なアプリケーションディレクトリにコピーします。

12. AOS を起動します。

13. Microsoft Dynamics AX 2009 クライアントを起動します。アップグレードのチェックリスト

が自動的に表示されます。

14. アップグレードのチェックリストに示された手順を実行して、アップグレードを完了します。



クイックスタート : Microsoft Dynamics AX 4.0

からのアップグレード

以下の手順では、Microsoft Dynamics AX 4.0 から Microsoft Dynamics AX 2009 にアップグレー

ドするために実行する必要があるタスクの概要を示します。

1. 既存のデータベースとアプリケーションファイルをバックアップします。

2. (オプション) パフォーマンスを向上させるため、Microsoft Dynamics AX 4.0 のすべてのユー

ザーデータとログを削除します。たとえば、SysDatabaseLog テーブルをクリーンアップし

ます。

3. (オプション) パフォーマンスを向上させるため、初期データとログファイルのサイズを設定

して、データアップグレードプロセスの実行中に増大しないようにします。

4. (オプション) パフォーマンスを向上させるため、Microsoft Dynamics AX 2009 データベース

の復旧モデルを [簡易] に設定します。

5. Microsoft Dynamics AX データベースをバックアップします。データベースをアップグレー

ドする準備ができました。

6. インストールメディアから Microsoft Dynamics AX 2009 Setup ファイルを実行します。イン

ストール中に、既存の Microsoft Dynamics AX データベースを選択します。

7. Microsoft Dynamics AX 2009 クライアントを起動します。アップグレードのチェックリスト

が自動的に表示されます。

8. アップグレードのチェックリストに示された手順を実行して、アップグレードを完了します。



アップグレードプロセスの改良

Microsoft Dynamics AX 2009 には追加機能があり、以前のバージョンからのアップグレードに役

立ちます。各機能について以下で説明します。

バッチフレームワークを使用したバッチジョブ

Microsoft Dynamics AX 2009 のアップグレードプロセスが変更され、更新されたバッチフレー

ムワークを利用できるようになりました。アップグレードは、Application Object Server (AOS)

インスタンスで、アップグレード手順 (事前同期、事後同期、およびアップグレードの追加機能)

ごとに 1 つのバッチジョブセットとして実行されるようになりました。各アップグレードジョ

ブは複数のアップグレードタスクで構成され、ジョブはアップグレードスクリプトごとに 1 つ

となります。バッチフレームワークの制約を使用して、アップグレードスクリプト間の依存関

係が作成されます。アップグレードジョブ間の依存関係を監視するには、バッチ依存関係イン

ターフェイスを使用します。

アップグレードのチェックリストの追加タスク

以前のタスクが再編成または名前変更され、新しいタスクがアップグレードのチェックリストに

追加されました。

以前のバージョンの Microsoft Dynamics AX からアップグレードした場合は、Microsoft

Dynamics AX 2009 クライアントを初めて起動するときにアップグレードのチェックリストが表

示されます。アップグレードのチェックリストには、アップグレードタスクの一覧とタスクの

実行順序が示されます。アップグレードのチェックリストの詳細については、「アップグレード

のチェックリスト」を参照してください。

データアップグレードコックピットの強化

データアップグレードコックピットが、タスクのステータスとエラー情報をより明確に表示す

るように再設計されました。また、エラー報告と SQL ステートメントが情報ログに表示される

ようになったので、失敗したスクリプトをダブルクリックしてスクリプトのコードを表示できる

ようになりました。

このフォームには、進行状況バーも追加されました。

アップグレードの競合の検出

どのタイプのアップグレードの競合に対してもコードアップグレードツールセットを使用でき

るようになりました。アップグレードの競合が発生した場合、古い要素を削除できます。また、

"プロパティの競合の自動解決" という新しいオプションもあります。このオプションを使用する

と、自分のリビジョンの AOT ノードでプロパティが変更され、同じ AOT ノードの最新の

Microsoft リビジョンで別のプロパティが変更された場合の競合が自動的に解決されます。自分

のバージョンと Microsoft のバージョンの両方で同じプロパティが変更された場合も、競合とし

てマークされます。



視覚インジケータの強化

コードアップグレードプロセスには、新しい視覚インジケータが用意されています。コードの

競合および解決されたコードの競合ごとに、影響を受けたノード上にアイコンでフラグが設定さ

れます。これにより、競合の発生場所の概要を把握しやすくなります。競合の処理時に競合を解

決済としてマークでき、これによって競合アイコンが赤色の警告から緑色のチェックマークに

変化します。

比較ツールの強化

Microsoft Dynamics AX 2009 では、比較ツールにいくつかの非常に役立つ改良が加えられていま

す。1 つ目の改良点は、比較ツールをキーボードショートカット (Ctrl + G キー) で起動できるよ

うになった点です。このツールはコンテキストメニューの最上位レベルに移動しました。2 つ目

の改良点は、基本設定を保存できるようになった点です。これにより、次に比較ツールを開いた

ときに比較対象を再選択する必要がなくなりました。3 つ目の改良点は、より多くの情報を使用

してより簡単に適切な意思決定を行えるようになった点です。"比較" フォームに元の値が示され

るようになったので、3 つの値 (自分の変更内容、Microsoft の変更内容、および元の値) をすべ

て同じフォームで確認できるようになりました。

競合解決の時間見積レポート

アップグレードのチェックリストを使用して検出されたアップグレードの競合の解決にかかる時

間の見積を示す、完全にコンフィギュレーション可能なレポートを印刷できるようになりました。

この見積は、検出された競合と同じ精度 (ノードレベルごと) に分割されます。



アップグレードのベストプラクティス

このセクションでは、アップグレードのベストプラクティスについて説明します。アップグレ

ードプロセスの開始前に、次のトピックを確認してください。

テスト環境のアップグレードから開始

実稼働環境でアップグレードする前に、テスト環境で Microsoft Dynamics AX 2009 にアップグ

レードします。

実稼働環境でアップグレードする前に、テスト環境でインストールしたシステムが正しく機能し

ているかどうかをテストします。

Microsoft Dynamics AX 2009 へのアップグレードが成功したかどうかをテストするには、最低限、

次の手順を実行する必要があります。

すべての Application Object Server (AOS) インスタンスを再起動します。

実行中の各 AOS インスタンスに接続されているクライアントを起動します。

ユーザーがシステムで最も一般的なタスクを実行できるかテストします。

管理者がシステムの保守作業を実行できるかテストします。

ユーザーがシステムで最も重要なタスクを実行できるかテストします。

ユーザーが生成されたレポートを読むことができるかテストします。

ユーザーがアップグレード前に持っていたデータへのアクセス権を現在も持っていることを

確認して、アクセス許可の設定が正しく動作するかテストします。

データがアップグレード前と整合性があるか検証します。

ディスク容量とログのサイズ

ハードドライブとトランザクションログに適切な容量があることを確認します。詳細について

は、「データアップグレードのパフォーマンスの向上」を参照してください。

データベースサーバーのコンフィギュレーション

Microsoft SQL Server で、パフォーマンスとスループットが可能な限り最大になるようにコンフ

ィギュレーションされていることを確認します。詳細については、「データアップグレードの

パフォーマンスの向上」を参照してください。

アップグレードプロセスは、専用サーバーで行ってください。他のアプリケーションがデータ

ベースサーバーで実行されている場合は、アップグレードプロセスとの間でリソースの競合が

発生します。



既存のデータベースサーバーのパフォーマンスベンチマークを確認し、リソースを追加する必

要があるかどうかを判断します。データベースサーバーの 64 ビットコンピュータへの移行や、

プロセッサ、メモリ、記憶域などのサーバーコンポーネントのアップグレードが必要になる場

合もあります。サーバーコンポーネントをアップグレードまたは変更した後は、Microsoft

Dynamics AX アップグレードプロセスを開始する前に、サーバーのパフォーマンスが最適かど

うかをテストしてください。

データのバックアップ

次の各アップグレード手順が正常に完了するたびにデータベースをバックアップして、必要に応

じてどの時点からでも簡単に再開できるようにすることをお勧めします。

アップグレード手順タイミング

データベース列の左揃えこの手順の完了後に、この手順を実行したデー

タベースをバックアップします。

Microsoft Dynamics AX DB アップグレード準

備ツール

この手順の完了後に、アップグレード前の

Microsoft Dynamics AX 2009 データベースをバ

ックアップします。

データベースの同期この手順の完了後に、Microsoft Dynamics AX

2009 データベースをバックアップします。

データベースの事後同期この手順の完了後に、Microsoft Dynamics AX


追加のアップグレードタスクこの手順の完了後に、Microsoft Dynamics AX


古いアプリケーションオブジェクトの削除

システムのアップグレード後に、更新オブジェクト 4.0 の保存 (SysDeletedObjects40) コンフ

ィギュレーションキーと更新オブジェクト 4.1 の保存 (SysDeletedObjects41) コンフィギュレ

ーションキーを無効にする必要があります。これらのキーを無効にすると、接頭語が DEL_ の

古いアプリケーションオブジェクトが削除されます。

メモ :

データのアップグレードが完了するまで、このコンフィギュレーションキーを無効にし

ないでください。

1. [管理]、[設定]、[システム]、[コンフィギュレーション] の順にクリックします。"コンフィギ

ュレーション" フォームが表示されます。

2. 左ウィンドウで、[管理] を展開します。

3. [更新オブジェクト 4.0 の保存] および [更新オブジェクト 4.1 の保存] をオフにして、[OK] を

クリックします。



アップグレードの前に

Microsoft Dynamics AX 2009 へは、Microsoft Dynamics AX 4.0 またはサポートされているサー

ビスパックが適用された Microsoft Dynamics AX 3.0 から直接アップグレードできます。このセ

クションでは、Microsoft Dynamics AX 2009 をインストールする前に実行する必要のあるタスク

について説明します。このセクションには次のトピックが含まれます。

サポートされているアップグレードパスのアップグレードタスク

適切なユーザーアクセス許可の設定


データのクリーンアップ

既存のアプリケーションファイルのコピー

Dynamics AX 2009 にアップグレードするための Axapta 3.0 データの準備

チームサーバーのアップグレード



サポートされているアップグレードパスの

アップグレードタスク

Microsoft Dynamics AX 3.0 と Microsoft Dynamics AX 4.0 でのデータのアップグレード手順は、

主に Microsoft Dynamics AX 3.0 からアップグレードするときに、より多くの準備が必要になる

という点で違いがあります。次の表に、各バージョンのアップグレードタスクを示します。

Microsoft Dynamics AX 3.0 のアップグレードタスク Microsoft Dynamics AX 4.0 のアップグレードタスク

適切なユーザーアクセス許可の設定。適切なユーザーアクセス許可の設定。

データのバックアップ。アプリケーションフ

ァイルとデータベースを含みます。

データのバックアップ。アプリケーションフ

ァイルとデータベースを含みます。

既存のアプリケーションファイルのコピー。既存のアプリケーションファイルのコピー。

データのクリーンアップ。データのクリーンアップ。

アップグレード前の Microsoft Dynamics AX の

インストール。


インストール。

Microsoft Axapta 3.0 ソースデータベースでの

データベース列の左揃え。


備ツール :

AxDbUpgrade.exe

Microsoft Dynamics AX 2009 への既存のアプリ

ケーションファイルのコピーおよび標準ディ

レクトリからのインデックスファイルの削除。

Microsoft Dynamics AX 2009 への既存のアプリ

ケーションファイルのコピーおよび標準ディ

レクトリからのインデックスファイルの削除。

Application Object Server (AOS) の起動。 Application Object Server (AOS) の起動。

Microsoft Dynamics AX 2009 クライアントの

起動。 Microsoft Dynamics AX 2009 クライアントの

起動。

アップグレードのチェックリストのタスクの実

行。「アップグレードのチェックリスト」を参

照してください。

アップグレードのチェックリストのタスクの実

行。「アップグレードのチェックリスト」を参


メモ :

これらのタスクを実行する前に、「アップグレードのベストプラクティス」を参照して

おくことをお勧めします。



適切なユーザーアクセス許可の設定

Microsoft Dynamics AX 2009 のインストールプロセスを開始する前に、システム管理者に問い

合わせて、各サーバーにログオンするときに使用するアカウントが適切なアクセス許可を持って

いることを確認します。

どの場合でも、コンポーネントをアップグレードするローカルコンピュータの Administrators

グループのメンバである必要があります。

次の表に、アップグレードを開始する前に設定する必要のあるアクセス許可を示します。これら

のアクセス許可は、最小限の特権の原則を適用して実装されています。

操作アカウントに必要なアクセス許可

Application Object Server (AOS) をインストー

ルする。アプリケーションに接続したり、アプリケーシ

ョンに対するフルアクセス許可を持つ必要の

ある Microsoft SQL Server コンピュータの

securityadmin ロールのメンバ

Microsoft SQL Server データベースを作成す

る。 SQL Server インスタンスの dbcreator ロール

のメンバ

AOS を SQL Server データベースに接続す

る。 SQL Server インスタンスの Database Security

Administrators ロールのメンバ

Oracle データベースを作成する。 Oracle データベースサーバーの SYSDBA のメ

ンバ

AOS を Oracle データベースに接続する。 Oracle データベースサーバーの SYSDBA のメ

ンバ

アプリケーションファイルサーバーをインス

トールする。ターゲットコンピュータの Administrators グ

ループのメンバ

Microsoft Dynamics AX クライアントをインス

トールする。ローカルコンピュータの Administrators グル

ープのメンバ

ロールセンターおよびエンタープライズポー

タルフレームワークをインストールする。 Microsoft Dynamics AX の Administrators グル

ープのメンバ、および Windows SharePoint

Services に使用されている SQL Server インス

タンスの dbcreator ロールのメンバ (WSS が

Microsoft Dynamics AX 設定を使用してインス

トールされている場合)

ワークフローをインストールする。 Microsoft Dynamics AX の Administrators グルー

プのメンバ



操作アカウントに必要なアクセス許可

レポート拡張機能を開始する。 Microsoft Dynamics AX の Administrators グルー

プのメンバ

同期サービスを開始する。 Microsoft Dynamics AX の Administrators グルー

プのメンバ

同期プロキシを開始する。 Microsoft Office Project Server 用の SQL

Server データベースの dbowner データベース

ロールのメンバ、および Office Project Server

を実行しているコンピュータの管理者

AIF Web サービスをインストールする。 Microsoft Dynamics AX の Administrators グルー

プのメンバ

BizTalk Adapter をインストールする。 BizTalk Server の administrators グループの

メンバ

開発用インストールを実行する。データベース、アプリケーションファイル、

AOS、クライアント、および .NET Business

Connector のインストールに必要なすべての権限


備ツールを実行する。 SQL Server を使用している場合 : ツールを実行

しているユーザーは、ソースデータベースおよ

びターゲットデータベースの ddl_admin、

db_datareader、および db_datawriter の各ロ

ールのメンバである必要があります

Oracle を使用している場合 : ツールを実行して

いるユーザーは、ソース Oracle スキーマおよ

びターゲット Oracle スキーマの dba ロールの

メンバである必要があります

アップグレードのチェックリストを実行する。 Microsoft Dynamics AX Administrator グループ

のメンバ




アップグレードの前に、次の情報をバックアップしておく必要があります。

データ。Microsoft SQL Server 関連のドキュメントで SQL Server の情報を参照するか、

Oracle のドキュメントを参照してください。

既存のシステムの DIS レイヤより上にあるすべてのレイヤ (LOS、BUS、VAR、CUS、USR)

の既存のアプリケーションファイル (*.aod、*.add、*.ald、*.ahd、および *.khd

ファイル)。たとえば、Microsoft Dynamics AX 4.0 システムでは、

\Microsoft Dynamics\4.0\Application\ApplStandard からアプリケーションファイルをコピ

ーします。

メモ :

ここに示したレイヤは、カスタマイズが行われた場合にのみ存在します。

Microsoft Dynamics AX 2009 では、レイヤの名前が変更されています。データをアップグレード

する前に、レイヤの名前を変更する必要があります。名前が変更されたレイヤの一覧については、

「既存のアプリケーションファイルのコピー」を参照してください。

http://go.microsoft.com/fwlink/?linkid=28107



データのクリーンアップ

監査証跡には必要のない、パフォーマンスを低下させる、またはデータベースの容量を不必要に

増やす、Microsoft Dynamics AX 3.0 データベース内のデータを削除します。データベースをア

ップグレードする前に、標準のフィルタ機能を使用してクリーンアップするデータのタイプを選

択します。

1. テスト環境で Microsoft Dynamics AX 3.0 を起動し ([スタート]、[すべてのプログラム]、

[Navision Axapta] の順に選択)、ログオンします。

2. アプリケーションオブジェクトツリー (AOT) を開きます。

3. [メニュー項目]、[アクション] の順に選択し、次のフォームを開いて実行し、データの各タイ

プをクリーンアップします。

SysUserLogCleanUp

SysDatabaseLogCleanUp

ProdJournalCleanup

InventJournalCleanUp

ProdTableCleanUp

SalesParmCleanUp

PurchParmCleanUp

LedgerJournalCleanUp



既存のアプリケーションファイルのコピー

既存のアプリケーションオブジェクトに対する変更を保持するためには、アプリケーションフ

ァイルを、更新されたバージョンと比較できるディレクトリにコピーする必要があります。

1. 実稼働環境からテスト環境にアプリケーションを複製します。

2. DIS レイヤ (LOS、BUS、VAR、CUS、USR) より上のすべてのレイヤにあるアプリケーシ

ョンファイル (*.aod、*.ahd、*.ald、*.add、*.khd ) を、実稼働環境からテスト環境にコピ

ーして、同様のフォルダに配置します。次のファイルはコピーしないでください。

axSYS.*

axSYP.*

axGLS.*

axGLP.*

axDIS.*

axDIP.*

メモ :

上記のファイルすべてが存在するとは限りません。

メモ :

間違ったレイヤをコピーすると、アップグレードが停止する場合があります。

たとえば、Dynamics AX 4.0 システムでは、実稼働環境 \Microsoft Dynamics

AX\40\Application\Appl\Standard のアプリケーションフォルダにあるすべてのアプリケー

ションファイルを、テスト環境のインスタンス名と場所のフォルダ \Microsoft Dynamics

AX\50\Application\Appl\<インスタンス名> にコピーします。

Microsoft Dynamics AX 2009 では、一部のレイヤ名が変更されました。次の表に、古い名前

とそれに対応する新しい名前を示します。アップグレード前に、古いレイヤファイルの名前

を対応する新しい名前に変更してください。

古い名前新しい名前

DIS HFX

DIP SL1

LOS SL2

LOP SL3

また、変更を加えた以前のバージョンのアプリケーションコードを現在のアプリケーション

コードと比較するためには、テスト環境の現在のアプリケーションフォルダ内に "Old" とい

うフォルダを作成する必要があります (例 : \Microsoft Dynamics AX\50\Application\Appl\

<インスタンス名>\Old)。以前のバージョンのすべてのアプリケーションファイル (*.aod、

*.ahd、*.ald、*.add、*.khd) を "Old" フォルダにコピーします。



Dynamics AX 2009 にアップグレードするため

の Axapta 3.0 データの準備

サポートされているサービスパックが適用された Microsoft Dynamics AX 3.0 を Microsoft

Dynamics AX 2009 にアップグレードするには、まず、データを新しいバージョンで使用できる

ように準備する必要があります。

メモ :

これらの作業を実行する前に、「アップグレードのベストプラクティス」を参照してお

くことをお勧めします。

このセクションには次のトピックの情報が含まれます。

64 ビットのレコード ID フィールドへのアップグレード

データベース列の左揃え

新しいデータベースの作成

Microsoft Dynamics AX DB アップグレード準備ツール



64 ビットのレコード ID フィールドへの

アップグレード

Microsoft Dynamics AX 3.0 用に作成されたデータベースを Microsoft Dynamics AX 2009 で使用

できるようにアップグレードする前に、すべての 32 ビット (データ型 int) の ID 参照を 64 ビッ

ト (データ型 int64) に変換する必要があります。変換する必要があるのは、32 ビットのレコー

ド ID 参照やトランザクション ID 参照などです。

ファイル PrivateProject_UpgradeColumnList.xpo を使用して、変換が必要な 32 ビットの値を含

む列の一覧を作成します。実際の変換は、後で Microsoft Dynamics AX DB アップグレード準備

ツールを使用して実行します。

メモ :

この作業を実行する前にデータをバックアップすることをお勧めします。

1. Microsoft Dynamics AX 3.0 を起動します。

2. Microsoft Dynamics AX 3.0 クライアントツールバーの [プロジェクト] アイコンをクリック

して、"プロジェクト" フォームを開きます。

3. [インポート] アイコンをクリックします。"インポート" フォームが表示されます。

4. [ファイル名] フィールドに PrivateProject_UpgradeColumnList.xpo ファイルの場所を入力し

ます。このファイルは、インストールメディアの DatabaseUpgrade フォルダに格納されて

います。

5. [OK] をクリックします。"プロジェクト" フォーム内の [プライベート] フォルダにプロジェク

トが表示されるようになります。

6. [プライベート] フォルダを展開します。

7. UpgradeColumnList を右クリックして [開く] をクリックします。

8. "プロジェクト UpgradeColumnList" フォームが表示されます。

9. [UpgradeColumnList] を右クリックして [開く] をクリックします。

10. "アップグレードする列" フォームで、[生成] をクリックします。

スクリプトによって、32 ビット値から 64 ビット値に変換する必要があるレコード ID フィ

ールドを含む列の一覧が生成されます。



データベース列の左揃え

Microsoft Dynamics AX 2009 のデータベース列は左揃えです。したがって、左揃えでない

Microsoft Dynamics AX 3.0 のデータベース列は、左揃えに変換する必要があります。この変換

を実行するには、LeftJustified.xpo ファイルを使用します。

メモ :

この作業を実行する前にデータをバックアップすることをお勧めします。

1. Microsoft Dynamics AX 3.0 を起動します。

2. Microsoft Dynamics AX 3.0 クライアントツールバーの [プロジェクト] アイコンをクリック

して、"プロジェクト" フォームを開きます。

3. [インポート] アイコンをクリックします。"インポート" フォームが表示されます。

4. [ファイル名] フィールドに PrivateProject_LeftJustified.xpo ファイルの場所を入力します。この

ファイルは、インストールメディアの DatabaseUpgrade フォルダに格納されています。

5. [OK] をクリックします。"プロジェクト " フォーム内の [プライベート] フォルダにプロジェ

クトが表示されるようになります。

6. [プライベート] フォルダを展開します。

7. [LeftJustified] を右クリックし、[開く] をクリックします。"LeftJustified プロジェクト" フォ

ームが表示されます。

8. [MainJob(usr)] を右クリックし、[開く] をクリックします。

進行状況バーに列のスキャンプロセスが表示されます。スキャンが完了すると、"Left

Justfy" フォームが開きます。

9. [Left justify all] をクリックします。

パフォーマンスを向上させるには、代わりに [Display commands] をクリックします。詳細

については、次の「SQL Server の SQL コマンドの実行」の手順を参照してください。



SQL Server の SQL コマンドの実行

大規模なデータベースを使用している場合は、前に示した手順 9. で [Left justify all] の代わりに

[Display commands] をクリックすることにより、パフォーマンスが向上します。

手順 9. で [Display commands] をクリックした場合、次の手順に進みます。

1. [Display commands] をクリックすると、InfoLog フォームに SQL コマンドの一覧が表示さ

れます。これらのコマンドを SQL テキストファイルにコピーし、Microsoft Dynamics AX

DB アップグレード準備ツールの実行が完了するまで保存しておきます。

2. Microsoft SQL Server Management Studio を開きます。

3. Microsoft Dynamics AX 2009 で使用するデータベースを選択します。

4. [新しいクエリ] をクリックします。

5. テキストファイルから SQL コマンドを読み込んで実行します。

メモ :

パフォーマンスを高速化するには、SQL コマンドを複数のテキストファイルに分割し、

コマンドを並列実行します。

Oracle データベースを使用している場合は、SQLPlus (または同等の機能) を使用して SQL コマ

ンドを実行します。



新しいデータベースの作成

Microsoft Dynamics AX DB アップグレード準備ツールを実行する前に、空のデータベースを作

成する必要があります。これは、Microsoft Dynamics AX DB アップグレード準備ツールを実行

するときのターゲットデータベースになります。このデータベースは、Microsoft Dynamics AX

2009 にアップグレードするデータベースにもなります。

1. SQL Server Management Studio を開きます ([スタート]、[プログラム]、[Microsoft SQL

Server 2005]、[SQL Server Management Studio] の順に選択)。

2. サーバーに接続するために必要な情報を入力し、[接続] をクリックします。

3. [オブジェクトエクスプローラ] ウィンドウで、[データベース] ノードを右クリックし、[新し

いデータベース] を選択します。[新しいデータベース] ウィンドウが表示されます。

4. データベースの名前を入力します。

5. (オプション) 後からデータのアップグレードのパフォーマンスを向上させるためには、[オプ

ション] ページで、[復旧モデル] を [単純] に設定します。詳細については、「データアップ

グレードのパフォーマンスの向上」を参照してください。

6. [OK] をクリックします。



Microsoft Dynamics AX DB アップグレード

準備ツール

Microsoft Dynamics AX DB アップグレード準備ツールは、前の手順で作成した新しいデータベ

ース (ターゲット) を、Microsoft Dynamics AX 2009 によって実行される自動的なデータアップ

グレードに向けて準備する別のアプリケーションです。Microsoft Dynamics AX 2009 を含むデー

タベースサーバーに Microsoft Dynamics AX DB アップグレード準備ツールをインストールする

ことをお勧めします。このツールは、データベースサーバーをインストールした後、Microsoft

Dynamics AX 2009 コンポーネントを起動する前に実行する必要があります。

メモ :

実行が完了した後にこのツールを同じターゲットデータベースに対して再度実行するこ

とはできません。

このツールによって Microsoft Dynamics AX 3.0 データベースに加えられる変更

データベースの準備が必要となるのは、Microsoft Dynamics AX 4.0 データベースに根本的かつ

重要な変更が実装されたためです。Microsoft Dynamics AX 3.0 データベースを Microsoft

Dynamics AX 2009 のセットアップウィザードで使用できるようにするには、以下の変更が必要

です。

Unicode の有効化

レコード ID の拡張

オプティミスティック同時実行管理 (OCC) の実装

Microsoft Dynamics AX DB アップグレード準備ツールの実行が完了すると、新しいデータベー

ス (ターゲット) を Microsoft Dynamics AX 2009 にアップグレードできるようになります。

データベースに前述の変更が加えられるほか、レコード ID 参照とトランザクション ID 参照の各

フィールドが 32 ビットのデータ型から 64 ビットのデータ型 (int ではなく int64) に変換されま

す。関連テーブルでは、OCC が有効になります。

このツールによって実行されるアクション

Microsoft Dynamics AX DB アップグレード準備ツールでは、次のアクションが実行されます。

Microsoft Dynamics AX 2009 (ターゲット) データベースのオブジェクトの初期セットを作成

します。これらのオブジェクトには、アップグレードの一部となる追加のテーブルやデータ

型の変更が反映されます。

一括コピーエクスポートを使用して、Microsoft Dynamics AX 3.0 データベース (ソース) か

らローカルハードドライブ上の一時的な場所にデータをエクスポートします。

Microsoft Dynamics AX DB アップグレード準備ツールは、Microsoft Dynamics AX 3.0 デー

タベース (ソース) を読み取り、マルチバイト文字セット (MBCS) データ型の代わりに

Unicode データ型 (nchar、nvarchar、および ntext) を新しいデータベース (ターゲット) に

設定します。



Microsoft Dynamics AX 2009 ターゲットデータベースにデータをインポートします。このイ

ンポートの間に、簡易データ変換により、Dynamics 4.0 データベーススキーマに組み込ま

れた新しいデータ型にデータが変換されます。このインポートは一括コピーエクスポート

ツールによって実行され、データベースにログが記録されます。

メモ :

FRx を使用している場合は、Microsoft Dynamics AX DB アップグレード準備ツールが失

敗します。詳細については、「Microsoft Dynamics AX DB アップグレード準備ツールの

トラブルシューティング」を参照してください。

AOT ベースではないテーブル

Microsoft Dynamics AX DB アップグレード準備ツールは、Microsoft Dynamics AX 3.0 に含まれ

ている AOT ベースのテーブルのみを対象としています。ISV または顧客が追加したテーブルで

使用した場合の動作結果は保証されません。AOT ベースではないテーブルは、次の手順に従っ

て処理する必要があります。

1. AOT ベースではないテーブルを識別するために、ソースデータベース (Microsoft Dynamics

AX 3.0) で DBPrep_nonAOTtable_SQL.sql (Microsoft SQL Server に基づくシステムの場合)

または DBPrep_nonAOTtable_Ora.sql (Oracle データベースサーバーに基づくシステムの場

合) を実行します。

2. 手順 1. のスクリプトで識別したテーブルをバックアップし、Microsoft Dynamics AX 3.0 デ

ータベーススキーマから削除します。

3. Microsoft Dynamics AX DB アップグレード準備ツールを実行して、Microsoft Dynamics AX

3.0 データベースをターゲットデータベースにコピーします。

4. AOT ベースではないテーブルを Microsoft Dynamics AX 2009 データベースに復元します。

ツールのパフォーマンスの最適化

パフォーマンスの最適化のために、Microsoft Dynamics AX DB アップグレード準備ツールを、

並列実行をサポートするシステムで並列実行することをお勧めします。このツールを並列実行す

るには、コマンドラインから Axdbupgrade.exe /pn というコマンドを使用して起動する必要が

あります。n は並列スレッドの数です (最小値は 1、最大値は 64、既定値は 8 です)。

一時フォルダのパフォーマンスと容量の計画で、一時フォルダにファイルが同時に書き込まれる

ことを考慮に入れる必要もあります。可能な場合、Microsoft Dynamics AX DB アップグレード

準備ツールの一時フォルダには、データベースファイルを含むボリュームとは別の、十分な容

量があるボリュームを指定することをお勧めします。

一時フォルダに必要な容量を見積もる際には、最も大きなテーブルのサイズと、目的とする並列

処理の限度を考慮に入れる必要があります。たとえば、Microsoft Dynamics AX DB アップグレ

ード準備ツールの並列処理の限度として 4 を使用する場合は、最も大きな 4 つのテーブルが並

行してエクスポートまたはインポートされることを想定します。この場合、一時フォルダには、

その最も大きな 4 つのテーブルの合計サイズと同じだけのサイズが必要になります。



Microsoft Dynamics AX DB アップグレード準備ツールの実行

Microsoft Dynamics AX DB アップグレード準備ツールを実行する際に覚えておく必要がある 2 つ

の重要なポイントは、次のとおりです。

このツールを特定のターゲットデータベースに対して実行できるのは 1 回だけです。

Microsoft Dynamics AX DB アップグレード準備ツールを使用するには、ソースデータベー

スへの読み取りアクセス権と、ターゲットデータベースへの書き込みアクセス権が必要です。

ターゲットデータベースには、一時フォルダへの読み取り/書き込みアクセス権が必要です。

メモ :

Microsoft Dynamics AX DB アップグレード準備ツールを実行した後にデータをバックア

ップすることをお勧めします。

このツールの SQL Server データベースでの実行

1. Application Object Server (AOS) をアップグレードまたはインストールするコンピュータで、

インストールメディアの AxDbUgrade.exe をダブルクリックします。

2. [セキュリティ接続] チェックボックスをオンにします。

ソースデータベースとターゲットデータベースの SQL Server インスタンス名とデータベー

ス名を入力します。ターゲットデータベースは、「新しいデータベースの作成」で作成した

データベースです。

3. ログフォルダのパスを入力します。ターゲットサーバーにはこのディレクトリへのアクセ

ス権が必要です。

4. 一時フォルダのパスを入力します。ターゲットサーバーにはこのディレクトリへのアクセス

権が必要です。

5. [開始] をクリックします。処理はいつでも中止できます。

このツールの Oracle データベースでの実行

1. Application Object Server (AOS) をアップグレードまたはインストールするコンピュータで、

インストールメディアの AxDbUgrade.exe をダブルクリックします。

2. [Oracle] タブをクリックします。

3. ソースデータベースとターゲットデータベースの接続文字列を入力します。接続文字列に

は、サーバーコンピュータの名前と Oracle の TNSNAMES が次の形式で含まれている必要

があります。

SERVER_NAME/TNSNAMES

4. ソーススキーマとターゲットスキーマを入力します。ソーススキーマは、Microsoft Axapta 3.0

スキーマです。ターゲットスキーマは、Microsoft Dynamics AX 2009 のインストール時に作

成したスキーマです。このスキーマは空である必要があります。

5. ログフォルダのパスを入力します。ターゲットサーバーにはこのディレクトリへのアクセ

ス権が必要です。

6. 一時フォルダのパスを入力します。ターゲットサーバーにはこのディレクトリへのアクセス

権が必要です。

7. [開始] をクリックします。処理はいつでも中止できます。



チームサーバーのアップグレード

バージョン管理システムを使用し、Microsoft Dynamics AX 4.0 からアップグレードする場合は、

Microsoft Dynamics AX 2009 にアップグレードする前にチームサーバーをアップグレードする

必要があります。詳細については、Microsoft Dynamics AX 2009 のインストールガイドを参照

してください。



Microsoft Dynamics AX 2009 への

アップグレード

このセクションでは、サポートされているサービスパックが適用された Microsoft Dynamics AX 3.0

の Microsoft Dynamics AX 2009 へのアップグレードについて説明します。Microsoft Dynamics AX

アプリケーションには、アップグレードを実行するためのツールが用意されていますが、アップ

グレードを成功させるためには、データアップグレード中の Microsoft Dynamics AX システムの

ダウンタイムを最短にするなど、入念な計画が必要です。このセクションには次のトピックが含

まれます。

アップグレード前の Microsoft Dynamics AX のインストール

アップグレードのチェックリスト

データアップグレードコックピット

アップグレードの準備

データのアップグレード

アップグレードの終了処理

追加のアップグレードタスク




インストール

「アップグレードの前に」の手順が完了したら、Microsoft Dynamics AX 2009 をインストールで

きます。インストールの詳細については、『Microsoft Dynamics AX 2009 Installation Guide

(Microsoft Dynamics AX 2009 インストールガイド)』を参照してください。

メモ :

サポートされるアップグレードパスについては、「サポートされるアップグレードパス」


1. インストールメディアから Setup.exe を実行します。[Microsoft Dynamics AX セットアップ]

ページが表示されます。

2. セットアップを表示するときに使用する言語を選択し、[OK] をクリックします。[Microsoft

Dynamics AX セットアッププログラムへようこそ] ページが表示されます。

3. [次へ] をクリックします。[ライセンス条件] ページが表示されます。

4. [ライセンス条項に同意する] チェックボックスをオンにし、[次へ] をクリックします。 [イン

ストールの種類の選択] ページが表示されます。

5. [開発者向けインストール] を選択し、[次へ] をクリックします。[以前のバージョンが検出さ

れました] ページが表示されます。

6. アップグレードパスについて、以下の該当手順を実行します。

アップグレードパスステップ

Microsoft SQL Server の使用と Microsoft

Dynamics AX 3.0 から Microsoft Dynamics

AX 2009 へのアップグレード

[既存の SQL Server データベースに接続]

を選択し、[次へ] をクリックします。

Microsoft SQL Server の使用と Microsoft

Dynamics AX 4.0 から Microsoft Dynamics

AX 2009 へのアップグレード

[既存の SQL Server データベースに接続]

を選択し、[次へ] をクリックします。

Oracle の使用データベースで Microsoft Dynamics AX 2009

オブジェクトが作成される Oracle データベー

スサーバースキーマに接続します。



7. [ファイルのインストール] ページが表示されたら、手順 9. にスキップします。それ以外で、

必要なソフトウェアをインストール必要がある場合は、[インストールの必要条件] ページが

表示されます。[必須ソフトウェアのインストール] をクリックします。

メモ :

Windows Server 2003 の新しいインストールでは、Microsoft Visual C++ 再頒布可能

パッケージと Visual C++ 2008 再頒布可能パッケージのインストールが必要です。

8. 必要なソフトウェアをインストールしたら、[次へ] をクリックします。[ファイルのインスト

ール] ページが表示されます。

9. 既定のファイルの場所を受け入れるか、別の場所を入力します。

10. [次へ] をクリックします。手順 6. で選択した内容に応じて、次のページのいずれかが表示さ

れます。

ページ名手順

AOS : SQL Server データベースへの接続 1. サーバー名を入力します。

2. Microsoft Dynamics AX DB アップグレー

ド準備ツールと共に使用していた Microsoft

Dynamics AX 4.0 データベースまたはターゲ

ットデータベースの名前を入力します。詳細

については、「Microsoft Dynamics AX DB ア

ップグレード準備ツール」を参照してくださ

い。

AOS : Oracle データベースサーバーへの接続使用する接続タイプを選択します。

[ネットサービス (TNS) を使用して接続]

を選択した場合は、サービス名を入力し

ます。

[カスタム設定を使用して接続] を選択し

た場合は、接続先のホスト名、データベ

ースサービス名、および TCP/IP ポート

を入力します。

[スキーマ (ユーザー) 名] ボックスで、デ

ータベースで Microsoft Dynamics AX オ

ブジェクトを作成するスキーマの名前を

指定します。既定値の DBO をそのまま

使用することもできます。存在していな

いスキーマ名を入力すると、セットアッ

プによって自動的に作成されます。[パス

ワード] ボックスで、スキーマのパスワ

ードを指定します。



11. [次へ] をクリックします。[アプリケーションファイル: インスタンス名の設定] ページが表

示されます。

12. [次へ] をクリックします。[アプリケーションファイル: 国または地域の選択] ページが表示

されます。

13. [次へ] をクリックします。[AOS: インスタンスの作成] ページが表示されます。

14. [次へ] をクリックします。[AOS: アカウントの選択] ページが表示されます。

15. ネットワークサービスアカウントまたはドメインアカウントの情報を入力し、[次へ] をク

リックします。[クライアント: 表示言語の選択] ページが表示されます。

16. [次へ] をクリックします。[クライアント: ヘルプ言語の選択] ページが表示されます。

17. [次へ] をクリックします。[インストールの準備ができました] ページが表示されます。

18. [インストールの完了後に AOS インスタンスを起動する] チェックボックスをオフにします。

19. [インストール] をクリックします。インストール後に、[セットアップが正常に完了しました]

ページが表示されます。

20. [完了] をクリックします。

インストール完了後の作業

インストールが完了したら、以下の手順に従ってアップグレードを続行します。

1. まだ実行していない場合は、既存のアプリケーションファイルをコピーします。詳細につい

ては、「既存のアプリケーションファイルのコピー」を参照してください。

2. Microsoft Dynamics AX 2009 AOS を起動します。[スタート] メニューの [ファイル名を指定

して実行] をクリックし、「Services.msc」と入力し、[OK] をクリックします。[サービス]

ウィンドウで、[Dynamics AX Object Server 5.0$[データベース名]] を右クリックし、[開始]

をクリックします。

メモ :

データベースのサイズと複雑さは、AOS の起動にかかる時間に影響します。起動に

時間がかかる場合があります。

3. Microsoft Dynamics AX クライアントを起動します。アップグレードのチェックリストが表

示されます。アップグレードのチェックリストの手順を実行してアプグレードを続行します。

詳細については、「アップグレードのチェックリスト」を参照してださい。



アップグレードのチェックリスト

アップグレードのチェックリストを使用すると、アップグレードプロセスの手順を確認して

Microsoft Dynamics AX システムを正しく効率的にアップグレードできます。

アップグレードのチェックリストには、アップグレードを正常に完了するために必要なタスクと

省略可能なタスクが表示されます。各タスクが完了すると、チェック済の印が表示されます。タ

スクの多くは、1 回だけ設定するオプションです。

関連するタスクのステータスを示すためにアイコンが使用されます。タスクの中には必須のもの

や、他のタスクが完了してからでないと実行できないものがあります。タスクは上から順に実行

する必要があります。

重要 :

中国、日本、ブラジル、インド、またはタイ向けの個別の GLS レイヤがインストー

ルされている Microsoft Dynamics AX 3.0 または 4.0 をアップグレードする場合は、

アップグレードのチェックリストを実行しないでください。このようなアップグレ

ードを進める方法については、Microsoft Dynamics AX 2009 の統合された GLS レイ

ヤ用のインストール手順を参照してください。

アップグレードのチェックリストの表示

アップグレードのチェックリストは、Microsoft Dynamics AX 2009 アプリケーションを初めて起

動したとき、またはシステムで以前のバージョンの Microsoft Dynamics AX を使用していたが一

部のアップグレードのチェックリストのタスクが完了していない場合に自動的に表示されます。

また、[管理]、[設定]、[システム]、[チェックリスト]、[アップグレードのチェックリスト] の順に

クリックしてアップグレードのチェックリストにアクセスすることもできます。

アップグレードチェックリストの起動の回避

(開発者向け) アップグレードのチェックリストは、チェックリストのすべての手順を完了しない

限り、Microsoft Dynamics AX 2009 クライアントを起動するたびに表示されます。Microsoft

Dynamics AX 2009 クライアントを起動するたびにアップグレードのチェックリストが起動され

ないようにするには、アップグレードのチェックリストの下部にある [アップグレードのチェッ

クリストの起動の防止] チェックボックスをオンにします。アップグレードのチェックリストの

[準備のアップグレード] セクションに示されたすべての必須タスクを完了している場合は、[チェ

ックリストの起動の防止] チェックボックスのみが表示されます。





データアップグレードコックピット

事前同期、事後同期、および追加のアップグレードの各ステージで、データアップグレードコ

ックピットを使用します。

メモ :

データアップグレードコックピットを使用する前に、アップグレードチェックリスト

の [準備のアップグレード] セクションに指定されているタスクをすべて完了しておく必

要があります。

データアップグレードコックピットで作成されるアップグレードジョブによって、データアッ

プグレードタスク間の正しい依存関係が維持され、タスクが正しい順序で開始されるようにな

ります。データアップグレードコックピットは、このアップグレードジョブおよび関連タスク

との対話や、アップグレードジョブのステータスの表示にも役立ちます。

データアップグレードコックピットグリッドのすぐ上のボックスには、データのログ作成に関

する情報が表示されます。

メモ :

データアップグレードプロセスは高いパフォーマンスを必要とするため、アップグレー

ド中はデータベースログを最小に変更することをお勧めします。アップグレードプロセ

スが完了したら、データベースログを以前の設定に戻してください。

データアップグレードコックピットグリッドの各行は、アップグレードジョブに含まれる個々

のタスクを表します。

データアップグレードコックピットの表示

データアップグレードコックピットを表示するには、アップグレードのチェックリストで [事前

同期]、[事後同期]、または [追加のアップグレード] をクリックします。

アップグレードジョブの開始

アップグレードジョブを開始してバッチサーバーに送信するには、[実行] をクリックします。

ジョブのタスクは、アップグレードスクリプトの依存関係ツリーに基づいて、正しい順序に並

べ替えられて実行されます。



タスクのステータス

ジョブを実行すると、ジョブの各タスクのステータスが、データアップグレードコックピット

に表示されます。

ステータス説明

準備完了アップグレードスクリプトを実行する準備が

できました。

待機中アップグレードスクリプトは別のジョブが完

了するのを待機しているか、ジョブは再開され

たので待機中です。

完了済アップグレードスクリプトが正常に完了しま

した。

エラーアップグレードスクリプトの実行中にエラー

が発生しました。

実行アップグレードスクリプトが実行中です。

アップグレードジョブの一時停止

アップグレードジョブをキャンセルせずに停止するには、[一時停止] をクリックします。ジョブ

内の既に開始されたタスクはキャンセルされませんが、準備完了状態のタスクは待機状態になり、

ジョブを再び実行するまでは他のタスクがバッチに送信されません。

スクリプトの再実行

タスクをバッチに再送信するには、タスクを選択して [スクリプトの再実行] をクリックし、[実行]

をクリックしてタスクを開始します。失敗したスクリプトを一度に 1 つずつ再開するには、この

アクションを実行します。

メモ :

正常に実行されたタスクは再実行されません。アップグレードフレームワークでは、

syssetupcompanylog テーブルにエントリがあるタスクは開始されません。

失敗したすべてのスクリプトの再実行

複数のアップグレードタスクが失敗した場合、失敗したスクリプトを再実行するには [失敗した

すべてのスクリプトの再実行] をクリックします。



スクリプトの再読み込み

データアップグレードジョブを最初から再作成するには、[スクリプトの再読み込み] をクリッ

クします。このアクションにより、すべてのアップグレードスクリプトの依存関係ツリーが再

スキャンされ、依存関係に基づくアップグレードジョブ制約が再作成されて、ジョブが再作成

されます。アップグレードスクリプト内の 1 つ以上の依存関係を変更した後、新しい依存関係

ツリーに基づいてデータアップグレードジョブを再実行する場合に、このオプションが役立ち

ます。

ジョブエラーの表示

ジョブのステータスが "エラー" の場合、次のようにしてエラーの発生元を検出できます。

1. エラーが発生したタスクを選択し、[ジョブエラーの表示] をクリックします。

エラーの発生元を示す情報ログボックスが表示されます。

2. エラーの発生元を調べて修正した後、[タスクの再実行] をクリックしてタスクを再実行します。

メモ :

開発者ライセンスを持っている場合、タスクをダブルクリックすると、そのタスクのス

クリプトにアクセスして編集することができます。アップグレードスクリプトの作成に

ついては、「How to Write Data Upgrade Scripts white paper (データアップグレードス

クリプトの記述方法に関するホワイトペーパー)」

(http://go.microsoft.com/fwlink/?LinkId=115169&clcid=0x409) を参照してください。トラ

ブルシューティングの詳細については、「データアップグレードコックピットのトラブ

ルシューティング」を参照してください。

ジョブの先行処理の表示

ステータスが "待機中" のタスクは、他の未完了のタスクに依存しています。あるタスクがどの

タスクに依存しているのかは、次のようにして確認できます。

1. ステータスが "待機中" のタスクを選択し、[スクリプトの先行処理の表示] をクリックします。

2. 新しいダイアログボックスに、選択したタスクの開始前に完了する必要があるタスクが一覧

表示されます。

バッチタスクの表示

バッチタスクの詳細を表示するには、タスクを選択して [バッチタスクの表示] をクリックします。

バッチジョブの表示

バッチジョブの詳細を表示するには、[バッチジョブの表示] を選択します。すべてのバッチタ

スクの相互関係を示すフォームが表示されます。

http://go.microsoft.com/fwlink/?LinkId=115169&clcid=0x409




キャンセル

ステータスが "待機中" のアップグレードジョブが開始されないようにするには、[キャンセル]

をクリックします。[キャンセル] をクリックする前に開始されたジョブは、完了するまで続行さ

れます。

メモ :

このアクションは慎重に実行してください。[キャンセル] をクリックした後は、データ

ベースの整合性が失われている可能性があります。アップグレードを再開するときは、

データベースバックアップから作業することをお勧めします。

試行

アップグレードタスクをスキャンして、データアップグレードに関する潜在的な問題を特定す

るには、[試行] をクリックします。実行操作の場合とは異なり、失敗時にもデータアップグレー

ドが停止しません。このアクションの主な目的は、データアップグレードプロセス中に発生す

る可能性のあるデータアップグレードの問題を修正するのに必要な労力を見積もることです。

試行中、親アップグレードタスクが正当な理由で失敗した場合に、子タスクで偽の失敗が発生

する可能性があります。この失敗が発生するのは、データの依存関係の要件が満たされないため

です。この場合、タスクを修復する必要はありません。



アップグレードの準備

このセクションでは、データのアップグレード前に実行する必要があるタスクについて説明しま

す。詳細については、次のトピックを参照してください。

アプリケーションのコンパイル (アップグレード)

ライセンス情報の指定

タイムゾーンとアップグレード

アップグレードされたデータのタイムゾーンの設定

顧客フィードバックオプションの設定

カスタマイズの競合の検出

比較ツール

コードのアップグレード後のシステムのテスト

グローバルアドレス帳用の仮想会社の作成



アプリケーションのコンパイル

(アップグレード)

アプリケーションをコンパイルします。これによって、すべてのオブジェクト参照が更新され、

アプリケーションを使用できるようになります。このプロセスは必ず実行してください。

メモ :

アプリケーションのコンパイルタスクを実行するには、チェックリストを実行している

コンピュータに .NET Business Connector がインストールされている必要があります。

また、サービスパックのインストールを行う場合も、標準アプリケーションからのオブジェク

ト参照を更新する必要があるので、アプリケーションをコンパイルする必要があります。

アプリケーションをコンパイルすると、そのソースコードファイルが Microsoft Dynamics AX

カーネルによって解釈可能なバイナリオブジェクトファイルに変換されます。このオブジェク

トファイルの拡張子は .aod です。

メモ :

使用するハードウェアによってはコンパイルに 1 時間以上かかることがあります。コン

パイルは必ず完了するまで実行する必要があります。



ライセンス情報の指定

Microsoft Dynamics AX を使用するには、管理者がライセンス情報を入力する必要があります。

ライセンスコードを入力することにより、ライセンスによってカバーされる一般的な機能を有

効にします。その後、コンフィギュレーションキーを変更することにより、個別の機能へのア

クセスを有効または無効にすることができます。

メモ :

ライセンスキーの更新により現在のライセンス設定を変更する場合、クライアントを再

起動しないと新しい機能は使用できません。

Microsoft Dynamics AX 機能用のライセンスコードに加えて、Microsoft Dynamics AX 開発環境

へのアクセス用に 4 つのライセンスがあります。詳細については、「開発アクセスライセンス」


ライセンスを所有していない場合でも、Microsoft Dynamics AX をデモモードで設定できます。

デモモードでは、Microsoft Dynamics AX のすべての機能を使用することができ、すべてのコン

フィギュレーションキーが既定で有効になっています。

ライセンス情報のインポート

1. 初期化のチェックリストまたはアップグレードチェックリストから "ライセンス情報" フォ

ームを開くか、[管理]、[設定]、[システム]、[ライセンス情報] の順にクリックします。

2. ファイルからライセンスコードをインポートするには、[ライセンスファイルの読み込み] を


[ライセンスファイルの読み込み] ダイアログボックスが表示されます。

3. フォルダアイコンをクリックし、ライセンスファイルを参照します。

メモ :

ライセンスファイルは、Microsoft Dynamics AX 管理者だけが知っている安全な場

所に保存することをお勧めします。

4. [OK] をクリックします。データベースを同期するかどうかを確認するメッセージが表示され

ます。

5. [はい] をクリックします。

6. [ライセンス情報] ウィンドウを閉じます。



ライセンス情報の入力

ライセンス情報をインポートする代わりに、ライセンス情報を手動で入力できます。

1. 初期化のチェックリストまたはアップグレードチェックリストから "ライセンス情報" フォ

ームを開くか、[管理]、[設定]、[システム]、[ライセンス情報] の順にクリックします。

2. ライセンス所有者の名前、システムのシリアル番号、および有効期限を入力します。これら

の情報はライセンスドキュメントに記載されています。

3. [システム] タブで、ライセンスコードを入力し、想定されたテキストが [ステータス] フィー

ルドに表示されることを確認します。

ライセンスコードは、標準、プロフェッショナル、またはエンタープライズのどのソリュー

ションを利用するかを示します。

重要 :

最初の 4 つの入力 (ライセンス保持者の名前、システムのシリアル番号、有効期限、

ライセンスコード) により、残りのコードに表示される内容が決定されます。した

がって、これらは正確に入力する必要があります。

4. 残りのコードを入力します。

各コードについて、[ステータス] フィールドを調べて、コードが正しいかどうか確認します。

参照

ライセンスコードとコンフィギュレーションキーについて



タイムゾーンとアップグレード

utcDateTime データ型は、Microsoft Dynamics AX 2009 で推奨される日付と時刻のデータの格

納方法です。データのアップグレードによって、utcDateTime データ型を使用するようにすべ

てのシステム日付とシステム時刻のフィールドが自動的に更新されます。データのアップグレー

ド中、テーブルが Microsoft Dynamics AX 2009 と共に出荷されたものか、パートナーによって

追加されたものかに関係なく、すべてのテーブルがスキャンされて各テーブルのシステムフィ

ールドが検索されます。

データを正しくアップグレードするには、アップグレードのチェックリストで使用するタイム

ゾーンを指定する必要があります。このタイムゾーンを使用して、日付と時刻のフィールドが

協定世界時 (UTC) 値に変換されるときにそれらのフィールドに適用するオフセットを決定します。

メモ :

カスタムの [日付] フィールドまたは [時刻] フィールドが Microsoft Dynamics AX に追加

された場合、それらのフィールドを新しい UtcDateTime フィールドにマージする必要

があるかどうかを決定する必要があります。UtcDateTime フィールドでは日付と時刻の

データを UTC で格納します。詳細については、「チュートリアル : 日付と時刻のテーブ

ルフィールドのペアを UtcDateTime にアップグレードする」を参照してください。

日付と時刻のデータおよびタイムゾーンの詳細については、Microsoft Dynamics AX の『アプリ

ケーションおよび業務プロセス』ヘルプを参照してください。



アップグレードされたデータのタイムゾーンの

設定

データのアップグレード時に、すべてのシステム日時フィールドが datetime データ型を使用す

るように更新され、協定世界時 (UTC) の値に変換されます。すべてのテーブルでシステム日時

フィールド (パートナーによって追加されたものも含む) がスキャンされます。

システムフィールド以外の日付と時刻をアップグレードすることもできます。

アップグレードされたデータのタイムゾーンの設定

1. アップグレードチェックリストで、[現在のタイムゾーンの設定] をクリックします。

"現在のタイムゾーン" フォームが表示されます。

2. [タイムゾーン] ボックスの一覧で、使用するタイムゾーンを選択します。このタイムゾー

ンを使用して、日時フィールドが UTC の値に変換されます。



顧客フィードバックオプションの設定

Microsoft のソフトウェアおよびサービスの品質、信頼性、パフォーマンスを向上させるために

役立つカスタマエクスペリエンス向上プログラムにご協力ください。

初期化のチェックリストまたはアップグレードチェックリストから "Microsoft Dynamics Ax 顧

客フィードバックオプション" フォームを開くか、[管理]、[設定]、[システム]、[顧客フィードバ

ックオプション] の順にクリックします。

このプログラムでは、コンピュータのハードウェアおよび Microsoft Dynamics AX の使用状況に

ついての情報が収集されますが、ユーザーの作業が中断されることはありません。これは、

Microsoft が Microsoft Dynamics AX の機能を向上させるために役立てられます。収集された情

報によって、ユーザーが識別されたり、ユーザーが連絡を受けたりすることはありません。

カスタマエクスペリエンス向上プログラムの詳細およびプライバシーに関する声明の全文につ

いては、カスタマエクスペリエンス向上プログラムの Web サイトを参照してください。

http://www.microsoft.com/products/ceip



カスタマイズの競合の検出

アップグレードプロセスにおけるコードのアップグレート部分は、Microsoft Dynamics AX 3.0

または 4.0 インストールでのコードの確認と、Microsoft Dynamics AX 2009 コードとの比較で構

成されています。以前にインストールしたバージョンのコードが新しいバージョンのコードと異

なる場合、アップグレードの競合が生じます。次のシナリオの場合にコードの競合が生じる可能

性があります。

前のインストールで開発した機能が現在 Microsoft Dynamics AX 2009 に存在している。

前のインストールに存在していたオブジェクトの使用をやめたか、名前を変更したため、

Microsoft Dynamics AX 2009 と非互換が生じている。

前のインストールで既存のオブジェクトを変更している (この場合、Microsoft Dynamics AX

2009 で処理を行うには、それらの変更 (テーブルのフィールド、クラスの変更、フォームや

レポートの変更) を移動または更新する必要がある)。

Microsoft Dynamics AX システムのカスタマイズによって生じたアップグレードの競合の検出に

使用できるツールがいくつか用意されています。

コードのアップグレードの競合の検出

コードのアップグレードの競合の検出ツールを使用して、コードのアップグレードの競合に関す

るカスタマイズを分析し、アップグレードプロジェクトを作成します。

1. [アップグレードのチェックリスト] で、[コードのアップグレードの競合の検出] をクリック

します。"コードのアップグレードの競合の検出" フォームが表示されます。

2. [OK] をクリックします。1 つ以上のアップグレードプロジェクトが作成されます。

見積報告書の作成

アップグレードプロジェクトが作成されたら、見積報告書ツールを使用して、カスタマイズの

アップグレードにかかる時間を確認できます。

1. メインの Microsoft Dynamics AX フォームを表示したまま、Ctrl + Shift + P キーを押して "プロ

ジェクト" フォームを表示します。

2. 上記の「コードのアップグレードの競合の検出」手順で作成したアップグレードプロジェク

トを右クリックし、[開く] を選択します。"プロジェクトのアップグレード" フォームが表示

されます。

3. アップグレードプロジェクトを右クリックし、[パラメータ] を選択します。"パラメータの

アップグレード" フォームが、既定の見積時間が入力された状態で表示されます。

4. [上書きされた見積] グリッドで新しいエントリを作成するには、グリッド内をクリックし、

Ctrl + N キーを押します。

5. アプリケーションオブジェクトタイプを 1 つ選択し、そのタイプの競合を修正するために必

要な見積時間を入力します。



6. [追加見積] タブをクリックし、既定の見積を確認および変更します。

7. 見積時間の入力が完了したら、"パラメータのアップグレード" フォームを閉じます。

8. "プロジェクトのアップグレード" フォームで、アップグレードプロジェクトを右クリックし、

[見積報告書] を選択します。"見積のアップグレード" フォームが表示されます。レポートを

生成する前に、レポートの設定を変更できます。

9. [OK] をクリックしてレポートを作成します。

レイヤの比較ツール

コードのアップグレードの競合の検出ツールの代わりに、レイヤの比較ツール (Microsoft

Dynamics AX メニューで、[ツール]、[開発ツール]、[コードのアップグレード]、[レイヤの比較]

の順に選択) を使用して、2 つのレイヤを比較し、異なるオブジェクトを持つプロジェクトを作

成できます。

レイヤの比較ツールでは、特定のレイヤで行われた変更の概要を確認できます。詳細については、

「比較ツール」を参照してください。

メモ :

複数のレイヤで変更している場合は、一度に 1 つのレイヤをアップグレードします。アク

セスできる最下位のレイヤを最初にアップグレードする必要があります。たとえば、

VAR レイヤと USR レイヤがある場合は、VAR レイヤを先にアップグレードしてから

USR レイヤをアップグレードします。

プロジェクトフィルタツール

開発者権限を持っている場合は、アップグレードプロセスで、コードのアップグレードの競合

の検出ツールまたはレイヤの比較ツールの代わりにプロジェクトフィルタツールを使用できま

す。プロジェクトフィルタツールでは、クエリフォームで指定された基準に基づいてプロジェ

クトを作成できます。たとえば、関連レイヤのすべてのオブジェクト、特定の接頭語を持つすべ

てのオブジェクト、特定のユーザーが作成したすべてのオブジェクトなどを基準として指定でき

ます。プロジェクトフィルタツールの詳細については、Microsoft Dynamics AX の [ヘルプ]

メニューにある開発者ヘルプを参照してください。



比較ツール

Microsoft Dynamics AX では、比較ツールを使用してアプリケーションオブジェクトを比較し、

違いを検出できます。違いを識別したら、比較したアプリケーションオブジェクト間でその違

いを挿入、削除、または移動できます。このトピックでは、比較結果の解釈方法について説明し

ます。

比較ツールでは次のものを比較できます。

2 つの異なるアプリケーションオブジェクト。

2 つの異なるレイヤにある同じアプリケーションオブジェクト。

バージョン管理を使用している場合、同じアプリケーションオブジェクトの 2 つのバージョン。

同じアプリケーションオブジェクトの 2 つのバージョンと、そのアプリケーションオブジ

ェクトの元のバージョン。

比較ツールの詳細については、Microsoft Dynamics AX 開発者向けドキュメントの比較ツールの

トピックを参照してください。






2 つのアプリケーションオブジェクトを比較

する方法

Microsoft Dynamics AX では、比較ツールを使用して、同じレイヤまたは異なるレイヤにある 2 つ

のアプリケーションオブジェクトを比較できます。たとえば、CUS レイヤのテーブルを SYS

レイヤの同じテーブルと比較できます。比較ツールでは、2 つのアプリケーションオブジェクト

の違いを識別し、その違いをコピー、移動、または削除するアクションボタンを提供します。

このトピックでは、アプリケーションオブジェクトツリー (AOT) の 2 つのアプリケーション

オブジェクトを比較する方法について説明します。

手順

2 つのアプリケーションオブジェクトを比較するには

1. AOT で、比較するアプリケーションオブジェクトを選択します。

2. 選択したアプリケーションオブジェクトを右クリックし、[比較] をクリックします。"比較"

フォームが開きます。

3. [詳細] タブをクリックし、必要に応じて次のオプションを設定します。

オプション説明

差額のみを表示差分のみを表示する場合は、このオプショ

ンを選択します。このオプションを選択し

ない場合、一致する結果が黒のチェック

マーク付きで表示されます。

空白の非表示 X++ コードのスペース数の違いを表示す

る場合は、このオプションを選択します。

大文字と小文字の区別大文字と小文字の違いを表示する場合は、

このオプションを選択します。このオプシ

ョンを使用すると、MyName と Myname

は異なるものとして表示されます。

行番号の表示 X++ コードの行番号を有効にする場合

は、このオプションを選択します。

4. [比較] をクリックして、2 つのアプリケーションオブジェクトの比較を開始します。

違いは、"比較" フォームの結果ウィンドウに表示されます。詳細については、

「Compare Tool (比較ツール)」を参照してください。

参照

オブジェクトのバージョンを比較する方法

方法 : アプリケーションオブジェクトレイヤの比較

http://go.microsoft.com/fwlink/?LinkID=124856&clcid=0x409



オブジェクトのバージョンを比較する方法

Microsoft Dynamics AX では、比較ツールを使用して同じアプリケーションオブジェクトの 2 つ

のバージョンを比較できます。たとえば、バージョン管理が有効な場合は、同じテーブルの以前

のバージョンとテーブルを比較できます。バージョン管理システムによって格納されているアプ

リケーションオブジェクトの各バージョンには番号が付けられます。比較ツールでは、2 つのバ

ージョンの違いを識別し、その違いをコピー、移動、または削除するアクションボタンを提供

します。このトピックでは、同じアプリケーションオブジェクトの 2 つの異なるバージョンを

比較する方法について説明します。

手順

アプリケーションオブジェクトの 2 つのバージョンを比較するには

1. アプリケーションオブジェクトツリーで、比較するアプリケーションオブジェクトを

右クリックし、[比較] をクリックします。"比較" フォームが表示されます。

2. [名前 & 場所] タブで、比較する 2 つのバージョンを選択します。

3. [詳細] タブをクリックし、必要に応じて次のオプションを設定します。

オプション値

差額のみを表示差分のみを表示する場合は、このオプショ

ンを選択します。このオプションを選択し

ない場合、一致する結果が黒のチェック

マーク付きで表示されます。

空白の非表示 X++ コードのスペース数の違いを表示す

る場合は、このオプションを選択します。

大文字と小文字の区別大文字と小文字の違いを表示する場合は、

このオプションを選択します。このオプシ

ョンを使用すると、MyName と Myname

は異なるものとして表示されます。

行番号の表示 X++ コードの行番号を有効にする場合

は、このオプションを選択します。

4. [比較] をクリックして、バージョンの比較を開始します。

バージョン間の違いは、"比較" フォームの結果ウィンドウに表示されます。詳細については、

「Compare Tool (比較ツール)」を参照してください。




方法 : アプリケーションオブジェクトレイヤの

比較

このトピックでは、Microsoft Dynamics AX のレイヤの比較ツールについて説明します。レイヤ

の比較ツールを使用して、2 つのアプリケーションオブジェクトレイヤ (SYP レイヤと SYS レ

イヤなど) を比較できます。

レイヤの比較ツールでは、ソースレイヤを参照レイヤと比較します。比較プロセスでは、変更

されたアプリケーションオブジェクトまたは参照レイヤにのみ存在するアプリケーションオブ

ジェクトを検索します。

VAR をソースレイヤとして、サービスパックがインストールされた標準アプリケーションと比

較するには、SYP を参照レイヤとして選択します。レイヤ比較プロセスでは、VAR レイヤと

SYP および SYS レイヤが比較されます。比較の結果はプロジェクトとして示されます。プロジ

ェクトには、参照レイヤに存在しないオブジェクト、または両方のレイヤに存在するオブジェク

トが含まれますが、[両方のレイヤにある要素だけを含める] オプションが選択されていない場合

は、異なるオブジェクトが含まれます。

参照レイヤが古いレイヤ (old sys など) ではない場合、参照レイヤには、その下にあるレイヤが

すべて含まれます。たとえば、USR レイヤがソースレイヤで、参照レイヤとして CUS レイヤ

と比較した場合、参照レイヤには CUS レイヤとその下にあるすべてのレイヤが含まれます。



手順

アプリケーションオブジェクトレイヤを比較するには

1. [Microsoft Dynamics AX] メニューで、[ツール]、[開発ツール]、[コードのアップグレード]

の順にポイントし、[レイヤの比較] をクリックします。レイヤの比較ツールが開きます。

2. レイヤの比較ツールで、必要に応じて次のプロパティを設定します。

オプション説明

プロジェクト名レイヤの比較ツールの処理結果を含むプロ

ジェクトの名前。

ソースレイヤ比較の基準レイヤとして使用されるレイヤ。

この比較ツールの結果には、ソースレイ

ヤに含まれているアプリケーションオブ

ジェクトの違いのみが表示されます。

参照レイヤソースレイヤと比較するレイヤ。

メモ :

参照レイヤとして old sys を

選択できます。これは、どの

アプリケーションオブジェク

トが変更されたか確認する場

合に便利です。

両方のレイヤにある要素だけを含めるレイヤ間の競合を検出する場合は選択しま

す。選択すると、いずれか 1 つのレイヤだ

けで見つかった要素は無視されます。

3. [OK] をクリックして、アプリケーションオブジェクトレイヤの比較を開始します。

4. 違いのあるアプリケーションオブジェクトを含むプロジェクトが作成されます。オブジ

ェクトはツリー構造で表示され、通常のアプリケーションオブジェクトツリー (AOT)

ショートカットメニューコマンドが使用できます。

メモ :

比較を行う場合は、各オブジェクトが属しているレイヤを参照すると役に立ちます。

詳細については、Microsoft Dynamics AX の開発者向けドキュメントの「How to: Set

the Layer View for Application Objects」を参照してください。






コードのアップグレード後のシステムのテスト

コードをアップグレードした後、データのアップグレードに進む前に、インストールが正しく機

能しているかどうかをテストします。

Microsoft Dynamics AX システムへのコードのアップグレードが成功したかどうかをテストする

には、最低限、次の手順を実行する必要があります。










グローバルアドレス帳用の仮想会社の作成

グローバルアドレス帳機能を使用すると、会社間でアドレス帳の情報を共有できます。アドレ

ス帳を共有する会社のグループごとに仮想会社を作成する必要があります。

重要 :

アドレス帳用の仮想会社は、会社の顧客、仕入先、従業員、競合他社、または連絡先の

レコードを作成する前に設定しておく必要があります。

会社コード、仮想会社、およびグローバルアドレス帳の詳細については、Microsoft Dynamics AX

の [ヘルプ] メニューにある『システムとアプリケーションのセットアップ』ヘルプを参照してく

ださい。

例

Fabrikam Inc. では、Microsoft Dynamics AX で 5 つの会社を設定しています。

会社 1 と会社 2 は、関連する製造業務と配送業務を行っています。

会社 3 と会社 4 は、専門サービスの業界に属しています。

会社 5 は小売業界に属しています。

Fabrikam Inc. では関連する会社がアドレス帳情報を共有する必要があります。このため、管理

者は次の仮想会社を設定します。

仮想会社仮想会社に含まれる会社

仮想会社 A 会社 1

会社 2

仮想会社 B 会社 3

会社 4

該当なし会社 5

アドレス帳用の仮想会社の設定

1. 初期化チェックリストまたはアップグレードチェックリストから "仮想会社" フォームを開

くか、[管理]、[設定]、[仮想会社] の順にクリックします。

2. Ctrl + N キーを押して新しいレコードを作成します。

3. [会社コード] フィールドに、会社の ID を入力します。

4. [会社コード名] フィールドに、仮想会社の名前を入力します。

5. [会社コード] をクリックします。



6. 仮想会社に含める会社コードを選択します。

会社コードを追加するには、[残りの会社コード] の下で会社名を選択し、左矢印 (<) を

クリックして [選択した会社コード] ボックスの一覧に移動します。

会社コードを削除するには、[選択した会社コード] の下で会社名を選択し、右矢印 (>)

をクリックして [残りの会社コード] に移動します。

7. [テーブルコレクション] タブをクリックします。

8. DirPartCollection テーブルを選択し、左矢印 (<) をクリックして [選択したテーブルコレク

ション] ボックスの一覧に移動します。

9. 初期化チェックリストまたはアップグレードチェックリストから "仮想会社" フォームを開

いた場合は、[アドレス帳の検証] をクリックすることで、仮想会社の設定に関連するアドレ

ス帳エラーがないかを確認できます。



データのアップグレード

新しいバージョンまたはサービスパックへのアップグレードプロセスの一環として、データを

アップグレードする必要があります。これは、既存のデータディクショナリに変更を加えたと

き (テーブル、フィールド、またはインデックスの名前変更、削除、または追加を実行したとき)

に必要です。

このセクションでは、データアップグレードのパフォーマンスの向上と、アップグレードのチ

ェックリストに示されたデータアップグレードタスクについて説明します。詳細については、

次のトピックを参照してください。

データアップグレードのパフォーマンスの向上

データベースの事前同期

データベースの同期

データベースの事後同期

データアップグレード後のシステムのテスト



データアップグレードのパフォーマンスの向上

データアップグレードの最適化に関するホワイトペーパー

(http://go.microsoft.com/fwlink/?LinkId=119309) を読んで、データアップグレードプロセス時の

システムのパフォーマンスを向上する方法を確認してください。




データベースの事前同期

データベースを同期できるように準備するには、データアップグレードコックピットを使用し

ます。詳細については、「データアップグレードコックピット」を参照してください。

このプロセスでは、以前のバージョンの Microsoft Dynamics AX データベーススキーマを同期で

きるように準備します。

たとえば、事前同期プロセスでは、重複を削除したり、

ReleaseUpdateDB_V30toV40::allowDupPurchParmTable などの固有のインデックスを無

効にします。

また、事前同期プロセスではメタデータの変更も準備します。この変更は、事後同期フェーズで

元に戻されます。

メモ :

データアップグレードコックピットを使用するには、アップグレードのチェックリスト

の先行するタスクがすべて完了している必要があります。

1. アップグレードのチェックリストで、[事前同期] をクリックします。"データアップグレー

ドコックピット" フォームが表示され、実行するアップグレードタスクが示されます。

2. [実行] をクリックします。アップグレードジョブが開始され、ジョブの各タスクの隣のアイ

コンにそのタスクのステータスが表示されます。

3. エラーが発生した場合は対処し、完了したらデータアップグレードコックピットを閉じま

す。実行できるアクションの詳細については、「データアップグレードコックピット」を

参照してください。



データベースの同期

アプリケーションファイルを、データベースサーバー上の対応する現在のバージョンと同期し

ます。これらの手順を実行するときに、テーブルとインデックスを、アプリケーションオブジ

ェクトツリー (AOT) で行った変更と同期します。アップグレードする場合や、AOT でのビュー

およびスキーマの変更をデータベースに入力する場合には、同期は必須です。

1. アップグレードのチェックリストで、[データベースの同期] をクリックします。"データベー

スの同期" フォームが表示されます。

[概要] タブには、同期プロセスによって作成されたエラーメッセージ、警告メッセージ、およ

び情報ログメッセージが表示されます。

2. [エラー]、[警告]、または [情報] タブをクリックし、メッセージの原因となったテーブルの一

覧およびメッセージのテキストを表示します。

3. [続行] をクリックします。



データベースの事後同期

事後同期プロセスを実行するには、データアップグレードコックピットツールを使用します。

データアップグレードコックピットの詳細については、「データアップグレードコックピット」


ほとんどのデータアップグレードが、事後同期で行われます。また、このプロセスで、事前同

期中に行われたメタデータ変更が破棄されます。

メモ :

事後同期を開始するには、アップグレードのチェックリストの先行タスクがすべて完了

している必要があります。

1. アップグレードのチェックリストで、[事後同期] をクリックします。データアップグレード

コックピットが表示されます。

2. [実行] をクリックして、事後同期タスクを、実行するアップグレードジョブバッチサーバ

ーに送信します。

タスクのステータスは、"準備完了"、"待機中"、"実行"、"完了済"、または "エラー" になりま

す。タスクのステータスの詳細については、「データアップグレードコックピット」を参


事後同期が完了したら、アップグレードのチェックリストの [アップグレードの終了処理] セク

ションに指定されている最初のタスクを開始できます。



データアップグレード後のシステムのテスト

データをアップグレードした後に、Microsoft Dynamics AX 2009 インストールが正しく機能して

いることを確認してから、実稼働環境でのアップグレードに進みます。これは、作成したドキュ

メントやトレーニングをテストするのに最適な機会です。

データのアップグレードが成功したかどうかをテストするには、最低限、次の手順を実行する必







ユーザーが生成されたレポートを読むことができるかテストします。



データがアップグレード前と整合性があるか検証します。



アップグレードの終了処理

このセクションでは、データのアップグレード後に実行する必要があるタスクについて説明します。

詳細については、次のトピックを参照してください。

メモ :

AIF のアップグレードタスクは、サポートされているサービスパックがインストールさ

れた Microsoft Dynamics AX 3.0 からアップグレードするシステムには適用できません。

Microsoft Dynamics AX 3.0 リリースには AIF が存在しないためです。

システムアカウントのコンフィギュレーション

エンタープライズポータルのアップグレード

ロールセンター Web サイトの指定

AIF のアップグレード



システムアカウントのコンフィギュレーション

システムで使用するアカウントをコンフィギュレーションします。これには、ビジネスコネク

タプロキシアカウント、ワークフローシステムアカウント、ワークフロー実行アカウント、同期

サービスアカウント、および Virtual Earth のアカウントが含まれます。

初期化のチェックリストまたはアップグレードチェックリストから "システムサービスアカウ

ント" フォームを開くか、[管理]、[設定]、[セキュリティ]、[システムサービスアカウント] の順

にクリックします。

ビジネスコネクタプロキシアカウントのコンフィギュレーション

[エイリアス] フィールドと [ネットワークドメイン] フィールドに、ビジネスコネクタプロキシ

アカウントのユーザー名およびドメインを入力します。

ビジネスコネクタプロキシアカウントは、Microsoft Dynamics AX とアプリケーション (ロール

センターやエンタープライズポータルフレームワーク、ワークフロー、同期サービス、AIF Web

サービスなど) 間の通信に使用されます。これらのアプリケーションをインストールする前に、

ビジネスコネクタプロキシアカウントをコンフィギュレーションする必要があります。

ビジネスコネクタプロキシアカウントの要件の詳細については、『サーバーおよびデータベー

ス管理ガイド』を参照してください。

ワークフローシステムアカウントのコンフィギュレーション

ワークフローシステムアカウントは、Microsoft Dynamics AX とワークフロー Web サーバー間

の通信に使用されます。次のいずれかのアカウントを使用できます。

[エイリアス] フィールドと [ネットワークドメイン] フィールドにドメインアカウントを入

力し、ワークフローシステムアカウントにドメインユーザーを使用します。

ワークフローサービスと通信する Microsoft Dynamics AX ユーザーを入力します。サービス

を新規または既存の Microsoft Dynamics AX ユーザーに関連付けることができます。

ワークフローシステムアカウントの要件の詳細については、『Microsoft Dynamics AX インストー

ルガイド』を参照してください。

ワークフロー実行アカウントのコンフィギュレーション

ワークフロー実行アカウントは、アプリケーションのビジネスロジックを実行したり、

Microsoft Dynamics AX データにアクセスするために使用されます。次のいずれかのアカウント

を使用できます。


力し、ワークフロー実行アカウントにドメインユーザーを使用します。

データベースにアクセスする新規または既存の Microsoft Dynamics AX ユーザーを入力します。

ワークフローシステムアカウントの要件の詳細については、『Microsoft Dynamics AX インストー

ルガイド』を参照してください。

http://go.microsoft.com/fwlink/?LinkID=99628









同期サービスアカウントのコンフィギュレーション

同期サービスアカウントは、Microsoft Dynamics AX、Windows メッセージキュー、および

Microsoft Office Project Server 2007 間の通信に使用されます。次のいずれかのアカウントを

使用できます。


力し、同期サービスアカウントにドメインユーザーを使用します。

同期サービスと通信する Microsoft Dynamics AX ユーザーを入力します。サービスを新規ま

たは既存の Microsoft Dynamics AX ユーザーに関連付けることができます。

同期サービスアカウントの要件の詳細については、『Microsoft Dynamics AX インストールガイド』


Virtual Earth アカウントのコンフィギュレーション

Virtual Earth のアカウントは、エンタープライズポータルからオンラインの Virtual Earth のマッ

プにアクセスする際に使用されます。

Virtual Earth のアカウント名とパスワードは、CustomerSource で確認できます。

チェックボックスをオンにして情報を入力することで、Microsoft Virtual Earth Map Control およ

び MapPoint Web サービスの使用条件に同意します。


https://mbs.microsoft.com/customersource





エンタープライズポータルをアップグレードするには、すべての前提条件を確認し、このトピ

ックの手順を実行する必要があります。エンタープライズポータルをアップグレードする前に、

『Microsoft Dynamics AX 2009 Installation Guide (Microsoft Dynamics AX 2009 インストールガ

イド)』の「Enterprise Portal and Role Centers (エンタープライズポータルとロールセンター)」

セクションを参照して、インストールプロセスを理解してください。

Microsoft Dynamics AX 2009 のインストールプロセスは、以前のバージョンから変更されまし

た。『エンタープライズポータル管理』ヘルプの「エンタープライズポータルの新機能」トピッ

クを読むことをお勧めします。これは、Microsoft Dynamics AX 2009 Windows クライアントの

[ヘルプ] メニューから参照できます。

アップグレードする前に、次のことに注意してください。

Microsoft Dynamics AX 4.0 SP1 用に新しく作成したエンタープライズポータルページは、

Microsoft Dynamics AX 2009 バージョンのエンタープライズポータルでも、4.01 でも引き

続き同様に機能します。

エンタープライズポータルのデータは、Microsoft Dynamics AX のアップグレードのチェッ

クリストを実行するときにアップグレードされます。

前提条件

Microsoft Dynamics AX 4.01 でエンタープライズポータルを実行している場合は、Microsoft

Dynamics AX 2009 のバージョンに直接アップグレードできます。現在 Microsoft Dynamics

AX 4.0 でエンタープライズポータルを実行している場合は、最新バージョンのエンタープ

ライズポータルにアップグレードする前に、Microsoft Dynamics AX 4.01 にアップグレード


最新バージョンのエンタープライズポータルには、Microsoft Windows SharePoint Services

3.0 の Service Pack 1 以降、または Microsoft Office SharePoint Server 2007 の Service

Pack 1 以降が必要です。最新バージョンのエンタープライズポータルにアップグレードす

る前に、以前のバージョンの SharePoint をどちらかのバージョンにアップグレードする必


エンタープライズポータルをアップグレードする前に、Microsoft Dynamics AX 2009 のアッ

プグレードのチェックリストを完了する必要があります。つまり、このトピックの手順を開

始する前に、アップグレードのチェックリストで [エンタープライズポータルのアップグレ

ードの終了処理] オプションを選択する必要があります。





1. Microsoft Dynamics AX 2009 のセットアップを開始します。

2. メッセージが表示されたら [コンポーネントの追加または変更] を選択し、[次へ] をクリック

します。

3. [コンポーネントの追加または変更] ページで [ロールセンターおよびエンタープライズポー

タル] を選択します。[次へ] をクリックします。

4. セットアップによって検出されない必要なソフトウェアがある場合、[インストールの必要条

件] ページが表示されます。ASP.NET 2.0 または Windows SharePoint Services 3.0 Service

Pack 1 のインストールを求めるメッセージが表示されたら、[必須ソフトウェアのインスト

ール] ボタンをクリックします。セットアップによって、必要なすべてのソフトウェアがサ

ーバーにインストールされたことが確認されたら、[次へ] をクリックします。

5. [.NET Business Connector プロキシアカウント情報] ページに、.NET Business Connector

プロキシアカウントのドメインとユーザー名 ("ドメイン\ユーザー名" の形式) およびパスワ

ードを入力します。[次へ] をクリックします。

6. [ロールセンターとエンタープライズポータルフレームワーク: IIS の構成] ページの [Web

サイト] ボックスの一覧で [Microsoft Dynamics AX 4.01 エンタープライズポータル Web サ

イト] を選択します。

7. [Windows SharePoint Services 用に構成する] オプションを選択します。これにより、アプ

リケーションプールを Business Connector プロキシアカウントで実行し、認証方法を

Windows NTLM に設定するように、セットアップでコンフィギュレーションできるようにな

ります。

8. [Web サイトの作成] オプションを選択解除します。このオプションを選択すると、セットア

ップによって古いエンタープライズポータルサイトがアップグレードされますが、新しい

エンタープライズポータルサイトも作成されます。

9. [インストールの準備ができました] ページで [インストール] をクリックします。セットアッ

プによるアップグレードとインストールが完了するまで、1 時間程度かかることがあります。

必要に応じて、インストールの完了時に IIS を再起動するオプションを選択します。このオ

プションを選択する前に、Web サーバー上の他のアプリケーションに対して IIS のリセット

が与える影響を考慮してください。



エンタープライズポータルのアップグレード後

インストールとアップグレードが完了したら、次の操作を行います。

匿名認証を使用するエンタープライズポータルサイト (パブリックエンタープライズポー

タルサイト) をアップグレードした場合、アップグレードの完了後に IIS マネージャで匿名

認証を選択する必要があります。

a. [スタート]、[管理ツール]、[インターネットインフォメーションサービス (IIS) マネージ

ャ] の順にクリックします。

b. [Web サイト] ディレクトリを展開します。

c. アップグレードした Web サイトを右クリックし、[プロパティ] をクリックします。

d. [ディレクトリセキュリティ] タブをクリックします。

e. [認証とアクセス制御] セクションで、[編集] をクリックします。

f. [匿名アクセスを有効にする] をクリックします。

アクセス許可を確認します。以前の SharePoint および Microsoft Dynamics AX のユーザーと

ユーザーグループのアクセス許可が、アップグレードプロセスでも維持されているはずで

す。ただし、それらのアクセス許可を確認してください。

アップグレードされたサイトを実稼働環境に移動する前に、ステージングサーバー上でテス

トします。



ロールセンター Web サイトの指定

Microsoft Dynamics AX とエンタープライズポータルのフレームワークには、ロールセンターと

呼ばれるカスタマイズ可能なホームページが含まれています。ロールセンターには、ユーザー

の組織におけるロールに関連付けられた、特定のデータ、レポート、警告、および一般的なタス

クが表示されます。ユーザーは、Microsoft Dynamics AX クライアントまたはエンタープライズ

ポータル Web サイトから、ロールセンターにアクセスできます。

ロールセンターをホストする Web サイトを指定するには、次のようにします。

1. アップグレードチェックリストで、ロールセンター Web サイトの指定を行うオプションを

クリックします。"Web サイトの管理" フォームが開きます。

2. このフォームの下部にある [Dynamics AX クライアントでロールセンターを表示するために

使用する Web サイト] フィールドを探します。

3. フィールドの右側にあるルックアップアイコンを使用してサイトを選択し、フォームを閉じ

ます。ロールセンターをホストするサイトが確定していない場合は、この手順をスキップし

ます。後でこのフォームを使用してサイトを選択できます。

4. このフォームに Web サイトが表示されない場合は、エンタープライズポータルがインスト

ールされていないか、エンタープライズポータル Web サイトが作成されていません。詳細に

ついては、『Microsoft Dynamics AX インストールガイド』の「エンタープライズポータル

およびロールセンターのインストール」を参照してください。

参照

ロールセンターの設定および管理




AIF のアップグレード

アプリケーション統合フレームワーク (AIF) は、外部システムとデータを交換するために使用さ

れる Microsoft Dynamics AX のフレームワークです。 AIF のアップグレードは、アップグレード

のチェックリスト内の手順の 1 つです。

AIF をアップグレードする場合、アップグレードプロセスには次の 2 つのコンポーネントがあ

ります。

コードのアップグレード : このプロセスでは、新しいサービスクラスの作成、新しいデータ

クラスの作成、および AOT サービスノードの作成を含め、すべての AIF コードをアップグ

レードします。コードのアップグレードプロセスは、アップグレードのチェックリストの

「Aif コードのアップグレード」の手順の一部として実行されます。

データアップグレード : このプロセスでは、データベース内のすべての AIF 関連レコードを

アップグレードします。データアップグレードプロセスは、アップグレードのチェックリ

ストの「追加機能のアップグレード」の手順の一部として実行されます。

Microsoft Dynamics AX 2009 には、AIF でコンフィギュレーションされたドキュメント交換があ

る場合に影響するスキーマの変更があります。Microsoft Dynamics AX 2009 では、ドキュメント

およびメッセージのスキーマが変更されています。したがって、着信メッセージを別の方法で書

式設定し、新しいスキーマに対して検証する必要があります。また、送信メッセージは別の方法

で書式設定され、新しいスキーマに対して検証されます。エンドポイントデータポリシー、

値マッピング、および XSLT の変更が必要な場合もあります。

詳細については、「AIF アップグレードプロセス」を参照してください。



追加のアップグレードタスク

前の手順で Microsoft Dynamics AX のコアシステムをアップグレードしましたが、アップグレー

ドが必要な追加機能がある場合があるので、すべての機能が完全に動作するわけではありません。

追加機能のアップグレード

アップグレードのチェックリストの追加機能のアップグレードタスクを完了するまで

1. アップグレードのチェックリストで、[追加機能のアップグレード] をクリックします。デー

タアップグレードコックピットが表示されます。詳細については、「データアップグレー

ドコックピット」を参照してください。

2. [実行] をクリックします。

3. アップグレードジョブが完了したら、データアップグレードコックピットを閉じます。

ドキュメントヘルプファイルの追加

ヘルプキットを使用すると、Microsoft Dynamics AX 2009 アプリケーションで使用する追加の

ヘルプファイルを作成できます。以前のリリースでヘルプキットを使用して Microsoft

Dynamics AX にドキュメントファイルを追加していた場合は、そのドキュメントの内容が

Microsoft Dynamics AX 2009 においても正確であることを確認してください。

ヘルプキットには、キットの使用手順が同梱されています。

ヘルプキットのダウンロード

SQL Server Reporting Services レポートのアップグレード

アップグレード後に、次の手順を実行して SQL Server Reporting Services レポートをアップグ

レードします。

分析視点の [用途] プロパティの設定

分析視点の [用途] プロパティを設定するには、次の手順を実行します。

1. Microsoft Dynamics AX クライアントを開きます。

2. ツールバーのアプリケーションオブジェクトツリーのアイコンをクリックします。

3. アプリケーションオブジェクトツリーで、[データディクショナリ]、[分析視点] ノードの順

に展開します。

4. 分析視点を右クリックし、[プロパティ] をクリックします。[分析視点 <分析視点名>] ウィン

ドウが表示されます。

5. [用途] 行を選択します。




6. [用途] ボックスの一覧から、次のいずれかを選択します。

[AdHocReporting] : 選択した分析視点に基づいてレポートモデルを生成する場合は、この

オプションを選択します。レポートモデルの生成の詳細については、『システムとアプ

リケーションのセットアップ』ヘルプファイルの「レポートモデルの生成および公開」

を参照してください。『システムとアプリケーションのセットアップ』ヘルプファイル

にアクセスするには、[Microsoft Dynamics AX]、[ヘルプ]、[システムとアプリケーショ

ンのセットアップ] の順にクリックします。

[OLAP] : 選択した分析視点に基づいて Business Intelligence プロジェクトを生成する場

合は、このオプションを選択します。Business Intelligence プロジェクトの生成の詳細

については、『Developing for Microsoft Dynamics AX』ヘルプの「Working with Business

Intelligence Projects」を参照してください。

[両方] : 選択した分析視点に基づいてレポートモデルと Business Intelligence プロジェ

クトを生成する場合は、このオプションを選択します。

7. 各分析視点に対して手順 4. ～ 6. を繰り返します。

レポートモデルの再生成

『システムとアプリケーションのセットアップ』ヘルプファイルの「レポートモデルの生成およ

び公開」に記載されている手順に従って、レポートモデルを再生成します。

レポートの生成

カスタムレポートを保存した場合は、そのレポートを生成 (実行) します。レポートを生成する

には、レポートマネージャまたはレポートビルダでそのレポートにアクセスします。

レポートの生成時にエラーが発生した場合は、レポートを変更する必要があります。レポートの

変更は、レポートの作成に使用したツールで行います。たとえば、レポートビルダを使用して

レポートを作成した場合は、レポートビルダを使用してレポートを変更します。レポートを変

更して、Microsoft Dynamics AX 2009 データモデルに存在しなくなった列およびフィールドを

削除してください。



アプリケーションのアップグレードの注意事項

次のセクションでは、アップグレードプロセス中に影響を受けるモジュールについて説明します。

すべてのモジュールに影響するアップグレードの注意事項

特定のモジュールに影響するアップグレードの注意事項



すべてのモジュールに影響するアップグレード

の注意事項

次の機能領域の問題は、Microsoft Dynamics AX 2009 全体に関係します。

警告ルール

インストール

Rapid Configuration Tool (RCT)

タスクレコーダ

警告ルール

問題 : アップグレード時に警告ルールが無効になる

影響を受けるバージョン

Microsoft Dynamics AX 4.0

アップグレードの注意事項

Microsoft Dynamics AX 4.0 から Microsoft Dynamics AX 2009 にアップグレードすると、すべて

の警告ルールが無効になります。アップグレードの完了後に警告ルールを再度有効にできますが、

Microsoft Dynamics AX 2009 で変更されたフォームを参照しているために失敗する警告ルールも

あります。アップグレード後に失敗する警告ルールは、削除して作成し直す必要があります。

Microsoft Dynamics AX 4.0 で受信されていた警告はアップグレード後に利用できるようになり

ますが、参照先のフォームが変更されていると、[基点に移動] ボタンをクリックしても正しいフ

ォームとレコードが既定で表示されない場合があります。そのような場合は、フォームとレコー

ドを手動で見つける必要があります。

インストール

問題 : 無害なエラーメッセージ


Microsoft Dynamics AX 3.0 および 4.0


Microsoft Dynamics AX 2009 へのアップグレードプロセスの間に、次のメッセージが表示され

る場合があります。

Object Server 01: Failed to create file old\axapd.aoi. Error code was 3

このメッセージは、データの問題やアップグレードの失敗を表すものではないため、無視してか

まいません。このメッセージが表示されないようにするには、アップグレードプロセスを開始

する前に、Application\Appl\Standard フォルダに "old" というディレクトリを作成します

(例 : C:\Program Files\Microsoft Dynamics AX\5.0\Application\Appl\Standard\Old\)。



問題 : アップグレード時の SQL Server データベースの同期エラー


Microsoft Dynamics AX 4.0 SP2 (SQL Server のみ)


Microsoft Dynamics AX 4.0 SP2 からバージョン 5.0 へのアップグレードプロセスの間に、SQL

Server データベースのインストールとの同期の途中でエラーが発生します。4 つのテーブルにつ

いてエラーが表示され、アップグレードを続行できなくなります。

この 4 つのテーブルを以下に示します。

DimensionCollection

DimensionHierarchyCombination

DimensionSetCombinationDuplicate

DimensionSetCombinationTemp

これらのテーブルは、分析コード階層機能の作業テーブルで、分析コード階層の作成時にのみ使

用されます。階層の設定後はデータは保持されません。

回避策

このエラーを回避するには、アップグレードを開始する前に MSDAX 4.0 SP2 データベースで次

の SQL スクリプトを実行する必要があります。

--DIMENSIONCOLLECTION

UPDATE SQLDICTIONARY SET FIELDID=1 WHERE FIELDID=50002 AND TABLEID=2897;




--DIMENSIONHIERARCHYCOMBINATION






--DIMENSIONSETCOMBINATIONDUP2899






--DIMENSIONSETCOMBINATIONTEMP







--PROVISIONALHIERARCHY






Rapid Configuration Tool (RCT)

問題 : アップグレード後に手動で RCT を削除する必要がある




Microsoft Dynamics AX 2009 へのアップグレード後、Microsoft Dynamics AX 2009 では機能し

ないにもかかわらず、前のバージョンの RCT が引き続きナビゲーションウィンドウとコードベ

ースに表示されます。

現在、RCT 用のアップグレードスクリプトやアンインストールスクリプトは用意されていない

ため、Microsoft Dynamics AX 2009 のインストールから手動で RCT を削除することをお勧めし

ます。たとえば、Sure Step Rapid Configuration Tool 2.0 for Microsoft Dynamics AX 4.0 Service

Pack 1 をインストールした場合は、共有プロジェクトの RctUserLayer と Class_PreImport ([AOT]

で、 [共有]、[プロジェクト] に移動) に、削除する必要がある RCT 要素の一覧が含まれています。

これらのプロジェクトの一覧に含まれている、RCT システムによって拡張された要素のコード

も、手動で評価および削除する必要があります。たとえば、Sure Step Rapid Configuration Tool 2.0

for Microsoft Dynamics AX 4.0 Service Pack 1 から Microsoft Dynamics AX 2009 にアップグレー

ドする場合は、アップグレードの間に次のシステム要素を手動で編集して、RCT コードを削除

する必要があります。これらのシステム要素も RCT によって拡張されています。

要素のタイプ削除する要素

テーブル DocuRef

マップ AddressMap

列挙 DocuStructureType、NumberSeqModule

クラス DocuActionArchive、DocuActionCOM_Word、

NumberSeqReference、SysDataExportExcel、

SysDictConfigurationKey

メニュー MainMenu

これらのカスタマイズされた RCT システム要素は、現在は使用されていません。これらを削除

することで、Microsoft Dynamics AX 2009 のシステムクラスが上書きされないようにすること

ができます。

後日、新しいバージョンの Rapid Configuration Tool を PartnerSource および CustomerSource から

ダウンロードできるようになります。





タスクレコーダ

問題 : アップグレード後に前のバージョンのタスクレコーダをアンインストー

ルする必要がある




Microsoft Dynamics AX 2009 では、以前に Partner Productivity Tools 2.0 for Microsoft Dynamics

AX 4.0 SP1 の一部としてインストールされたバージョンのタスクレコーダからのデータのアッ

プグレードはサポートされていません。前のバージョンがインストールされていると、Microsoft

Dynamics AX 2009 に組み込まれているバージョンのタスクレコーダを [ツール] メニューから使

用できません。

Microsoft Dynamics AX 2009 へのアップグレード後にこの問題を解決するには、次の操作を行

います。

1. Microsoft Dynamics AX 2009 のデータとアプリケーションをバックアップします。

2. Ctrl + D キーを押して AOT を開き、[プロジェクト]、[共有]、[RecSystemOnly] の順にクリ

ックします。

3. 古いタスクレコーダをインストールしたレイヤから次のカスタマイズクラスを完全に削除

します。

フィールド

Info

ClassFactory

タスクレコーダをインストールしたレイヤと同じレイヤでこれらのクラスが他の目的でカス

タマイズされている場合は、それらを AOT で編集して、古いタスクレコーダのコード行を

すべて新しい SYS レイヤのコード行に手動で置き換える必要があります。比較ツールを使

用して、以下の 2 つのコメント行の各ペアの間にある古いコード行をすべて見つけます。

//+TaskRecorder … //-TaskRecorder

4. [共有]、[MiniRecorder] の順にクリックしてプロジェクトを開き、このプロジェクトの項目を

すべて削除します。

メモ :

以前に保存されたタスクの記録は AX 2009 にアップグレードできないため、すべて

削除されます。GlobalToolsMenu にその他のカスタマイズが行われている場合は、

古い tskRecorder エントリを AOT から手動で削除し ([メニュー]、[GlobalToolsMenu]、

[タスクレコーダ] の順に選択)、比較ツールを使用して SYS レイヤの新しいタスク

レコーダエントリ (SysTaskRecorderToolbar) を挿入する必要があります。



5. AOT を開き、3 つのクラス (Box、Info、ClassFactory) がすべて正常にコンパイルされるこ

とを先に進む前に確認します。

注意 :

これらのクラスが正常にコンパイルされるまで Microsoft Dynamics AX クライアン

トを閉じないでください。閉じてしまうと、クライアントを開けなくなる可能性が

あります。

6. Microsoft Dynamics AX クライアントを閉じて、AOS を停止します。アプリケーションが含

まれているフォルダ (C:\Microsoft Dynamics AX\50\Application\Appl\DynamicsAx など) で、

コマンドラインを開いて次のコマンドを実行して、既存の RCT ラベルファイルをすべて削

除します。

del axRCT*.al?

メモ :

これらのファイルを削除すると、タスクレコーダと RCT の両方のラベルが削除されます。

7. AOS を再起動して、Microsoft Dynamics AX クライアントを開きます。[ツール]、[タスクレ

コーダ] の順に選択して、このメニュー項目を使用できること、および正しい "タスクレコ

ーダ" フォーム (SysTaskRecorderToolbar) が開くことを確認します。

参照

特定のモジュールに影響するアップグレードの注意事項



特定のモジュールに影響するアップグレードの

注意事項

このトピックでは、次の機能領域のアップグレードの問題について説明します。

資産の減価償却スケジュール

銀行

キューブ

従業員 ID/ユーザー ID のマッピング

経費精算書

グローバルアドレス帳

雑費

更新日と作成日

支払協定の調整

印刷の管理

製品モデル

品質管理

見積依頼 (RFQ)

返品注文

販売パラメータ

売買契約



資産の減価償却スケジュール (ITA)

問題 : フィールドマッピングの問題によって不正確な減価償却スケジュールが

生成される場合がある

影響を受けるモジュール

GDL、一般会計、固定資産




フィールドマッピングの問題により、Microsoft Dynamics AX 2009 へのアップグレード中に会

社の AssetDepreciationProfile テーブルのデータが失われて、無効な減価償却スケジュールが提

案される場合があります。データが失われる可能性があるのは、次の条件に当てはまる場合だけ

です。

イタリアのコンフィギュレーションキーを有効にしている会社がある

その会社に対して作成されている減価償却プロファイルレコードが次のように設定されている

方法が [手動] に設定されている

間隔が [年 1 回] に設定されている

計算基準が [月] に設定されている

このフィールドマッピングの問題のために、Microsoft Dynamics AX 2009 へのアップグレード

を実行すると AssetDepreciationProfile テーブルの CalculationBase フィールドが削除されます

(減価償却プロファイルでは、基本列挙 CalculationBase の値により、減価償却期間を日次と月次

のどちらで計算するかが決まります)。このフィールドがアップグレード中に削除された場合は、

値 0 ([間隔 (日数)]) を使用して再作成されます。この変更により、以前は [月] に設定されていた

減価償却プロファイルを使用して償却提案を生成した場合に正しくない結果が生成されます。

アップグレードプロセスの完了後にこの問題を解決するには、"減価償却プロファイル" フォー

ム ([一般会計]、[設定]、[固定資産]、[減価償却プロファイル] の順に選択) の計算基準の値を確認

して、[月] に設定し直します。

メモ :

減価償却明細行を転記する前に明細行を確認して、正しくない減価償却期間の提案値を

手動で調整することもできます。



銀行

問題 : 小切手のロゴのソースの更新


小切手のロゴ




Microsoft Dynamics AX 2009 へのアップグレード後に、小切手に会社のロゴが印刷されなくなる

場合があります。

Microsoft Dynamics AX 2009 では、小切手に印刷するロゴは BankChequeLayout テーブルで指

定されますが、以前のバージョンの Microsoft Dynamics AX では、会社のロゴが小切手のロゴと

して使用されていました。

小切手のフォームに会社のロゴを印刷するように銀行口座が設定されている場合は、アップグレ

ード後に次の手順を実行することによってこの問題を解決できます。

1. [銀行]、[共通フォーム]、[銀行口座詳細]、[設定]、[レイアウトの確認] の順にクリックします。

2. [会社のロゴ] ボタンをクリックします。

3. 選択した銀行口座の小切手に印刷するロゴのファイルを選択します。

キューブ

問題 : アップグレードがサポートされていない


レポートとビジネスインテリジェンス




Microsoft Dynamics AX 4.0 に含まれていたサンプルオンライン分析処理 (OLAP) キューブを使用

している場合や、カスタムキューブを作成している場合は、それらのキューブを Microsoft

Dynamics AX 2009 にアップグレードすることはできません。

Microsoft Dynamics AX 2009 には、Microsoft Dynamics AX のデータモデルからキューブを生成

することができる新しいビジネスインテリジェンスフレームワークが含まれています。そのほ

か、Microsoft Dynamics AX 2009 には以下の定義済みキューブも用意されています。

買掛金勘定

売掛金勘定

顧客関係管理

経費管理



総勘定元帳

人事管理

生産

プロジェクト会計

購買

販売

これらのキューブのインストールについては、『Microsoft Dynamics AX Installation Guide

(Microsoft Dynamics AX 2009 インストールガイド)』

(http://go.microsoft.com/fwlink/?LinkID=99623) を参照してください。

従業員 ID/ユーザー ID のマッピング

問題 : 従業員 ID/ユーザー ID のマッピングの復元


経費管理




Microsoft Dynamics AX 3.0 から Microsoft Dynamics AX 2009 にアップグレードする際には、以前

に会社に対して設定した従業員/ユーザーのマッピングが保持されません。

この問題を解決するには、アップグレードの完了後に Active Directory インポートウィザード ([管

理]、[共通フォーム]、[ユーザー]、[インポート] の順に選択) を使用して、すべてのユーザー ID

を手動で従業員 ID にマップする必要があります。

経費精算書

問題 : 経費管理の番号順序の再割り当て


経費管理




Microsoft Dynamics AX 2009 では、経費管理の番号順序が、"経費管理パラメータ" フォームでは

なく "番号順序の参照" フォームで指定されるようになりました。




メモ :

Microsoft Dynamics AX 2009 へのアップグレードの中間ステップとして 3.0 から 4.1 に

アップグレードする場合は、会社で経費精算書を作成する前に、"経費管理パラメータ"

フォームを開いて新しい番号順序を選択する必要があります。

Microsoft Dynamics AX 2009 へのアップグレードの完了後、次の手順に従います。

1. [基本設定]、[設定]、[番号順序]、[参照] の順にクリックして、"番号順序の参照" フォームを

開きます。

2. モジュールが [経費管理] で参照が [経費精算書番号] の行を見つけます。

3. [番号順序コード] 列で、割り当てる番号順序を選択します。

メモ :

Microsoft Dynamics AX 3.0 のインストールで使用していたのと同じ番号順序を選択

することも、違う番号順序を選択することもできます。

4. [ファイル]、[保存] の順にクリックします。

5. この変更を確認するには、[経費管理]、[設定]、[パラメータ] の順にクリックします。

6. [番号順序] タブをクリックし、選択した番号順序が適用されていることを確認します。

グローバルアドレス帳

問題 : [職務の接頭語]、[あいさつ文]、および [接尾語] の各フィールドのデータ

が移行されない


基本、人事管理




Microsoft Dynamics AX 4.0 からのアップグレードの間に、従業員の [職務の接頭語]、[あいさつ

文]、および [接尾語] の各フィールドのデータが Microsoft Dynamics AX 2009 のグローバルアド

レス帳に移行されません。これらのフィールドのデータを復元するには、手動でグローバルア

ドレス帳に追加するか ([基本設定]、[共通フォーム]、[グローバルアドレス帳の詳細]、[一般] の順

に選択)、Microsoft Dynamics AX 入力ユーティリティを使用して従業員レコードを一括更新しま

す。入力ユーティリティの使用については、[Microsoft Dynamics AX]、[ヘルプ]、[アプリケーシ

ョンおよび業務プロセス] の順に選択して、ヘルプトピックの「入力ユーティリティを使用した

複数のレコードの更新」を参照してください。

メモ :

Microsoft Dynamics AX 2009 のグローバルアドレス帳では、これらのフィールドでユー

ザー定義の値がサポートされています。Microsoft Dynamics AX 4.0 ではシステム定義の

値でした。



問題 : 仮想会社を事前に設定する必要がある


CRM、財務




Microsoft Dynamics AX 2009 の新機能であるグローバルアドレス帳 (GAB) の仮想会社を 1 つ以

上作成する新しいステップが、アップグレードプロセスに追加されています。

GAB を使用すると、顧客、仕入先、従業員、連絡先、部門、競合他社、および取引関係に関す

るデータを複数の会社で共有できます。これにより、これらの任意のエンティティのすべての活

動を全体的な視点から把握できます (共通の仕入先を共有している会社や同じ顧客を持つ会社が

わかるなど)。

これらのエンティティのデータを複数の会社で共有するには、1 つの GAB を共有する会社のグ

ループごとに 1 つの仮想会社を設定する必要があります。この設定プロセスは、顧客が取引して

いるすべての企業で 1 つの顧客取引明細書を印刷できるようにする顧客集中取引明細書機能や、

別の会社の請求書の支払を仕入先に対して行ったり別の会社の請求書の支払を受け取ったりでき

るようにする集中支払機能のために必要です。

メモ DirPartyCollection (GAB) に関連付けられているのに仮想会社に含まれていない会社がある

場合、その会社の GAB は会社間で共有されないものと見なされます。

雑費

問題 : "固定または個数" カテゴリの [売上税込価格] の設定


売掛金勘定、買掛金勘定




Microsoft Dynamics AX 2009 より前のバージョンでは、カテゴリが "固定または個数" の雑費の

金額が税抜きの金額と見なされる場合と、注文ヘッダーの [売上税込価格] オプションに従って売

上税込みで計算される場合がありました。これは、インストールされているバージョンおよびサ

ービスパックによって決まります。

一方、Microsoft Dynamics AX 2009 以降では、注文ヘッダーの [設定] タブにある [売上税込価格]

オプションの値により、雑費コードに対して入力された金額が税込みと見なされるかどうかが決

まります。



このアップグレードの問題は、発注書、購買要求、販売注文、または販売見積を使用する実装で、

次の 2 つの条件に当てはまる場合に影響します。

1. 注文ヘッダーの [設定] タブにある [売上税込価格] チェックボックスがオンになっている。

2. カテゴリが "固定または個数" の雑費コードが 1 つ以上使用されている。

Microsoft Dynamics AX 2009 へのアップグレード後にこの問題に対処するには、まず、上の条件

に当てはまるドキュメントのリストを特定します。次に、システムの雑費の金額に正しい税額が

反映されていることを確認します ([売上税込価格] チェックボックスがオンになっている場合)。

雑費の金額が "固定または個数" カテゴリに含まれている場合の Microsoft Dynamics AX 2009

の動作の例を以下に示します。

[売上税込価格] チェックボックスをオンにして発注書を作成します。

品目は、1 @ USD 100.00 です。

USD 10.00 の雑費 (カテゴリは "固定") が含まれます。

品目と雑費の両方に 17% の税率がかけられます。

この USD 100.00 の品目の正味金額には税金が含まれているため、Microsoft Dynamics AX の計

算では、品目の税抜き金額が USD 85.47 (100.00/ 1.17% = 85.47)、品目の税金が $14.53 として

計算されます。

価格に税金が含まれていると発注書のヘッダーで指定されているため、Microsoft Dynamics AX

2009 では、USD 10.00 の雑費の金額も、既に税金が含まれているものとして計算されます。した

がって、雑費の税抜き金額が USD 8.55 (10.00/1.17 = 8.55)、税金が USD 1.45 として計算され

ます。

その結果、品目 (USD 85.47) + 雑費 (USD 8.55) + 税金 (USD 14.53 + USD 1.45) = USD 110.00

になります。

更新日と作成日

問題 : 更新日と作成日の値が上書きされる


経費管理




Microsoft Dynamics AX 3.0 から Microsoft Dynamics AX 2009 にアップグレードする際には、

Microsoft Dynamics AX 3.0 に保存されていた [更新日] と [作成日] の情報が保持されません。代わ

りにアップグレードの日付がこれらのフィールドに設定されます。



支払協定の調整

問題 : フィールドマッピングの問題により、各支払協定による支払調整の順序

が正しくなくなる場合がある


作業現場管理


Microsoft Dynamics AX 4.0 SP2


フィールドマッピングの問題により、Microsoft Dynamics AX 4.0 SP2 から Microsoft Dynamics

AX 2009 へのアップグレード中に会社の JmgPayAdjustSetup テーブルのデータが失われて、各支

払協定による支払調整の順序が正しくなくなる場合があります。

このアップグレードの問題では、データベースと AOT の間で LineNum フィールドの ID の不一

致が生じ、アップグレードプロセスの同期ステップの間にこのフィールドが削除されて再作成

されます。その結果、LineNum フィールドの値が失われ、支払調整の元の順序が失われます。

アップグレードプロセスの完了後にこの問題を解決するには、次の操作を行います。

1. [作業現場管理]、[設定]、[給与]、[支払協定]、[支払調整] の順にクリックします。

2. "支払調整" フォームで、選択した協定に対して定義されている支払調整の順序を確認します。

3. 必要に応じて、[上へ] および [下へ] のボタンを使用して支払を並べ替えます。

アップグレードプロセスの前にこの問題を解決するには、次の操作を行います。

次のスクリプトを実行します。

UPDATE SQLDICTIONARY SET FIELDID=1 WHERE FIELDID=2 AND TABLEID=8594

印刷の管理

問題 : 印刷管理設定の変更


売掛金勘定、買掛金勘定、プロジェクト、CRM




印刷管理機能は、買掛金勘定の発注書、売掛金勘定の販売注文、在庫のピッキングリスト、およ

びプロジェクト請求書の転記時や CRM 販売見積の更新時に生成されるドキュメントの管理を支

援します。



この機能との関連で、Microsoft Dynamics AX 3.0 および 4.0 の実装を Microsoft Dynamics AX

2009 にアップグレードする場合に次のデータポイントが実装に影響を与えます。

1. 顧客とパートナーの両方のカスタマイズで、いくつかの既存のテーブルが削除されて、この

機能をサポートする新しいテーブルに置き換えられます。これらのテーブルは、

SysDeletedObjects41 コンフィギュレーションキーにリンクされます。これらのテーブルを

以下に示します。

PurchPrintCopies

PurchPrintSetup

SalesPrintCopies

SalesPrintSetup

ProjPrintCopies

2. 既に存在しない勘定やトランザクションに関連付けられている Microsoft Dynamics AX 4.0

の印刷管理レコードが削除されます。

3. モジュールタイプが "ユーザー" の Microsoft Dynamics AX 4.0 の印刷管理レコードが削除さ

れます。

4. ドキュメントのステータスが "ProjectPackingSlip" の Microsoft Dynamics AX 4.0 の印刷管理

レコードが削除されます。

5. 印刷管理レコードの言語 ID が既定で会社の既定の言語に設定されます。

6. ドキュメントのステータスが "PickingList" の Microsoft Dynamics AX 4.0 の印刷管理レコー

ドが、Microsoft Dynamics AX 2009 へのアップグレード後は販売ではなく在庫に関連付けら

れます。

販売のアップグレードプロセスの間に、タイプが "Confirmation" の各ドキュメントに基づいて

追加のレコードが作成されます。この追加レコードは確認レコードのコピーですが、ドキュメン

トタイプは "SalesOrderConfirmation" です。元の確認レコードは正常にアップグレードされます。

問題 : 印刷管理設定のオプションの変更


売掛金勘定、買掛金勘定、プロジェクト、CRM




印刷管理機能は、買掛金勘定の発注書、売掛金勘定の販売注文、在庫のピッキングリスト、およ

びプロジェクト請求書の転記時や CRM 販売見積の更新時に生成されるドキュメントの管理を支

援します。複数の言語でフッターテキストを生成する機能と、印刷管理機能をクエリに基づい

て選択する機能は、Microsoft Dynamics AX 2009 の新機能です。



印刷管理で管理されているドキュメントは、転記フォームまたは更新フォームから印刷されます。

どちらから印刷されるかはドキュメントによって決まります。これらのフォームには、Microsoft

Dynamics AX の標準の "プリンタの設定" フォームを開く [プリンタの設定] ボタンが含まれてい

ます。転記フォームまたは更新フォームで [印刷管理先の使用] チェックボックスがオンになっ

ている場合は、"プリンタの設定" フォームで指定したドキュメントの出力先が印刷管理の既定値

になります。転記フォームまたは更新フォームで [印刷管理先の使用] チェックボックスがオン

になっていない場合は、"プリンタの設定" フォームで指定したドキュメントの出力先がすべての

ドキュメントの出力先になります。

以前のバージョンの Microsoft Dynamics AX では、印刷管理に対して指定されている部数に "プリ

ンタの設定" フォームの部数を掛けた値が使用されていました。Microsoft Dynamics AX 2009 で

は、"プリンタの設定" フォームに表示される部数は印刷管理では使用されません。代わりに、"

印刷管理設定" フォームに指定されている部数が使用されます。

製品モデル

問題 : VAT のみの請求書の不一致の解決


一般会計




付加価値税の請求金額のみを含む請求書 (VAT のみの請求書) で、"売上税コード" フォーム ([一

般会計]、[設定]、[売上税]、[売上税コード] の順に選択) の [一般] タブで指定されている通貨と請

求書の通貨が違っていると、転記済売上税の金額が正しく計算されません。

Microsoft Dynamics AX 4.0 SP1 および SP2 に対しては、この問題を解決するための DIS レイヤ

のホットフィックスが先ごろ実装されています。Microsoft Dynamics AX 2009 にアップグレー

ドする前にこれらのホットフィックスを適用することを強くお勧めします。

また、Microsoft Dynamics AX のカスタマサポートでは、この問題の影響を受けるトランザクシ

ョンがデータベースにあるかどうかを確認できるレポートを提供しています。Microsoft

Dynamics AX のサポート窓口に問い合わせて、このレポートを実行するためのコードを入手し

てください。

このレポートによって特定された問題を修正するには、仕訳帳エントリを作成して ([一般会計]、

[仕訳帳]、[一般仕訳帳] の順に選択)、修正エントリを登録します。レポートの伝票番号を使用し

て、以前の転記に使用された勘定を特定し、それらの勘定に正しい金額を転記します。それらの

エントリを税コードの通貨で作成して、元々転記されるはずだった合計額の差額を補う必要があ

ります。この税額修正の転記日付は現在の期間である必要があります。

これらの修正は、Microsoft Dynamics AX 2009 へのアップグレードの前に行うのが理想的ですが、

事前に問題を特定できなかった場合はアップグレード後に行うこともできます。



品質管理

問題 : 品質管理ソリューションには別のアップグレードスクリプトが必要


品質管理ソリューション

メモ :

このモジュールは、Microsoft Dynamics AX 4.0 では "総合品質管理" と呼ばれていました。




Microsoft Dynamics AX 4.0 で総合品質管理モジュールを実行している場合は、別のアップグレ

ードスクリプトを実行して、Microsoft Dynamics AX 4.0 のデータを Microsoft Dynamics AX

2009 の品質管理ソリューションに移行する必要があります。

重要 :

その前に、Microsoft Dynamics AX 2009 で変更されたフィールドの文字列サイズを調整

する必要がある場合もあります (これらの変更は、いくつかのテーブルのキーの長さの

ベストプラクティスに準拠するために行われました)。

手順については、PartnerSource で QMS Upgrade スクリプトと共にダウンロードできる QMS

Upgrade のドキュメントを参照してください。

見積依頼 (RFQ)

問題 : 購買見積を手動で調整する必要がある


売掛金勘定




Microsoft Dynamics AX 3.0 または 4.0 で作成した "見積書" タイプの発注書に行が含まれていな

い場合、それらは Microsoft Dynamics AX 2009 へのアップグレード時に見積依頼 (RFQ) に変換

されません。アップグレード後に Microsoft Dynamics AX 2009 で新しい RFQ を手動で作成する

必要があります。

また、購買見積に入力した税金調整は RFQ に変換されません。Microsoft Dynamics AX 2009 へ

のアップグレード後に税金調整を RFQ に入力することもできません。RFQ では税金調整はサポ

ートされていません。



返品注文

問題 : 返品注文の請求はアップグレード前に行う必要がある


売掛金勘定




タイプが "返品品目" の販売注文は、Microsoft Dynamics AX 2009 へのアップグレードプロセス

を開始する前に請求書の更新を行う必要があります。そうしないと、在庫トランザクションが販

売注文明細行と同期されなくなる可能性があります。

販売パラメータ

問題 : 販売パラメータテーブルでアップグレードが失敗する場合がある


売掛金勘定




Microsoft Dynamics AX 4.0 から Microsoft Dynamics AX 2009 へのアップグレードの同期後のプ

ロセスの間に、販売パラメータテーブル (SalesParameters) のレコードを編集できないために

ReleaseDB41_Cust::createOrderEntryDeadline が断続的に失敗する場合があります。この問題

を解決するには、Microsoft Dynamics AX 2009 アップグレードスクリプトを再度実行します。

問題 : アップグレードの前にマトリックスレポートを転記する必要がある


経費管理




Microsoft Dynamics AX 3.0 の実装に、保存されているがまだ転記されていない "マトリックス"

タイプの経費精算書がある場合は、Microsoft Dynamics AX 2009 にアップグレードする前に転記

する必要があります。マトリックストランザクションは Microsoft Dynamics AX 2009 ではサポ

ートされていません。



Microsoft Dynamics AX 2009 へのアップグレードを実行する前に、タイプが "マトリックス" の

ものだけでなく、すべての経費精算書を転記することをお勧めします。

メモ Microsoft Dynamics AX 2009 では、マトリックストランザクションの代わりに分解経費

機能を使用できます。

売買契約

問題 : [有効] 列と [価格グループ] 列の表示が拡張されている


プロジェクト




Microsoft Dynamics AX 4.0 から Microsoft Dynamics AX 2009 にアップグレードすると、[有効]

列と [価格グループ] 列が、以前のバージョンで表示されていたフォームだけでなく次のフォーム

にも表示されます。

販売価格 - 時間

販売価格 - 経費

販売価格 - 手数料

販売価格 - 定期売買

この変更の影響を受けるテーブルを以下に示します。

projHourSalesPrice

projCostSalesPrice

projRevenueSalesPrice

smaSalesPriceSubscription

これらのテーブルでは、プロジェクト ID が含まれている既存の販売価格レコードの [有効] 列は

"テーブル" に設定され、他のすべてのレコードの [有効] 列は "すべて" に設定されます。



特定のロケールに影響するアップグレードの注

意事項

このトピックでは、次のロケールでのアップグレードに関する問題の解決方法について説明します。

ブラジル

フィンランド

ブラジル

問題点 : 新しい割引フィールドの更新に販売明細行と購買注文明細行がない






一連の新しいフィールドとアップグレードスクリプトは、ヘッダー割引情報が請求書明細行に

継続して適用されるように作成されています。ただし、アップグレードスクリプトは、

InventTable データに基づいて割引を適用する必要があるかどうかを定義する一方で、PurchLine

および SalesLine のテーブル情報を参照して対応する金額を再計算します。割引ヘッダーが適用

される品目の設定が変更された場合、または購買注文明細行や販売明細行が存在しなくなった場

合は、対応するフィールドを手動で更新する必要があります。

この問題は、注文のヘッダー割引が使用されていない実装には影響しません。

新しいフィールドおよびアップグレードスクリプトは、ヘッダー割引に関する次の情報を継続

して請求明細行に適用するように作成されています。

\Data Dictionary\Tables\CustInvoiceTrans\Fields\LineEndDiscAmount_BR

\Data Dictionary\Tables\VendInvoiceTrans\Fields\LineEndDiscAmount_BR

\Data Dictionary\Tables\VendInvoiceTrans\Fields\SumLineDiscAmount_BR

新しい割引フィールドを反映するために、次のフィールドが更新されます。

\Data Dictionary\Tables\CustInvoiceJour\Fields\InvoiceGoodsAmount

\Data Dictionary\Tables\CustInvoiceJour\Fields\InvoiceServicesAmount

\Data Dictionary\Tables\VendInvoiceJour\Fields\InvoiceGoodsAmount

\Data Dictionary\Tables\VendInvoiceJour\Fields\InvoiceServicesAmount

メモ :

ブラジルの個々のレイヤは、このドキュメントの発行時にリリースされていない可能性

のある Microsoft Dynamics AX 2009 統合 GLS レイヤに含まれます。



問題点 : 配送業者の情報の更新に販売テーブルと購買テーブルがない






アップグレードは、CustInvoiceJour テーブルと VendInvoiceJour テーブルの配送業者情報に基

づきます。関連する販売注文または発注書が削除された場合、DlvStateRegistered フィールドと

DlvPackingName フィールドは更新されません。

問題点 : 補助請求書と返品請求書の売上請求書参照の更新に販売テーブルと販

売明細行がない


売掛金勘定




アップグレードでは、SalesTable テーブルと SalesLines テーブルの情報を使用して、補助請求

書 (前の請求書の税金や価格の修正を作成する) および返品請求書でそれぞれ売上請求書参照と

売上請求書明細行参照を更新します。これらの参照に関連する販売注文が削除された場合、これ

らのフィールドは請求書データで更新されません。

問題点 : サービスコードの更新に販売明細行がない


売掛金勘定




アップグレードでは、SalesLine テーブルに格納されている配送業者情報を使用して、売上請求

書のサービスコード情報を更新します。特定の売上請求書に関連する販売明細行が販売明細行

テーブルから削除された場合、売上請求書ではサービスコードが更新されません。



問題点 : 分析コードを追加し、[名前] フィールドの拡張データ型 (EDT) のサイ

ズを 60 から 80 に変更する






Microsoft Dynamics AX 2009 へのアップグレードを実行する前に、4 つ目の分析コード

"支店" を作成し、[名前] フィールドの EDT を 80 に変更するために、AOT で利用できる

"SYSDimensionAddWizard_BR" フォームを開いて実行する必要があります。

フィンランド

問題点 : 日次仕訳帳で支払参照番号を保持する


売掛金勘定




フィンランド企業では、日次仕訳帳を使用してアップグレード中に未処理の売掛金勘定のエント

リをインポートする場合、アップグレードプロセスを開始する前に、修正プログラムを実行す

る必要があるという問題が確認されています。

この修正プログラムについては、Microsoft Dynamics AX のサポート技術情報の記事 949906

で説明されています。この記事は、CustomerSource および PartnerSource から入手できます。

この問題は、請求書トランザクションの一部として請求書番号に加えて支払参照番号を使用する

というフィンランドの慣行に関連します。電子支払を行う顧客は、この番号を参照して、支払が

該当の請求に適用されているかどうかを確認できます。

アップグレードの前に修正プログラムが適用されない場合、アップグレードプロセス中に [支払

の参照] フィールドの値が 2 回計算され、2 回目の結果で [支払の参照] の元の値が上書きれるの

で、顧客の支払を対応する元の請求書と照合できなくなります。



アップグレードのトラブルシューティング

このセクションでは、Microsoft Dynamics AX システムをアップグレードするときに発生する可

能性のある問題のトラブルシューティングについて説明します。このセクションには次のトピッ

クが含まれます。

Microsoft Dynamics AX DB アップグレード準備ツールのトラブルシューティング

アップグレード中の AOS または Microsoft Dynamics AX クライアントの起動に関するトラ

ブルシューティング

Microsoft Dynamics AX のコンパイルに関するトラブルシューティング

データアップグレードコックピットのトラブルシューティング

アップグレード中のエラーメッセージ




備ツールのトラブルシューティング

このセクションでは、アップグレード中に Microsoft Dynamics AX DB アップグレード準備ツー

ルを使用しているときに発生する可能性のある問題について説明します。

FRx と Microsoft Dynamics AX DB アップグレード準備ツールの

併用

Microsoft Dynamics AX DB アップグレード準備ツールの実行時に FRx を使用すると、frl_entity

テーブルでエラーが発生してテーブルを新しい Microsoft Dynamics AX データベースにコピーす

るプロセスが停止します。このプロセスは、frl_entity に ID 列があることが原因で失敗します。

この失敗を防ぐには、次のどちらかの解決策を実行する必要があります。

解決策 1 :

Microsoft Dynamics AX DB アップグレード準備ツールを実行する前に、frl_entity テーブルを削

除します。Microsoft Dynamics AX 2009 へのアップグレードが完了したら、データ変換サービス

(DTS) を使用して、frl_entity テーブルのバックアップを Axapta 3.0 データベースから新しい

Microsoft Dynamics AX データベースに復元します。

メモ :

DTS を使用する同じプロセスを、AOT に存在しない Dynamics AX データベース内のテ

ーブルに使用できます。DBPrep_nonAOTtable_SQL.sql スクリプトまたは

DBPrep_nonAOTtable_Ora.sql スクリプトを使用して、このような影響を受けるテーブ

ルを特定します。

1. Microsoft Dynamics AX DB アップグレード準備ツールを起動する前に、Axapta 3.0 データベ

ースのバックアップを作成します。

2. Axapta 3.0 データベースの frl_entity テーブルを削除します。

3. Microsoft Dynamics AX DB アップグレード準備ツールを実行し、Microsoft Dynamics AX

2009 へのアップグレードを完了します。

4. SQL Server 2000 Enterprise Manager または SQL Server 2005 Management Studio で、手

順 1. の Axapta 3.0 のバックアップを復元します。frl_entity テーブルを Microsoft Dynamics

AX 3.0 データベースから Microsoft Dynamics AX 2009 データベースにエクスポートします。

解決策 2 :

Microsoft Dynamics AX DB アップグレード準備ツールを実行する前に、Axapta 3.0 データベー

スの frl_entity テーブルを削除します。Microsoft Dynamics AX 2009 への更新が完了した後に、

frl_entity テーブルを再作成します。



Microsoft Dynamics AX DB アップグレード準備ツールと Oracle

Oracle を使用する場合は、Microsoft Dynamics AX DB アップグレード準備ツールを実行する前に、

Oracle 32 ビットクライアント (管理者 SKU) ライブラリが存在することを確認してください。

ウイルス検索プログラムによる Microsoft Dynamics AX DB アップ

グレード準備ツールの停止

Microsoft Dynamics AX DB アップグレード準備ツールでは、ウイルス検索プログラムを誤って

トリガする可能性がある一時ファイルが作成されるので、DB アップグレード準備ツールの実行

に失敗する場合があります。

この問題が発生した場合は、ウイルス検索プログラムを無効にしてから Microsoft Dynamics AX DB

アップグレード準備ツールを再起動します。Microsoft Dynamics AX DB アップグレード準備ツ

ールを使用し終えたら、ウイルス検索プログラムを再起動してください。

Microsoft Dynamics AX DB アップグレード準備ツールの実行の

失敗

問題点 : Microsoft Dynamics AX DB アップグレード準備ツールの実行に失敗し、ターゲットデ

ータベースでオブジェクトを作成しているときに構文エラーが表示される。

考えられる原因 1 : AOT ベースではないテーブルがソースデータベーススキーマにあります。

解決策 : 「Microsoft Dynamics AX DB アップグレード準備ツール」の「AOT ベースではないテ

ーブル」の手順に従ってください。

考えられる原因 2 : Microsoft Dynamics AX 3.0 データベースで、データベースの予約されたキー

ワードをオブジェクト名、インデックス名、および制約名として使用しています。

解決策 : Microsoft Dynamics AX 3.0 データベース内でデータベースの予約語を使用しているオブ

ジェクト名、インデックス名、および制約名を他の名前に変更し、Microsoft Dynamics AX DB

アップグレード準備ツールを実行してデータをコピーしてから、オブジェクト名、インデックス

名、および制約名を元の名前に戻します。たとえば、いずれかのテーブル列が INTERNAL とい

う名前の場合は、その名前を XINTERNAL に変更し、Microsoft Dynamics AX DB アップグレー

ド準備ツールを実行した後にテーブル列の名前を INTERNAL に戻します。



最初のテーブル AccessRightsList に対する Microsoft Dynamics

AX DB アップグレード準備ツールの実行の失敗

問題点 : 一括コピープロセス (BCP) の開始後に、最初のテーブル AccessRightsList でスクリプ

トが失敗する。

考えられる原因 :Microsoft Dynamics AX DB アップグレード準備ツールに BCP 一時フォルダへ

のアクセス権がありません。

解決策 : SQL Server の BCP 一時フォルダの場所は、新しい Microsoft Dynamics AX 2009 デー

タベースが配置されるアップグレード先 SQL Server のローカルである必要があります。

Microsoft Dynamics AX DB アップグレード準備ツールの起動の

失敗

問題点 : 起動時に発生した未処理の例外により、Microsoft Dynamics AX DB アップグレード準備

ツールが開かない。

考えられる原因 : Microsoft Dynamics AX 2009 のインストール時に必要なソフトウェアをインス

トールしていない可能性があります。

解決策 : インストールメディアから必要なソフトウェアをインストールします。



アップグレード中の AOS または Microsoft

Dynamics AX クライアントの起動に関するト

ラブルシューティング

このセクションでは、アップグレードプロセスで Application Object Server (AOS) または

Microsoft Dynamics AX 2009 クライアントを初めて起動する際に発生する可能性のある問題点に

ついて説明します。

AOS またはアップグレードのチェックリストが起動しない

問題点 : アップグレードプロセス中に、AOS またはアップグレードのチェックリストが起動し

ません。

考えられる原因 1 : 複数の照合順序を使用してデータを保存しています。

解決策 : データベースで複数の照合順序を使用することはできません。

1. 1 つの照合順序を使用するようにデータベースを変換します。詳細については、SQL Server

または Oracle のマニュアルを参照してください。Microsoft Dynamics AX 2009 にアップグ

レードするときには、これらのステップを実行して問題を解決します。

2. システムが正しく稼動していること、およびデータに問題がないことを確認します。

3. Microsoft Dynamics AX 2009 へのアップグレードを開始します。

考えられる原因 2 : 次のいずれかを変更しています。

AOS の起動中に使用されるシステムテーブル (SysSetupCompanyLog や SysUserInfo など)

グローバルクラスで使用される要素 (情報ノードやアプリケーションノードなど)

AOS の起動中に同期されるフィールドにユーザー統計情報を作成するなどのテーブルオブ

ジェクトの削除や作成を防ぐデータベース要素

解決策 : アップグレードを開始する前に、これらの変更を Microsoft Dynamics AX 4.0 から削除

し、Microsoft Dynamics AX 2009 に移行します。Windows イベントビューア ([管理ツール]、[イベ

ントビューア] の順に選択) を表示して、SQL ステートメントに関連するエラーがないかを確認

します。SQL ステートメントに関連するエラーをデバッグして問題を解決します。たとえば、

テーブルフィールドにユーザー統計情報が定義されている場合は、エラーのあるテーブルのユ

ーザー統計情報を削除します。

メモ :

システムクラスまたはシステムオブジェクトのカスタマイズはお勧めできません。

考えられる原因 3 : Microsoft Dynamics AX 2009 のインストール中に正しい Microsoft Dynamics

AX データベースを指定しなかったので、AOS が正しくアップグレードされませんでした。この

結果、"このデータベースのストアドプロシージャのバージョンが Application Object Server

(AOS) に必要なバージョンではありません。更新されたストアドプロシージャバージョンを指

定する AOS の新しいインスタンスを設定する必要があります" という内容のメッセージが表示

されます。



解決策 : 2 つの解決策があります。

Microsoft Dynamics AX 2009 を再インストールし、インストール中にアップグレードする必

要がある正しい Microsoft Dynamics AX データベースを指定します。

Microsoft SQL Server Management Studio を開き、稼動している Microsoft Dynamics AX

2009 インスタンスから Microsoft Dynamics AX データベースに、sysserversessions ストア

ドプロシージャと sysclientsessions ストアドプロシージャをコピーします。次に、以下の

クエリを使用して、SQLSYSTEMVARIABLES テーブルの SYSSPVERSION パラメータ (列)

の値を確認します。

select * from SQLSYSTEMVARIABLES where parm='SYSSPVERSION';

値が "8" 以外の場合は、次のクエリを実行します。

Update SQLSYSTEMVARIABLES set value=8 where parm='SYSSPVERSION';

明示的なコミットを必要とするデータベースの場合は、次を実行します。

Commit;

アップグレードプロセス中、Microsoft Dynamics AX クライアント

が起動時にクラッシュする

問題点 : 「アップグレードの準備」のすべてのステップを完了した後に、Microsoft Dynamics AX

2009 クライアントがクラッシュします。

考えられる原因 1 : 起動に影響を与えるクラスの変更を行っています。

解決策 : 起動時に実行される低レベルのコード、またはアプリケーションノードや情報ノードな

どのクラスノードから開始されるコードを変更していないかを確認します。

Microsoft Dynamics AX を正しく起動するためのクラスを変更していた場合は、その変更を削除

します。

考えられる原因 2 : 新しいデータベース構造と競合する名前の変更を行っています。

解決策 : フィールド名を変更したことで、mcCoName によって追加されたフィールド名との競

合が発生した可能性があります。フィールド名には一意の ID が必要です。イベントビューア

([管理ツール]、[イベントビューア] の順に選択) を開き、フィールドの重複を示すイベントログ

を確認してください。



Microsoft Dynamics AX のコンパイルに関する

トラブルシューティング

このセクションでは、アップグレードプロセス中に Microsoft Dynamics AX 2009 をコンパイル

したときに発生する可能性のある問題について説明します。

コンパイル時の権限不足エラー

アップグレード中に Microsoft Dynamics AX をコンパイルするとき、権限不足エラーが発生した

場合は、VAR レイヤまたは BUS レイヤ (およびそのパッチレイヤ) 内でライセンスの読み込み

が必要なクラスを変更したかどうかを確認します。開始時期が早くライセンスを必要とするクラ

スを変更した場合は、更新したアプリケーションファイルを Standard フォルダにコピーする前

に、Application Object Server (AOS) を起動して適切なライセンスを読み込みます。つまり、ア

ップグレードの順序は次のとおりです。

1. Microsoft Dynamics AX (アプリケーションファイル、クライアント、AOS、および空の新規

データベースを含む) をインストールします。

2. インストールメディアから Microsoft Dynamics AX DB アップグレード準備ツールを実行し

ます。

3. AOS を起動します。

4. Microsoft Dynamics AX クライアントを起動します。

5. [管理]、[設定]、[システム]、[ライセンス情報] の順にクリックして、ライセンスキーを読み

込みます。次に [ライセンスファイルの読み込み] ボタンをクリックします。

6. Microsoft Dynamics AX クライアントを閉じます。

7. [スタート]、[管理ツール]、[サービス] の順にクリックし、AOS ([サービス] 一覧の

Dynamics AX Object Server) を停止します。

8. HFX レイヤの上のすべてのレイヤから、アプリケーションファイル (*.aod) を次の場所にコ

ピーします。

\Microsoft Dynamics\5.0\Application\Appl\Standard

9. HFX レイヤの上のすべてのレイヤから、アプリケーションファイル (*.aod) を次の場所にコ

ピーします。

\Microsoft Dynamics\5.0\Application\Appl\Standard\Old

10. Standard フォルダからインデックスファイル (axapd.aoi) を削除します。

11. [サービス] 一覧から AOS を起動します。

12. Microsoft Dynamics AX クライアントを起動します。

13. アップグレードのチェックリストを順に実行します。



データアップグレードコックピットの


このセクションでは、データアップグレードコックピットを使用するときに発生する可能性の

ある問題について説明します。

アップグレードジョブの開始の失敗

問題点 : データアップグレードコックピットの [実行] ボタンまたは [試行] ボタンをクリックし

てもアップグレードジョブが開始されず、すべてのアップグレードスクリプトの状態が長時間

にわたって "準備完了" のままになる。

メモ :

データアップグレードコックピットの [更新] ボタンをクリックすると、アップグレー

ドステータス情報を手動で更新できます。アップグレードステータス情報の自動更新を

有効にするには、[自動更新有効] チェックボックスをオンにします。

考えられる原因 1 : 以前にデータベースがアップグレードされており (Microsoft Axapta 2.5 から

Microsoft Dynamics AX 3.0 など)、DataUpdate というバッチグループがまだ存在していますが、

このバッチグループに関連付けられたジョブが存在しません。

解決策 : 次の手順に従います。

1. "バッチグループ" フォームを開きます ([管理]、[設定]、[バッチグループ] の順に選択)。

2. [DataUpdate] グループを選択します。

3. [バッチサーバー] タブをクリックします。

4. 現在の AOS が [選択したサーバー] ボックスの一覧に示されていることを確認します。一覧

にない場合は、[残りのサーバー] ボックスの一覧から移動してアップグレードを再開します。

考えられる原因 2 : アップグレードジョブを実行するように定義されているバッチサーバーが

実行されていません。

解決策 : "サーバーコンフィギュレーション" フォームを開きます ([管理]、[設定]、[サーバーコ

ンフィギュレーション] の順に選択)。アップグレードを実行する AOS インスタンスに対して [バ

ッチサーバー] がオンになっていることを確認します。

考えられる原因 3 : DataUpgrade バッチグループが、アップグレードを実行する AOS インスタ

ンスに対して選択されたグループではありません。

解決策 : "サーバーコンフィギュレーション" フォームを開きます ([管理]、[設定]、[サーバーコ

ンフィギュレーション] の順に選択)。[バッチサーバーグループ] タブの [選択したグループ] ボ

ックスの一覧に [DataUpdate] バッチグループが示されていることを確認します。



同期手順でのデータ損失

アップグレードのチェックリストの同期手順でデータが失われた場合は、次の項目を確認して

ください。

1. [同期の警告] ページを参照してエラーがないことを確認します。

2. 同期時には、AOT がデータベースと同期されます。正常にアップグレードされなかったカス

タマイズがある場合、その変更は AOT の一部ではない可能性があり、同期プロセス時に削

除されます。

3. 同期時に、Microsoft Dynamics AX 2009 でフィールド ID またはテーブル ID が Microsoft

Dynamics AX 3.0 または Microsoft Dynamics AX 4.0 の ID から変更された場合は、そのフィ

ールドまたはテーブルのデータが失われます。これを回避するには、アップグレードスクリ

プトを作成して TableID を同期プロセスの一部として変更します。詳細については、ホワイ

トペーパー『How to Write Data Upgrade Scripts for Microsoft Dynamics AX 2009

(Microsoft Dynamics AX 2009 用にデータアップグレードスクリプトを記述する方法)』を

参照してください。また、関連する問題については、テーブルが削除される可能性に関する

セクションを参照してください。

4. 列に対するユーザー統計情報の定義など、データベーススキーマの変更を行うと、オブジェ

クトが AOT と同期されずエラーが発生する可能性があります。エラーを発生させるオブジ

ェクトを確認し、SQL Server Management Studio または Oracle における同等の SQLplus

などを使用して SQL ステートメント (Microsoft Dynamics AX 情報ログまたは Windows イベ

ントビューアから取得) をデータベースに対して直接実行することによって調査します。

5. DEL_<テーブル> を示すエラーが発生します。このエラーは、前回のアップグレード後にこ

のテーブルが削除されなかったことを示す場合があります。Microsoft Dynamics AX 3.0 デー

タベースをバックアップし、更新オブジェクト 3.0 の保存コンフィギュレーションキーを無

効にします。このチェックボックスをオフにすると、ソースデータベースの古い DEL_ オ

ブジェクトが削除されます。アップグレードプロセスを続行する前に、システムが正常に実

行されていることを確認します。

6. "<テーブル名> でデータ定義言語コマンドを実行できません" というメッセージが表示され

ます。ここで、<テーブル名> は問題が発生している実際のテーブルのプレースホルダを表

し、AOS アプリケーションイベントログでは、オブジェクト名が既に存在するので SQL

でオブジェクト名を変更できなかったことを示すメッセージが表示されます。

MSDAX5, を起動して AOT を開き、問題が発生しているテーブルを特定します。同じ名前の

テーブルが 2 つある場合は、一方が SYS レイヤのみに存在し、もう一方が SYS レイヤと別

のレイヤに存在するかどうかを確認します。その場合は、2 つの異なるレイヤに存在するテ

ーブルを右クリックし、[比較] をクリックします。比較ツールを使用して、テーブルの名前

が変更されているかどうかを確認します。問題のテーブルの名前が新しいバージョンで

DEL_[テーブル名] に変更されている場合があります。変更を記録してから現在のレイヤオ

ブジェクトを削除すると、DEL_[テーブル名] が AOT に表示されるようになり、テーブルで

同期エラーが発生しなくなります。




7. 名前は重複しているが ID 値が異なるフィールドが存在することを示すメッセージが表示さ

れます。この問題を解決する方法の 1 つとして、事前同期プロセスで問題を解決するための

アップグレードスクリプトを記述する方法が挙げられます。ホワイトペーパー『How to

Write Data Upgrade Scripts for Microsoft Dynamics AX 2009 (Microsoft Dynamics AX 2009

用にデータアップグレードスクリプトを記述する方法)』を参照してください。

この問題は、テーブルを 1 つのレイヤからオブジェクト ID と共に別のレイヤにエクスポー

トしたことが原因で発生する可能性もあります。オブジェクトをエクスポートする際は、オブ

ジェクト ID をエクスポートしないように注意してください。

事後同期の手順でのデータ損失またはアップグレードタスクの失敗

アップグレードのチェックリストの事後同期手順でデータが失われた場合は、次の項目を確認し

てください。

1. アップグレードスクリプトは、適切なコンフィギュレーションキーが有効な場合にのみ実

行できます。データがアップグレードされていないテーブルまたはフィールドを見つけて、

それらのテーブルまたはフィールドに関連付けられているコンフィギュレーションキーが有

効になっていることを確認してください。

2. アップグレードスクリプトが失敗する場合は、失敗の原因となっている SQL ステートメン

トを確認してください。SQL ステートメントは、Microsoft Dynamics AX 情報ログまたは

Windows イベントビューアで参照できます。

アップグレードスクリプトのパフォーマンスの問題の検出

数時間かかるような大規模データベースのアップグレードを行う場合は、[自動更新時間 (秒)] フ

ィールドで自動更新時間を 1800 秒に増やすか、チェックボックスをオフにして自動更新を無効

にすることでパフォーマンスを改善することができます。

アップグレードバッチサーバーに対して定義されたバッチスレッドの数を増やすこともできま

す。"サーバーコンフィギュレーション" フォームを開きます ([管理]、[設定]、[サーバーコンフ

ィギュレーション] の順に選択)。[バッチサーバースケジュール] タブで、[最大バッチスレッド]

列に必要な数を入力します。スレッドの数を変更した場合は、必ずアップグレードのパフォーマ

ンスをテストするようにしてください。

Oracle を使用している場合は、すべての必要な修正プログラムがインストールされた、最新の

サポート対象の Oracle クライアントを使用していることを確認してください。

データのアップグレード時にパフォーマンスを向上させる方法の詳細については、「データア

ップグレードのパフォーマンスの向上」のトピックを参照してください。

アップグレードジョブのパフォーマンスの問題を検出するには、次の操作を実行します。

1. データアップグレードコックピットの [開始時刻]、[期間]、および [アップグレードジョブ

ID] の各列を並べ替えて、通常より長時間実行されているタスクを確認します。

2. ステータスが "待機中" のすべてのアップグレードタスクが開始されないように [キャンセル]

をクリックします。バッチサーバーに既に送信されたタスクは引き続き実行されます。プロ

セスを突然停止したために、無効なデータがデータベースに残っていることがあります。こ

のため、データアップグレードを再度実行する前にバックアップから復元する必要があります。






アップグレード中の同期の失敗

問題点 : SQL Server を使用していて、アプリケーションビルドが 4.0.2500.61 以上の Microsoft

Dynamics AX 4.0 SP1、または Microsoft Dynamics AX 4.0 SP2 からアップグレードする場合に、

同期中にエラーが発生することがある。この場合、次の 4 つのテーブルが失敗し、アップグレー

ドが続行できなくなる。

DimensionCollection

DimensionHierarchyCombination

DimensionSetCombinationDuplicate

DimensionSetCombinationTemp

考えられる原因 : 上記の 4 つのテーブルのフィールド ID が Microsoft Dynamics AX 4.0 SP2 と

Microsoft Dynamics AX 2009 で異なっています。ただし、両方のリリースでテーブル ID は同じ

であるため、フィールド ID を修正するアップグレードコードプロセスをアップグレードスク

リプトが開始しようとすると失敗します。フィールド ID がデータベースと AOT で異なるため、

同期手順でフィールドが削除されて再作成されます。このフィールドを参照して削除されないよ

うにする SQL インデックスがあるため、同期手順は失敗します。

解決策 : アップグレードを実行する前に、Microsoft Dynamics AX 4.0 SP2 データベース上で次

の SQL スクリプトを実行する必要があります。

--DIMENSIONCOLLECTION





--DIMENSIONHIERARCHYCOMBINATION






--DIMENSIONSETCOMBINATIONDUP2899






--DIMENSIONSETCOMBINATIONTEMP







--PROVISIONALHIERARCHY




テーブルが削除される可能性

同期時に、Microsoft Dynamics AX 2009 がデータテーブルを削除して再作成することを示すエ

ラーが表示されることがあります。この場合、テーブルのすべてのデータが失われます。

この問題は、アップグレードではなく既存のカスタマイズを再実装する場合に発生することがあ

ります。これは通常、テーブル ID が変更されたときに発生し、SQLDictionary テーブルがテー

ブルの AOT 表現と一致しなくなります。同期プロセス時にテーブルを削除して再作成すること

により、SQLDictionary テーブルが更新されます。

この問題を解決する 2 つのオプションを次に示します。

方法 1

この問題を解決するには、ReleaseUpdateDB クラスの静的メソッドを使用することをお勧めし

ます。このメソッドは事前同期プロセス時に実行され、テーブルのデータを保持します。この例

では、ReleaseUpdateDB41_Administration クラスを使用します。使用するクラスは、テーブル

が関連付けられているモジュールによって決まります。

1. AOT を開きます。

2. [クラス] ノードを展開します。

3. ReleaseUpdateDB41_Administration クラスを探します。

4. このクラスをダブルクリックして、エディタでこのクラスを開きます。

5. [新規作成] をクリックして新しいメソッドを作成します。



6. 次のコードを入力します。

void RepairCustomTable()

{

TableID oldID;

TableID newID;

;

oldID = 50008;

newID = 50001;

ReleaseUpdateDB::changeTableByName("COREEXCHANGETABLE",oldID,newID);

}

7. コードを保存します。

8. initPreSyncJobs メソッドを変更して、手順 5. ～ 7. で作成したメソッドを呼び出すようにし

ます。エディタの一番左側のウィンドウで initPreSyncJobs メソッドを強調表示します。コ

ードが表示されます。

9. コード内で "this.addStandardJob" で始まるセクションを探します。

10. このセクションに記載されているジョブの後に次の行を追加します。

this.addStandardJob(methodStr(ReleaseUpdateDB41_Administration,

RepairCustomTable),'Backing up custom table');

11. コードを保存します。再度アップグレードプロセスを実行すると、カスタムコードが読み

込まれ、テーブルが修復されます。

方法 2

この問題を解決する別の手段は、一時的なテーブルを作成して問題のあるテーブルのデータを移し、

Microsoft Dynamics AX 2009 がテーブルを削除して再作成するようにし、一時的なテーブルから

新しく作成されたテーブルにデータを復元することです。

1. AOT を開きます。

2. [クラス] ノードを展開します。

3. ReleaseUpdateDB41_Administration クラスを探します。

4. このクラスをダブルクリックして、エディタでこのクラスを開きます。

5. [新規作成] をクリックして新しいメソッドを作成します。


void backupCustomTable()

{

//back up a custom table so it may be dropped by the synch process

SqlStatementExecutePermission permission;



Connection connection;

Statement statement;

SalesTable salesTable;

SqlSystem sqlSystem = new SqlSystem();

str ext;

int tickCount;

str sqlStatement;

;

//create our connection

connection = new Connection();

statement = connection.createStatement();

// coreexchangetable is our table with issues

sqlStatement = strfmt(@"select * into COREEXCHANGETABLE_temp from

COREEXCHANGETABLE");

permission = new SqlStatementExecutePermission(sqlStatement);

permission.assert();

//BP deviation documented

statement.executeUpdate(sqlStatement);

CodeAccessPermission::revertAssert();

}


8. initPreSyncJobs メソッドを変更して、手順 5. ～ 7. で作成したメソッドを呼び出すようにし

ます。エディタの一番左側のウィンドウで initPreSyncJobs メソッドを強調表示します。コ

ードが表示されます。

9. コード内で "this.addStandardJob" で始まるセクションを探します。

10. このセクションに記載されているジョブの後に次の行を追加します。

this.addStandardJob(methodStr(ReleaseUpdateDB41_Administration,

RepairCustomTable),'Backing up custom table');


12. 次の手順では、同期プロセスによりテーブルが再作成された後にデータを復元するようにメ

ソッドを作成します。[新規作成] をクリックして新しいメソッドを作成します。




void restoreCustomTable()

{

// back up a custom table so it may be dropped by the synch process

SqlStatementExecutePermission permission;

Connection connection;

Statement statement;

SalesTable salesTable;

SqlSystem sqlSystem = new SqlSystem();

str ext;

int tickCount;

str sqlStatement;

;

//create our connection

connection = new Connection();

statement = connection.createStatement();

// coreexchangetable is our table with issues

sqlStatement = strfmt(@"insert into COREEXCHANGETABLE

(EXCHANGEITEMSPERASSEMBLY,EXCHANGEITEMGROUP,EXCHANGEITEMNUMBER,ASSEMBLYITEMNUMBER,CORERET

URNPERIOD,EXCHANGECONFIGID,ASSEMBLYCONFIGID,

MODIFIEDDATE,MODIFIEDTIME,MODIFIEDBY,MODIFIEDTRANSACTIONID,CREATEDDATE,CREATEDTIME,CREATE

DBY,CREATEDTRANSACTIONID,DATAAREAID,RECID) Select

EXCHANGEITEMSPERASSEMBLY,EXCHANGEITEMGROUP,EXCHANGEITEMNUMBER,

ASSEMBLYITEMNUMBER,CORERETURNPERIOD,EXCHANGECONFIGID,ASSEMBLYCONFIGID,

MODIFIEDDATE,MODIFIEDTIME,MODIFIEDBY,MODIFIEDTRANSACTIONID,CREATEDDATE,CREATEDTIME,CREATE

DBY,CREATEDTRANSACTIONID,DATAAREAID,RECID from COREEXCHANGETABLE_temp");

permission = new SqlStatementExecutePermission(sqlStatement);

permission.assert();

//BP deviation documented

statement.executeUpdate(sqlStatement);

CodeAccessPermission::revertAssert();

}




15. initPostSyncJobs メソッドを変更して、手順 12. ～ 14. で作成したメソッドを呼び出すよう

にします。エディタの一番左側のウィンドウで initPostSyncJobs メソッドを強調表示します。

コードが表示されます。

16. コード内で "this.addSharedJob" で始まるセクションを探します。

17. コードのこの行の後に次のように入力します。

this.addSharedJob(methodStr(ReleaseUpdateDB41_Administration,

restoreCustomTable),'Restore data into custom table');

18. コードを保存します。この時点で事前同期が実行できるようになり、カスタムメソッドによ

りテーブルがバックアップされます。同期プロセスではテーブルを削除することを確認する

プロンプトが表示され (ここでは問題なく実行できます)、事後同期によりデータが新しく作

成されたテーブルに復元されます。



コードのアップグレードの競合の検出ツールの


このセクションでは、アップグレードの競合の検出ツールを使用するときに発生する可能性のあ

る問題点について説明します。

コードのアップグレードの競合の検出ツールがフリーズまたはクラ

ッシュする

問題点 : コードのアップグレードの競合の検出ツール ([ツール]、[開発ツール]、[コードのアップ

グレード]、[コードのアップグレードの競合の検出] の順に選択) を実行しているときに、AX ク

ライアントがフリーズまたはクラッシュします。

考えられる原因 : コードのアップグレードの競合の検出ツールが、分析できないカスタマイズを

検出しています。たとえば、データソースとしてクエリをホストするようにフォームを変更し

ている場合、このカスタマイズによって、コードのアップグレードの競合の検出ツールがクラッ

シュまたはフリーズする可能性があります。

解決策 : コードのアップグレードの競合の検出を実行している間は、分析中のカスタマイズの名

前が画面に表示されます。問題が発生したときは、分析中のカスタマイズの名前を書き留めてお

いてください。

次に、以下の手順を実行します。

1. クライアントを再起動します。

2. クライアントがハングまたはクラッシュする原因のカスタマイズをエクスポートします。

3. カスタマイズを削除します。

4. アップグレードの競合の検出ツールをもう一度実行します。

5. 手順 2. のファイルをインポートします。

カスタマイズに競合が含まれているものと見なし、比較ツールを使用して手動の競合解決を実行

します。



アップグレード中のエラーメッセージ

このトピックでは、アップグレードプロセス中に表示される可能性があるいくつかのエラーメ

ッセージについて説明し、それらのメッセージの考えられる原因と解決策を示します。

新しい固有インデックス名 [INDEXNAME] で発生する可能性がある

固有インデックス違反

問題点 : データ損失または固有キー違反が発生する。

考えられる原因 : 同期中にフィールドのサイズが変更 (縮小) され、コードアップグレードの前

にデータアップグレードを実行しました。

解決策 : データベースのバックアップを復元し、データアップグレードの前にコードアップグ

レードを完了します。

制約がないことを示すエラーメッセージ

問題点 : 以前に Microsoft Dynamics AX 3.0 から Microsoft Dynamics AX 4.0 にアップグレードし

たことがある場合、初めて Application Object Server (AOS) を起動するとき、またはアップグレ

ードのチェックリストの事前同期、同期、または事後同期の手順を実行しているときに、

Microsoft Dynamics AX 2009 アップグレードプロセスが失敗する。また、Microsoft Windows ア

プリケーションイベントログに、制約がないことが原因で SQL ステートメントが失敗している

ことを示すエラーメッセージが表示される (NULL が想定されていない場合、テーブルやインデ

ックスの alter コマンドまたは create コマンドが失敗した場合など)。

考えられる原因 : Microsoft Dynamics AX 4.0 データベーススキーマのいくつかのテーブルに既

定の制約がありません。これが原因かどうかを確認するには、SQL Server Management Studio

で次のコマンドを実行します。

Sp_help<テーブル名>

例 : sp_help ACCESSRIGHTSLIST

制約タイプの結果セットは、ACCESSRIGHTSLIST テーブルの場合は次の例のようになります。

Constraint_type

----------------------------

CHECK on column RECID

DEFAULT on column ACCESSTYPE

DEFAULT on column ACCESSTYPEFKEYUSE

DEFAULT on column DEL_CREATEDTIME

DEFAULT on column CREATEDBY

DEFAULT on column CREATEDDATETIME

DEFAULT on column DOMAINID

DEFAULT on column ELEMENTNAME



DEFAULT on column GROUPID

DEFAULT on column DEL_MODIFIEDTIME

DEFAULT on column MODIFIEDBY

DEFAULT on column MODIFIEDDATETIME

DEFAULT on column PARENTID

DEFAULT on column RECORDTYPE

DEFAULT on column RECVERSION

DEFAULT on column ID

PRIMARY KEY (clustered)

また、BANKPARAMETERS、COMPANYDOMAINLIST などの他のテーブルの制約も確認します。

多くの列に対して定義されている DEFAULT 制約が結果に表示されない場合は、Microsoft

Dynamics AX 2009 にアップグレードする前に Microsoft Dynamics AX 4.0 データベースを修正


解決策 : 解決策については、http://go.microsoft.com/fwlink/?LinkId=120373 を参照してください。




比較ツールのトラブルシューティング

このセクションでは、比較ツールを使用するときに発生する可能性のある問題点について説明

します。

現在のオブジェクトを古いオブジェクトと比較できない

現在の Microsoft Dynamics AX 2009 オブジェクトを、Microsoft Dynamics AX 3.0 または

Microsoft Dynamics AX 4.0 のオブジェクトと比較できない場合は、\Microsoft Dynamics

AX\40\Application\Standard\Old フォルダ内の AXAPD.AOI ファイルが正しく構築されて

いません。この問題を修正するには、次の手順を実行します。

1. AOS サービスを停止します。

2. Standard\Old フォルダに対してフルコントロールのアクセス許可 (Windows アクセス許可)

があることを確認します。

3. 前のバージョンの *.AOD ファイルを Standard\Old フォルダに再コピーし、ファイルが読み

取り専用として設定されていることを確認します。

4. Standard\Old フォルダ内の既存の AXAPD.AOI ファイルの名前を変更します。

5. AOS サービスを開始します。Standard\Old フォルダの AXAPD.AOI ファイルが再作成され、

このファイルには、前の Microsoft Dynamics AX バージョンに存在していたすべてのオブジ

ェクトへの更新された参照が含まれます。



アップグレードガイドの付録

この付録では、Microsoft Dynamics AX 2009 へのアップグレード時に役立つ参照情報を示します。

このセクションには次のトピックが含まれます。

開発アクセスライセンス

チュートリアル : 日付と時刻のテーブルフィールドのペアを UtcDateTime にアップグレー

ドする

セットアップによってインストールされる前提条件となるソフトウェア

AIF アップグレードプロセス

コードのアップグレード : 例



開発アクセスライセンス

Microsoft Dynamics AX の開発アクセス許可は、次の 4 つの異なるライセンスに分けられています。

基本パッケージ

MorphX

Web MorphX

X++

基本パッケージ

基本パッケージでは、次のアクセス許可が提供されます。

メニュー (ユーザーメニュー、メインメニューなど) の作成および変更

ユーザーフォームの作成または変更

MorphX

MorphX 開発ライセンスでは、テーブル、フィールド、列挙、および拡張データ型が保守される

データディクショナリノードへのアクセス許可が提供されます。また、MorphX 開発ライセン

スでも、フォームの作成または変更が可能です。

フォーム、テーブル、拡張データ型、マクロ、メニュー、レポート、ジョブ、およびクエリの追

加、変更、および削除が可能です。フォームなど、テーブルに関連付けられたメソッドを変更す

ることができます。たとえば、メソッドを変更することにより、新規顧客を追加する際の標準情

報を変更できます。また、MorphX を使用して拡張データ型を変更することにより、勘定番号の

長さを変更することもできます。

アプリケーションオブジェクトツリー (AOT) に次のノードが表示されます。

データディクショナリ

フォーム

マクロ

レポート

クエリ

ジョブ

メニュー

メニュー項目

リソース

システムのドキュメント

Application Developer Documentation

Application documentation



Web MorphX

Web MorphX Development Suite ライセンスでは、MSDAX の Web 開発フレームワークへのア

クセス許可が提供されます。

AOT には、次のノードが表示されます。

Web フォーム

Web レポート

Web メニュー

Web ページ

Web エディタ

スタイルシートエディタ

X++

X++ 開発ライセンスでは、Microsoft Dynamics AX のすべてのクラス、および CUS レイヤの開

発コードへの完全なアクセス許可が提供されます。このライセンスを使用すると、請求書ルーチ

ンなどのプロセスや仕訳元帳の転記プロセスを変更できます。CUS レイヤの開発コードを利用

すると、顧客が CUS レイヤまたは USR レイヤ、あるいはその両方に、変更したアプリケーシ

ョンオブジェクトを配置できるようにすることが可能になります。

クラスの追加、変更、および削除が可能です。たとえば、クラス SalesFormLetter で定義され

ている請求書更新のロジックを変更できます。



チュートリアル : 日付と時刻のテーブルフィー

ルドのペアを UtcDateTime にアップグレード

する

Microsoft Dynamics AX に日付や時刻のカスタムフィールドを追加している場合は、それらを新

しい UtcDateTime フィールドにマージするかどうかを決定する必要があります。UtcDateTime

フィールドは、協定世界時 (UTC) の日付/時刻データを格納します。

メモ :

この情報は、Microsoft Dynamics AX 2009 より前の任意のバージョンから Microsoft

Dynamics AX 2009 以降にアップグレードする必要がある場合に関連します。

アップグレードの際には、1 つの日付フィールドと 1 つの時刻フィールドから成るフィールドの

ペアを新しい UtcDateTime フィールドにマージするのが一般的です。UtcDateTime を使用する

と、組織のあらゆる場所で、ローカルタイムゾーンに合わせて自動的に調整された日付/時刻の

値を表示できます。

日付フィールドと時刻フィールドを UtcDateTime フィールドにマージする必要がある場合は、

アップグレードを実行する前にいくつかの準備を行う必要があります。この UtcDateTime の準

備は、実稼働環境で Microsoft Dynamics AX 2009 アップグレードプロセスを実行する前に行わ

れる数多くの準備の一部にすぎません。

このチュートリアルでは次のタスクについて説明します。

実稼働環境で SysDeletedObjects41 を有効にする

テストデータベースをインストールする

テスト環境に新しいバージョンをインストールする

テスト環境で SysDeletedObjects41 を有効にする

アップグレードする日付フィールドと時刻フィールドを特定する

接頭語 DEL_ を追加してフィールドの名前を変更する

名前を変更したフィールドに SysDeletedObjects41 を割り当てる

置換先の UtcDateTime フィールドを追加する

新しい UtcDateTime フィールドを使用するように X++ コードを更新する

テスト環境でコードのアップグレードを実行する

以降のステップの概要

ReleaseUpdateDB41_* にメソッドを追加する

新しいメソッドを登録する

メソッドの関係の概要

テスト環境でコードのアップグレードを再実行する

特殊なケースに対処する

実稼働環境でアップグレードを実行する

その他の詳細について検討する



前提条件

このチュートリアルは、Microsoft Dynamics AX 2009 へのアップグレードを行う必要がある管理

者 (またはリード開発者) を対象としています。

このチュートリアルを完了するためには次のものが必要です。

Microsoft Dynamics AX 2009、Application Object Server (AOS)、およびクライアントの一時

的なインストール (アプリケーションオブジェクトツリー (AOT) を含む)

Microsoft Dynamics AX 2009 クライアントにアクセスできるライセンスファイル

Microsoft Dynamics AX 2009 (AOS) がアクセスするデータベースサーバー

実稼働環境で SysDeletedObjects41 を有効にする

この手順は、まだアップグレードしていない実稼働環境で実行します。コンフィギュレーション

キーの SysDeletedObjects41 を使用して、アップグレードの完了後に簡単に削除できるようにす

る項目にタグを付けます。

この手順では、ナビゲーションウィンドウを使用して、削除用にマークするオブジェクトを保

持します。後にこの設定をクリアすると、オブジェクトが削除されます。

SysDeletedObjects41 を有効にするには

1. ナビゲーションウィンドウで、[管理]、[設定]、[システム]、[コンフィギュレーション]

の順にクリックします。

2. 表示される "コンフィギュレーション" フォームで、[管理] を展開して [更新オブジェク

ト 41 の保存] ノードを表示します。

3. [更新オブジェクト 41 の保存] チェックボックスをオンにします。

テストデータベースをインストールする

この手順では、最終的に生産システムをアップグレードするための準備のステップをサポートす

るために必要な、テストデータベース環境を作成します。このテスト環境は、生産システムを

アップグレードした後に破棄できます。

テストデータベースをインストールするには

1. テストデータベースサーバーに空のデータベースを作成します。

2. その空のデータベースに運用データベースのコピーを読み込みます (省略可能)。

空のデータベースを使用する場合は、そのデータベースに新しい Microsoft Dynamics AX を

接続すると、テーブルやその他の構造が作成されます。これらの構造は同期プロセスによっ

て作成されます。



テスト環境に新しいバージョンをインストールする

この手順では、生産システムのアップグレード先となる Microsoft Dynamics AX 2009 (またはそ

れより新しいバージョンの Microsoft Dynamics AX) を、後に破棄できるテスト環境にインスト

ールする必要があります。

テスト環境で SysDeletedObjects41 を有効にする

この手順は、実稼働環境のアップグレード先となる新しい Microsoft Dynamics AX のテスト環境

で実行します。

ナビゲーションウィンドウを使用して、削除用にマークするオブジェクトを保持します。後に

この設定をクリアすると、オブジェクトが削除されます。

この方法は、先ほど実稼働環境について説明した方法と同じです。

アップグレードする日付フィールドと時刻フィールドを特定する

この手順では、インストールに追加された日付と時刻のカスタムフィールドをすべて見つけま

す。その中のどれを新しい UtcDateTime 型にアップグレードするかを決定する必要があります。

アップグレードする必要がある日付と時刻のカスタムフィールドのリストを作成します。

日付フィールドや時刻フィールドを UtcDateTime にアップグレードするかどうかを決定す

るには

1. 正確な時間を保存するために一緒に (同じテーブルで) 使用されている日付フィールドと

時刻フィールドのペアを特定します。そのようなペアは、両方のフィールドで同じ名前

が使用されていて、Date または Time の接尾語のみで区別されている可能性があります。

メモ :

たとえば、YourMeetingDate と YourMeetingTime というフィールドのペアな

どが考えられます。このペアを、YourMeetingDateTime という新しいフィール

ドに置き換えることができます。

2. 時刻フィールドとペアになってはいないが、ローカル時刻が暗黙的に含まれる日付フィ

ールドを特定します。たとえば、法律や契約で定められた期日には、午前 0 時などの時

刻が暗黙的に含まれる場合があります。

3. 日付フィールドとペアになってはいないが、UTC で表した方が便利な時刻フィールドを

特定します。そのような時刻フィールドはまれです。



接頭語 DEL_ を追加してフィールドの名前を変更する

この手順では、先ほど特定した日付フィールドと時刻フィールドの名前を変更します。それぞれ

に 4 文字の接頭語 DEL_ を追加する必要があります。

テーブルのフィールドの名前を変更するには

1. AOT で、[データディクショナリ] ノードを展開し、[テーブル] を展開します。

2. 名前を変更するフィールドを含むテーブルを展開し、[フィールド] ノードを展開します。

3. 名前を変更するフィールドを右クリックし、[プロパティ] を選択します。

4. [プロパティ] ウィンドウで、[名前] のテキストボックスをクリックします。

5. 接頭語 DEL_ を入力して名前を変更し、Enter キーを押します。

名前を変更したフィールドに SysDeletedObjects41 を割り当てる

この手順では、UtcDateTime にアップグレードする日付フィールドと時刻フィールドに、

SysDeletedObjects41 コンフィギュレーションキーを割り当てます。

Microsoft Dynamics AX の各バージョンごとに、末尾のバージョン番号のみが異なる、同じよう

な名前のコンフィギュレーションキーがあります。41 というバージョン接尾語は、Microsoft

Dynamics AX 2009 を表します。

接頭語 DEL_ を使用して名前を変更したフィールドに SysDeletedObjects41 を割り当てること

により、実稼働環境をアップグレードした後に使用されなくなるすべてのフィールドを追跡でき

ます。また、使用されなくなったすべてのフィールドを一度に簡単に削除できるようにもなります。

フィールドに SysDeletedObjects41 コンフィギュレーションキーを割り当てるには

1. AOT で、[データディクショナリ] を展開し、目的のテーブルを展開して、[フィールド]

を展開します。

2. 接頭語 DEL_ が付いたフィールドを右クリックし、[プロパティ] を選択します。

3. [プロパティ] ウィンドウで、ConfigurationKey プロパティのドロップダウンリストを

クリックし、[SysDeletedObjects41] を選択します。



置換先の UtcDateTime フィールドを追加する

この手順では、使用されなくなるすべての日付フィールド、時刻フィールド、またはフィールド

のペアについて、置換先となる UtcDateTime フィールドを追加します。

置換先の utcDateTime フィールドを追加するには

1. AOT で、[データディクショナリ] を展開し、[テーブル] を展開します。

2. 新しい UtcDateTime フィールドが必要なテーブルを展開します。

3. [フィールド] ノードを右クリックし、[新規] をクリックして、[UtcDateTime] を選択し

ます。

4. 新しいフィールドノードを右クリックし、[プロパティ] を選択します。

5. [プロパティ] ウィンドウで、[名前] を変更し、必要に応じて他のプロパティを変更し

ます。

新しい UtcDateTime フィールドを使用するように X++ コードを更

新する

この手順では、X++ コードをスキャンして、置換される日付フィールドや時刻フィールドへの参

照をすべて見つけます。

これらの参照は、X++ コードをすべて再コンパイルすることによって見つけることができます。

先ほどのフィールド名の変更によってコンパイルエラーが発生するため、更新する必要がある

参照がわかります。

それぞれのケースで X++ コードに必要な変更を手動で特定する必要があります。新しいコード

では、新しい UtcDateTime フィールドを参照する必要があります。

新しい utcDateTime フィールドを使用するように X++ コードを更新するには

1. X++ コードをすべて再コンパイルして、古い DEL_ フィールドへの参照を見つけます。

2. 各エラーを調査して、新しい UtcDateTime フィールドを参照してコードを修正するた

めの方法を特定します。

3. 変更した X++ コードを再コンパイルします。



UtcDateTime の関数

次の表に、UtcDateTime 値を操作できる関数の例を示します。

機能説明

DateTimeUtil クラスこのクラスには、utcDateTime 値を操作するた

めのメソッドが数多くあります。

Global クラス Global クラスには、utcDateTime 値を操作する

ためのメソッドがいくつかあります。以下に例

を示します。

clrSystemDateTime2UtcDateTime

dateToBeginUtcDateTime

dateToEndUtcDateTime

utcDateTime2SystemDateTime

utcDateTimeNull

メモ utcDateTime2SystemDateTime は、.NET

Framework クラスの System.DateTime を参照し

ます。この関数は、

clrSystemDateTime2UtcDateTime と同等です (接頭

語 clr は .NET Framework の共通言語ランタイ

ムを表します)。

関数 utcDateTime 値を操作するための X++ 関数が

あります。以下に例を示します。

datetime2Str

str2Datetime

テスト環境でコードのアップグレードを実行する

この手順では、Microsoft Dynamics AX 2009 クライアントからテスト環境でコードのアップグレ

ードを実行します。これにより、生産システムでアップグレードを実行するときに使用す

る .AOD ファイルが生成されます。

この手順は何度でも実行できるため、すべての変更が完了するのを待たずに、変更を加えるたび

に実行することができます。変更を小分けにしてその都度この手順を繰り返すと、問題の診断や

修正が容易になる可能性があります。



詳細については、Microsoft Dynamics AX のアップグレードのドキュメントを参照してください。

コードのアップグレードを実行するには

1. クライアントのメニューで、[ツール]、[開発ツール]、[コードのアップグレード] の順に


2. アップグレードに関連する 4 つのアクションが表示されます。それらのアクションを一

度に 1 つずつ、メニューに表示される順番に実行します。

a. コードのアップグレードの競合の検出

b. レイヤの比較

c. 見積報告書

d. パラメータ

以降のステップの概要

以降の手順では、アップグレードに必要な X++ コードを記述します。Microsoft Dynamics AX 2009

に用意されているクラスにメソッドを追加します。この新しいメソッドは、手動の準備のフェー

ズで呼び出すのではなく、登録して、実稼働環境のアップグレードプロセスで起動されるよう

にします。

ReleaseUpdateDB41_* にメソッドを追加する

この手順では、ReleaseUpdateDB41_* というパターンの名前を持ついずれかのクラスにメソッド

を追加します。このようなクラスはいくつかあり、それぞれ特定のモジュールを対象としていま

す。各テーブルにはコンフィギュレーションキーが割り当てられており、そのコンフィギュレ

ーションキーは、そのテーブルが属するモジュールを表します。名前のパターンの末尾のアス

タリスク (*) は、モジュール ID のプレースホルダです。メソッドは、影響を受けるテーブルのモ

ジュールに対応するクラスに追加する必要があります。どのクラスを使用すればよいのかがわか

らない場合は、ReleaseUpdateDB41_Basic クラスを使用できます。

追加するメソッドには、慣例に従い、一貫性を保つために、updateToDateTime_* で始まる名前を

付けます。識別しやすいように、自分の名前を接尾語として含めます。

メモ :

一見同じに見えて実際には違う単語 (update または upgrade) で始まっているメソッド名

があるので注意してください。これらは同じメソッドではありません。



追加するメソッドでは、システムに用意されている upgradeToDateTime というメソッドを呼び出

します。upgradeToDateTime メソッドは、DEL_SysUpgradeTimeZone テーブルへの SQL insert を実

行します。このような呼び出しを 1 つのメソッドで複数実行できます。

ReleaseUpdateDB41_Basic にメソッドを追加するには

1. AOT で、[クラス] ノードを展開し、[ReleaseUpdateDB41_Basic] を展開します。

2. [メソッド] を右クリックし、[新しいメソッド] を選択します。

3. 次の例のような新しいインスタンスメソッドを追加します。メソッドの名前は、重複し

ない名前であれば何でもかまいません。新しいメソッドでは、この例のように、

upgradeToDateTime を呼び出す必要があります。

メモ :

日付の列が時刻の列とペアになっていない場合は、時刻の列の fieldId の値とし

てゼロ (0) を渡します。

メモ :

ここに示されている最後のパラメータ (classnum) は省略可能で、ここに示され

ている値 (ReleaseUpdateDB_TimezoneUpgrade) が既定値です。

void updateToDateTime_Jane

{

ReleaseUpdateDB41_Basic ::upgradeToDateTime

(

tableNum( YourActivitiesTable )

,fieldNum( YourActivitiesTable ,YourMeetingStartDateTime )

,fieldNum( YourActivitiesTable ,DEL_YourMeetingStartDate )

,fieldNum( YourActivitiesTable ,DEL_YourMeetingStartTime )

,classNum( ReleaseUpdateDB_TimezoneUpgrade )

);

}

4. コードエディタのウィンドウで保存のアイコンをクリックし、ウィンドウを閉じます。



ReleaseUpdateDB_TimezoneUpgrade クラス

前のコード例では、ReleaseUpdateDB_TimezoneUpgrade クラスがパラメータとして渡されています。

このクラスには、Microsoft SQL Server データベースのインストールに適用される

runSQLCode_UpdateDateToUTCDateTime というメソッドがあります。Oracle データベース用の、

runORACode_UpdateDateToUTCDateTime というよく似たメソッドもあります。これらのメソッドは、

UTC の時刻値を割り当てて新しい UtcDateTime 型のフィールドを更新します (非表示の関連フ

ィールドへのタイムゾーンの割り当ても行われます)。この UTC 値は、使用されなくなった日

付フィールドと時刻フィールドのペアと、AOS のローカルタイムゾーンから導き出されます。

前の例の upgradeToDateTime の呼び出しでは、この 2 つのメソッドのいずれかが呼び出されます。

影響を受けるモジュールについて検討する

ReleaseUpdateDB41_Basic クラスは、特定のモジュールに固有のクラスではありません。このク

ラスに似たクラスがいくつかありますが、それらは、特定のモジュールに固有のコードを保持す

るためのクラスです。たとえば、ReleaseUpdateDB41_smm はそうしたクラスの 1 つです。これら

のクラスは、ReleaseUpdateDB41_* という名前付け規則に従っています。新しいメソッドを

*_Basic クラスに追加することもできますが、そのメソッドによってアップグレードされる項目

を含むモジュールの名前が付いた類似のクラスに追加することをお勧めします。

新しいメソッドを登録する

この手順では、最終的な実稼働環境のアップグレードプロセスのために新しいメソッドを登録

する X++ コードを記述します。この例では、addSharedJob メソッドを呼び出します。パラメー

タは、追加した新しいメソッドの名前と、そのメソッドを追加したクラスです。

新しいメソッドを登録するには

1. AOT で、[クラス]、[ReleaseUpdateDB41_Basic]、[方法] の順に展開します。

2. [initPreSyncJobs] を右クリックし、[編集] を選択します。

3. エディタウィンドウで、次の例の呼び出しをメソッドの内部に記述します。

this .addSharedJob

(

methodStr( ReleaseUpdateDB41_Basic

,updateToDateTime_Jane

)

,"Handles new fields like YourMeetingStartDateTime."

)

4. 保存のアイコンをクリックし、エディタを閉じます。

詳細については、「How to write upgrade scripts (アップグレードスクリプトを記述する方法)」





メソッドの関係の概要

次の表に、クラスおよびそのメソッドと、これまでに説明したその他のオブジェクトとの関係の

概要を示します。

イニシエータオペランド関係

DEL_YourMeetingStartDate、

DEL_YourMeetingStartTime

(テーブルフィールド)

YourMeetingStartDateTime データ :

DEL_YourMeetingStartDate

と

DEL_YourMeetingStartTime

からデータが読み取ら

れ、タイムゾーンの情報

が適用された後、新しい

YourMeetingStartDateTime

フィールドに格納されます。

updateToDateTime_You メソッド

(ReleaseUpdateDB41_Basic クラス)

ReleaseUpdateDB41_Basic::upgra

deToDateTime

呼び出し :

updateToDateTime_You が

upgradeToDateTime を呼び

出します。


deToDateTime

ReleaseUpdateDB_TimezoneUpgrade

/* .runSQLCode_UpdateDateToUTC

DateTime

*/

パラメータ :

オペランドのクラスは、

upgradeToDateTime のパラ

メータです。このオペラ

ンドクラスには、

runSQLCode_UpdateDateToU

TCDateTime という重要な

メソッドがあります。こ

のオペランドクラスをパ

ラメータとして渡すと、

最終的にこのメソッド

(または対応する Oracle

用のメソッド) が実行され

ます。



イニシエータオペランド関係


deToDateTime

DEL_SysUpgradeTimeZone

(テーブル)

SQL insert:

このメソッドは、オペラ

ンドのテーブルへの insert

を実行します。このテー

ブルは、実稼働環境をア

ップグレードするプロセ

スによって読み取られま

す。

ReleaseUpdateDB41_Basic.initPr

eSyncJobs

ReleaseUpdateDB41_Basic.addSha

redJob

呼び出し :

initPreSyncJobs は

addSharedJob を呼び出し

ます。

ReleaseUpdateDB41_Basic.addSha

redJob

updateToDateTime_You メソッド

(ReleaseUpdateDB41_Basic クラ

ス、またはモジュールに固有の

類似のクラス)

パラメータ :

updateToDateTime_You

(メソッド名) は、

addSharedJob のパラメー

タです。

テスト環境でコードのアップグレードを再実行する

この手順については既に説明しました。

特殊なケースに対処する

カスタマイズされた日付フィールドと時刻フィールドが専用の X++ コードを対象にしている場

合や、特殊なアプリケーションルールが含まれる場合があります。

次の表に、特殊なケースに対処する方法を示します。



特殊なケース説明

次のクラスを拡張する

ReleaseUpdateDB_TimezoneUpgrade

このクラスを拡張して、特殊なケースの日付フ

ィールドと時刻フィールドに対処するために必

要な専用のロジックを提供することができま

す。

ReleaseUpdateDB_TimezoneActivityUpgrade クラ

スをサンプルとして使用できます。この子クラ

スには、runSQLCode_UpdateDateToUTCDateTime

メソッドのオーバーライドと、対応する

Oracle メソッドのオーバーライドが含まれて

います。多くの場合、オーバーライドするのは

2 つのメソッドのいずれかのみです。

ReleaseUpdateDB41_Basic と似ているがそれと

は別のクラスにメソッドを追加する AOT には、ReleaseUpdateDB41_* というパター

ンの名前を持つクラスがいくつかあります。

中には、Microsoft Dynamics AX の別のモジュ

ールに対応するものもあります。これらのクラ

スのいずれかにメソッドを追加することができ

ます。

Microsoft Dynamics AX に含まれている、アプ

リケーションの日付フィールドと時刻フィール

ドのアップグレードを省略する

日付フィールドと時刻フィールドのペアに外部

システムがアクセスする場合もありますが、そ

のような場合に、その外部システムを、置換先

の UtcDateTime フィールドを使用するように

変更できないこともあります。

ReleaseUpdateDB41_* クラスのいずれかで該当

する呼び出しをコメントアウトすることによ

り、特定の日付と時刻のペアのアップグレード

を省略することができます。

アプリケーションの起動時に同期するテーブル

が追加されている

Application.syncApplTables に syncTable メソッ

ドの呼び出しが追加されている場合がありま

す。この手法は推奨されません。

syncApplTables に追加したテーブルは、

UtcDateTime 用に正しくアップグレードされ

ません。これを解決するには、追加したテーブ

ルの呼び出しを syncApplTables でコメントアウ

トするか、自動アップグレードの完了後にテー

ブルを手動でアップグレードします。



実稼働環境でアップグレードを実行する

テスト環境の準備が完了して、組織の実稼働環境をアップグレードできるようになるまでには、

しばらくかかる場合があります。UtcDateTime の準備がアップグレードの準備全体に占める割

合は、比較的小さいと言えます。

すべての準備が整ったら、実稼働環境をアップグレードします。次の表に、UtcDateTime のア

ップグレードに直接関係のある、アップグレードの 2 つのフェーズを示します。

アップグレードのフェーズ説明

同期前同期前の最後のステップとして、initPreSyncJobs メ

ソッドが実行されます。このステップが実行されてい

る間は、他のアップグレードの処理は行われません。

このステップの間は、SQL データベースのテーブル

がロックされます。

これにより、作成したメソッドが、同期後フェーズで

実行されるメソッドのリストに追加されます。

メモ :

同期後フェーズが開始された後に

ReleaseUpgradeDB41_Basic::upgradeToDateTime

メソッドを実行しても無視されます。

同期後同期後の最初のステップとして、

runSQLCode_UpdateDateToUTCDateTime メソッドが実行

されます。これにより、新しい UtcDateTime 列の UTC

値が更新されます。



その他の詳細について検討する

UtcDateTime のアップグレードに関するその他の詳細を以下に示します。

アップグレードのチェックリストでは、AOS に対して設定するタイムゾーンの入力を求め

られます。ほとんどの日付と時刻のデータに対応するタイムゾーンを選択してください。

注意 :

選択したタイムゾーンがアップグレードで使用され始めた後に別のタイムゾーンに

変更する方法はありません。正しいタイムゾーンを選択するように注意してくださ

い。アップグレードを開始する前にデータベースのバックアップコピーを作成する

必要があります。

Null の日付値は、UtcDateTime にアップグレードしても null のままです。それらのデータ

型の最小値は null として扱われます。

時刻フィールドとペアになっていない日付フィールドがアップグレードされる際には、まず、

UtcDateTime 値の時刻部分が 12:00 (正午) に設定されます。次に、タイムゾーンのオフセ

ットが適用されます。これにより、時刻の設定が 12:00 から変更されますが、時刻が変更さ

れても日付は変わらないと予想されます。

アップグレードが途中で中断され、その後に再開された場合も、UtcDateTime へのアップグ

レードは完了します。アップグレードの各ステップのステータスがシステムによって追跡さ

れています。



セットアップによってインストールされる前提

条件となるソフトウェア

前提条件となる次のソフトウェアコンポーネントを 1 つ以上インストールする必要があるコン

ポーネントをインストールする場合は、セットアップを実行するとソフトウェアがローカル

コンピュータにインストールされてコンフィギュレーションされます。

次の表に、前提条件となるソフトウェアとそのソフトウェアが必要となるコンポーネントを示

します。

前提条件そのインストールを必要とするコンポーネント

インターネットインフォメーションサービス

(IIS) ワークフロー

ロールセンターおよびエンタープライズポー

タルフレームワーク

AIF Web サービス

Microsoft メッセージキュー (MSMQ) 同期サービス (Project Server 2007)

Microsoft Windows SharePoint Services 3.0

Service Pack 1 ロールセンターおよびエンタープライズポー


Microsoft Visual C++ 2005 再頒布可能パッケージ AOS

クライアント

.NET Business Connector

Microsoft Visual C++ 2008 再頒布可能パッケージ AOS

クライアント

.NET Business Connector

Microsoft SQL Server 2005 ADOMD.NET ロールセンターおよびエンタープライズポー


SQL Server 2005 Native Client AOS

DHTML Editing Control for Applications 再頒布

可能パッケージクライアント

システム管理者ではない場合は、インストールする前にシステム管理者に問い合わせてください。

Microsoft Dynamics AX セットアップを使用してこのソフトウェアを後でアンインストールする

ことはできません。



AIF アップグレードプロセス

アップグレードの前に

Microsoft Dynamics AX 2009 ではメッセージ形式が変更されました。したがって、アップグレー

ドを実行する前にすべての AIF メッセージを完全に処理する必要があります。次の場所からすべ

てのメッセージが処理されたことを確認してください。

システムディレクトリ、メッセージキュー、AIF が着信メッセージを取得するすべての場所

など、すべての着信メッセージの場所。

キューマネージャ。キューマネージャ内のすべてのメッセージは未処理であり、削除する

必要があります。キューマネージャに移動するには、[基本設定]、[定期処理]、[アプリケー

ション統合フレームワーク]、[キューマネージャ] の順にクリックします。

コードアップグレード

AIF コードのアップグレード手順では、既存の Axd<Document> クラスおよびメソッドがアップ

グレードされます。アップグレードプロセスでは、既存の Axd<Document> クラスは変更されず、

対応するサービスとコンポーネントが作成されます。次の表に示すように、コードアップグレ

ードで処理されるクラスは 3 種類あります。

カテゴリ説明

Microsoft Dynamics AX に付属の

Axd<Document> クラスサービスクラスおよびコンポーネントは、

Microsoft Dynamics AX に付属のすべての

Axd<Document> クラスに対して生成されま

す。カスタムクラスがない場合、またはカス

タムアクションを実装しなかった場合は、これ

以上処理は不要です。標準サービスの詳細につ

いては、後述の「標準 Axd<Document> クラ

ス」を参照してください。

カスタム Axd<Document> クラスサービスクラスおよびコンポーネントは、す

べてのカスタム Axd<Document> クラスに対し

て生成されます。アップグレードプロセスの

結果は、これらのクラスのコーディング方法に

よって異なります。カスタムサービスの詳細

については、後述の「カスタム Axd<Document>

クラス」を参照してください。

AifServicable インターフェイスを実装するカ

スタムクラスアップグレードプロセスは警告メッセージを

生成し、これらのクラスのサービスコンポー

ネントを生成しません。



標準 Axd<Document> クラス

サービスクラスおよびデータオブジェクトは、次の表に示すように、既存の各 Axd<Document>

クラスに対して生成されます (AxdSalesOrder クラスの場合)。クラスは、[AOT]、[クラス] の順に

クリックすることで見つかります。各サービスの AOT サービスノードは、[AOT]、[サービス]

の順にクリックすることで見つかります。

生成される

コンポーネント

説明例

ドキュメントクラスルートデータオブジェクト。 SalesSalesOrder

データオブジェクトデータオブジェクトクラス

は、クエリ内の各データソ

ースに対して作成されま

す。これらのオブジェクト

は、ドキュメントクラスの

子です。

SalesSalesOrder_SalesTable、

SalesSalesOrder_DocuRefHeader、

SalesSalesOrder_DocuRefLine、

SalesSalesOrder_InventDim、

SalesSalesOrder_MarkupTransHeader、

SalesSalesOrder_MarkupTransLine、

SalesSalesOrder_SalesLine

サービスクラスサービスクラスは、各

Axd<Document> クラスに対

して生成されます。

Axd<Document> クラスでサ

ポートされる各アクション

について、サービスクラス

に工程が作成されます。

SalesSalesOrderService

AOT サービスノードサービスとその工程のプロ

パティを表示および変更で

きる AOT サービスノード内

のエントリ。




標準メソッドのアクションマッピング

Microsoft Dynamics AX 2009 では、新しいアクションのセットがサポートされており、ドキュメ

ントサービスにはこれらのアクションに対応する工程があります。以前のバージョンの 2 つの

アクションの機能を含む新しいアクションがデザインされていることもあります。

Microsoft Dynamics AX に付属の Axd<Document> クラスの標準アクションは、コードアップグ

レードの一部としてアップグレードされます。追加の作業は不要です。次の表に、新しいアクシ

ョンの一覧と、以前のバージョンからアクションがどのようにマップされているかを示します。

以前のバージョンのアクションマップ先のサービス工程

createList

create

create

deleteList delete

findList find

findEntityKeyList findKeys

readList

read

read

updateList

update

update

Microsoft Dynamics AX 4.0 では、製品に含まれるすべての Axd<Document> クラスがすべてのア

クションをサポートしていたわけではありません。標準 Axd<Document> クラスをカスタマイズ

し、標準アクションのサポートを有効にした場合、コードアップグレードでは、アクション名 +

ドキュメントクラス名という名前付け規則に従った名前でメソッドがサービスクラスに追加さ

れます。

たとえば、AxdASN ドキュメントクラスでは create アクションがサポートされません。create ア

クションのサポートを AxdASN に追加した場合は、コードアップグレードプロセスによって、

createASN が新しいサービスクラスに追加されます。アクション ID は、Axd<Document> クラス

の getActionList メソッドに見つかります。このメソッドの次のコード行では、完全なアクショ

ン名が作成されます。

aifActionInfo.parmActionId(strfmt('%1%2',

methodstr(AxdBase, findEntityKeyList), this.getName()));



カスタムメソッドのアクションマッピング

標準 Axd<Document> クラスにカスタムアクションを実装した場合、コードアップグレードで

は、アクション名 + ドキュメントクラス名という名前付け規則に従った名前でメソッドがサー

ビスクラスに追加されます。たとえば、test という名前のメソッドを AxdASN ドキュメントクラ

スに追加した場合、コードアップグレードプロセスでは testAxdASN という名前のメソッドが新

しいサービスクラスに追加されます。

カスタム Axd<Document> クラス

AIF アップグレードプロセス中に、カスタム Axd<Document> クラスもアップグレードされます。

生成されるサービスとコンポーネントは、次の表に示すように標準 Axd<Document> クラスと同

じです。ただし、アップグレードプロセスでは、カスタムドキュメントクラスのメソッド (アク

ション) が、そのコーディング方法に応じて異なる方法で処理されます。

生成されるコンポーネント説明例

ドキュメントクラスルートデータオブジェクト。テスト

データオブジェクトデータオブジェクトクラスは、

クエリ内の各データソースに対

して作成されます。これらのオ

ブジェクトは、ドキュメントク

ラスの子です。

Test_Table1

サービスクラスサービスクラスは、各

Axd<Document> クラスに対して

生成されます。Axd<Document>

クラスでサポートされる各アク

ションについて、サービスクラ

スに工程が作成されます。

TestService

AOT サービスノードサービスとその工程のプロパテ

ィを表示および変更できる AOT

サービスノード内のエントリ。

TestService



アクションマッピング

カスタム Axd<Document> クラスの標準アクションは、次の表に示すように、Microsoft

Dynamics AX 2009 でサポートされている新しいアクションにマップされます。新しいアクショ

ンは、サービスクラス内のメソッドとして実装されます。

以前のバージョンのアクションマップ先のアクション

createList create

deleteList delete

findList find

findEntityKeyList findKeys

readList read

updateList update

アクション create、read、update、または delete がカスタム Axd<Document> クラスによってサ

ポートされている場合、これらのアクションは、アクション名 + ドキュメントクラス名という

名前付け規則で新しいサービスクラスに追加されます。たとえば、create というアクションを

持つ AxdTest という名前のカスタムドキュメントクラスがある場合、アップグレードプロセス

では、createAxdTest という工程が新しいサービスクラスに追加されます。

カスタム Axd<Document> クラスにカスタムアクションを実装した場合、アップグレードプロ

セスでは、アクション名 + ドキュメントクラス名という名前付け規則でメソッドが新しいサー

ビスクラスに追加されます。たとえば、AxdTest という名前の Axd<Document> クラスがあり、

createTest というカスタムメソッドを追加した場合、アップグレードプロセスでは、

createTestAxdTest という工程が新しいサービスクラスに追加されます。

コンポーネントの名前付け規則

次の表に、アップグレードプロセスでサービスとコンポーネントが生成される場合に使用され

る名前付け規則の一覧を示します。これらの名前付け規則は、接頭語を除き、標準

Axd<Document> クラスおよびカスタムドキュメントクラスに対して生成されるコンポーネント

に適用されます。カスタムドキュメントクラスから生成されたサービスには接頭語が適用され

ません。



コンポーネントの

種類

名前の説明名前の生成ルール例

ドキュメントオ

ブジェクトルートデータオ

ブジェクトの X++

クラスの名前。

<接頭語> + <ドキ

ュメント名> +

"Service"

SalesSalesOrder

データオブジェ

クトドキュメントク

ラスの子データ

オブジェクトに

対する X++ クラ

スの名前。

<ルートデータオ

ブジェクトの名前>

+ "_" + <クエリデ

ータソース名>

SalesSalesOrder_SalesTable、

SalesSalesOrder_DocuRefHeader、

SalesSalesOrder_DocuRefLine、

SalesSalesOrder_InventDim、

SalesSalesOrder_MarkupTransHeader、

SalesSalesOrder_MarkupTransLine、

SalesSalesOrder_SalesLine

サービスクラス AIF サービスク

ラスの名前。 <接頭語> + <ドキ

ュメント名> +

"Service"


AOT サービス

ノードサービスの AOT

ノードの名前。 <接頭語> + <ドキ

ュメント名> +

"Service"


サービスの外

部名 WCF に発行され

たサービスの

名前。

<ドキュメント名> +

"Service"

SalesOrderService

メモ :

カスタムドキュメントクラスがアップグレードされている場合、または独自のドキュメ

ントクラスを作成している場合は、接頭語を使用する必要はありません。

データアップグレード

データアップグレードプロセスでは、Microsoft Dynamics AX データベース内の AIF データが

アップグレードされます。ここで示すテーブルは、Microsoft Dynamics AX 2009 で新規またはア

ップグレードされたものです。名前の先頭に "DEL_" が付いているテーブルまたはフィールドは、

データアップグレード中に使用されるテーブルであり、内部的にのみ使用されます。

メモ :

データアップグレードプロセスの前に、AIF コードアップグレードプロセスを実行す

る必要があります。したがって、アップグレードのチェックリストの「Aif コードのアッ

プグレード」の手順をあらかじめ実行する必要があります。コードアップグレード手順

が実行されたことを確認するには、[AOT] の [サービス] ノードをチェックし、AIF サー

ビスの一覧を参照します。これは、コードアップグレードプロセスが既に実行されたこ

とを示しています。



AifGlobalSettings

フィールド ResponseCacheLifetime がテーブルに追加され、24 (時間) に設定されています。

AifService

これは、次のフィールドを持つ新しいテーブルです。

ClassId

Name

Description

Enabled

ErrorState

ErrorMessage

Namespace

ExternalName

アップグレードプロセスでは、各 Axd<Document> クラスについて、このテーブルにサービスが

追加されます。AifAction テーブルの一意のドキュメント ClassId ごとに、アップグレードプロ

セスで次の処理が行われます。

1. [AOT] の [サービス] で、サービスノードを探します。

2. AifService テーブルにレコードを追加し、AOT のデータをそのレコードに設定します。

3. AifAction テーブルのサービスアクションの処理中にアップグレードプロセスでエラーが発

生した場合は、これらのエラーが連結され、各サービスの ErrorMessage フィールドに保存さ

れます。

4. サービスに、AifAction テーブルで有効になっているアクションがある場合は、Enabled フィ

ールドを true に設定します。

メモ :

登録されたアクションがある (アクションが AifAction テーブルに存在する)

Axd<Document> クラスのみアップグレードされます。

AifAction

次のフィールドが削除されました。

ActionType

WebSvcOutOfSync

ActionEnabled

WebMethodEnabled

InfoLogData

ErrorState



次のフィールドが追加されました。

EnforceIdempotency

ServiceName

次のフィールドのデータが変更されました。

ActionId

Microsoft Dynamics AX 2009 では、アクション create、read、update、および delete がサポー

トされず、使用できなくなりました。ただし、これらのアクションの機能は、複数のエンティテ

ィキー値または複数のドキュメントを含むパラメータを受け取ることのできる新しい create、

read、update、および delete サービス工程で置き換えられました。

Axd<Document> クラスに AifService テーブル内の一致するサービスクラスがある各アクション

について、アップグレードプロセスは次の処理を行います。

1. アクションをアップグレードできることを確認します。Microsoft Dynamics AX に付属のド

キュメントについて、メソッド create、read、update、および delete はアップグレードされ

ません。これらのメソッドは、単一のドキュメントまたはエンティティキーを処理するため

です。ドキュメントクラスアクションをアップグレードできない場合は、そのアクション

がスキップされ、アップグレードプロセスはドキュメントクラスの次のアクションに進み

ます。

2. アクションをアップグレードできる場合、アップグレードプロセスでは、次の表に示す新し

いメソッド名が取得されます。

以前のバージョンのアクションマップ先のメソッド

createList create

deleteList delete

findList find

findEntityKeyList find

readList read

updateList update



3. AifAction テーブルのレコードは、次のように更新されます。

フィールド値

ActionId serviceClassName.Method

Name serviceExternalName.serviceNodeOperationName

ServiceName AOT のサービス名

ClassId サービスの ClassId

ExternalAction サービスノードの工程名

MethodName サービスクラスメソッド名

EnableIdempotence サービスの参照ノードの値に応じて設定

データアップグレードプロセスが完了すると、無効になっている AifAction テーブルのアクシ

ョンを表示できます (ActionEnabled フィールドが false に設定されています)。この状況が発生す

る理由は次のとおりです。

1. レコードが、以前のバージョンの create、read、update、または delete アクションに対する

ものであるためです。これらのアクションは、テーブルでは無効になります。これ以上処理

は不要です。

2. アップグレードプロセス中に予期しないエラーが発生し、アクションをアップグレードでき

ない場合は、AifAction テーブル内で無効になります。

AifDocumentSchemaTable

DocumentClassId は、データオブジェクトの ClassId に更新されます。

AifDocumentFieldTable

DocumentClassId は、データオブジェクトの ClassId に更新されます。

AifEndpoint

PreventLoopbackSend フィールドと PropagateErrors フィールドは、false に設定されます。

AifResponse


CreatedDateTime

古いメッセージ形式は上位互換性がないため、すべてのレコードがデータアップグレード中に

削除されます。



AifEndpointActionValueMap

ActionId は、正常にアップグレードされたアクションの新しい ActionId に更新されます。

AifDataPolicy

ActionId は、正常にアップグレードされたアクションの新しい ActionId に更新されます。

AifPipeline


Direction

EndpointId

パイプラインは、エンドポイントアクションポリシーのアクションの種類によって決定される

ドキュメントフローの方向によって、着信または送信になります。AifPipeline 内に対応するレ

コードを持つ AifEndpointActionPolicy 内の任意のレコードについて、AifPipeline.Direction フ

ィールドは次のように更新されます。

アクションの種類が ReceiveDocument、ReceiveDocumentList、ProcessEntity、または

ProcessEntityList の場合は Inbound。

アクションの種類がその他の値の場合は Outbound。

また、データアップグレードプロセスは、AifPipeline.ActionId フィールドを新しい ActionId

で更新し、AifPipeline.EndpointId を AifEndpointActionPolicy テーブルの EndpointId で更新し

ます。

AifEndpointActionPolicy


InboundPipelineId

OutboundPipelineId

IsDefault

AutoErrorResponse

次の列が削除されました。

XsltFilePath

SchemaRecId

PipelineId

DataPolicySynchronized

ActionId フィールドは新しい ActionId で更新され、InboundPipelineId フィールドと

OutboundPipelineId フィールドは、エンドポイントアクションポリシーに関連付けられている

パイプラインがある場合に更新されます。



AifEndpointActionParameterSchema


EndpointId

ActionId

ParameterClassId

SchemaRecId

DataPolicySynchronized

データアップグレードプロセスは、AifEndpointActionPolicy テーブル内の各レコードについて、

このテーブルにレコードを作成します。フィールド EndpointId、ActionId、SchemaRecId、およ

び DataPolicySynchronized は、すべて AifEndpointActionPolicy テーブルから更新されます。

ParameterClassId は、シリアライズ可能なデータオブジェクトの ID に設定されます。

AifDataPolicyXPath


DocumentClassId

ActionId は、アップグレードされたアクションの新しい ActionId に更新されます。

DocumentClassId は、SerializableClassId に設定されます。

AifXmlTransformConfig


ParameterName

データアップグレードプロセスは、ParameterName フィールドをサービス工程のパラメータ名に

設定します。

AifValueSubstitutionComponentConfig


PipelineComponentRecId

ParameterName

データアップグレードプロセスは、AifValueSubstitutionConfig テーブル内の各レコードにつ

いて、このテーブルにレコードを追加します。ParameterName フィールドは、サービス工程のパラ

メータ名に設定されます。PipelineComponentRecId フィールドは、AifValueSubsititutionConfig

テーブルの PipelineComponentRecId フィールド値に設定されます。



アップグレードされないデータ

アップグレードされていない ActionId を使用するようにコンフィギュレーションされているデ

ータは、次の表に従って移動されます。

テーブル名移動先のテーブル名

AifAction DEL_AifAction

AifDataPolicy DEL_AifDataPolicy

AifDataPolicyXpath DEL_AifDataPolicyXpath

AifEndpointActionPolicy DEL_AifEndpointActionPolicy

AifEndpointActionValueMap DEL_AifEndpointActionValueMap

AifPipeline DEL_AifPipeline

AifPipelineComponent DEL_AifPipelineComponent

AifSchemaStore DEL_AifSchemaStore

AifValueSubstitutionConfig DEL_AifValueSubstitutionConfig

AifWebsites DEL_AifWebsites

AifWebsites テーブルはアップグレードされず、以前のバージョンで作成された Web サイトは

DEL_AifWebsites テーブルに格納されます。Microsoft Dynamics AX 2009 では、管理者が Web

サイトを手動で追加する必要があります。詳細については、『サーバーおよびデータベース管理』

ヘルプの「ドキュメント交換用の Web サイトの構成」を参照してください。

スキーマの変更

Microsoft Dynamics AX 2009 では、メッセージとドキュメントのスキーマが変更されました。ア

ップグレード後に、次の手順に従って AIF サービスを更新する必要があります。

1. [基本設定]、[設定]、[アプリケーション統合フレームワーク]、[サービス] の順にクリックし

ます。

2. [更新] をクリックします。

次の表に示すように、AIF のメッセージの形式と内容を定義するさまざまなスキーマがあります。






スキーマ説明

メッセージスキーマメッセージメタデータの形式と内容を定義しま

す。これには、エンベロープ、ヘッダー、クエリ

基準、エンティティキーの一覧などの要素があ

ります。メッセージスキーマは、Microsoft

Dynamics AX に含まれています。詳細につい

ては、Microsoft Dynamics AX Developer ヘル

プのメッセージ XSD およびスキーマに関する

トピックを参照してください。

ドキュメントスキーマメッセージ内のビジネスデータの形式と内容

を定義します。このスキーマには、データ交換

に参加できるすべてのフィールドが含まれま

す。AIF に送信されるメッセージは、ドキュメ

ントスキーマに対して検証する必要があり

ます。

エンドポイントスキーマ特定のエンドポイントのデータ交換に参加でき

るドキュメントスキーマフィールドをさらに

制限します。エンドポイントスキーマは、各

エンドポイントアクションに対して設定した

データポリシーによって定義されます。

これらのスキーマ変更により、着信 AIF メッセージを作成する外部システムは、新しいスキーマ

に従ってメッセージを正しく書式設定するように変更する必要があります。送信 AIF メッセージ

のデータに依存する外部システムは、送信データ内の変更を処理するように変更する必要があり

ます。

メッセージスキーマ

着信メッセージ内のメッセージスキーマ要素は、<Microsoft Dynamics AX インストールディレ

クトリ>Application\Share\Include にある新しいメッセージスキーマに対して検証する必要があ

ります。詳細については、Microsoft Dynamics AX Developer ヘルプの AIF メッセージおよびメ

ッセージ XSD に冠するトピックを参照してください。

ドキュメントスキーマ

ドキュメントスキーマは変更され、ビジネスデータを含む着信メッセージは、新しいスキーマ

に対して検証するように変更する必要があります。また、ビジネスデータを含む送信メッセー

ジは、新しいスキーマに対して検証するように書式設定される必要があります。詳細については、

Microsoft Dynamics AX Developer ヘルプのスキーマおよびドキュメントスキーマの概要に関す

るトピックを参照してください。



スキーマ変更の結果として、パイプライン変換で使用される XSLT を更新することが必要な場合

があります。XSLT を更新した後で、[基本設定]、[設定]、[アプリケーション統合フレームワー

ク]、[XSLT レポジトリ] の順にクリックして、再インポートできます。[基本設定]、[設定]、[ア

プリケーション統合フレームワーク]、[値のルックアップ] の順にクリックすることで実行できる

値のルックアップの更新も必要な場合があります。

エンドポイントスキーマ

エンドポイントスキーマは、エンドポイントアクションデータポリシーとも呼ばれます。アッ

プグレード後に、ドキュメントスキーマの変更は、既存のエンドポイントデータポリシーに反

映されません。ドキュメントスキーマ内の新しい要素は、必須の要素でない限り、データポリ

シー内でオフになります。AIF 管理者は、既存のエンドポイントアクションポリシーを変更し、

必要に応じてデータポリシーに新しい要素を追加する必要があります。詳細については、『サ

ーバーおよびデータベース管理』ヘルプの「エンドポイントアクションデータポリシーの構成」


アップグレードの後に

AIF ドキュメントサービスの更新

AIF ドキュメントサービスを呼び出すには、サービスを更新する必要があります。

1. [基本設定]、[設定]、[アプリケーション統合フレームワーク]、[サービス] の順にクリックし

ます。

2. [更新] をクリックしてサービスを読み込みます。サービスの読み込み中に遅延が発生する場

合があります。

詳細については、『サーバーおよびデータベース管理』ヘルプのサービスの構成に関するトピッ

クを参照してください。

ユーザーのアクセス許可

AIF テーブルに対する表示アクセス許可がすべてのソースエンドポイントユーザーに付与され

ていることを確認してください。







コードのアップグレード : 例

このトピックでは、次の 2 つのコードアップグレードシナリオについて説明します。

シナリオ 1 : CustTable テーブルのアップグレード

コードの変更では、通常、既存のテーブルに 1 つ以上のフィールドが追加されます。

シナリオ 2 : VendTable フォームのアップグレード

もう 1 つの一般的な変更は、既存のフォームへのボタンの追加です。

テーブルオブジェクトとフォームオブジェクトではアップグレード時の扱いが異なるため、

別の例で説明します。

フォーム (およびレポート) は、1 つのエンティティとして設計されています。したがって、フォ

ームに変更を加えた場合は、ボタンの追加かメソッドの変更かにかかわらず、フォーム全体を更

新する必要があります。

その他の種類のアプリケーションオブジェクト (テーブル、クラス、メニューなど) はすべて、

アプリケーションオブジェクトツリー (AOT) のノードとして表示されるいくつかのコンポーネ

ントで構成されています。1 つのテーブルメソッドのみが変更されている場合、アップグレード

プロセスで考慮されるのはそのメソッドだけです。

以下のシナリオで使用されているフィールド名と数は架空の例であり、必ずしも現実の状況に対

応するものではありません。これらの例では SYS レイヤと USR レイヤが使用されますが、

これらとは別のレイヤが変更される場合もあれば、複数のレイヤが変更される場合もあります。



シナリオ 1 : CustTable テーブルのアップグレード

このシナリオでは、Microsoft Dynamics AX 3.0 の既存のインストールに対するアップグレード

として Microsoft Dynamics AX がインストールされています。

SYS レイヤでは、CustTable に A と B の 2 つのフィールドがあります。

SYS レイヤでは、CustTable に A、B、C、および D の 4 つのフィールドがあります。

つまり、新しいバージョンには 2 つのフィールドが追加されています。

USR レイヤでは、CustTable に CompanyLogo という 1 つのフィールドがあります。

USR レイヤでは、CustTable に CompanyLogo という 1 つのフィールドがあります。

USR レイヤは、新しいバージョンと古いバージョンで同じです。

CustTable テーブルの各フィールドに更新プロジェクトの作成のアルゴリズムを適用した場合、

フィールド A と B は無視されます。これらのフィールドは Microsoft Dynamics AX 3.0 に存在し

ているため、アップグレードは必要ないからです。

新しいフィールドである C と D についても同様です。これらのフィールドは前のバージョンに

は存在していないため、前のバージョンからの変更はありません。したがって、アップグレード

は必要ありません。

同様に、CompanyLogo フィールドもアップグレードに関係ありません。前のバージョンとの競

合がないからです。

CustTable テーブルに対する更新プロジェクトの作成の最終的な結果では、このテーブルは、解決

する必要がある競合がないため、アップグレードプロジェクトに含まれません。Microsoft

Dynamics AX では、CustTable に 5 つのフィールドがあります (SYS レイヤに 4 つ、USR レイ

ヤに 1 つ)。



シナリオ 2 : VendTable フォームのアップグレード

最初のシナリオと同様に、Microsoft Dynamics AX 3.0 の既存のインストールに対するアップグ

レードとして Microsoft Dynamics AX がインストールされています。

VendTable フォームが SYS レイヤに存在します。

SYS レイヤで、VendTable フォームに Y という追加のボタンが新しいバージョンで追

加されています。

VendTable フォームは USR レイヤにも存在し、ボタン X が追加されています。

VendTable フォームは USR レイヤにも存在し、ボタン X が追加されています。新し

いバージョンと古いバージョンは同じです。

前述したように、更新プロジェクトの作成のアルゴリズムは VendTable フォーム全体に適用さ

れます。その結果、このフォームはアップグレードプロジェクトに追加されます。

このフォームは 2 つのレイヤで変更されているため、競合が発生する可能性があります。このフ

ォームをアップグレードプロジェクトに追加して、手動で競合を調査して解決する必要があり

ます。



フォームのシナリオのバリエーション

Microsoft Dynamics AX 3.0 用の "修正プログラム" (重大な問題を引き起こす問題に対して迅速に

送信されるプログラム) が適用されている場合、フォームのシナリオのバリエーションが生じま

す。その修正プログラムを含む .xpo ファイルがインポートされると、フォームが USR レイヤに

追加されます。Microsoft Dynamics AX 2009 のリリースでは、その修正プログラムが標準のアプ

リケーションの一部として実装されています。

フォーム A が SYS レイヤに存在します。

フォーム A が SYS レイヤに存在します (古い SYS レイヤのバージョンとは異なる新し

いバージョンのフォーム A)。

変更されたバージョンのフォーム A が USR レイヤに存在します。

変更されたバージョンのフォーム A が USR レイヤに存在します。

次の図に、修正プログラムを実装する場合の意思決定ツリーを示します。

新しい SYS レイヤと新しい USR レイヤのフォーム A は同じであるため、USR レイヤのフォー

ム A は廃止となり、削除されます。



コードのアップグレードに関する追加情報

ここでは、コードアップグレードプロセスを正常に完了するために役立つ追加情報を提供しま

す。手順を開始する前に以下の各セクションを最後までお読みください。

空のデータベースでのコードアップグレードプロセスの実行

コードアップグレードの間にデータの心配をしなくても済むように、空のデータベースでコー

ドアップグレードプロセスを実行すると有効な場合があります。

1. Microsoft Dynamics AX 2009 をインストールし、セットアップウィザードを使用して新しい

Microsoft SQL Server データベースを作成します。詳細については、インストールガイドの

「Create a Microsoft SQL Server database using the Setup wizard (セットアップウィザード

を使用して Microsoft SQL Server データベースを作成する)」を参照してください。

2. インストールが完了したら、Windows エクスプローラを開いて、アプリケーションファイ

ルインストールフォルダを参照します。既定の場所は、C:\Program Files\Microsoft

Dynamics AX\50\Application\Appl\DynamicsAx1 です。

3. アプリケーションファイルインストールフォルダに、Old という名前のフォルダを作成し

ます。

4. 前のバージョンの AOD ファイル (*.AOD) とラベルファイル (*.ALD、*.ALI) を、必要に応じ

て Old フォルダにコピーします。

5. 前のバージョンの、DIS レイヤの外側の AOD ファイル (axbux.aod、axvar.aod、axcus.aod、

axusr.aod、およびパッチレイヤ (存在する場合) の axbup.aod、axvap.aod、axcup.aod、

axusp.aod) と、関連するラベルファイル (*.ald、*.ali) を、アプリケーションファイルイン

ストールフォルダにコピーします。

メモ :

BUS/BUP レイヤは、通常はサードパーティの追加製品のために予約されているた

め、axbus.aod ファイルと axbup.aod ファイルはコピーしないことをお勧めします。

Microsoft Dynamics AX 2009 向けに認定されている同じアプリケーションの新しい

バージョンをインストールしてください。

6. AOS サービスを開始します。サービスが開始されるまでに時間がかかる場合があります。

AOS サービスにより、現在のアプリケーションファイルインストールフォルダと、手順 3.

で作成した Old フォルダに、axapd.aoi ファイルが作成されます。



一度に 1 つのレイヤの比較

一度に比較するコードレイヤは 1 つだけにすることをお勧めします。たとえば、追加レイヤが

3 つある場合は、最も内側のレイヤから最も外側のレイヤへという順に作業して、各レイヤのア

ップグレードプロジェクトを作成します。

メモ :

SYS レイヤが最も内側のレイヤと見なされます。レイヤの構造は、内側から外側へ、

SYS、GLS、LOS、DIS、BUS、VAR、CUS、USR、各レイヤに関連付けられているパ

ッチレイヤ、という形になります。

各レイヤの作業を進めていきながら、内側のレイヤから外側のレイヤに新しいコードを昇格するか、

有効でなくなったコードを削除する必要があります。

各レイヤで次の手順を実行します。すべてのアップグレードプロジェクトの処理が完了すると、

データをアップグレードできるようになります。

1. 前の手順の手順 1. ～ 5. を実行します。

2. AOS サービスを開始します。サービスが開始されるまでに時間がかかる場合もあります。

AOS サービスにより、現在のアプリケーションフォルダと、先ほど作成した Old フォルダ

に、AXAPD.AOI ファイルが作成されます。

3. クライアントコンフィギュレーションツールを開きます。手順 5. でアプリケーションフォ

ルダにコピーしたレイヤファイルに対応するレイヤにログインするようにしてください。

4. インストールチェックリストを起動します (初回のみ)。

5. コードのアップグレードの競合の検出ツールを起動します (Microsoft Dynamics AX メニュー、

[ツール]、[開発ツール]、[コードのアップグレード]、[コードのアップグレードの競合の検出]

の順に選択)。

6. そのレイヤのアップグレードプロジェクトを実行します。

7. AOS を停止して、現在のレイヤファイル (ax*.aod) をバックアップします。

8. 現在のレイヤのすぐ外側のレイヤで、手順 5. ～ 12. を繰り返します。

前のバージョンの複数のレイヤの 1 つのレイヤファイルへの統合

前のバージョンの Microsoft Dynamics AX で、アプリケーションに複数のレイヤファイルが含ま

れている場合は、複数のレイヤの機能を 1 つのレイヤに統合することができます。前のバージョ

ンのレイヤを統合すると、Microsoft Dynamics AX 2009 へのアップグレードが容易になります。



また、アップグレードの前にレイヤを統合すると、現在使用しているアップグレード前の

Microsoft Dynamics AX の変更されているインストールで、マージされたレイヤの機能を既知の

データやプロセスに対してテストして、コードが正常に機能することを確認できます。さらに、

将来サービスパックがリリースされたときに、その変更を外側のレイヤに反映するために比較

するレイヤの数が減るため、将来の保守も容易になります。

メモ :

オブジェクトをレイヤ間で移動すると、オブジェクト ID の問題が発生することがありま

す。場合によっては、アップグレードスクリプトやアップグレードジョブを作成して、

Microsoft Dynamics AX 2009 データモデルを調整する必要があります。詳細については、

ホワイトペーパー「How to Write Data Upgrade Scripts (データアップグレードスクリ

プトを記述する方法)」(http://go.microsoft.com/fwlink/?LinkId=115169&clcid=0x409) を参


最も簡単なアプローチの実行

自分で加えたコードの変更を評価します。その変更に基づく機能が Microsoft Dynamics AX 2009

にない場合は、その変更を Microsoft Dynamics AX 2009 に再度実装する必要があると考えられ

ます。

そのカスタマイズに似た機能が Microsoft Dynamics AX 2009 に新たに追加されている場合は、

そのカスタマイズを削除して、その仕様に合わせて既存の機能を変更することができます。

これは、使用されなくなった機能を削除するための良い機会にもなります。

すべてのレイヤの表示

[すべてのレイヤを表示] の設定 (Microsoft Dynamics AX メニュー、[ツール]、[オプション]、[開発]

タブ、[アプリケーションオブジェクトレイヤ] の順に選択) を使用して、オブジェクトが存在す

るすべてのレイヤを開発者が表示できるようにします。

プロダクトビルダを使用する場合

プロダクトビルダを使用する予定の場合は、プロダクトビルダによって AOT に作成されるクラ

ス専用のレイヤを用意することを検討してください。Microsoft Dynamics AX 3.0 には、パフォー

マンス向上のためにプロダクトビルダが AOT にコードを書き込めるようにするオプションがあ

りました。Microsoft Dynamics AX 4.0 以降では、この機能が必須になっています。

プロダクトビルダのコード専用のレイヤを用意すると、プロダクトビルダで問題が発生してレ

イヤファイルが破損した場合に役に立ちます。プロダクトビルダが使用するレイヤに、システ

ムに対するカスタマイズが含まれていなければ、そのレイヤが破損したとしても、そのレイヤの

バックアップを復元し、AXAPD.AOI ファイルを再作成して、AOS を再起動するだけで、簡単に

修正できます。プロダクトビルダ専用のレイヤのバックアップがなかったとしても、AOS を停

止して、レイヤファイルを削除し、AXAPD.AOI ファイルを削除して、AOS を再起動すれば、

Microsoft Dynamics AX が再び機能するようになります。

http://go.microsoft.com/fwlink/?LinkId=115169&clcid=0x409).



基本コードの変更の削減 (可能な場合)

変更を加える際には、なるべく基本クラスは変更しないようにします。代わりに、新しいメソッ

ドを作成したり、基本クラスを継承する新しいクラスを作成したりして、基本クラスを拡張しま

す。これにより、サービスパックやメジャーバージョンアップグレードがリリースされた場合

に、そのスタンドアロンのコードが変更による悪影響を受けることはなくなります。この場合、

基本クラスに加える必要がある変更は、作成した新しい機能の単純な呼び出しだけです。多数の

異なるメソッドの内部のコードを反映して目的の機能を再実装する場合に比べると、実装やアッ

プグレードがはるかに簡単になります。



データアップグレードに関する追加情報

このセクションでは、データアップグレードについて、さらに説明します。この情報は、

Microsoft Dynamics AX 2009 へのアップグレード時に役立ちます。

データアップグレードが必要となる場合

データアップグレードが必要となるのは、次のような場合です。

テーブルの削除時にデータを保存する必要がある場合

フィールドの削除時にデータを保存する必要がある場合

固有インデックスを追加または変更する場合

固有でないインデックスを固有インデックスに変更する場合

データの格納場所を移動する場合 (フィールドのデータを別のフィールドに移動する場合など)

古いデータの不整合を修正する場合

新しいフィールドに既存のデータを入力する必要がある場合

データアップグレードプロセスのトリガ

Microsoft Dynamics AX 2009 は SYSSETUPLOG テーブルに情報が格納されているかどうかを確

認します。テーブルに情報が含まれていない場合、Microsoft Dynamics AX の新しいインストー

ルが実行されるものと見なされて、[インストールのチェックリスト] が表示されます。

SYSSETUPLOG テーブルに情報が含まれている場合、Microsoft Dynamics AX は、SQL スクリ

プト SELECT LASTONLY FROM SYSSETUPLOG に似たスクリプトを実行します。スクリプト

から返される情報には、最後に正常に起動された製品バージョン、アプリケーションのビルド値、

およびカーネルのビルド値が含まれます。これらの値がすべて現在のインストールに一致する場

合、Microsoft Dynamics AX 2009 は通常どおり起動します。いずれかの値が異なる場合、[アッ

プグレードのチェックリスト] が表示されます。

データの手動アップグレードが必要となる場合

削除または移動されたテーブルやフィールドのデータに依存するテーブルやフィールドを新しく

作成した場合、データを手動でアップグレードする必要が生じることがあります。

削除されたテーブルやフィールドを探すには、先頭に DEL_ が付いているアプリケーションオ

ブジェクトを検索します。



削除されたテーブルおよびフィールド

Microsoft Dynamics AX 2009 へのアップグレード時に、以前のバージョンのオブジェクトが削除

される場合があります。このようなオブジェクトには DEL_ という接頭語が付与され、特定のコ

ンフィギュレーションキーに割り当てられます。これらのコンフィギュレーションキー ([更新

オブジェクト 4.0 の保存] および [更新オブジェクト 4.1 の保存]) が "コンフィギュレーション" フ

ォーム ([管理]、[設定]、[システム]、[コンフィギュレーション] の順に選択) で選択されていない

場合、コンフィギュレーションキーに割り当てられたオブジェクトは削除されます。テーブル

やフィールドは、データベースから手動で削除しないでください。

データアップグレード時の名前を変更したアプリケーションオブジ

ェクトの扱い

Microsoft Dynamics AX のテーブルとフィールドは、名前ベースではなく ID ベースです。つまり、

これらには固有 ID コードがあるため、データアップグレードプロセスで問題が生じることはあ

りません。名前を変更したアプリケーションオブジェクトが原因となってデータアップグレー

ドに問題が生じるのは、X++ コードでそのオブジェクトを参照している場合だけです。名前を変

更したアプリケーションオブジェクトを X++ コードで参照している場合、アップグレードプロ

セス時にコンパイルエラーが発生することがあります。その場合、正常にコンパイルするため

には、正しいオブジェクトを使用するようにコードを変更する必要があります。

データアップグレード時の削除されるアプリケーションオブジェク

トの扱い

データアップグレードプロセスでは、Microsoft Dynamics AX 2009 バージョンで削除されるテ

ーブルなどのアプリケーションオブジェクトを表す特別な接頭語として、DEL_ を使用します。

DEL_ のテーブルとフィールドがデータアップグレードに必要なのは、"古い" テーブル構造をデ

ータアップグレードが完了するまで維持して、データが失われないようにする必要があるため

です。

Microsoft Dynamics AX 2009 のスキーマ変更のため、または独自の変更を変更したために、

DEL_ 接頭語を持つオブジェクトが使用された場合、標準アプリケーション内で Microsoft

Dynamics AX 2009 のアップグレードスクリプトによって変更が処理されます。たとえば、

ReleaseUpdateDB_<旧バージョン>to<新バージョン> クラスによって、フィールドと X++ コー

ドが、DEL_ 接頭語を持つテーブルの代わりとなるテーブルに移動された場合です。

SysDeletedObjects30 と SysDeleteObjects40 のコンフィギュレーションキーは、DEL_ 接頭語

を持つアプリケーションオブジェクトに割り当てられます。

メモ :

DEL_ 接頭語を持つアプリケーションオブジェクトを X++ コードで参照している場合、

既存の変更を再評価して、DEL_ オブジェクトの代わりとなる新しいオブジェクトを使

用するように更新する必要があります。

Microsoft Dynamics AX 2009 アップグレード...

Documents

Transcript of Microsoft Dynamics AX 2009 アップグレード...