コンポーネントライブラリ

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

コンポーネントを作成するための概要記事の中では、キャンバスアプリ内のコンポーネントが紹介されています。アプリ内にコンポーネントを作成すると、再利用できるコンポーネントのライブラリを作成することもできます。コンポーネントライブラリを作成することで、アプリメーカーは 1 つ以上のコンポーネントを他のメーカーと簡単に共有および更新できます。

コンポーネントライブラリは、容易にするコンポーネント定義のコンテナです:

コンポーネントを検出および検索します。
更新を公開します。
使用可能なコンポーネントの更新をアプリメーカーに通知します。

注意

コンポーネントライブラリは、アプリ間でコンポーネントを再利用するための推奨されている方法です。コンポーネントライブラリを使用すると、アプリは使用するコンポーネントへの依存関係を保持します。依存コンポーネントの更新が利用可能になると、アプリメーカーに通知されます。したがって、新しい再利用可能なコンポーネントはすべて、その代わりにコンポーネントライブラリ内で作成する必要があります。あるキャンバスアプリから別のキャンバスアプリへのコンポーネントのインポートを許可した以前の Power Apps 機能は廃止されました。

アプリとコンポーネントライブラリの違い

コンポーネントライブラリは、再利用可能なコンポーネントの集中管理されたリポジトリを提供します。

左側のナビゲーションウィンドウの挿入は、コンポーネントライブラリを作成すると、既定でコンポーネントタブになります。アプリを作成すると、このビューにはコンポーネントではなくスクリーンが表示されます。

コンポーネントライブラリ内のスクリーンは、テストのみに使用可能です。ライブラリの作成者に、作成されたコンポーネントを実際のスクリーンですばやくテストし、コンポーネントが時間経過とともに強化されていくにつれて、更新動作を検証する方法を提供します。コンポーネントライブラリからコンポーネントを使用するには、コンポーネントライブラリを使用するアプリを作成する必要があります。

ライブラリ内のスクリーンを再生オプションで使用して、コンポーネントライブラリコンポーネントをプレビューできます。コンポーネントタブを選択すると、再生オプションが無効にされます。 Power Apps Mobile の使用時には、コンポーネントライブラリは表示されません。

注意

この記事で説明するコンポーネントライブラリは、開発者およびメーカーがモデル駆動型アプリおよびキャンバスアプリ用のコードコンポーネントを作成できるようにする Power Apps component framework とは異なります。詳細については、Power Apps component framework の概要。

コンポーネントライブラリの操作

同じインターフェースから、新しいコンポーネントライブラリを作成または既存のコンポーネントライブラリを編集できます。左側のナビゲーションから Power Apps に移動してその他を選択し、アプリの拡張セクションからすべてを検出 > コンポーネントライブラリを選択します。 コンポーネントライブラリ オプションを Power Apps インターフェイスにピン留めすることもできます。詳細: Power Apps の左側のナビゲーション

コンポーネントライブラリの例の作成

コンポーネントライブラリ内にコンポーネントを作成する手順は、アプリ内にコンポーネントを作成する場合と同じです。コンポーネントライブラリを作成してから、コンポーネント概要の例からコンポーネントを作成する手順を再利用します。次に、新しいアプリで再利用可能なコンポーネントを提供するため、コンポーネントライブラリを使用します。

Power Apps にサインインします。
左側のナビゲーションでコンポーネントライブラリを選択し、新しいコンポーネントライブラリを選択します。または、左側のナビゲーションからその他を選択し、アプリの拡張セクションからすべてを検出 > コンポーネントライブラリを選択します。
コンポーネントライブラリにメニューコンポーネントという名前をつけます; 別の希望する名前を付けることもできます。
コンポーネント概要の例から手順に従ってコンポーネントを作成します。新しいコンポーネントライブラリを既に作成しているため、Power Apps Studio を開いたり、新しい空のアプリを作成する必要はありません。ステップ 2 から開始します。

手順に従ってコンポーネントを作成したら、次の一連の手順に従って、スクリーンにコンポーネントを追加および出力プロパティを作成します。
コンポーネントの作成とテストを完了した後、ファイル メニューを選択してコンポーネントライブラリを保存し、保存を選択します。

バージョンノートを保存するオプションもあります。バージョンノートは、コンポーネントライブラリのバージョンを取得し、このコンポーネントライブラリからアプリで使用されるコンポーネントをアップグレードするのに役立ちます。

