コードコンポーネントをパッケージ化する

[アーティクル]
04/04/2023

この記事では、コードコンポーネントを Microsoft Dataverse にインポートする方法について説明します。 Microsoft Power Platform CLI を使用してコードコンポーネントを実装した後、次のステップは、すべてのコードコンポーネント要素をソリューションファイルにバンドルし、ソリューションファイルを Dataverse にインポートし、実行時にコードコンポーネントを確認できるようにします。

ソリューションファイルを作成およびインポートするには:

サンプルコンポーネントフォルダ内に新しいフォルダを作成し、コマンド mkdir Solutions を使用して ソリューション (または任意の名前) という名前を付けます。コマンド cd Solutions を使用して、ディレクトリに移動します。
pac solution init コマンドを使用して新しいソリューションプロジェクトを作成します。ソリューションプロジェクトは、コードコンポーネントをソリューション zip ファイルにバンドルする目的で使用され、Dataverse へのインポートに使用されます。
```
pac solution init --publisher-name developer --publisher-prefix dev
```
注意

publisher-name と publisher-prefix の値は環境に固有である必要があります。
新しいソリューションプロジェクトが作成されたら、作成したサンプルコンポーネントがある場所の ソリューション フォルダーを参照します。 pac solution add-reference コマンドを使用して参照を追加することができます。この参照は、コードコンポーネントがビルド中に追加すべきソリューションのプロジェクトを通知します。参照を 1 つのソリューションのプロジェクトの複数コンポーネントへ追加できます。
```
 pac solution add-reference --path c:\downloads\mysamplecomponent
```
ソリューションプロジェクトから zip ファイルを生成するには、ソリューションプロジェクトのディレクトリに移動して、以下のコマンドを使用してプロジェクトを構築する必要があります。このコマンドは MSBuild を使用して、復元の一部として NuGet の依存関係をプルダウンすることで、ソリューションプロジェクトを構築します。初めてソリューションプロジェクトを構築する際には /restore のみを使用します。その後の各ビルドに対しては、コマンド msbuild を実行できます。
```
msbuild /t:build /restore
```
ヒント
- msbuild 15.9.*がパスに存在しない場合は、VS2017の開発者コマンドプロンプトを開いて msbuild コマンドを実行します。
- デバッグ 構成でソリューションをビルドして、アンマネージドソリューションパッケージを生成します。管理ソリューションパッケージは、リリース 構成でソリューションを構築することにより生成されます。これらの設定は、cdsproj ファイルの SolutionPackageType プロパティを指定することでオーバーライドできます。
- 運用ビルドを発行するためにRelease にmsbuild構成を設定できます。例: msbuild /p:configuration=Release
- ソリューションで msbuild コマンドを実行する際に Ambiguous project name と言うエラーが発生した場合は、ソリューション名とプロジェクト名が同じでないことを確認してください。
生成されたソリューションファイルは、ビルド正常に行なわれたら \bin\debug\ フォルダー内に配置されます。
Web ポータルを使用して手動でソリューションを Dataverse にインポートするか、Microsoft Power Platform Build Tools を使用して自動的にインポートします。

環境に接続しています

コードコンポーネントは、Dataverse 環境に接続して、その後その更新されたコンポーネントをプッシュすることで Microsoft Power Platform CLI から直接デプロイできます。

以下の手順に従って、認証プロファイルを作成し、Dataverse に接続して、更新されたコンポーネントをプッシュします。

pac auth create コマンドを使用して、認証プロファイルを作成します。
```
pac auth create --url https://xyz.crm.dynamics.com 
```
前に認証プロファイルを作成した場合は、pac auth list コマンドを使用してすべての既存プロファイルを表示できます。
```
 pac auth list 
```
前に作成した認証プロファイル間を切り替えるには、pac auth select コマンドを使用します。
```
 pac auth select --index <index of the active profile>
```
環境に関する基本情報を取得するには、pac org who コマンドを使用します。接続は既定の認証のプロファイルを使用しておこないます。
```
pac org who 
```
特定の認証プロファイルを削除するには、pac auth delete コマンド pac auth delete --index <index of the profile> を使用します。
ローカルコンピューターからすべての認証プロファイルをオフにする場合は、pac auth clear コマンドを使用します。この操作は、ローカルコンピュータから完全に authprofile.json ファイルやトークンキャッシュファイルを削除するため不可逆です。

コードコンポーネントのデプロイ

認証プロファイルを正常に作成したら、最新の変更をすべて加えて、コードコンポーネントを Dataverse インスタンスにプッシュし始めることができます。

push 機能は、コードコンポーネントのバージョン管理要件をバイパスして、コードコンポーネントをインポートするためにソリューション (cdsproj) を作成する必要がないため、社内開発者サイクルの開発を高速化します。

push 機能を使用するには、以下のことを行います:

有効な認証のプロファイルを作成したことを確認します。
サンプルコンポーネントファイルが配置されているディレクトリに移動します。
pac pcf push コマンドを実行します。
```
pac pcf push --publisher-prefix <your publisher prefix>
```
注意

push コマンドで使用する公開元は、コンポーネントを含むソリューションの公開元の接頭辞と一致させる必要があります。

ソリューションからのコンポーネントの削除

ソリューションファイルからコードコンポーネントを削除したい場合:

ソリューションプロジェクトディレクトリの cdsproj ファイルを編集し、コンポーネントへの参照を削除します。以下は、コンポーネント参照の例です:

<ItemGroup>
    <Projectreference Include="..\pcf_component\pcf_component.pcfproj">
      <Project>0481bd83-ffb0-4b70-b526-e0b3dd63e7ef</Project>
      <Name>pcf_component</Name>
      <Targets>Build</Targets>
      <referenceOutputAssembly>false</referenceOutputAssembly>
      <OutputItemType>Content</OutputItemType>
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </Projectreference>
</ItemGroup>

以下のコマンドを使用して再構築 (またはクリーンアップ) を実行します:
```
msbuild /t:rebuild
```

次の方法で共有

コードコンポーネントをパッケージ化する

環境に接続しています

コードコンポーネントのデプロイ

ソリューションからのコンポーネントの削除

関連項目

その他のリソース

次の方法で共有

コード コンポーネントをパッケージ化する

環境に接続しています

コード コンポーネントのデプロイ

ソリューションからのコンポーネントの削除

関連項目

その他のリソース

コードコンポーネントをパッケージ化する

コードコンポーネントのデプロイ