クライアント側の設計 API

[アーティクル]
10/16/2024

重要

財務と業務 (Dynamics 365) モバイルアプリケーションおよびプラットフォームはサポートされなくなりました。モバイルアプリケーションをサポートするプラットフォームコンポーネントは、将来の更新で削除される予定です。モバイルアプリケーションは、アプリケーション店舗でも削除されました。以前にインストールしたアプリケーションのインスタンスは引き続き動作します。詳細については、削除済みまたは非推奨のプラットフォーム機能を参照してください。

この記事では、クライアント側での設計のためのプリケーションプログラミングインターフェイス (API) の概要と、それらの使用に関する推奨事項について説明します。

用語

次のリストには、クライアント側の設計 API に適用される用語がいくつか含まれています。

デザイン : 既定のデザインを上書きするために必要に応じてページ、アクション、または他のコンポーネントオブジェクトで指定できるプロパティ。
コンポーネント : コンポーネントは、次の4つのタイプのいずれかを使用できます。
- コンテナーのブロック (既定) : 動作のブロックを CSS しているコンテナー。 (つまり、コンテナーは、CSS display: block スタイル申告を持つ要素に相当します。)
- フレックスコンテナー : フレックス動作 CSS 含むコンテナー。 (つまり、コンテナーは、CSS display: flex スタイル申告を持つ要素に相当します。)
- 制御参照 : PageまたはActionの静的メタデータ (XML) に存在するコントロールを参照するコンポーネント。
- 新しいコントロール : 新しいコントロールをインスタンス化するコンポーネント。 (つまり、コントロールは、ページまたはアクションの静的メタデータ [XML] にはまだ存在しません。)
  
  コンポーネントは JavaScript Object Notation (JSON) オブジェクトによってデザイン内に表され、この JSON オブジェクトのプロパティは、コンポーネントのプロパティを表します。デザインプロパティ階層のほとんどすべての JSON オブジェクトはコンポーネントです。
[品目 ] : コンテナーに入れ子になったコンポーネント。
プロパティ : コンポーネントには、次の複数のタイプのプロパティを設定できます。
- コンテナー固有
- 品目固有
- コントロール固有
- リスト固有
- 一般 (不特定)
  
  プロパティは、コンポーネントの JSON オブジェクトのキーと値のペアとして指定されます。適用可能なプロパティは、プロパティが適用されるコンポーネントのタイプによって異なります。
  
  使用可能な値の定義済リストを持つプロパティについては、ドキュメントで示されている最初の値がプロパティの既定値です。ほとんどの場合、プロパティをまったく指定していない (つまり、JSON オブジェクトからのプロパティを省略する) 場合、プロパティは既定値を設定していた場合と同じように動作します。
  
  一般的なプロパティは、すべてのコンポーネントのタイプに適用できます。
  
  プロパティを指定するときは、次のガイドラインに従います。
- プロパティ名は引用符で囲まないでください。
- ドキュメントでそれ以外が指定されない限り、すべてのプロパティ値を二重引用符で囲む必要があります。
継承 : 色、フォントサイズ、またはフォント重量をコントロールに適用した場合、すべての子孫コントロールは、再割り当てされていない限り、同じプロパティを継承します。コントロールにスペースを適用する場合は、コントロールの品目 (非コンテナー) 子孫によって継承されます。その他のプロパティは継承されません。

設計 API の使用

次のコードは、予約管理の例のビジネスロジックコードの変更されたセグメントです。具体的には、このコードは、引当の詳細ページのデザインを指定する変数から取得されます。コメントはコードに含まれており、いくつかの可能性を強調します。

メモ

コントロールに適用される色、フォントサイズ、またはフォントの太さはコントロールのすべての子にも適用されます。埋め込みは、コンテナー以外の子によって継承されます。その他のプロパティは継承されません。コンテナーにはリスト、ページ、グループ、およびパーツが含まれます。

子または品目を持たないコントロールを作成した後、コントロール名は引用符で囲む必要があります (次のコードの FMCustomer_FullName を参照してください)。ただし、任意のカスタマイズがコントロールに適用される場合、コードはブロックされる必要があり、名前ラベルを使用する必要があります (次のコードの FMCustomer_Image を参照してください)。

// Page root container
"flexFlow":"column nowrap",
"items":[
    // Upper third of page, contains 4 rows
    {
        "flexFlow":"column nowrap",
        "background":"theme", // set background color to the theme color
        "color":"light",      // set the foreground (e.g. font) color to light
        "fontSize":"small",
        "border": "none",
        "padding":"small",
        "items":[
            // Row 1/4 with customer image and name
            {
                "flexFlow":"row nowrap",
                "alignItems":"center",
                "justifyItems":"center",
                "labelStyle":"hidden", // don't show label for field
                "fontSize":"large",
                "fontWeight":"bold",
                "items":[
                    {
                    // Customer image – since we're modifying the imageStyle, etc., this
                    // code must be blocked and the "FMCustomer_Image" must be labeled
                    // with "name".
                        "name":"FMCustomer_Image",
                        "imageStyle":"circular",
                        height:3,
                        width:3
                    },
                    // don't need to create a new object or use the "name" label if
                    // there is no customization
                    "FMCustomer_FullName",
                ]
            },
            // Row 2/4 with vehicle description
            . . .
        }
    }

次の図は、前のコードで生成された顧客画像、顧客名、フォント、背景色などを示しています。

前のコードにより生成された情報を示す画像。

次の方法で共有

クライアント側の設計 API

用語

設計 API の使用

フィードバック

その他のリソース