非推奨の API

この記事では、非推奨の API の一覧と、非推奨の API の一部の移行ガイダンスを示します。

Overview

この記事では、Dynamics AX 2012 の非推奨の API を特定します。 廃止の理由はさまざまです。 ほとんどの場合、理由は次のいずれかです。

  • 新しいクライアントには適していません。
  • パフォーマンスが低下します。
  • Chatty (サーバーとクライアントの間で送受信されるトラフィックの多くが発生します)。
  • 冗長 (フレームワークは自動的にこれらを処理するようになりました)。

テーブルの下の
廃止の理由見出し、「クライアント」は Web クライアントを参照します。

非推奨 API のリスト

オブジェクト タイプ Name Notes
ActionPane Method tabChanged ActionPanes (または ActionPanes の内部コントロール) への更新は、タブが有効になったときではなく、行が有効になったときに実行される必要があります。
ActionPaneTab Method selectionChanged ActionPaneTabs (または ActionPaneTabs の内部コントロール) への更新は、タブが有効になったときではなく、行が有効になったときに実行される必要があります。
ボックス Method yesNoTextMenu-
LinkText
ComboBox Method getEditText Overview
N/A
非推奨の理由
冗長。
移行のメモ
代わりに getText を使用します。
DataSet DataSetNode DataSetRun クラス Overview
Dynamics AX 2012 のエンタープライズ ポータルで使用されます。
非推奨の理由
クライアントでは適用されません。



移行のメモ
コードからこれらの API への呼び出しを削除します。

DataSourceMethodInfo
DataSourceMethodInfoList
クラス
DDEClient DDEServer DLL DLLFunction HDC HWnd スレッド WinAPINative WinGDI クラス Overview
N/A
非推奨の理由
Dynamics AX 2012 Windows クライアントに固有であり、クライアントと互換性がありません。
移行のメモ
コードからこれらの API の使用を削除します。
DocumentManagement-
ヘルパー
クラス
Form Method addhistory
currentHistoryName
currentHistoryState
updateHistory
Overview
Dynamics AX 2012 のアドレス バーで使用されます。
非推奨の理由
クライアントのナビゲーション モデルが変更されました。

移行のメモ
コードからこれらの API への呼び出しを削除します。
Form Method arrange
Form Method controlCallingMethod
Form Method controlMethod-
Overload controlMethod-
OverloadObject
Overview
Dynamics AX 2012 でオーバーライド メソッドを登録するのに使用します。
非推奨の理由
これは、オーバーライド メソッドを登録するためのクリーンで推奨された方法ではありません。