ヒント

バージョンノートは、コンポーネントライブラリのバージョンを確認する場合、およびコンポーネントライブラリを使用するアプリメーカーが変更を確認し、必要に応じてこれらのコンポーネントを使用するアプリを更新する場合に役立ちます。詳細については、コンポーネントライブラリを更新に移動します。
保存したコンポーネントライブラリを公開できます。コンポーネントライブラリを使用するアプリでは、公開されたコンポーネントライブラリの更新のみ使用可能です。コンポーネントライブラリのバージョンを公開するには、公開するを選択します:

ライブラリコンポーネントのカスタマイズ

コンポーネントライブラリ内でコンポーネントを作成する場合、ライブラリのコンポーネントを使用するアプリケーションで使用する際に、コンポーネントをカスタマイズできるようにするオプションがあります。既定では、この設定はオンに設定されています。この設定をオフにすると、他のアプリケーションで使用する際にコンポーネントをカスタマイズする機能がなくなります。

アプリで使用しているときに、このコンポーネントのカスタマイズを許可するオプション。

カスタマイズが可能なコンポーネントを追加すると、このコンポーネントを編集してさらにカスタマイズするためのオプションが表示されます。アプリはローカルコピーを作成し、ローカルコンポーネントのコピーに変更を加えることができます。コンポーネントを編集すると、コンポーネントライブラリとの関連付けは解除されます。

カスタマイズ可能なコンポーネントを編集します。

コンポーネントの編集を選択すると、カスタマイズのためにコンポーネントをローカルにコピーするよう促されます。

しかし、コンポーネントのカスタマイズを許可していない場合、使用するアプリにはコンポーネントを編集するオプションが表示されません。

使用するアプリ内コンポーネントを編集するオプションはありません。

この場合、コンポーネントを編集する唯一の方法は、そのコンポーネントが格納されているコンポーネントライブラリを編集することです。

コンポーネントライブラリからインポートする

コンポーネントライブラリを作成して公開した後、アプリはライブラリをインポートすることにより、このコンポーネントライブラリからコンポーネントを使用できます。コンポーネントライブラリを共有することもできます。

コンポーネントライブラリからインポートするには、既存のアプリを編集するか、新しいアプリを作成します。キャンバスアプリスタジオでアプリが開いたら、挿入または左側のナビゲーション + を選択します。次に、現在の環境で使用可能なコンポーネントライブラリを一覧表示するには、さらにコンポーネントを取得を選択します:

さらにコンポーネントを取得。

スクリーンの右側に、現在の環境で使用可能なコンポーネントライブラリの一覧が表示されます。コンポーネントライブラリから個々のコンポーネントを選択します。または、一度にライブラリからすべてのコンポーネントをインポートするには、すべて選択を使用します:

コンポーネントをインポートする。

注意

メーカーが、インポートセクションでリストされているコンポーネントライブラリを表示しない場合は、コンポーネントライブラリがメーカーと共有されていることを確認してください。詳細については、コンポーネントライブラリのアクセス許可に移動します。

複数のコンポーネントを選択し、異なるコンポーネントライブラリからインポートできることに注意してください。

アプリ内で使用可能なコンポーネントは、挿入ウィンドウ内のコンポーネントリストのカスタム カテゴリの下に一覧表示されます。インポートされたコンポーネントライブラリから使用可能なコンポーネントは、ライブラリコンポーネント カテゴリーの下に一覧表示されます:

アプリにコンポーネントを挿入する。

コンポーネントライブラリを更新する

既存のコンポーネントライブラリを変更して、他のバージョンノートで変更を保存できます。ただし、コンポーネントライブラリを使用する既存のアプリで使用するには、更新されたコンポーネントライブラリのバージョンを公開する必要があります。コンポーネントライブラリの例の上記の手順は、コンポーネントライブラリを保存した後に公開する方法について説明しました。

ライブラリのコンポーネントを使用するアプリが最新の変更を取得する方法は 2 つあります。

方法 1: アプリ編集時のコンポーネント更新通知

他のアプリのメーカーには、使用可能な更新されたコンポーネントが通知されます。メーカーがキャンバスアプリスタジオでアプリを編集すると、通知が表示されます。コンポーネントの更新を選択できます。

使用可能な更新プログラム。

レビューを選択し、コンポーネントを更新するオプションが表示されます:

コンポーネントを更新する。

