次の方法で共有


非推奨 API

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

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

開始する

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

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

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

非推奨 API のリスト

オブジェクト タイプ 名前 注記
ActionPane 方法 tabChanged ActionPanes (または ActionPanes の内部コントロール) への更新は、タブが有効になったときではなく、行が有効になったときに実行される必要があります。
ActionPaneTab 方法 selectionChanged ActionPaneTabs (または ActionPaneTabs の内部コントロール) への更新は、タブが有効になったときではなく、行が有効になったときに実行される必要があります。
フィールド 方法 yesNoTextMenu-
LinkText
ComboBox 方法 getEditText 概要
在庫切れ
減価償却の理由
冗長。
移行のメモ
代わりに getText を使用します。
DataSet DataSetNode DataSetRun クラス 概要
Dynamics AX 2012 のエンタープライズ ポータルで使用されます。
減価償却の理由
クライアントでは適用されません。



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

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

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

移行のメモ
代わりに registerOverrideMethod を使用します。
フォーム 方法 コピー 切り取り 貼り付け
フォーム 方法 delAutoCompleteString(自動補完文字列の削除) getAutoCompleteString(自動補完文字列の取得) setAutoCompleteString(自動補完文字列の設定) 概要
Dynamics AX 2012 で、自動候補の設定、取得、削除に使用されます。
減価償却の理由
Dynamics AX 2012 Windows クライアントに固有です。
移行のメモ
コードからこれらの API への呼び出しを削除します。
フォーム 方法 firstField
フォーム 方法 formOnTop 概要
Dynamics AX 2012 で、ウィンドウとナビゲーションを管理するために使用されます。
減価償却の理由
クライアントには新しいナビゲーション モデルがあります。
移行のメモ
コードからこれらの API への呼び出しを削除します。
フォーム 方法 hWnd installMessageProc removeMessageProc 概要
在庫切れ
減価償却の理由
Dynamics AX 2012 Windows クライアントに固有であり、クライアントと互換性がありません。
移行のメモ
コードからこれらの API の使用を削除します。
フォーム 方法 isPreloadedInstance 概要
Dynamics AX 2012 のプリロードで使用されます。
減価償却の理由
プリロードは、クライアントでは適用されません。
移行のメモ
コードからこれらの API への呼び出しを削除します。
フォーム 方法 最後のフィールド 次のフィールド 次のグループ 前のフィールド 前のグループ
フォーム 方法 ロック
lockWindowUpdate
unLock
概要
これらのメソッドは、一連の UI 更新を実行する際にウィンドウの再描画を防止するために使用されていました。 これらのメソッドがないと、個々の変更に応じてウィンドウが再描画され、エンド ユーザー エクスペリエンスが低下し、パフォーマンスが低下します。
減価償却の理由
これらのメソッドは Windows クライアントに固有のもので、クライアントにとって必要ではなくなりました。
移行のメモ
コード アップグレード規則により、これらの API の出現箇所が削除されます。 コードからこれらの API への任意の呼び出しを安全に削除することができます。
フォーム 方法 print printPreview send 概要
Dynamics AX 2012 でフォームの自動レポート生成をオーバーライドするのに使用
減価償却の理由
Microsoft 365 統合では、クライアントでの強化されたユーザー エクスペリエンスが用意されています。 Dynamics AX クライアント フォームのユーザーは、"エクスポート" 機能を使用できます。
移行のメモ
コードからこれらの API への呼び出しを削除します。
フォーム 方法 再振出
resetStatusBar-
BackgroundColor
setStatusBar-
BackgroundColor
sysColorChanged
概要
スタイルや色を制御するのに使用します。
減価償却の理由
一貫したビジュアルを実現するために API を通じて色を指定する開発者向けの機能を削除します。
移行のメモ
コードアップグレードルールは、再描画 API の出現箇所を削除します。 コードからこれらの API の使用を削除します。
フォーム 方法 リロードする
フォーム 方法 resetSize 概要
このメソッドは、コントロールがフォームに追加または削除され、サイズが変更されたときに使用されました。 これを指定しないと、追加または削除されたコントロールを考慮するようにウィンドウのサイズが正しく設定されていない可能性があります。
減価償却の理由
これらのメソッドは Windows クライアントに固有のもので、クライアントにとって必要ではなくなりました。
移行のメモ
コードからこれらの API への任意の呼び出しを安全に削除することができます。
フォーム 方法 サイズ変更
FormActiveXControl
FormAnimateControl
FormBuildActiveXControl
FormBuildAnimateControl
FormBuildManaged-
HostControl
FormBuildSegmented-
エントリーコントロール フォーム管理ホストコントロール
FormSegmented-
EntryControl
クラス 概要
これらは、Dynamics AX 2012 のさまざまなカスタム コントロールをホストまたは作成するために使用されました。
減価償却の理由
これらのテクノロジは、クライアントでは機能しません。
移行のメモ
アプリケーション開発者は、コントロール拡張機能を使用して、必要に応じ代替コントロールを構築する必要があります。
FormControl 方法 beginDrag
dragDrop
dragLeave
dragOver
dragOverEx
dragText
削除
dropEx
dropFile
endDrag
概要
Dynamics AX 2012 でドラッグ アンド ドロップのシナリオを有効にするために使用しました。
減価償却の理由
ドラッグ アンド ドロップのシナリオは、クライアントではサポートされていません。
移行のメモ
コードからこれらの API の使用を削除し、ドラッグ アンド ドロップ機能への依存がないシナリオが有効になるようにリファクタリングします。
FormControl 方法 calcControlSize
FormControl 方法 command processBase processForm processLink processPicture processTitle 概要
Dynamics AX 2012 では廃止としてマークされました。
減価償却の理由
在庫切れ
移行のメモ
コードからこれらの API への呼び出しを削除します。
FormControl 方法 コンテキストメニューを表示 概要
このメソッドは、コントロールがフォームに追加または削除され、サイズが変更されたときに使用されました。 これを指定しないと、追加または削除されたコントロールを考慮するようにウィンドウのサイズが正しく設定されていない可能性があります。
減価償却の理由
これらのメソッドは、Windows クライアントに固有の API に依存していました。
移行のメモ
代わりに getContextMenuOptions および selectedMenuOptions を使用します。
FormControl 方法 コピー 切り取り 貼り付け
FormControl 方法 dateTextChange
FormControl 方法 editControl
FormControl 方法 hasControl-
PositionOverride
FormControl 方法 helpField
FormControl 方法 hWnd 概要
在庫切れ
減価償却の理由
Dynamics AX 2012 Windows クライアントに固有であり、クライアントと互換性がありません。
移行のメモ
コードからこれらの API の使用を削除します。
FormControl 方法 inputSearch
FormControl 方法 itemChanging
FormControl 方法 keyDown
FormControl 方法 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 方法 labelMousedown labelMouseup mouseDown mouseEnter mouseLeave mouseMove mouseUp 概要
マウス イベントを検出したり応答したりするのに使用します。
減価償却の理由
これらの方法はタッチスクリーンに優しくなく、アプリケーションクライアントではサポートされていません。
移行のメモ
コードからこれらの API の使用を削除し、マウス イベントへの依存がないシナリオが有効になるようにリファクタリングします。
FormControl 方法 onHScroll onVScroll
FormControl 方法 paint
FormControl 方法 prefColumnSize 概要
Dynamics AX 2012 で幅と高さを制御するために使用
減価償却の理由
クライアントでは適用されません。
移行のメモ
代わりに幅と高さを明示的に設定します。
FormControl 方法 selectionChanging
FormControl 方法 setScrollInfo
FormControl 方法 サイズ
FormControl 方法 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-
ホリゾンタルオフセットコンテナースクロール
VerticalOffset IMEMode MaximizeBox MinimizeBox Mode NeededAccessLevel ProgressType Securable SecurityKey StatusBarStyle WindowResize
概要
在庫切れ
減価償却の理由
Dynamics AX 2012 Windows クライアントに固有であり、必要はなくなりました。
移行のメモ
コードからこれらの API の使用を削除します。
FormControl / FormDesign プロパティ 太字
FormControl / FormDesign プロパティ CanScroll
FormControl / FormDesign プロパティ 無効画像 無効画像の場所 無効リソース
FormControl / FormDesign プロパティ DisplayTarget ハイパーリンクデータソース ハイパーリンクメニュー項目 フィルターを保存 サイズを保存 概要
Dynamics AX 2012 のエンタープライズ ポータルで使用
減価償却の理由
クライアントでは適用されません。
移行のメモ
コードからこれらの API への呼び出しを削除します。
FormControl / FormDesign プロパティ フォント
FormControl / FormDesign プロパティ フォントサイズ
FormControl / FormDesign プロパティ フレーム FramePosition 概要
在庫切れ
減価償却の理由
開発者がメタデータを使用してフレームを制御する機能を削除しました。
移行のメモ
コードからこれらの API の使用を削除します。
FormControl / FormDesign プロパティ HideToolbar HorizontalScrollBarVisible Scrollbars VerticalScrollBarVisible 概要
該当なし
減価償却の理由
開発者がメタデータを通じてスクロール バーを制御する機能を削除しました。
移行のメモ
コードからこれらの 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(ラベルフォアグラウンドカラーRGB)
FormControl / FormDesign プロパティ LabelGuide
FormControl / FormDesign プロパティ ラベル高さ ラベル高さモード ラベル高さ値
FormControl / FormDesign プロパティ LabelItalic
FormControl / FormDesign プロパティ LabelUnderline
FormControl / FormDesign プロパティ LabelWidth LabelWidthMode LabelWidthValue
FormControl / FormDesign プロパティ 保管場所
FormControl / FormDesign プロパティ NormalResource
FormControl / FormDesign プロパティ ParentPage
FormControl / FormDesign プロパティ 検索後入力 検索モード
FormControl / FormDesign プロパティ SelectControl
FormControl / FormDesign プロパティ SendExternalContext
FormControl / FormDesign プロパティ ShortKey
FormControl / FormDesign プロパティ 下線
FormDataRow クラス
FormDataSource プロパティ autoNotify 概要
Dynamics AX 2012 で非推奨としてマークされています。
減価償却の理由
在庫切れ
移行のメモ
コードから使用を削除します。
FormDataSource 方法 cacheOnlyMode
FormDataSource 方法 cacheRemoveRecord
FormDataSource 方法 defaultMark
FormDataSource 方法 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 方法 getDataRow
FormDataSource 方法 markAllLoadedRecords
FormDataSource 方法 maxPagingRowCountValue pagingEnabled startRowIndex setPagingParameters totalNumberOfRows 概要
Dynamics AX 2012 のエンタープライズ ポータルで使用
減価償却の理由
クライアントでは適用されません。
移行のメモ
コードからこれらの API への呼び出しを削除します。
FormDataSource 方法 印刷する
FormDesign 方法 cssClass localWebMenu showWebHelp supportReload 概要
Dynamics AX 2012 のエンタープライズ ポータルで使用
減価償却の理由
クライアントでは適用されません。
移行のメモ
コードからこれらの API への呼び出しを削除します。
FormObjectSetNotify 方法 onPaging-
ParametersChanged
FormObjectSetPaging-
ParamsChangedEvtArgs
クラス
グローバル xInfo 方法 endLengthyOperation startLengthyOperation 概要
これらのメソッドを使用して、実行時間の長い操作中に進行状況インジケーターを表示または停止します。
減価償却の理由
クライアントでは、進行状況インジケーターの表示と非表示が自動的に行われ、これらの API の呼び出しは必要ありません。
移行のメモ
コードからこれらの API への任意の呼び出しを安全に削除することができます。
Image 方法 captureScreen captureWindow clipboardCopy clipboardPaste crop displayImage displayOrign exportBitmap flip getImageDimensionUnits getPixel height imageInfo imageSpotlight promoteColor reduceColorOctree resize rotate saveImage saveType transparent width
ListPage ページ 方法 activeActionPane-
TabNames
概要
アクティブな操作ウィンドウ タブを見つけるには、このメソッドを使用します。
減価償却の理由
クライアントでは、クライアント側の [アクション ウィンドウ] タブのみを処理します。 サーバーは状態を認識していません。


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

