ClickOnce を使用した Office ソリューションの配置
ClickOnce を使用していくつかの手順の Office 2013 または Office 2010 にソリューションを配置できます。更新を発行すると、ソリューションは自動的に検出し、インストールします。ただし、ClickOnce はコンピューターのユーザーごとに、ソリューションを個別にインストールする必要があります。したがって、複数のユーザーが同じコンピューターでソリューションを実行する場合、Windows インストーラー (.msi) の使用を検討する必要があります。
ClickOnce 配置と Windows インストーラーの配置の違いの一覧については、配置ストラテジの選択を参照してください。
このトピックの内容
ソリューションを発行します。
ソリューションに信頼を付与するかを決定します。
Help users install the solution
エンド ユーザーのコンピューターに設定します (ドキュメント レベルのカスタマイズにのみ) ソリューション ドキュメントを
SharePoint ドキュメント レベルのカスタマイズ (のみ) を実行しているサーバーにソリューション ドキュメントを設定します
カスタム インストーラーを作成します。
Publish an update
ソリューションのインストール位置を変更します。
ソリューションを以前のバージョンにロールバックする
Windows インストーラー ファイルを作成して Office ソリューションを配置する方法の詳細については、Windows インストーラーを使用した Office ソリューションの配置を参照してください。
ソリューションを発行します。
[発行ウィザード] か [プロジェクト デザイナー] を使用して、ソリューションを発行できます。この手順では、発行オプションの完全なセットを提供するため [プロジェクト デザイナー] を使用します。「発行ウィザード (Visual Studio での Office 開発)」を参照してください。
ソリューションを発行します。
[ソリューション エクスプローラー] で、プロジェクトのという名前のノードを選択します。
メニュー バーで、プロジェクト、[プロジェクト名] **[プロパティ]**を選択します。
[プロジェクト デザイナー] では、次の図に示す [発行] のタブをクリックします。
[Publishing Folder Location (web site, ftp server, or file path)] ボックスに、[プロジェクト デザイナー] にソリューション ファイルをコピーするフォルダーのパスを入力します。
次の種類のパスを入力できます。
ローカル パス (たとえば、B: 15\FolderName\FolderName)。
ネットワーク (たとえば、) \\ServerName\FolderNameのフォルダーの名前付け規則の (UNC) (パス。
プロジェクトが既定で発行される) フォルダーにある相対パス (PublishFolder\。
[インストール フォルダーの URL] ボックスでは、エンド ユーザーがソリューションを検索場所の完全パスを入力します。
位置はわからない場合は、このフィールドには何も入力しないようにします。既定では、ClickOnce は、ユーザーがソリューションをインストール フォルダーの更新プログラムを検索します。
[必須コンポーネント] ボタンをクリックします。
[必須コンポーネント] のダイアログ ボックスで、[必須コンポーネントをインストールするセットアップ プログラムを作成する] のチェック ボックスがオンになっていることを確認します。
[インストールする必須コンポーネントを選択する] の一覧で、[Windows Installer 4.5] と .NET Framework の適切なパッケージのチェック ボックスをオンにします。
たとえば、ソリューションに .NET Framework 4.5を対象とする場合は、[Windows Installer 4.5] と [Microsoft .NET Framework 4.5 Full] のチェック ボックスをオンにします。
ソリューションが .NET Framework 4.5 を対象とする場合は、[Visual Studio 2010 Tools for Office Runtime] のチェック ボックスをオンにします。
[!メモ]
既定では、このチェック ボックスは表示されません。このチェック ボックスを表示するには、ブートストラップ パッケージを作成する必要があります。" "を参照してください。Visual Studio 2012 を使用した Office VSTO 2013 のアドインのブートストラップ パッケージの作成
[必須コンポーネントのインストール場所を指定してください] の下に表示される、選択し、[OK] のボタンを選択します。オプションの 1 つがが。
各オプションの説明を次の表に示します。
オプション
説明
[必須コンポーネントをコンポーネントの開発元の Web サイトからダウンロードする]
ユーザーは、販売元からこれらの必須コンポーネントをダウンロードし、インストールを求められます。
[アプリケーションと同じ場所から必須コンポーネントをダウンロードする]
必要なソフトウェアは、ソリューションとともにインストールされます。このオプションを選択すると、Visual Studio は、の発行の位置に必要なパッケージをすべてコピーします。このオプションを使用するには、必須パッケージが開発用コンピューターに存在する必要があります。
[次の場所から必須コンポーネントをダウンロードする]
Visual Studio は、指定したコピーし、ソリューションでのインストール位置に必要なパッケージをすべて。
「[必須コンポーネント] ダイアログ ボックス」を参照してください。
[更新プログラム] のボタンをクリックすると、頻度で更新プログラムの確認に各エンド ユーザーのカスタマイズまたはアドインを必要として指定し、[OK] のボタンの選択します。
[!メモ]
CD またはリムーバブル ドライブを使用して配置する場合は、[更新の確認をしない] のオプション ボタンを選択します。
更新を発行する方法の詳細については、Publish an Updateを参照してください。
[オプション] のボタンを選択し、[オプション] のダイアログ ボックスのオプションを確認し、次に [OK] のボタンをクリックします。
[今すぐ発行] のボタンをクリックします。
Visual Studio は、この手順の前半で指定した発行フォルダーに次のフォルダーとファイルを追加します。
[アプリケーション ファイル] フォルダー。
セットアップ プログラム。
最新バージョンの配置マニフェストを参照する配置マニフェスト。
[アプリケーション ファイル] のフォルダーに発行するバージョンごとにサブフォルダーが含まれます。それぞれのバージョン固有のサブフォルダーは次のファイルが含まれます。
アプリケーション マニフェスト。
配置マニフェスト。
カスタマイズ アセンブリ。
次の図は、Outlook アドインの発行フォルダー構造を示します。
[!メモ]
ClickOnce はアセンブリにインターネット インフォメーション サービス (IIS) の安全なインストールが安全な拡張子のファイルをブロックするように、.deploy 拡張子が追加されます。ユーザーがソリューションをインストールすると、ClickOnce は .deploy 拡張子を削除します。
この手順の前半で指定したソリューションのインストール場所にファイルをコピーします。
ソリューションに信頼を付与するかを決定します。
ソリューションがユーザーのコンピューターで実行する前に信頼を付与するソリューションをインストールするユーザーは、信頼プロンプトに応答する必要があります。ソリューションに信頼を付与するには、既知の信頼される発行者を特定する証明書を使用してマニフェストに署名します。「ソリューションのアプリケーション マニフェストと配置マニフェストの署名によって信頼します」を参照してください。
ドキュメント レベルのカスタマイズを配置していて、ドキュメントをフォルダーにユーザーのコンピューターに入力するか、または SharePoint サイトでドキュメントを使用できるようにする場合は、Office でドキュメントの場所を信頼できることを確認します。「ドキュメントへの信頼の付与」を参照してください。
ヘルプのユーザーがソリューションをインストール
ユーザーはセットアップ プログラムをことはできますが、配置マニフェストを実行することによって、またはドキュメントを直接開くドキュメント レベルのカスタマイズの場合は、ソリューションを開きますインストールします。ベスト プラクティスとして、ユーザーはセットアップ ファイルを使用してソリューションをインストールする必要があります。他の 2 とおりの方法は、必要なソフトウェアがインストールされていることを確認しません。ユーザーがインストール位置からドキュメントを開く場合は、Office アプリケーションのセキュリティ センターにある信頼できる場所の一覧に追加する必要があります。
ドキュメント レベルのカスタマイズのドキュメントの開始
ユーザーはユーザーのローカル コンピューターにコピーし、そのコピーを開くことによってドキュメント レベルのカスタマイズのドキュメントを直接インストール位置からまたは文書を開くことができます。
ベスト プラクティスとして、ユーザーは複数のユーザーが同じコピーを同時に開くことができように、ローカル コンピューターのドキュメントのコピーを開きます。この手法を適用するには、ユーザーのコンピューターにドキュメントをコピーするために、セットアップ プログラムを構成できます。「エンド ユーザーのコンピューターに設定します (ドキュメント レベルのカスタマイズにのみ) ソリューション ドキュメントを」を参照してください。
ソリューションを IIS の Web サイトから配置マニフェストを開くことによってインストール
ユーザーが Web からの配置マニフェストを開いて Office ソリューションをインストールできます。ただし、インターネット インフォメーション サービス (IIS) の安全なインストールは .vsto という拡張子を持つファイルをブロックします。MIME の種類が IIS で IIS を使用して Office ソリューションを配置する前に定義する必要があります。
の .vsto MIME の種類を IIS 6.0 に追加するには
IIS 6.0 を実行しているサーバーで、[開始]、[すべてのプログラム]、[管理ツール]、 **[インターネット インフォメーション サービス (IIS) マネージャー]**を選択します。
構成するコンピューター名、[Web サイト] のフォルダー、または Web サイトを選択します。
メニュー バーで、[アクション]、[プロパティ] を選択します。
[HTTP ヘッダー] のタブで、[MIME の種類] のボタンをクリックします。
[MIME の種類] のペインで、[新規作成] のボタンをクリックします。
[MIME の種類] のウィンドウで、拡張子が MIME の種類として、application/x ミリ秒 vsto に入力" "と入力し、新しい設定を追加するようにに .vsto。
[!メモ]
変更を有効にするために、リサイクルするためにワーカー プロセスの World Wide Web Publishing Service 待ち時間を再起動する必要があります。ディスク、ブラウザーのキャッシュをフラッシュし、次にの .vsto ファイルを開いてことを行う必要があります。
の .vsto MIME の種類を IIS 7.0 に追加するには
IIS 7.0 を実行しているサーバーで、[開始]、[すべてのプログラム]、[アクセサリ] を選択します。
[コマンド プロンプト] のショートカット メニューを開き、 [管理者として実行] を選択します。
[開く] ボックスに次のパスを入力し、を [OK] のボタンをクリックします。
%windir%\system32\inetsrv
次のコマンドを入力し、新しい設定を適用します。
set config /section:staticContent /+[fileExtension='.vsto',mimeType='application/x-ms-vsto']
[!メモ]
変更を有効にするには、World Wide Web Publishing Service を再起動するリサイクルするワーカー プロセスを待機する必要があります。ディスク、ブラウザーのキャッシュをフラッシュし、次にの .vsto ファイルを開いてことを行う必要があります。
エンド ユーザーのコンピューターに設定します (ドキュメント レベルのカスタマイズにのみ) ソリューション ドキュメントを
配置後アクションを作成すると、これらのエンド ユーザーのコンピューターにソリューションのドキュメントをコピーできます。これにより、ユーザーは、ソリューションのインストール後、インストール位置からコンピューターにドキュメントを手動でコピーする必要はありません。アプリケーション マニフェストを変更し、再署名してアプリケーション マニフェストと配置マニフェストを配置後アクション、ビルドを定義し、ソリューションを発行するクラスを作成する必要があります。
次の手順は、プロジェクト名が [ExcelWorkbook] で、コンピューターの B: 15\publish のディレクトリにソリューションを発行すると仮定します。
配置後アクションを定義するクラスを作成します。
メニュー バーで [ファイル] をクリックし、[追加] を選択し、[新しいプロジェクト] をクリックします。
[新しいプロジェクトの追加] のダイアログ ボックスで、[インストールされたテンプレート] のウィンドウで、[ウィンドウ] フォルダーを選択します。
[テンプレート] のペインで、[クラス ライブラリ] テンプレートを選択します。
[名前] のフィールドで、[FileCopyPDA]を入力し、を [OK] のボタンをクリックします。
[ソリューション エクスプローラー] では、[FileCopyPDA] のプロジェクトを選択します。
メニュー バーで、プロジェクト、[参照の追加] を選択します。
[.NET] のタブで、Microsoft.VisualStudio.Tools.Applications.Runtime および Microsoft.VisualStudio.Tools.Applications.ServerDocument への参照を追加します。
クラスの FileCopyPDAに名前を変更し、コードとファイルの内容を置き換えます。このコードは次のタスクを実行します。
ユーザーのデスクトップにドキュメントをコピーします。
_AssemblyLocation プロパティを相対パスから配置マニフェストの絶対パスに変更します。
ユーザーがソリューションをアンインストールするとファイルを削除します。
Imports Microsoft.VisualStudio.Tools.Applications.Deployment Imports Microsoft.VisualStudio.Tools.Applications Public Class FileCopyPDA Implements IAddInPostDeploymentAction Sub Execute(ByVal args As AddInPostDeploymentActionArgs) Implements IAddInPostDeploymentAction.Execute Dim dataDirectory As String = "Data\ExcelWorkbook.xlsx" Dim file As String = "ExcelWorkbook.xlsx" Dim sourcePath As String = args.AddInPath Dim deploymentManifestUri As Uri = args.ManifestLocation Dim destPath As String = Environment.GetFolderPath(Environment.SpecialFolder.DesktopDirectory) Dim sourceFile As String = System.IO.Path.Combine(sourcePath, dataDirectory) Dim destFile As String = System.IO.Path.Combine(destPath, file) Select Case args.InstallationStatus Case AddInInstallationStatus.InitialInstall, AddInInstallationStatus.Update System.IO.File.Copy(sourceFile, destFile) ServerDocument.RemoveCustomization(destFile) ServerDocument.AddCustomization(destFile, deploymentManifestUri) Exit Select Case AddInInstallationStatus.Uninstall If System.IO.File.Exists(destFile) Then System.IO.File.Delete(destFile) End If Exit Select End Select End Sub
using Microsoft.VisualStudio.Tools.Applications.Deployment; using Microsoft.VisualStudio.Tools.Applications; using System.IO; namespace FileCopyPDA { public class FileCopyPDA : IAddInPostDeploymentAction { public void Execute(AddInPostDeploymentActionArgs args) { string dataDirectory = @"Data\ExcelWorkbook.xlsx"; string file = @"ExcelWorkbook.xlsx"; string sourcePath = args.AddInPath; Uri deploymentManifestUri = args.ManifestLocation; string destPath = Environment.GetFolderPath(Environment.SpecialFolder.DesktopDirectory); string sourceFile = System.IO.Path.Combine(sourcePath, dataDirectory); string destFile = System.IO.Path.Combine(destPath, file); switch (args.InstallationStatus) { case AddInInstallationStatus.InitialInstall: case AddInInstallationStatus.Update: File.Copy(sourceFile, destFile); ServerDocument.RemoveCustomization(destFile); ServerDocument.AddCustomization(destFile, deploymentManifestUri); break; case AddInInstallationStatus.Uninstall: if (File.Exists(destFile)) { File.Delete(destFile); } break; } }
ソリューションをビルドして発行します。
[ソリューション エクスプローラー] では、[FileCopyPDA] のプロジェクトのショートカット メニューを開き、[ビルド] を選択します。
[ExcelWorkbook] のプロジェクトのショートカット メニューを開き、[ビルド] を選択します。
[ExcelWorkbook] のプロジェクトのショートカット メニューを開き、[参照の追加] を選択します。
[参照の追加] のダイアログ ボックスで、[プロジェクト] のタブをクリックし、[FileCopyPDA] を選択し、を [OK] のボタンをクリックします。
[ソリューション エクスプローラー] では、[ExcelWorkbook] のプロジェクトを選択します。
メニュー バーで、プロジェクト、[新しいフォルダー] を選択します。
データを入力し、Enter キーを選択します。
[ソリューション エクスプローラー] では、[データ] フォルダーを選択します。
メニュー バーで、プロジェクト、[既存項目の追加] を選択します。
[既存項目の追加] のダイアログ ボックスで、[ExcelWorkbook] プロジェクトの出力ディレクトリに移動し、[ExcelWorkbook.xlsx] ファイルを選択し、を [追加] のボタンをクリックします。
[ソリューション エクスプローラー] で [ExcelWorkbook.xlsx] のファイルを選択します。
[プロパティ] のペインで、[コンテンツ] に [ビルド アクション] のプロパティと [新しい場合はコピーする] に [出力ディレクトリにコピー] のプロパティを変更します。
これらの手順を完了すると、プロジェクトは次の図のようになります。
[ExcelWorkbook] のプロジェクトを発行します。
アプリケーション マニフェストを変更します。
[エクスプローラー] を使用して c: \publish のディレクトリを開きます。
[アプリケーション ファイル] フォルダーを開き、ソリューションの最新のによって発行されたバージョンに対応するフォルダーを開きます。
メモ帳などのテキスト エディターで [ExcelWorkbook.dll.manifest] ファイルを開きます。
</vstav3:update> の要素の後に、次のコードを追加します。<vstav3:entryPoint> 要素の class 属性には、<名前空間名>.<クラス名> という構文を使用します。次の例では、名前空間とクラス名は同じですが、この結果エントリ ポイント名は FileCopyPDA.FileCopyPDAです。
<vstav3:postActions> <vstav3:postAction> <vstav3:entryPoint class="FileCopyPDA.FileCopyPDA"> <assemblyIdentity name="FileCopyPDA" version="1.0.0.0" language="neutral" processorArchitecture="msil" /> </vstav3:entryPoint> <vstav3:postActionData> </vstav3:postActionData> </vstav3:postAction> </vstav3:postActions>
アプリケーション マニフェストと配置マニフェストに再署名します。
%USERPROFILE%\Documents\Visual Studio の 2012\Projects\ExcelWorkbook\ExcelWorkbook のフォルダーで、ExcelWorkbook_TemporaryKey.pfx の証明書ファイルをコピーし、PublishFolder \Application Files\ExcelWorkbookMostRecentPublishedVersion フォルダーに貼り付けます。
Visual Studio コマンド プロンプトを開き、c: \publish\Application Files\ExcelWorkbookMostRecentPublishedVersion フォルダーにディレクトリを変更します (たとえば、) を c: \publish\Application Files\ExcelWorkbook_1_0_0_4。
次のコマンドを実行して、変更したアプリケーション マニフェストに署名する:
mage -sign ExcelWorkbook.dll.manifest -certfile ExcelWorkbook_TemporaryKey.pfx
"ExcelWorkbook.dll.manifest が正常に署名されました" というメッセージが表示されます。
次に c: \publish フォルダーへの変更は、次のコマンドを実行して、配置マニフェストを更新して署名する:
mage -update ExcelWorkbook.vsto -appmanifest "Application Files\Ex celWorkbookMostRecentVersionNumber>\ExcelWorkbook.dll.manifest" -certfile "Application Files\ExcelWorkbookMostRecentVersionNumber>\ExcelWorkbook_TemporaryKey.pfx"
[!メモ]
前の例では、ソリューションの発行されたバージョンの最新バージョン番号に置き換えます MostRecentVersionNumber (たとえば、1_0_0_4)。
"ExcelWorkbook.vsto 正常に署名されました" というメッセージが表示されます。
c: \publish\Application Files\ExcelWorkbookMostRecentVersionNumber の ExcelWorkbook.vsto ファイルをディレクトリにコピーします。
SharePoint ドキュメント レベルのカスタマイズ (のみ) を実行しているサーバーにソリューション ドキュメントを設定します
エンド ユーザーに SharePoint 使用してドキュメント レベルのカスタマイズを発行できます。ユーザーが SharePoint サイトにアクセスし、文書を開くと、ランタイムは自動的に共有ネットワーク フォルダーからユーザーのローカル コンピューターにソリューションをインストールします。ソリューションがローカルにインストールされた後、カスタマイズは、デスクトップなどのドキュメントが別の場所にコピー機能します。
ドキュメントを SharePoint を実行しているサーバーに配置するには
SharePoint サイトのドキュメント ライブラリにソリューション ドキュメントを追加します。
次の方法の 1 種類の手順を実行します:
すべてのユーザーのコンピューターで Word または Excel のセキュリティ センターに SharePoint を実行しているサーバーを追加するには、Office 構成ツールを使用します。
" "を参照してください。Office 2010 のセキュリティ ポリシーと設定
各ユーザーが次の手順を実行することを確認します。
ローカル コンピューターでを開き Word または Excel が、[ファイル] のタブをクリックし、[オプション] のボタンを選択します。
[セキュリティ センタ] のダイアログ ボックスで、[信頼できる場所] のボタンをクリックします。
[プライベート ネットワーク上にある信頼できる場所を許可する (推奨しません)] のチェック ボックスをオンにし、[新しい場所の追加] のボタンをクリックします。
[パス] ボックスで (たとえば、) http://SharePointServerName/TeamName/ProjectName/DocumentLibraryNameアップロードしたドキュメントを含む SharePoint ドキュメント ライブラリの URL を入力します。
default.aspx や AllItems.aspx など、既定の Web ページの名前を追加しないでください。
[この場所のサブフォルダーも信頼する] のチェック ボックスをオンにし、[OK] のボタンをクリックします。
ユーザーが SharePoint サイトからドキュメントを開くと、ドキュメントが開き、カスタマイズがインストールされます。ユーザーは、その文書をデスクトップにコピーできます。カスタマイズはまだドキュメントのネットワークの場所へのドキュメントのポイントのプロパティ実行されます。
カスタム インストーラーを作成します。
ソリューションを発行すると、作成されるセットアップ プログラムを使用する代わりに、Office ソリューション用のカスタム インストーラーを作成できます。たとえば、インストールを開始するには、ログイン スクリプトを使用するか、ユーザーとの対話を使用しないソリューションのインストールにバッチ ファイルを使用できます。これらのシナリオでは、必須コンポーネントがエンド ユーザーのコンピューターに既にインストールされている場合に最適です。
カスタム インストール プロセスの一環として、次の位置に既定でインストールされている Office ソリューション (VSTOInstaller.exe) のインストーラー ツールを呼び出します:、
%commonprogramfiles%\microsoft shared\VSTO\10.0\VSTOInstaller.exe
ツールがその位置にない場合、そのツールのパスを取得するには HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath or HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath or HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath or HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath or HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath or HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath or HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath or HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath レジストリ キーを使用できます。
VSTOinstaller.exe の次のパラメーターを使用できます。
パラメーター |
定義 |
---|---|
/Install または /I |
ソリューションをインストールします。配置マニフェストのパスでこのオプションに従う必要があります。ローカル コンピューター、汎用的な名前付け規則の (UNC) ファイル共有、または HTTP/HTTPS Web サイトのパスを指定できます。ローカル パス (B: 15\FolderName\PublishFolder)、相対パス (Publish\)、完全修飾位置を指定できます (\\ServerName\FolderName か https://ServerName/FolderName)。 |
/Uninstall または /U |
ソリューションをアンインストールします。配置マニフェストのパスでこのオプションに従う必要があります。ローカル コンピューター、UNC ファイル共有、または HTTP/HTTPS Web サイトでもかまいませんパスを指定できます。ローカル パス (c: \FolderName\PublishFolder)、相対パス (Publish\)、完全修飾位置を指定できます (\\ServerName\FolderName か https://ServerName/FolderName)。 |
/Silent または /S |
入力のユーザーが入力するか、またはメッセージを表示インストールまたはアンインストールします。信頼プロンプトが必要な場合は、カスタマイズのインストールまたは更新されません。 |
/Help または /? |
ヘルプ情報を表示します。 |
VSTOinstaller.exe を実行すると、次のエラー コードが表示されることがあります。
エラー コード |
定義 |
---|---|
0 |
ソリューションが正常にインストールまたはアンインストールされている場合、VSTOInstaller ヘルプが表示されます。 |
-100 |
一つ以上のコマンド ライン オプションが有効でないか、または何度も設定されました。詳細については、"vstoinstaller /?" と入力するか、または、ClickOnce Office ソリューションのカスタム インストーラーの作成"を参照してください。 |
-101 |
一つ以上のコマンド ライン オプションが無効です。詳細については、"vstoinstaller/" と入力します。 |
-200 |
配置マニフェストの URI が無効です。詳細については、"vstoinstaller/" と入力します。 |
-201 |
ソリューションは、配置マニフェストが有効でないため、インストールできませんでした。「Office ソリューション用配置マニフェスト」を参照してください。 |
-202 |
ソリューションは、Office アプリケーション マニフェストのセクション用の Visual Studio ツールが無効であるため、インストールできませんでした。「Office ソリューション用アプリケーション マニフェスト」を参照してください。 |
-203 |
ソリューションは、ダウンロードのエラーが発生したためインストールできませんでした。配置マニフェストの URI またはネットワーク ファイルの位置を確認し、もう一度実行します。 |
-300 |
ソリューションはセキュリティ例外が発生したため、インストールできませんでした。「Office ソリューションのセキュリティ保護」を参照してください。 |
-400 |
ソリューションをインストールできませんでした。 |
-401 |
ソリューションをアンインストールできませんでした。 |
-500 |
操作は、ソリューションをインストールまたはアンインストールできないか、配置マニフェストをダウンロードできないため、Cancel。 |
更新を発行します。
ソリューションを更新するには、[プロジェクト デザイナー] か [発行ウィザード] で再び発行し、をインストール場所に更新されたソリューションをコピーします。インストール場所にファイルをコピーするときに、前のファイルを上書きすることを確認します。
ソリューションが更新プログラムをチェックし、次に、自動的に新しいバージョンが検出、読み込みます。
ソリューションのインストール位置を変更します。
ソリューションを発行した後、インストール パスを追加または変更できます。次の理由の一つ以上のインストール パスを変更する可能性があります:
セットアップ プログラムのインストール パスが既知の前にコンパイルされます。
ソリューション ファイルは、別の場所からコピーされたものである。
インストール ファイルをホストするサーバーの名前または位置があります。
ソリューションのインストール パスを変更するには、セットアップ プログラムを更新し、ユーザーが実行する必要があります。ドキュメント レベルのカスタマイズの場合、ユーザーは、新しい場所を指すように、ドキュメントのプロパティを更新する必要があります。
[!メモ]
ユーザーにドキュメント プロパティを更新したときに依存しない場合は、ユーザーにインストール場所から更新されたドキュメントを取得してもらうことができます。
セットアップ プログラムのインストール パスを変更するには
[コマンド プロンプト] のウィンドウを開き、インストール フォルダーにディレクトリを変更します。
セットアップ プログラムを実行して、文字列として新しいインストール パスを使用する /url パラメーターを指定します。
次の例に、必要なパスで、Fabrikam の Web サイトの場所にインストール パスを変更する方法をその URL を置き換えることができますが示されています:
setup.exe /url="http://www.fabrikam.com/newlocation"
[!メモ]
実行可能ファイルの定義が無効であることを示すメッセージが表示され、参照する場合は、ソリューションの署名に使用された証明書が無効、発行者が不明ではありません。その結果、ユーザーはそれをインストールする前に、ソリューションのソースを信頼することを確認する必要があります。
[!メモ]
URL の現在の値を表示するには、/LTCG setup.exe /url。
ドキュメント レベルのカスタマイズでは、ユーザーがドキュメントを開き、_AssemblyLocation のプロパティを更新する必要があります。次の手順では、ユーザーがこのタスクを実行する方法について説明します。
ドキュメントの_AssemblyLocation のプロパティを更新するには
[ファイル] のタブでは、次の図に示す [情報] を選択します。
[プロパティ] の一覧で、次の図に示す [詳細プロパティ] を選択します。
[プロパティ] の一覧の [カスタム] のタブでは、次の図に示すように、_AssemblyLocationを選択します。
[値] ボックスは配置マニフェストの識別子が含まれます。
識別子の前に、バーに続くファイル形式 [パス]にドキュメントの絶対パスを入力します。 |[識別子] (たとえば、File://ServerName/FolderName/FileName|74744e4b-e4d6-41eb-84f7-ad20346fe2d9。
この識別子を指定する方法の詳細については、「カスタム ドキュメント プロパティの概要」を参照してください。
次に [OK] のボタンを選択し、ドキュメントを保存して閉じます。
指定した位置のソリューションをインストールするには /url のパラメーターなしでセットアップ プログラムを実行します。
ソリューションを以前のバージョンにロールバックする
ソリューションをロールバックする場合、そのソリューションの以前のバージョンにユーザーが元に戻されます。
ソリューションをロールバックする
ソリューションのインストール位置を開きます。
トップレベルの発行フォルダーで、配置マニフェスト (.vsto ファイル) を削除します。
、ロールバックするするバージョンのサブフォルダーを検索します。
このサブフォルダー内の配置マニフェストをトップレベルの発行フォルダーにコピーします。
たとえば、バージョン 1.0.0.1 のバージョン 1.0.0.0 への OutlookAddIn1 と呼ばれる、ソリューションをコピー OutlookAddIn1_1_0_0_0 のフォルダーからファイル OutlookAddIn1.vsto をロールバックします。既にあった OutlookAddIn1_1_0_0_1 用のバージョン固有の配置マニフェストを上書きするトップレベルの発行フォルダーにファイルを貼り付けます。
次の図は、この例で発行フォルダー構造を示します。
ユーザーがアプリケーションまたはカスタマイズされたドキュメントを開くときに、配置マニフェストの変更が検出されます。Office ソリューションの以前のバージョンは、ClickOnce キャッシュから実行されます。
[!メモ]
ローカル データは、ソリューションの 1 つ前のバージョンについてのみ保存されます。2 種類のバージョンをロールバックする場合は、ローカル データは保持されません。ローカル データの詳細については、ClickOnce アプリケーションにおけるローカル データおよびリモート データへのアクセス"を参照してください。
参照
その他の技術情報
ClickOnce を使用した Office ソリューションの配置
方法: ClickOnce を使用して Office ソリューションを公開する
方法: ClickOnce Office ソリューションをインストールする
方法: ClickOnce を使用して SharePoint Server にドキュメント レベルの Office ソリューションを公開する