コンポーネントライブラリのバージョンを公開するときに追加したバージョンノートがここに表示されるはずです。

更新を選択してコンポーネントを更新します。

最新のコンポーネントで更新されたアプリ

方法 2: 更新のプロアクティブチェック

この方法は、スタジオでアプリを操作しているときに、アプリの更新を事前に確認するためのものです。

このチェックを行うには、コンポーネントパネルの挿入を左側から選択し、検索ボタンの横にある ...(省略記号) を選択します。そして、更新を確認を選択します。

最新のコンポーネントを確認する

ライブラリから使用されるコンポーネントに更新がある場合、作成者はレビュー用にメッセージを受け取り、最新の変更を取得します。レビューと更新時に、アプリは最新のコンポーネントで更新されます。

次のアニメーションは、最新のコンポーネント取得のプロセスを示しています。

最新のコンポーネントを入手する手順

消費するアプリのコンポーネントライブラリからコンポーネントを更新する

コンポーネントライブラリからコンポーネントをインポートする場合、使用中のアプリ内で編集することはできません。 コンポーネントを編集を選択した場合、変更するために、現在のアプリ内にコンポーネントのコピーを作成するオプションが表示されます。

ライブラリコンポーネントを編集する。

コピーを作成を選択した場合、コンポーネントがローカルアプリにコピーされます。コンポーネントのローカルコピーは、挿入ウィンドウのカスタム カテゴリの下に表示されます。コンポーネントのこのローカルコピーは、元のコンポーネントライブラリの新しいバージョンが後で公開された場合、更新を受け取りません。

注意

コンポーネントのローカルコピーを作成した後、コンポーネントライブラリのコンポーネントの使用中のインスタンスは影響を受けず、コンポーネントライブラリ定義にリンクされたままになります。ローカルにコピーされたコンポーネントのインスタンスのみ (カスタム カテゴリ) は、ローカルアプリコンポーネントと見なされます。

コンポーネントライブラリの削除

コンポーネントライブラリがキャンバスアプリによって参照されている場合、削除することはできません。これは、Power Platform 環境と Power Platform 以外の環境の両方に当てはまります。ライブラリを削除する前に、アプリからコンポーネントを削除します。コンポーネントライブラリを使用しているアプリに関する情報は、ソリューションの依存関係ビューまたはライブラリを削除しようとしたときに表示されるメッセージのいずれかで確認できます。

コンポーネントライブラリの削除

コンポーネントライブラリのアクセス許可

コンポーネントライブラリの共有は、キャンバスアプリの共有と同じように機能します。コンポーネントライブラリを共有すると、他のユーザーがコンポーネントライブラリを再利用するのを許可します。共有されると、他のユーザーはコンポーネントライブラリを編集し、アプリを作成および編集するために、この共有コンポーネントライブラリからコンポーネントをインポートしてします。共同所有者として共有されている場合、ユーザーはコンポーネントライブラリを使用、編集、および共有できますが、所有者を削除または変更することはできません。

コンポーネントライブラリをセキュリティグループと共有する場合のその他の考慮事項:

ソリューションの一部として作成されたコンポーネントライブラリを共有する場合、共有 UI を使用することはできません。代わりに、CanEdit アクセス許可レベルで Set-PowerAppRoleAssignment コマンドレットを使用して、コンポーネントライブラリを選択したセキュリティグループと共有します。
Dataverse データベースを使用せず共同所有者として共有される、Power Platform 環境で作成したコンポーネントライブラリは、CanEdit アクセス許可を自動的に選択したセキュリティグループに付与します。

既知の制限

コンポーネントに適用可能な既知の制限は、コンポーネントライブラリにも適用されます。
ローカルに保存されたコンポーネントライブラリからコンポーネントをインポートすることはできません。 ファイル > 名前を付けて保存 > このコンピュータ を使用したコンポーネントライブラリの保存が可能です。ただし、そのような保存されたコンポーネントライブラリをインポートしようとすると、次のエラーメッセージが表示されます:
初めて環境にアプリとコンポーネントライブラリをインポートする場合は、アプリがコンポーネントライブラリに含まれているコンポーネントの最新バージョンを使用していることを確認してください。それ以外の場合は、インポート後にアプリが更新を受信しません。アプリは、同じ環境への後続のコンポーネントライブラリのインポート時に、更新されたバージョンを認識してプロンプトを表示します。
コードコンポーネントは、コンポーネントライブラリ内ではサポートされていません。

参照

注意