レガシアプリを VB の式に移行する

レガシアプリとは、VB 式言語の導入前に作成されたアプリ、またはレガシ式言語を使用するアプリを指します。

この移行プロセスでは、レガシアプリを入力として受け取り、VB の式で設計されたレガシアプリのコピーを生成します。

レガシアプリを VB の式に移行するには、以下の手順を実行します。

移行後のアプリは、「app_name + 移行のタイムスタンプ」の構文の名前で [構築] タブに表示されます。

重要:

移行後に、新しい VB アプリでエラーが表示されることがあります。このエラーは、レガシ式と VB の間の非互換性が原因で発生します。

アプリを機能させるには各エラーを確認し、VB の要件を満たすように式を手動で調整します。

移行対象の機能

次のリストは、レガシから VB 式言語に移行される Apps の機能をまとめたものです。すべての機能が保持されるわけではなく、手動の修正が必要な場合があります。レガシ式を VB 言語で書き換えられるように、移行アルゴリズムではガイド文字列が提供されます。

レガシ式言語で構築されたアプリのすべてのページ、コントロール、レイアウトは、VB 式の関連インスタンスに移行されます。

以下のコントロールや要素は異なる方法で移行されます。

ファイルピッカー: [ファイルピッカー] コントロールが [ダウンロードのみ] で使用されている場合は、[ファイルダウンローダー] として移行されます。
それ以外の場合、[ファイルピッカー] コントロールは [ファイルアップローダー] として移行されます。
値のバインド: VB の式では値のバインドがサポートされません。
データコンテキスト: データコンテキストは、VB の式ではサポートされていません。

注:

[データソース] プロパティは、表、ドロップダウン、リストなどのいくつかのコントロールで空白として移行されます。[クエリビルダー] を使用して式を再構築します。

すべてのリテラル式が完全に移行されます。リテラル式とは、ユーザーが直接入力する値です。

Lookup などの複合式は、新しい VB 式を構築する指針となる文字列に置換されます。

プロセス、キュー、ストレージバケットなどのすべての連携が完全に移行されます。

連携要素の名前が VB 要素の命名規則に従っていない場合、エラーが発生する可能性があります。移行アルゴリズムでは、ユーザーに代わって要素の名前が変更されます。

移行中、変数は元のデータ型に関係なく String 型に設定されます。

String 以外のデータ型が割り当てられている変数では、エラーが発生する可能性があります。このような場合は手動の修正が必要です。

変数名は、VB 要素の命名規則に従っていることを確認してください。

直接バインドとは、2 つの単一要素のみをつなぐリンクです。たとえばレガシアプリでは、[テキストボックス] コントロールの [値のバインド] プロパティや、[ストレージバケットへファイルをアップロード] ルールの [ストレージバケット] フィールドのことを指します。

VB 式言語ではページ間のバインドが非推奨であるため、これらのバインドは移行されません。ページ間のバインドが設定されている要素にはエラーが表示され、式の書き換えに役立つガイド文が表示されます。

コントロールのプロパティにあるすべての単純式 ([必須]、[読み取り専用]、[非表示] など) は移行されます。

直接バインドを含むすべてのルールが移行されます。複合式は削除されるか、ガイド文字列に変換されます。

次の図は、VB 式に移行する前 (図 1) と移行後 (図 2) の [値を設定] ルールの設定を比較したものです。

以下のルールは異なる方法で移行されます。

エンティティレコードを作成/更新: このルールは [エンティティレコードを作成] ルールとして移行されます。このルール内の式は保持されないため、ルールを再設定する必要があります。
値を設定: ルールの [設定する項目] フィールドに複数の項目がある場合、それらは個別の [値を設定] ルールとして移行されます。

このルール内の式は、新しい VB 式を構築する際の指針となる文字列に置換されます。
If/else: ルールは条件を含めずに移行されます。