移行のメモ
代わりに registerOverrideMethod を使用します。
Form Method コピー、切り取り、貼り付け
Form Method delAutoCompleteString getAutoCompleteString setAutoCompleteString Overview
Dynamics AX 2012 で、自動候補の設定、取得、削除に使用されます。
非推奨の理由
Dynamics AX 2012 Windows クライアントに固有です。
移行のメモ
コードからこれらの API への呼び出しを削除します。
Form Method firstField
Form Method formOnTop Overview
Dynamics AX 2012 で、ウィンドウとナビゲーションを管理するために使用されます。
非推奨の理由
クライアントには新しいナビゲーション モデルがあります。
移行のメモ
コードからこれらの API への呼び出しを削除します。
Form Method hWnd installMessageProc removeMessageProc Overview
N/A
非推奨の理由
Dynamics AX 2012 Windows クライアントに固有であり、クライアントと互換性がありません。
移行のメモ
コードからこれらの API の使用を削除します。
Form Method isPreloadedInstance Overview
Dynamics AX 2012 のプリロードで使用されます。
非推奨の理由
プリロードは、クライアントでは適用されません。
移行のメモ
コードからこれらの API への呼び出しを削除します。
Form Method 最後のフィールド 次のフィールド 次のグループ 前のフィールド 前のグループ
Form Method ロック
lockWindowUpdate
unLock
Overview
これらのメソッドは、一連の UI 更新を実行する際にウィンドウの再描画を防止するために使用されていました。 これらのメソッドがないと、個々の変更に応じてウィンドウが再描画され、エンド ユーザー エクスペリエンスが低下し、パフォーマンスが低下します。
非推奨の理由
これらのメソッドは Windows クライアントに固有のもので、クライアントにとって必要ではなくなりました。
移行のメモ
コード アップグレード規則により、これらの API の出現箇所が削除されます。 コードからこれらの API への任意の呼び出しを安全に削除することができます。
Form Method print printPreview send Overview
Dynamics AX 2012 でフォームの自動レポート生成をオーバーライドするのに使用
非推奨の理由
Microsoft 365 統合では、クライアントでの強化されたユーザー エクスペリエンスが用意されています。 Dynamics AX クライアント フォームのユーザーは、"エクスポート" 機能を使用できます。
移行のメモ
コードからこれらの API への呼び出しを削除します。
Form Method 再振出
resetStatusBar-
BackgroundColor
setStatusBar-
BackgroundColor
sysColorChanged
Overview
スタイルや色を制御するのに使用します。
非推奨の理由
一貫したビジュアルを実現するために API を通じて色を指定する開発者向けの機能を削除します。
移行のメモ
コードアップグレードルールは、再描画 API の出現箇所を削除します。 コードからこれらの API の使用を削除します。
Form Method リロードする
Form Method resetSize Overview
このメソッドは、コントロールがフォームに追加または削除され、サイズが変更されたときに使用されました。 これを指定しないと、追加または削除されたコントロールを考慮するようにウィンドウのサイズが正しく設定されていない可能性があります。
非推奨の理由
これらのメソッドは Windows クライアントに固有のもので、クライアントにとって必要ではなくなりました。
移行のメモ
コードからこれらの API への任意の呼び出しを安全に削除することができます。
Form Method サイズ変更
FormActiveXControl
FormAnimateControl
FormBuildActiveXControl
FormBuildAnimateControl
FormBuildManaged-
HostControl
FormBuildSegmented-
EntryControl FormManagedHostControl
FormSegmented-
EntryControl
クラス Overview
これらは、Dynamics AX 2012 のさまざまなカスタム コントロールをホストまたは作成するために使用されました。
非推奨の理由
これらのテクノロジは、クライアントでは機能しません。
移行のメモ
アプリケーション開発者は、コントロール拡張機能を使用して、必要に応じ代替コントロールを構築する必要があります。
FormControl Method beginDrag
dragDrop
dragLeave
dragOver
dragOverEx
dragText
削除
dropEx
dropFile
endDrag
Overview
Dynamics AX 2012 でドラッグ アンド ドロップのシナリオを有効にするために使用しました。
非推奨の理由
ドラッグ アンド ドロップのシナリオは、クライアントではサポートされていません。
移行のメモ
コードからこれらの API の使用を削除し、ドラッグ アンド ドロップ機能への依存がないシナリオが有効になるようにリファクタリングします。
FormControl Method calcControlSize
FormControl Method command processBase processForm processLink processPicture processTitle Overview
Dynamics AX 2012 では廃止としてマークされました。
非推奨の理由
N/A
移行のメモ
コードからこれらの API への呼び出しを削除します。
FormControl Method コンテキスト コンテキストメニューを表示 Overview
このメソッドは、コントロールがフォームに追加または削除され、サイズが変更されたときに使用されました。 これを指定しないと、追加または削除されたコントロールを考慮するようにウィンドウのサイズが正しく設定されていない可能性があります。
非推奨の理由
これらのメソッドは、Windows クライアントに固有の API に依存していました。
移行のメモ
代わりに getContextMenuOptions および selectedMenuOptions を使用します。
FormControl Method コピー、切り取り、貼り付け
FormControl Method dateTextChange
FormControl Method editControl
FormControl Method hasControl-
PositionOverride
FormControl Method helpField
FormControl Method hWnd Overview
N/A
非推奨の理由
Dynamics AX 2012 Windows クライアントに固有であり、クライアントと互換性がありません。
移行のメモ
コードからこれらの API の使用を削除します。
FormControl Method inputSearch
FormControl Method itemChanging
FormControl Method keyDown
FormControl Method labelMouseDblClick
mouseDblClick
Overview
he FormControl.labelMouseDblClick (int x、int y、int ボタン、Boolean Ctrl, Boolean Shift) メソッドは、コントロールのラベルがダブルクリックされたときに呼び出されます。 マウス ポインターの x 座標、y 座標、クリックされたマウス ボタンを示すブール値、Ctrl キーと Shift キーが押されたかどうかを示すブール値を提供します。 he FormControl.mouseDblClick (int x、int y、int ボタン、Boolean Ctrl, Boolean Shift) メソッドは、labelMouseDblClick メソッドへの関数と似ています。 違いは、(ラベルだけでなく) ダブルクリックがあるたびにこのメソッドが呼び出されるということです。
非推奨の理由
ダブルクリック アクションは、Web ベースのアプリケーションやタッチベースのシナリオにうまく変換されません。 また、多くのインスタンスで短くなり終了する可能性があります。
移行のメモ
これらのメソッドに推奨される代替は、ボタンとクリックされたイベントを使用することです。
FormControl Method labelMousedown labelMouseup mouseDown mouseEnter mouseLeave mouseMove mouseUp Overview
マウス イベントを検出したり応答したりするのに使用します。
非推奨の理由
これらの方法はタッチスクリーンに優しくなく、アプリケーションクライアントではサポートされていません。
移行のメモ
コードからこれらの API の使用を削除し、マウス イベントへの依存がないシナリオが有効になるようにリファクタリングします。
FormControl Method onHScroll onVScroll
FormControl Method paint
FormControl Method prefColumnSize Overview
Dynamics AX 2012 で幅と高さを制御するために使用
非推奨の理由
クライアントでは適用されません。
移行のメモ
代わりに幅と高さを明示的に設定します。
FormControl Method selectionChanging
FormControl Method setScrollInfo
FormControl Method size
FormControl Method updateWindow
FormControl / FormDesign 財産 AcquireFocus
FormControl / FormDesign 財産 ActiveBackCol ActiveBackColor ActiveBackColorRGB ActiveForeColor ActiveForeColorRGB AlternateRowShading BackgroundColor BackgroundColorRGB BackStyle BackStyleRGB CharacterSet ColorScheme DrawFocusRect ForegroundColor ForegroundColorRGB GridLines GridLinesStyle PromptRect Overview
スタイルや色を制御するのに使用します。
非推奨の理由
一貫したビジュアルを実現するために API を通じて色を指定する開発者向けの機能を削除します。
移行のメモ
コードからこれらの API の使用を削除します。
FormControl / FormDesign 財産 AlignChild AlignChildren AlignControl 境界線 BottomMargin BottomMarginMode ColumnSpace ColumnSpaceMode ColumnSpaceValue 左 LeftMargin LeftMarginMode LeftMode RightMargin RightMarginMode SizeHeight SizeWidth TabAppearance TabAutoChange TabLayout TabMode TabPlacement 上 TopMargin TopMarginMode TopMode VerticalSpacing VerticalSpacingMode VerticalSpacingValue Overview
レイアウトを制御するのに使用します。
非推奨の理由
このプロパティを使用して一貫性のあるレイアウトを実現するレイアウトを制御するための開発者向けの機能を削除します。


