手順3: アプリの AppSource パッケージを作成する
ソリューションおよびデモ データ ファイルを他の必須ファイルと共に含めるにあたって、 AppSource パッケージ (.zip ファイル) を作成する必要があります。 AppSource のパッケージは以下のファイルから構成されます:
| ファイル | 説明 |
|---|---|
| パッケージ ファイル | ソリューションおよびデモ構成データを複数言語に展開するにあたって Package Deployer ツールが使用するパッケージ ファイル。 |
| [Content_Types].xml | AppSource パッケージに含まれるファイル拡張子のMIMEタイプ情報を提供するファイル。 これらは通常、.config、.dll、.exe、.xml、および .zip のファイルの種類ですが、Windows によってサポートされるほとんどすべてのファイルの種類を追加することができます。 |
| アイコン ファイル | appsource パッケージ アイコンのイメージ ファイル。サイズは 32x32 ピクセルである必要があります。 有効なイメージ フォーマットは PNG および JPG です。 |
| [HTML ファイル] | ライセンス条項含むファイル。 |
| Input.xml | AppSource パッケージの資産を示すファイル。 |
パッケージ ファイルを作成する
アプリに関連付けられた複数のファイルを同時にバンドルおよび展開することができるパッケージ。
手順 2: アプリの管理ソリューションを作成するで作成したソリューションおよび構成データ ファイルを含める Dynamics 365 パッケージを作成します。 また、パッケージには、パッケージが Microsoft Dataverse インスタンスに展開される前、間、または後に実行可能なカスタム コードを含むことができます。 パッケージ ファイルの作成に関する詳細については、 Package Deployerのパッケージを作成する を参照してください。
パッケージを作成すると、パッケージは以下の内容で構成されます。
<PackageName> フォルダー: このフォルダーには、すべてのソリューション、構成データ、フラット ファイル、およびパッケージの内容が含まれます。 例: PkgFolder。
<PackageName>.DLL: アセンブリには、パッケージのカスタム コードが含まれています。 例: SamplePackage.dll。
次に、パッケージに含まれるファイル拡張子のMIMEタイプ情報を提供する [Content_Types].xml ファイルを作成します。 これは、 AppSource パッケージに再び含まれるものとは別のものです。 これは一覧表示されるファイルの種類の [Content_Types].xml ファイルのサンプル コンテンツです。
<?xml version="1.0" encoding="utf-8"?> <Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types"> <Default Extension="xml" ContentType="application/octet-stream" /> <Default Extension="xaml" ContentType="application/octet-stream" /> <Default Extension="dll" ContentType="application/octet-stream" /> <Default Extension="zip" ContentType="application/octet-stream" /> <Default Extension="jpg" ContentType="application/octet-stream" /> <Default Extension="gif" ContentType="application/octet-stream" /> <Default Extension="png" ContentType="application/octet-stream" /> <Default Extension="htm" ContentType="application/octet-stream" /> <Default Extension="html" ContentType="application/octet-stream" /> <Default Extension="db" ContentType="application/octet-stream" /> <Default Extension="css" ContentType="application/octet-stream" /> <Default Extension="json" ContentType="application/octet-stream" /> <Default Extension="msapp" ContentType="application/octet-stream" /> </Types>以下のファイルを package.zip という名前のファイルに圧縮 (zip) します。
パッケージ フォルダー (PkgFolder)
パッケージ dll (SamplePackage.dll)
[Content_Types].xml
これらのファイルを圧縮するには、これらのファイルが存在する場所のフォルダーを探して、すべてを選択し、右クリックし送信先>圧縮 (zip) フォルダーの順に選択します。
.zip ファイルの名前を package.zip に変更します。
[Content_Types].xml を作成する
前述の 手順 2 のセクションで作成した [Content_Types].xml を再利用することができます。
AppSource パッケージのアイコンを作成する
Dynamics 365 管理センター ポータルに目的のソリューション名と説明と共に表示する、32x32 サイズのアイコン ファイルを作成します。 有効なファイル フォーマットは PNG および JPG です。
ライセンス条項の HTML ファイルを作成する
ライセンス条項を含む HTML ファイルを作成します。 アプリケーションが複数言語をサポートしている場合、ユーザーが選択した言語でライセンス条項を表示するために、言語ごとに HTML ファイルを持つことができます。
input.xml ファイルの作成
パッケージおよびパッケージのコンテンツに関する情報を提供する input.xml ファイルを作成します。 これはサンプル ファイル input.xml のコンテンツです。各要素は表の後半で説明されます。
<?xml version="1.0" encoding="utf-8"?>
<PvsPackageData>
<ProviderName>Microsoft</ProviderName>
<PackageFile>package.zip</PackageFile>
<SolutionAnchorName>SampleSolution.zip</SolutionAnchorName>
<StartDate>12/01/2017</StartDate>
<EndDate>01/01/2031</EndDate>
<SupportedCountries>US,CA</SupportedCountries>
<LearnMoreLink>https://www.microsoft.com</LearnMoreLink>
<Locales>
<PackageLocale Code="1033" IsDefault="true">
<Logo>logo32x32.png</Logo>
<Terms>
<PackageTerm File="TermsOfUse.html" />
</Terms>
</PackageLocale>
</Locales>
</PvsPackageData>
重要
XML 要素の属性はすべて大文字と小文字を区別します。
これは input.xml ファイル内の要素の説明です。
| 要素 | 説明設定 |
|---|---|
| ProviderName | ソリューション プロバイダーの名前。 Microsoft 社内チームによって作成された場合は、 Microsoft 指定します。 |
| PackageFile | Package Deployer ツールのパッケージ (.zip ファイル) の名称。 この zip ファイルには、パッケージ アセンブリ、アプリ資産を持つパッケージ フォルダー、および Content_Types.xml ファイルを含める必要があります。 たとえば、パッケージ ファイルを作成するセクションで作成された package.zip ファイルです。 |
| SolutionAnchorName | ソリューション資産の表示名称と説明に使用される、パッケージ内のソリューションzipファイルの名称。 |
| StartDate | AppSource でアプリが利用可能になった日付。 形式は MM/DD/YYYY です。 |
| 終了日 | AppSource でアプリが利用できなくなった日付。 形式は MM/DD/YYYY です。 |
| SupportedCountries | これはアプリが利用可能な国または地域をコンマで区切ったリストです。 この記事を書いている時点で、サポートされている国のリストは次のとおりです: AD、AE、AF、AG、AI、AL、AM、AO、AQ、AR、AS、AT、AU、AW、AX、AZ、BA、BB、BD、BE、BF、BG、BH、BI、BJ、BL、BM、BN、BO、BR、BS、BT、BV、BW、BY、 BZ、CA、CC、CD、CF、CG、CH、CI、CK、CL、CM、CN、CO、CR、CV、CW、CX、CY、CZ、DE、DJ、DK、DM、DO、DZ、EC、EE、EG、ER、ES、ET、FI、FJ、FK、FM、 FO、FR、GA、GB、GD、GE、GF、GG、GH、GI、GL、GM、GN、GP、GQ、GR、GS、GT、GU、GW、GY、HK、HM、HN、HR、HT、HU、ID、IE、IL、IM、IN、IO、IQ、IS、 IT、JE、JM、JO、JP、KE、KG、KH、KI、KM、KN、KR、KW、KY、KZ、LA、LB、LC、LI、LK、LR、LS、LT、LU、LV、LY、MA、MC、MD、ME、MF、MG、MH、MK、ML、 MM、MN、MO、MP、MQ、MR、MS、MT、MU、MV、MW、MX、MY、MZ、NA、NC、NE、NF、NG、NI、NL、NO、NP、NR、NU、NZ、OM、PA、PE、PF、PG、PH、PK、PL、PM、 PN、PR、PS、PT、PW、PY、QA'RE、RO、RS、RU、RW、SA、SB、SC、SE、SG、SH、SI、SJ、SK、SL、SM、SN、SO、SR、ST、SV、SZ、TC、TD、TF、TG、TH、TJ、 TK, TL,TM,TN,TO,TR,TT,TV,TW,TZ,UA,UG,UM,US,UY,UZ,VA,VC'VE,VG,VI,VN,VU,WF,WS, YE、YT、ZA、ZM、ZW |
| LearnMoreLink | このパッケージの詳細情報ページの URL。 |
| ロケール | 目的のソリューション UI でサポートする各言語のためのこのノードのインスタンス。 このノードには以下の子要素が含まれます。 - PackageLocale.Code: このノードの言語のLCID。 例: 米国英語は 1033 です 注: solution.xmlファイルとinput.xmlファイルの両方に同じロケール コードが含まれていることを確認してください。 - PackageLocale.IsDefault: デフォルトの言語を示します。 顧客が選択した言語が利用可能でない場合は、これが代替言語として使用されます。 - ロゴ: アプリ パッケージのロゴ。 イメージのサイズは 32x32 である必要があります。 有効なイメージ フォーマットは PNG および JPG です。 - 条件: 各言語のライセンス条件を含むHTMLファイルの名前。 |
重要
SupportedCountries 要素では、国コードの間にスペースや改行キーワードが入らないようにしてください。
AppSource パッケージにアイテムを追加する
最後の手順は、以前作成済みのすべてのコンポーネントを単一の圧縮 (zip) ファイルに追加することです。これはアプリ ソース パッケージになります。
パッケージファイル、 [Content_Types].xml、 アイコン、 ライセンス条件ファイル (HTML) が格納されているフォルダに移動します。そのすべてを選択し、右クリックして 送る>圧縮(zip形式)フォルダーを選択します。
重要
ここで説明されているパッケージのコンテンツ構造に正確に従う必要があります。 従わない場合は、パッケージは認証中に失敗します。 認証失敗につながる一般的な問題の一部は、不正確なファイル名または入れ子ファイル構造です。
アプリごとにファイルの名前を適切に変更します。 会社名とアプリ名を含めることを推奨します。 例: Microsoft_SamplePackage.zip。