非推奨 API

Note

コミュニティの関心グループが Yammer から Microsoft Viva Engage に移行されました。 Viva Engage コミュニティに参加し、最新のディスカッションに参加するには、「 Finance and Operations Viva Engage Community へのアクセスを要求する 」フォームに入力し、参加するコミュニティを選択します。

この記事では、非推奨の 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 概要
N/A
減価償却の理由
冗長。
移行のメモ
代わりに getText を使用します。
DataSet DataSetNode DataSetRun クラス 概要
Dynamics AX 2012 のエンタープライズ ポータルで使用されます。
減価償却の理由
クライアントでは適用されません。



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

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

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

移行のメモ
代わりに registerOverrideMethod を使用します。
Form Method コピー、切り取り、貼り付け
Form Method delAutoCompleteString getAutoCompleteString setAutoCompleteString 概要
Dynamics AX 2012 で、自動候補の設定、取得、削除に使用されます。
減価償却の理由
Dynamics AX 2012 Windows クライアントに固有です。
移行のメモ
コードからこれらの API への呼び出しを削除します。
Form Method firstField
Form Method formOnTop 概要
Dynamics AX 2012 で、ウィンドウとナビゲーションを管理するために使用されます。
減価償却の理由
クライアントには新しいナビゲーション モデルがあります。
移行のメモ
コードからこれらの API への呼び出しを削除します。
Form Method hWnd installMessageProc removeMessageProc 概要
N/A
減価償却の理由
Dynamics AX 2012 Windows クライアントに固有であり、クライアントと互換性がありません。
移行のメモ
コードからこれらの API の使用を削除します。
Form Method isPreloadedInstance 概要
Dynamics AX 2012 のプリロードで使用されます。
減価償却の理由
プリロードは、クライアントでは適用されません。
移行のメモ
コードからこれらの API への呼び出しを削除します。
Form Method 最後のフィールド 次のフィールド 次のグループ 前のフィールド 前のグループ
Form Method ロック
lockWindowUpdate
unLock
概要
これらのメソッドは、一連の UI 更新を実行する際にウィンドウの再描画を防止するために使用されていました。 これらのメソッドがないと、個々の変更に応じてウィンドウが再描画され、エンド ユーザー エクスペリエンスが低下し、パフォーマンスが低下します。
減価償却の理由
これらのメソッドは Windows クライアントに固有のもので、クライアントにとって必要ではなくなりました。
移行のメモ
コード アップグレード規則により、これらの API の出現箇所が削除されます。 コードからこれらの API への任意の呼び出しを安全に削除することができます。
Form Method print printPreview send 概要
Dynamics AX 2012 でフォームの自動レポート生成をオーバーライドするのに使用
減価償却の理由
Microsoft 365 統合では、クライアントでの強化されたユーザー エクスペリエンスが用意されています。 Dynamics AX クライアント フォームのユーザーは、"エクスポート" 機能を使用できます。
移行のメモ
コードからこれらの API への呼び出しを削除します。
Form Method 再振出
resetStatusBar-
BackgroundColor
setStatusBar-
BackgroundColor
sysColorChanged
概要
スタイルや色を制御するのに使用します。
減価償却の理由
一貫したビジュアルを実現するために API を通じて色を指定する開発者向けの機能を削除します。
移行のメモ
コードアップグレードルールは、再描画 API の出現箇所を削除します。 コードからこれらの API の使用を削除します。
Form Method リロードする
Form Method resetSize 概要
このメソッドは、コントロールがフォームに追加または削除され、サイズが変更されたときに使用されました。 これを指定しないと、追加または削除されたコントロールを考慮するようにウィンドウのサイズが正しく設定されていない可能性があります。
減価償却の理由
これらのメソッドは Windows クライアントに固有のもので、クライアントにとって必要ではなくなりました。
移行のメモ
コードからこれらの API への任意の呼び出しを安全に削除することができます。
Form Method サイズ変更
FormActiveXControl
FormAnimateControl
FormBuildActiveXControl
FormBuildAnimateControl
FormBuildManaged-
HostControl
FormBuildSegmented-
EntryControl FormManagedHostControl
FormSegmented-
EntryControl
クラス 概要
これらは、Dynamics AX 2012 のさまざまなカスタム コントロールをホストまたは作成するために使用されました。
減価償却の理由
これらのテクノロジは、クライアントでは機能しません。
移行のメモ
アプリケーション開発者は、コントロール拡張機能を使用して、必要に応じ代替コントロールを構築する必要があります。
FormControl Method beginDrag
dragDrop
dragLeave
dragOver
dragOverEx
dragText
削除
dropEx
dropFile
endDrag
概要
Dynamics AX 2012 でドラッグ アンド ドロップのシナリオを有効にするために使用しました。
減価償却の理由
ドラッグ アンド ドロップのシナリオは、クライアントではサポートされていません。
移行のメモ
コードからこれらの API の使用を削除し、ドラッグ アンド ドロップ機能への依存がないシナリオが有効になるようにリファクタリングします。
FormControl Method calcControlSize
FormControl Method command processBase processForm processLink processPicture processTitle 概要
Dynamics AX 2012 では廃止としてマークされました。
減価償却の理由
N/A
移行のメモ
コードからこれらの API への呼び出しを削除します。
FormControl Method context showContextMenu 概要
このメソッドは、コントロールがフォームに追加または削除され、サイズが変更されたときに使用されました。 これを指定しないと、追加または削除されたコントロールを考慮するようにウィンドウのサイズが正しく設定されていない可能性があります。
減価償却の理由
これらのメソッドは、Windows クライアントに固有の API に依存していました。
移行のメモ
代わりに getContextMenuOptions および selectedMenuOptions を使用します。
FormControl Method コピー、カット、ペースト
FormControl Method dateTextChange
FormControl Method editControl
FormControl Method hasControl-
PositionOverride
FormControl Method helpField
FormControl Method hWnd 概要
N/A
減価償却の理由
Dynamics AX 2012 Windows クライアントに固有であり、クライアントと互換性がありません。
移行のメモ
コードからこれらの API の使用を削除します。
FormControl Method inputSearch
FormControl Method itemChanging
FormControl Method keyDown
FormControl Method labelMouseDblClick
mouseDblClick
概要
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 概要
マウス イベントを検出したり応答したりするのに使用します。
減価償却の理由
これらの方法はタッチスクリーンに優しくなく、アプリケーションクライアントではサポートされていません。
移行のメモ
コードからこれらの API の使用を削除し、マウス イベントへの依存がないシナリオが有効になるようにリファクタリングします。
FormControl Method onHScroll onVScroll
FormControl Method paint
FormControl Method prefColumnSize 概要
Dynamics AX 2012 で幅と高さを制御するために使用
減価償却の理由
クライアントでは適用されません。
移行のメモ
代わりに幅と高さを明示的に設定します。
FormControl Method selectionChanging
FormControl Method setScrollInfo
FormControl Method サイズ
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 概要
スタイルや色を制御するのに使用します。
減価償却の理由
一貫したビジュアルを実現するために 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 概要
レイアウトを制御するのに使用します。
減価償却の理由
このプロパティを使用して一貫性のあるレイアウトを実現するレイアウトを制御するための開発者向けの機能を削除します。


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