MessageWin クラス
オブジェクト 方法 notify notifyAll wait 概要
これらのメソッドを使用して、対話または操作をブロックして待機し、ブロックを解除するように通知します。
減価償却の理由
これらの呼び出しは、 formRun とその派生物を除くすべてのオブジェクトで非推奨とされます。
移行のメモ
formRunまたはその派生物からのこれらの API の呼び出しが許可されます。 他のオブジェクトからこれらの API への呼び出しを削除する必要があります。
オブジェクト 方法 objectOnServer 概要
オブジェクトがサーバー上にあるかどうかを判断するには、このメソッドを使用します。
減価償却の理由
すべてのオブジェクトがサーバー上にあるため、このチェックは冗長であり、不要になりました。
移行のメモ
これらの API の呼び出しは、コードから安全に削除できます。 常に true と評価されます。
オブジェクト 方法 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 方法 fromFile 代わりに .NET StreamReader クラスを使用します。
TextBuffer 方法 toFile 代わりに .NET StreamWriter クラスを使用します。
スレッド クラス 概要
在庫切れ
減価償却の理由
Dynamics AX 2012 Windows クライアントに固有であり、クライアントと互換性がありません。
移行のメモ
新しい runAsync メソッドに置き換えるか、コードからこれらの API の使用を削除することを検討してください。
WinAPI クラス 概要
在庫切れ
減価償却の理由
Dynamics AX 2012 Windows クライアントに固有であり、クライアントと互換性がありません。
移行のメモ
コードからこれらの API の使用を削除します。 WinAPI::getTempPathWinAPI::fileExistsなどのファイル アクセス API を新しいファイル API に置き換えます。
WinAPIServer 方法 cryptProtectData cryptUnprotectData 概要
機密データを暗号化および復号化するには、WinAPIServer::cryptProtectData( CryptoBlob _unEncryptedDataBlob) メソッドと WinAPIServer::cryptUnProtectData( CryptoBlob _encryptedDataBlob) メソッドを使用します。
減価償却の理由
これらのメソッドは、デスクトップの使用に最適で、Web ベースのアプリケーションの使用には推奨されません。 また、パフォーマンスに悪影響を及ぼします。
移行のメモ
代わりに、.NET Framework API と既知のハッシュアルゴリズムとセキュリティ アルゴリズムを使用してください。
xApplication 方法 runAsync 概要
Dynamics AX 2012 では、xApplication::runAsync メソッドを使用してメソッドを非同期呼び出します。
減価償却の理由
クライアントに適したメソッドに置き換えられます。
移行のメモ
代わりに、Global クラスまたは FormRun クラスで runAsyncメ ソッドを使用します。 これらの新しいバージョンの runAsync を使用すると、呼び出し元は静的な X++ クラス メソッドへの非同期呼び出しを行うことができます。 これらは、.NET System.Threading.Tasks ライブラリを利用して、X++ で非同期メソッドを実行します。 System.Threading.Tasks.Task 型を使用すると、.NET で使用できる豊富な機能を利用できます。
xGlobal 方法 clientKind 概要
通常、インタラクティブ セッションなどのクライアントの存在を検出するために使用します。
減価償却の理由
クライアントに適したメソッドに置き換えられます。
移行のメモ
代わりに global::hasGUI メソッドを使用します。
xGlobal 方法 computerName
xGlobal 方法 forceFormPreload 概要
Dynamics AX 2012 のプリロードで使用されます。
減価償却の理由
プリロードは、クライアントでは適用されません。
移行のメモ
コードからこれらの API への呼び出しを削除します。
xGlobal 方法 terminalServer
xInfo 方法 ディレクトリ
xInfo 方法 navPane
XmlDocument 方法 LoadSave
XmlWriter 方法 CreateNewFile
XppCompiler クラス