コンポーネントを作成するための 概要 記事では、キャンバス アプリ内のコンポーネントについて説明します。 アプリ内にコンポーネントを作成するときに、再利用できるコンポーネントのライブラリを作成することもできます。 コンポーネント ライブラリを作成することで、アプリ作成者は 1 つ以上のコンポーネントを他の作成者と簡単に共有および更新できます。
コンポーネント ライブラリは、容易にするコンポーネント定義のコンテナです:
- コンポーネントを検出および検索します。
- 更新を公開します。
- 使用可能なコンポーネントの更新をアプリ メーカーに通知します。
注
コンポーネント ライブラリは、アプリ間でコンポーネントを再利用するための推奨されている方法です。 コンポーネント ライブラリを使用すると、アプリは使用するコンポーネントへの依存関係を保持します。 依存コンポーネントの更新プログラムが使用可能になると、アプリ 作成者にアラートが送信されます。 そのため、コンポーネント ライブラリ内に再利用可能なコンポーネントを作成します。 あるキャンバス アプリから別のキャンバス アプリへのコンポーネントのインポート を許可した以前の Power Apps 機能は廃止されました。
アプリとコンポーネント ライブラリの違い
コンポーネント ライブラリは、再利用可能なコンポーネントの集中管理されたリポジトリを提供します。
左側のナビゲーション ウィンドウの挿入は、コンポーネント ライブラリを作成すると、既定でコンポーネント タブになります。 アプリを作成すると、このビューにはコンポーネントではなくスクリーンが表示されます。
注
コンポーネント ライブラリの画面は、テストでのみ使用できます。 ライブラリの作成者に、作成されたコンポーネントを実際のスクリーンですばやくテストし、コンポーネントが時間経過とともに強化されていくにつれて、更新動作を検証する方法を提供します。 コンポーネント ライブラリからコンポーネントを使用するには、コンポーネント ライブラリを使用するアプリを作成する必要があります。
ライブラリ内の画面と再生オプションを使用して、コンポーネント ライブラリ コンポーネントをプレビューできます。 コンポーネント タブを選択すると、再生オプションが無効にされます。 Power Apps Mobile の使用時には、コンポーネント ライブラリは表示されません。
注
この記事で説明するコンポーネント ライブラリは、開発者およびメーカーがモデル駆動型アプリおよびキャンバス アプリ用のコード コンポーネントを作成できるようにする Power Apps component framework とは異なります。 詳細については、「 Power Apps コンポーネント フレームワークの概要」を参照してください。
コンポーネント ライブラリの操作
同じインターフェースから、新しいコンポーネント ライブラリを作成または既存のコンポーネント ライブラリを編集できます。 Power Apps> に進んで、左側のナビゲーションからその他を選択し、>すべてを検出>を選択し、アプリの拡張セクションからコンポーネント ライブラリを選択します。 コンポーネント ライブラリ オプションを Power Apps インターフェイスにピン留めすることもできます。 詳細については、「Power Appsの左側のナビゲーション」を参照してください。
コンポーネント ライブラリの例の作成
コンポーネント ライブラリ内にコンポーネントを作成する手順は、アプリ内にコンポーネントを作成する場合と同じです。 コンポーネント ライブラリを作成してから、コンポーネント概要の例 からコンポーネントを作成する手順を再利用します。 次に、コンポーネント ライブラリを使用して、新しいアプリで再利用可能なコンポーネントを提供します。
Power Apps にサインインします。
左側のナビゲーションでコンポーネント ライブラリを選択し、新しいコンポーネント ライブラリを選択します。 または、左側のナビゲーションにコンポーネント ライブラリが表示されない場合は、左側のナビゲーションから [その他] を選択し、[すべて検出] ボタンを選択し、[アプリの機能強化] セクションから [コンポーネント ライブラリ] を選択します。
コンポーネント ライブラリの メニュー コンポーネントに名前を付けます。または、選択した別の名前を指定します。
コンポーネント概要の例 から手順に従ってコンポーネントを作成します。 新しいコンポーネント ライブラリを既に作成しているため、Power Apps Studio を開いたり、新しい空のアプリを作成したりする必要はありません。 ステップ 2 から開始します。
手順に従ってコンポーネントを作成したら、次の一連の手順に従って、スクリーンにコンポーネントを追加 および出力プロパティを作成 します。
コンポーネントの作成とテストが完了したら、アプリ アクションから [保存 ] アイコンを選択してコンポーネント ライブラリを保存します。
また、保存アイコンの横にある矢印メニューから、バージョン ノート付きで保存することもできます。 バージョンノートは、コンポーネント ライブラリのバージョンを取得し、このコンポーネント ライブラリからアプリで使用されるコンポーネントをアップグレードするのに役立ちます。 アプリアクションの詳細については、Power Apps Studio の記事を参照してください。
ヒント
バージョンノートは、コンポーネント ライブラリのバージョンを確認する場合、およびコンポーネント ライブラリを使用するアプリ メーカーが変更を確認し、必要に応じてこれらのコンポーネントを使用するアプリを更新する場合に役立ちます。 詳細については、コンポーネント ライブラリを更新 に移動します。
保存したコンポーネント ライブラリを発行できます。 コンポーネント ライブラリを使用するアプリでは、公開されたコンポーネント ライブラリの更新のみ使用可能です。 アプリ アクションから [発行 ] アイコンを選択して、コンポーネント ライブラリのバージョンを発行します。
ライブラリ コンポーネントのカスタマイズ
コンポーネント ライブラリ内にコンポーネントを作成するときに、ライブラリ コンポーネントを使用するアプリでコンポーネントをカスタマイズできるかどうかを設定できます。 既定では、この設定はコンポーネントのプロパティ内で [オン] です。 この設定を オフ にすると、他のアプリでコンポーネントをカスタマイズする機能が削除されます。
カスタマイズを許可するコンポーネントを追加すると、このコンポーネントを編集してさらにカスタマイズできるオプションが表示されます。 アプリはローカル コピーを作成し、ローカル コンポーネントのコピーに変更を加えることができます。 コンポーネントを編集すると、コンポーネント ライブラリとの関連付けが削除されます。
コンポーネントの編集を選択すると、カスタマイズのためにコンポーネントをローカルにコピーするよう促されます。
コンポーネントのカスタマイズを許可しない場合、使用しているアプリには、コンポーネントを編集するオプションは表示されません。
この場合、コンポーネントを編集する唯一の方法は、そのコンポーネントが格納されているコンポーネントライブラリを編集することです。
コンポーネント ライブラリからインポートする
コンポーネント ライブラリを作成して発行した後、アプリはライブラリをインポートすることで、このコンポーネント ライブラリのコンポーネントを使用できます。 コンポーネント ライブラリを共有 することもできます。
コンポーネント ライブラリからインポートするには、既存のアプリを編集するか、新しいアプリを作成します。 キャンバス アプリ スタジオでアプリが開いたら、左側のナビゲーションで挿入または + を選択します。 次に、現在の環境で使用可能なコンポーネント ライブラリを一覧表示するには、さらにコンポーネントを取得を選択します:
画面の右側に、現在の環境で利用可能なコンポーネント ライブラリのリストが表示されます。 コンポーネント ライブラリから個々のコンポーネントを選択します。 または、一度にライブラリからすべてのコンポーネントをインポートするには、すべて選択を使用します:
注
メーカーが、インポート セクションでリストされているコンポーネント ライブラリを表示しない場合は、コンポーネント ライブラリがメーカーと共有されていることを確認してください。 詳細については、 コンポーネント ライブラリのアクセス許可を参照してください。
注
複数のコンポーネントを選択してインポートし、異なるコンポーネント ライブラリ間でインポートできます。
アプリ内で使用可能なコンポーネントは、挿入ウィンドウ内のコンポーネント リストのカスタム カテゴリの下に一覧表示されます。 インポートされたコンポーネント ライブラリから使用可能なコンポーネントは、ライブラリ コンポーネント カテゴリーの下に一覧表示されます:
コンポーネント ライブラリを更新する
既存のコンポーネント ライブラリを変更して、他のバージョン ノートで変更を保存できます。 ただし、コンポーネント ライブラリを使用する既存のアプリで使用するには、更新されたコンポーネント ライブラリのバージョンを公開する必要があります。 コンポーネント ライブラリの例の手順では、保存後にコンポーネント ライブラリを発行する方法について説明します。
ライブラリのコンポーネントを使用するアプリが最新の変更を取得する方法は 2 つあります。
方法 1: アプリ編集時のコンポーネント更新通知
他のアプリの作成者は、更新されたコンポーネントが利用可能になると通知を受け取ります。 メーカーがキャンバス アプリ スタジオでアプリを編集すると、通知が表示されます。 コンポーネントの更新を選択できます。
レビューを選択すると、コンポーネントを更新するオプションが表示されます。
コンポーネント ライブラリのバージョンを発行するときに追加するバージョン ノートがここに表示されます。
更新を選択してコンポーネントを更新します。
方法 2: 更新のプロアクティブ チェック
このメソッドを使用して、Studio でアプリの作業中にアプリの更新を事前に確認します。
このチェックを行うには、左側にある [コンポーネントの挿入 ] パネルを選択し、[ 更新プログラムの確認 ] アイコンを選択します。
ライブラリから使用されるコンポーネントの更新プログラムがある場合は、最新の変更を確認して取得するためのメッセージが表示されます。 確認して更新すると、アプリは最新のコンポーネントで更新されます。
消費するアプリのコンポーネントライブラリからコンポーネントを更新する
コンポーネント ライブラリからコンポーネントをインポートする場合、使用中のアプリ内で編集することはできません。 [コンポーネントの 編集] を選択すると、現在のアプリ内にコンポーネントのコピーを作成して変更できるようにするオプションが表示されます。
コピーを作成を選択した場合、コンポーネントがローカル アプリにコピーされます。 コンポーネントのローカル コピーは、挿入ウィンドウのカスタム カテゴリの下に表示されます。 元のコンポーネント ライブラリの新しいバージョンが後で公開された場合、コンポーネントのこのローカル コピーは更新プログラムを受け取りません。
注
コンポーネント ライブラリのコンポーネントの使用中のインスタンスは、コンポーネントのローカル コピーを作成した後も影響を受けず、コンポーネント ライブラリ定義にリンクされたままです。 ローカルにコピーされたコンポーネントのインスタンスのみ (カスタム カテゴリ) は、ローカル アプリ コンポーネントと見なされます。
コンポーネント ライブラリの削除
コンポーネント ライブラリがキャンバス アプリによって参照されている場合、削除することはできません。 この条件は、Power Platform 環境と Power Platform 以外の環境の両方に当てはまります。 ライブラリを削除する前に、アプリからコンポーネントを削除します。 コンポーネント ライブラリを使用しているアプリに関する情報は、ソリューションの依存関係ビューまたはライブラリを削除しようとしたときに表示されるメッセージのいずれかで確認できます。
コンポーネント ライブラリのアクセス許可
コンポーネント ライブラリの共有は、キャンバス アプリの共有と同じように機能します。 コンポーネント ライブラリを共有すると、他のユーザーがコンポーネント ライブラリを再利用するのを許可します。 共有されると、他のユーザーはコンポーネント ライブラリを編集し、アプリを作成および編集するために、この共有コンポーネント ライブラリからコンポーネントをインポートしてします。 共同所有者として共有されている場合、ユーザーはコンポーネント ライブラリを使用、編集、および共有できますが、所有者を削除または変更することはできません。
コンポーネント ライブラリをセキュリティ グループと共有する場合のその他の考慮事項:
- ソリューションの一部として作成されたコンポーネント ライブラリを共有する場合、共有 UI を使用することはできません。 代わりに、CanEdit アクセス許可レベルで Set-PowerAppRoleAssignment コマンドレットを使用して、コンポーネント ライブラリを選択したセキュリティ グループと共有します。
- Dataverse データベースを使用せず共同所有者として共有される、Power Platform 環境で作成したコンポーネント ライブラリは、CanEdit アクセス許可を自動的に選択したセキュリティ グループに付与します。
既知の制限
コンポーネントに適用される既知の制限は、コンポーネント ライブラリにも適用されます。
ローカルに保存されたコンポーネント ライブラリからコンポーネントをインポートすることはできません。 コンポーネント ライブラリは、[アプリアクションからコピーを ダウンロード する] を選択してダウンロードできます。 ただし、その保存されたコンポーネント ライブラリをインポートしようとすると、次のエラー メッセージが表示されます。
初めて環境にアプリとコンポーネント ライブラリをインポートする場合は、アプリがコンポーネント ライブラリに含まれているコンポーネントの最新バージョンを使用していることを確認してください。 それ以外の場合、アプリはインポート後に更新プログラムを受け取りません。 アプリは、後続のコンポーネント ライブラリが同じ環境にインポートされると、更新されたバージョンを認識し、プロンプトを表示します。
コード コンポーネントは、コンポーネント ライブラリ内ではサポートされていません。