FormControl / FormDesign 財産 AllowDocking AlwaysOnTop ArrangeGuide ArrangeWhen ContainerScroll-
HorizontalOffset ContainerScroll-
垂直オフセット IMEモード 最大化ボックス 最小化ボックス モード 必要なアクセスレベル 進捗タイプ 保護対象 セキュリティキー ステータスバーのスタイル ウィンドウのリサイズ
概要
N/A
減価償却の理由
Dynamics AX 2012 Windows クライアントに固有であり、必要はなくなりました。
移行のメモ
コードからこれらの API の使用を削除します。
FormControl / FormDesign 財産 太字
FormControl / FormDesign 財産 CanScroll
FormControl / FormDesign 財産 無効化された画像 無効化された画像の場所 無効化されたリソース
FormControl / FormDesign 財産 DisplayTarget HyperLinkDataSource HyperLinkMenuItem SaveFilter SaveSize 概要
Dynamics AX 2012 のエンタープライズ ポータルで使用
減価償却の理由
クライアントでは適用されません。
移行のメモ
コードからこれらの API への呼び出しを削除します。
FormControl / FormDesign 財産 書体
FormControl / FormDesign 財産 フォントサイズ
FormControl / FormDesign 財産 フレーム FramePosition 概要
N/A
減価償却の理由
開発者がメタデータを使用してフレームを制御する機能を削除しました。
移行のメモ
コードからこれらの API の使用を削除します。
FormControl / FormDesign 財産 ツールバーを隠す 水平スクロールバー表示 スクロールバー 垂直スクロールバー表示 概要
該当なし
減価償却の理由
開発者がメタデータを通じてスクロール バーを制御する機能を削除しました。
移行のメモ
コードからこれらの API の使用を削除します。
FormControl / FormDesign 財産 ImageMode
FormControl / FormDesign 財産 ImageName
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 財産 LabelWidth LabelWidthMode LabelWidthValue
FormControl / FormDesign 財産 Location
FormControl / FormDesign 財産 NormalResource
FormControl / FormDesign 財産 ParentPage
FormControl / FormDesign 財産 SearchAfterInput SearchMode
FormControl / FormDesign 財産 SelectControl
FormControl / FormDesign 財産 SendExternalContext
FormControl / FormDesign 財産 ShortKey
FormControl / FormDesign 財産 下線
FormDataRow クラス
FormDataSource 財産 autoNotify 概要
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 (合計行数) 概要
Dynamics AX 2012 のエンタープライズ ポータルで使用
減価償却の理由
クライアントでは適用されません。
移行のメモ
コードからこれらの API への呼び出しを削除します。
FormDataSource Method 印刷する
FormDesign Method cssClass localWebMenu showWebHelp supportReload 概要
Dynamics AX 2012 のエンタープライズ ポータルで使用
減価償却の理由
クライアントでは適用されません。
移行のメモ
コードからこれらの API への呼び出しを削除します。
FormObjectSetNotify Method onPaging-
ParametersChanged
FormObjectSetPaging-
ParamsChangedEvtArgs
クラス
グローバル xInfo Method endLengthyOperation startLengthyOperation 概要
これらのメソッドを使用して、実行時間の長い操作中に進行状況インジケーターを表示または停止します。
減価償却の理由
クライアントでは、進行状況インジケーターの表示と非表示が自動的に行われ、これらの 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
概要
アクティブな操作ウィンドウ タブを見つけるには、このメソッドを使用します。
減価償却の理由
クライアントでは、クライアント側の [アクション ウィンドウ] タブのみを処理します。 サーバーは状態を認識していません。


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

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