移行のメモ
コードからこれらの API の使用を削除します。 代わりにスタイルまたは CSS を使用します。

FormControl / FormDesign 財産 AllowDocking AlwaysOnTop ArrangeGuide ArrangeWhen ContainerScroll-
HorizontalOffset ContainerScroll-
垂直オフセット IMEモード 最大化ボックス 最小化ボックス モード 必要なアクセスレベル 進捗タイプ 保護対象 セキュリティキー ステータスバーのスタイル ウィンドウのリサイズ
Overview
N/A
非推奨の理由
Dynamics AX 2012 Windows クライアントに固有であり、必要はなくなりました。
移行のメモ
コードからこれらの API の使用を削除します。
FormControl / FormDesign 財産 太字
FormControl / FormDesign 財産 CanScroll
FormControl / FormDesign 財産 無効化された画像 無効化された画像の場所 無効化されたリソース
FormControl / FormDesign 財産 DisplayTarget HyperLinkDataSource HyperLinkMenuItem SaveFilter SaveSize Overview
Dynamics AX 2012 のエンタープライズ ポータルで使用
非推奨の理由
クライアントでは適用されません。
移行のメモ
コードからこれらの API への呼び出しを削除します。
FormControl / FormDesign 財産 フォント
FormControl / FormDesign 財産 フォント サイズ
FormControl / FormDesign 財産 フレーム FramePosition Overview
N/A
非推奨の理由
開発者がメタデータを使用してフレームを制御する機能を削除しました。
移行のメモ
コードからこれらの API の使用を削除します。
FormControl / FormDesign 財産 ツールバーを隠す 水平スクロールバー表示 スクロールバー 垂直スクロールバー表示 Overview
N/A。
非推奨の理由
開発者がメタデータを通じてスクロール バーを制御する機能を削除しました。
移行のメモ
コードからこれらの API の使用を削除します。
FormControl / FormDesign 財産 ImageMode
FormControl / FormDesign 財産 画像名
FormControl / FormDesign 財産 ImageResource
FormControl / FormDesign 財産 斜体
FormControl / FormDesign 財産 LabelAlignment
FormControl / FormDesign 財産 LabelBold
FormControl / FormDesign 財産 LabelCharacterSet
FormControl / FormDesign 財産 LabelFont
FormControl / FormDesign 財産 LabelFontSize
FormControl / FormDesign 財産 LabelForegroundColor LabelForegroundColorRGB
FormControl / FormDesign 財産 LabelGuide
FormControl / FormDesign 財産 LabelHeight LabelHeightMode LabelHeightValue
FormControl / FormDesign 財産 LabelItalic
FormControl / FormDesign 財産 LabelUnderline
FormControl / FormDesign 財産 ラベル幅 ラベル幅モード ラベル幅値
FormControl / FormDesign 財産 場所
FormControl / FormDesign 財産 NormalResource
FormControl / FormDesign 財産 ParentPage
FormControl / FormDesign 財産 入力後に検索 検索モード
FormControl / FormDesign 財産 SelectControl
FormControl / FormDesign 財産 SendExternalContext
FormControl / FormDesign 財産 ShortKey
FormControl / FormDesign 財産 下線
FormDataRow クラス
FormDataSource 財産 autoNotify Overview
Dynamics AX 2012 で非推奨としてマークされています。
非推奨の理由
N/A
移行のメモ
コードから使用を削除します。
FormDataSource Method cacheOnlyMode
FormDataSource Method cacheRemoveRecord
FormDataSource Method defaultMark
FormDataSource Method findRecord findValue 使用方法
FormDataSource.findRecord (共通レコード) メソッドは、データ ソース内の特定のレコードを検索し、現在のレコードにします。 FormDataSource.findValue(FieldId field, str value) メソッドは、データ ソース内の特定のフィールド内の特定の値を検索し、対応するレコードを現在のレコードにします。 これに FormDataSource.findRecord メソッドを使用します。
非推奨の理由
これらのメソッドは、線形検索を使用し、メモリ内の多数のレコードをロードし、パフォーマンスに悪影響を与えます。
移行のメモ
新しい API で置き換えます。 positionToRecord and findValue を持つ findRecord を positionToRecordByValue に置き換えます。 新しい API は、特に一時テーブルとビューでは機能しない場合があります。 このような場合、フレームワークは例外をスローします。 新しい API に置き換えることができない場合は、 element.args().lookupRecord(recordToFind) の後に FormDataSource.research(false)を 呼び出すことが推奨されます。FormDataSource は、検索するレコードを含むデータ ソースです。 false引数をresearchに渡すと、args.lookupRecordを使用して見つかったレコードに位置を変更するため、現在位置が保持されません。 この方法では、並べ替え順序、範囲、およびその他の設定のリセットを回避できます。
FormDataSource Method getDataRow
FormDataSource Method markAllLoadedRecords
FormDataSource Method maxPagingRowCountValue (最大ページング行数値) pagingEnabled (ページング有効) startRowIndex (開始行インデックス) setPagingParameters (ページングパラメータを設定) totalNumberOfRows (合計行数) Overview
Dynamics AX 2012 のエンタープライズ ポータルで使用
非推奨の理由
クライアントでは適用されません。
移行のメモ
コードからこれらの API への呼び出しを削除します。
FormDataSource Method 印刷する
FormDesign Method cssClass localWebMenu showWebHelp supportReload Overview
Dynamics AX 2012 のエンタープライズ ポータルで使用
非推奨の理由
クライアントでは適用されません。
移行のメモ
コードからこれらの API への呼び出しを削除します。
FormObjectSetNotify Method onPaging-
ParametersChanged
FormObjectSetPaging-
ParamsChangedEvtArgs
クラス
グローバル xInfo Method endLengthyOperation startLengthyOperation Overview
これらのメソッドを使用して、実行時間の長い操作中に進行状況インジケーターを表示または停止します。
非推奨の理由
クライアントでは、進行状況インジケーターの表示と非表示が自動的に行われ、これらの API の呼び出しは必要ありません。
移行のメモ
コードからこれらの API への任意の呼び出しを安全に削除することができます。
Image Method captureScreen captureWindow clipboardCopy clipboardPaste crop displayImage displayOrign exportBitmap flip getImageDimensionUnits getPixel height imageInfo imageSpotlight promoteColor reduceColorOctree resize rotate saveImage saveType transparent width
ListPage ページ Method activeActionPane-
TabNames
Overview
アクティブな操作ウィンドウ タブを見つけるには、このメソッドを使用します。
非推奨の理由
クライアントでは、クライアント側の [アクション ウィンドウ] タブのみを処理します。 サーバーは状態を認識していません。


移行のメモ
コードからこの API の使用を削除します。

MessageWin クラス
オブジェクト Method notify notifyAll wait Overview
これらのメソッドを使用して、対話または操作をブロックして待機し、ブロックを解除するように通知します。
非推奨の理由
これらの呼び出しは、 formRun とその派生物を除くすべてのオブジェクトで非推奨とされます。
移行のメモ
formRunまたはその派生物からのこれらの API の呼び出しが許可されます。 他のオブジェクトからこれらの API への呼び出しを削除する必要があります。
オブジェクト Method objectOnServer Overview
オブジェクトがサーバー上にあるかどうかを判断するには、このメソッドを使用します。
非推奨の理由
すべてのオブジェクトがサーバー上にあるため、このチェックは冗長であり、不要になりました。
移行のメモ
これらの API の呼び出しは、コードから安全に削除できます。 常に true と評価されます。
オブジェクト Method setTimeOut Overview
このメソッドはオブジェクト上に存在しましたが、機能しませんでした。 FormRun の実装は、ロジックの実行を遅らせるタイマーとして使用しました。
非推奨の理由
ブラウザー ベースのクライアントでは、この実装はサポートされなくなりました。
移行のメモ
代わりに FormRun で新しい setTimeOutEx メソッドを使用します。 setTimeOutEx メソッドは、myCallBack(AsyncTaskResult の結果) など、型 AsyncTaskResult のパラメーターを受け入れるためのコールバックを期待していることに注意してください。
ポップアップメニュー クラス Overview
Dynamics AX 2012 で使用すると、分割された 2 つのパーツのサイズをユーザーが変更できるスプリッターを取得できます。
非推奨の理由
Dynamics AX 2012 Windows クライアントに固有の API に依存しており、クライアントで使用することはできません。
移行のメモ
代わりに、ContextMenu を使用します。
SysExcel クラス Overview
SysExcel クラスは、COM を使用して Excel ブックを作成および編集していました。
非推奨の理由
SysExcel は、クライアントからの Excel COM オブジェクトへの呼び出しに依存します。 サーバー上にこれらの COM オブジェクトは存在せず、今後 COM 呼び出しは強く控えることが推奨されます。
移行のメモ
代わりに OpenXML .NET framework API を使用します。 製品チームは、X++ からの呼び出しを容易にするために OpenXML をラップするアセンブリの作成を調査しています。
SysINetMai SysMailer SmmOutlook クラス Overview
これらの電子メール関連のクラスでは、使用できなくなったり、非常に推奨されないクライアント側テクノロジが主に使用されます。
非推奨の理由
SysINetMail クラスは、クライアント側 MAPI を使用しているため、非推奨とされます。 SysMailer クラスは、CDO (OLE メッセージングのバリアント) を使用しているため、非推奨です。 SmmOutlook で始まるクラスは、Outlook COM オブジェクトを使用するため、非推奨とされます。
移行のメモ
今後は、SysMailerNet クラスを使用して SMTP 経由で電子メールを送信することがサポートされています。 製品チームは、クライアント側の対話型電子メール機能にも積極的に取り組んでいます。
SysFormSplitter クラス Overview
Dynamics AX 2012 で使用すると、分割された 2 つのパーツのサイズをユーザーが変更できるスプリッターを取得できます。
非推奨の理由
クライアントで不要になりました。
移行のメモ
コントロールは自動的に機能を提供します。 コードからこれらの API への任意の呼び出しを安全に削除することができます。 今後、使用を自動的に削除するコード アップグレード規則が作成される可能性があります。
SysListPageHelper クラス
SysSetupFormRun クラス Overview
FormRun を間接的に拡張するために使用します。
非推奨の理由
FormRun クラスに統合されました。
移行のメモ
代わりに FormRun クラスを使用します。
TextBuffer Method fromFile 代わりに .NET StreamReader クラスを使用します。
TextBuffer Method toFile 代わりに .NET StreamWriter クラスを使用します。
スレッド クラス Overview
N/A
非推奨の理由
Dynamics AX 2012 Windows クライアントに固有であり、クライアントと互換性がありません。
移行のメモ
新しい runAsync メソッドに置き換えるか、コードからこれらの API の使用を削除することを検討してください。
WinAPI クラス Overview
N/A
非推奨の理由
Dynamics AX 2012 Windows クライアントに固有であり、クライアントと互換性がありません。
移行のメモ
コードからこれらの API の使用を削除します。 WinAPI::getTempPathWinAPI::fileExistsなどのファイル アクセス API を新しいファイル API に置き換えます。
WinAPIServer Method cryptProtectData cryptUnprotectData Overview
機密データを暗号化および復号化するには、WinAPIServer::cryptProtectData( CryptoBlob _unEncryptedDataBlob) メソッドと WinAPIServer::cryptUnProtectData( CryptoBlob _encryptedDataBlob) メソッドを使用します。
非推奨の理由
これらのメソッドは、デスクトップの使用に最適で、Web ベースのアプリケーションの使用には推奨されません。 また、パフォーマンスに悪影響を及ぼします。
移行のメモ
代わりに、.NET Framework API と既知のハッシュアルゴリズムとセキュリティ アルゴリズムを使用してください。
xApplication Method runAsync Overview
Dynamics AX 2012 では、xApplication::runAsync メソッドを使用してメソッドを非同期呼び出します。
非推奨の理由
クライアントに適したメソッドに置き換えられます。
移行のメモ
代わりに、Global クラスまたは FormRun クラスで runAsyncメ ソッドを使用します。 これらの新しいバージョンの runAsync を使用すると、呼び出し元は静的な X++ クラス メソッドへの非同期呼び出しを行うことができます。 これらは、.NET System.Threading.Tasks ライブラリを利用して、X++ で非同期メソッドを実行します。 System.Threading.Tasks.Task 型を使用すると、.NET で使用できる豊富な機能を利用できます。
xGlobal Method clientKind Overview
通常、インタラクティブ セッションなどのクライアントの存在を検出するために使用します。
非推奨の理由
クライアントに適したメソッドに置き換えられます。
移行のメモ
代わりに global::hasGUI メソッドを使用します。
xGlobal Method コンピュータ名
xGlobal Method forceFormPreload Overview
Dynamics AX 2012 のプリロードで使用されます。
非推奨の理由
プリロードは、クライアントでは適用されません。
移行のメモ
コードからこれらの API への呼び出しを削除します。
xGlobal Method terminalServer
xInfo Method ディレクトリ
xInfo Method navPane
XmlDocument Method LoadSave
XmlWriter Method CreateNewFile
XppCompiler クラス