SharePoint ソリューションのトラブルシューティング
次の問題または警告は、Visual Studio デバッガーを使用して SharePoint ソリューションをデバッグするときに発生する可能性があります。 詳細については、SharePoint 2007 ワークフロー ソリューションのデバッグに関する記事を参照してください。
サンドボックス視覚的 Web パーツでのトークンの制約
サンドボックス ソリューションの視覚的 Web パーツは、SharePoint ランタイムでサポートされる $SPUrl などの標準トークンを処理できません。 そのため、URL は解決されず、次の例のように、スクリプト要素でこのトークンを直接参照する場合、視覚的 Web パーツ デザイナーのデザイン ビューでコンテンツをプレビューできません。
<script src="<% $SPUrl:~site/SiteAssets/ListOperations.js %>"></script>
この制限を回避し、トークンを解決するには、次のようにリテラルを使用してトークンを参照します。
<asp:literal ID="Literal1" runat="server" Text="<script src='" />
<asp:literal ID="Literal2" runat="server" Text="<% $SPUrl:~site/SiteAssets/ListOperations.js %>" />
<asp:literal ID="Literal3" runat="server" Text="' type='text/javascript' ></script>" />
プロジェクトとプロジェクト アイテムの名前の文字制限
プロジェクトとプロジェクト アイテムの名前には、SharePoint 2010 の配置パスで有効な文字だけを使用できます。 他の文字は使用できません。
エラー メッセージ
"無効な文字" エラー メッセージ。
解像度
SharePoint のプロジェクトとプロジェクト アイテムの名前では、次の文字だけを使用してください。
ASCII 英数字
Space
ピリオド (.)
コンマ (,)
アンダースコア (_)
ダッシュ (-)
円記号 (\)
プロジェクトがパッケージされるとき、検証規則により、配置される各ファイルの配置パス プロパティに有効な文字だけが含まれていることが確認されます。
カスタム フィールド作成時のエラー
Visual Studio の場合、カスタム フィールドは XML で定義されます。 フィールドが特定の形式で定義または参照されていない場合、エラーが発生する可能性があります。
エラー メッセージ
パッケージ実行時の "無効な文字" エラー メッセージ。
解像度
フィールド定義の ID には、次の例のように、中かっこで囲まれた GUID を指定する必要があります。
<Field ID="{5744d18c-305e-4632-8bd1-09d134f4830d}"
Type="Note"
Name="PatientName"
DisplayName="Patient Name"
Group="A Custom Group">
</Field>.
次の例に示すように、コンテンツ タイプ内のフィールド参照は、開始/終了要素 (<FieldRef></FieldRef>) ではなく、空の要素の形式 (<FieldRef />) で定義する必要があります。
<FieldRef ID="{5744d18c-305e-4632-8bd1-09d134f4830d}"
Name="PatientName"
DisplayName="Patient Name"
Required="TRUE"/>
フィールドのソース XML の形式が間違っている場合、有効な XML ファイルでない場合、またはその他の問題がある場合、"ファイルを解析できません" エラーが発生します。
英語以外の新しいサイト定義が配置後にサイトの作成ページに表示されない
英語以外のバージョン (ロケール ID が 1033 以外のバージョン) の Visual Studio を使用してサイト定義を作成して配置した後に、[テンプレートの選択] ボックスに [SharePoint のカスタマイズ] タブが表示されず、[新しい SharePoint サイト] ページに新しいサイト テンプレートが表示されません。
エラー メッセージ
なし。
解像度
この問題は、webtemp サイト定義構成ファイル (webtemp_SiteDefinitionProject1.xml など) の [パス] プロパティの値が正しくないために発生します。 webtemp ファイルの [パス] プロパティ ([配置場所] の下にあります) で、1033 を適切なロケール ID に変更します。 たとえば、日本語ロケールを使用するには、値を 1041 に変更します。 詳細については、「 Microsoft によって割り当てられているロケール ID」を参照してください。
ワークフロー プロジェクトをクリーン システムに配置するとエラーが表示される
この問題は、Visual Studio のワークフロー プロジェクトをクリーン システムに配置した場合に発生します。 クリーン システムとは、Visual Studio と SharePoint の新しいインストールが含まれているが、ワークフロー プロジェクトは配置されていないコンピューターです。
エラー メッセージ
SharePoint リストが見つかりません: ワークフローの履歴。
解像度
このエラーが発生するのは、ワークフローの履歴リストがないからです。 開発環境がクリーン システムの場合、ワークフローが配置されていないため、ワークフローの履歴リストはまだ存在しません。 この問題を解決するには、ワークフロー ウィザードをもう一度開きます。これにより、ワークフローの履歴リストが作成されます。
ワークフロー ウィザードを再実行するには
ソリューション エクスプローラーでワークフロー ノードを選択します。
[プロパティ] ウィンドウで、省略記号 [...] ボタンが付いている任意のプロパティの省略記号ボタンを選択します。
デバッグ中に更新されたイメージを表示するにはブラウザーでアプリケーション ページを更新する必要がある
デバッグしている SharePoint ソリューションに、イメージを表示するコントロール (HTML Image コントロールなど) を含むアプリケーション ページが含まれている場合に、そのイメージに対して行われた変更を表示するには、ブラウザーでページを更新する必要があります。
エラー: サイトの場所が有効ではありません
この問題は、SharePoint Server がインストールされていない場合に発生することがあります。 また、SharePoint カスタマイズ ウィザードで指定した SharePoint Web サイトに対する管理者の権限がない場合にも発生する可能性があります。
エラー メッセージ
- 入力されている SharePoint サイトの場所が有効ではありません。
解像度
SharePoint Server をインストールします。
SharePoint Web サイトに対する管理者の権限があることを確認します。 詳細については、Office Online の記事「SharePoint Server でサービス アプリケーションの管理者を割り当てる、または削除する」を参照してください。
イベント レシーバー プロジェクトでサイト削除 Web イベントが発生しない
イベント レシーバー プロジェクトを作成し、"サイトが削除されています" などの特定の Web イベントを選択すると、イベントは発生しません。
エラー メッセージ
なし。
解像度
この問題は、サイト レベルのイベントを処理するにはフィーチャーのスコープが "サイト" である必要があるのに、イベント レシーバー プロジェクトの既定のフィーチャー スコープが "Web" になっているために発生します。 影響を受ける Web イベントは次のとおりです。
サイトが削除されています (WebDeleting)
サイトが削除されました (WebDeleted)
サイトが移動されています (WebMoving)
サイトが移動されました (WebMoved)
この問題を修正するには、イベント レシーバーのフィーチャー スコープを次のように変更します。
イベント レシーバーのフィーチャー スコープを変更するには
ソリューション エクスプローラーで、イベント レシーバーの .feature ファイルを、ダブルクリックするか、そのショートカット メニューを開いて [開く] を選択することにより、フィーチャー デザイナーで開きます。
[スコープ] の横にある矢印を選択し、表示される一覧で [サイト] を選択します。
ビジネス データ接続モデル プロジェクトで識別子の名前を変更すると配置エラーが発生する
この問題は、ビジネス データ接続 (BDC) モデルでエンティティの識別名を変更した後、ソリューションを配置しようとすると発生します。
エラー メッセージ
<model name> には次の外部コンテンツ タイプ アクティブ化エラーがあります...
名前 '<model name>' の IMetadataObject は、フィールド '名' の値が重複しています...
解像度
この問題を解決するには、モデルを手動で削除した後、ソリューションを再び配置します。 モデルを削除するには、次のどちらかのツールを使用します。
SharePoint 2010 サーバーの全体管理。 詳細については、Microsoft TechNet Web サイトで BDC モデルの管理に関する記事を参照してください。
Windows PowerShell。 コマンドプロンプトでコマンド「Remove-SPBusinessDataCatalogModel」を入力することで、モデルを削除できます。 詳細については、Microsoft TechNet Web サイトでコマンドレット全般 (SharePoint Server 2010) に関する記事を参照してください。
SharePoint Server 上の IIS アプリケーション プールのリサイクル中に配置エラーが発生しました
この問題は、IIS 6 WMI 互換機能と .NET Framework 3.5 が SharePoint Server マシンにインストールされていない場合に発生します。
エラー メッセージ
- 配置手順 "IIS アプリケーション プールのリサイクル" でエラーが発生しました: 名前空間が無効です
- 配置手順 "IIS アプリケーション プールのリサイクル" でエラーが発生しました: タスクが取り消されました。
解像度
この問題を解決するには、SharePoint Server マシンで、Windows 機能の IIS 6 WMI 互換がインストールされているかどうかを確認します。
- Windows PowerShell。 この機能がインストールされているかどうかを確認するには、次の PowerShell コマンドを実行します: get-windowsfeature -name Web-WMI。 インストールされていると表示されない場合は、次の PowerShell コマンドを実行してインストールできます: install-windowsfeature -name Web-WMI。 アプリケーション プールのリサイクル中に引き続きエラーが表示される場合は、get-windowsfeature -name NET-Framework-Core を実行して、.NET Framework 3.5 もマシンにインストールされていることを確認し、そうでない場合は、install-windowsfeature -name NET-Framework-Core を実行します。
可視 Web パーツを SharePoint で表示しようとするとエラーが表示される
この問題は、ユーザー コントロールの [パス] プロパティが文字列 "CONTROLTEMPLATES\" で始まっていない場合に発生します。
エラー メッセージ
'/_CONTROLTEMPLATES/<project name>/<Web Part name>/<user control name>.ascx' ファイルが存在しません。
Server Error in '/' Application.
解像度
この問題を解決するには
ソリューション エクスプローラーで、ファイル名拡張子が .ascx であるユーザー コントロール ファイルを選択します。
メニュー バーで、[表示]>[プロパティ ウィンドウ] の順に選択します。
[プロパティ] ウィンドウで、[配置場所] ノードを展開します。
[パス] プロパティの値が、文字列 "CONTROLTEMPLATES\" で始まっていることを確認します。
インポートしたタスク フォーム フィールドを含む再使用可能なワークフローを実行するとエラーが表示される
この問題は、フィールドを含むタスク フォームが存在するワークフローをインポートした後、ワークフローのインポート元と同じシステム上で新しいワークフローを実行したときに発生します。
エラー メッセージ
配置手順 "機能のアクティブ化" でエラーが発生しました。機能 [Guid] に定義された ID [Guid] が、現在のサイト コレクションまたはサブサイト内で検出されました。
解像度
このエラーは、Visual Studio の再利用可能なワークフローのインポート プロジェクトでタスク フォームのフィールド ID が変更されないせいで、フィールド ID の競合が発生した結果です。 インポートされたワークフローを元のワークフローを含む同じサーバーに展開すると、フィールド ID の競合が発生します。
この問題を解決するには、検索置換機能を使用して、インポートしたすべてのワークフロー ファイル内のフィールド ID 属性の値を変更する必要があります。
インポートして名前を変更したリスト インスタンスを実行するとエラーが表示される
この問題は、インポートしたリスト インスタンスの名前を変更した後、Visual Studio で実行した場合に発生します。
エラー メッセージ
ビルド エラー: 配置手順 '機能のアクティブ化' でエラーが発生しました。Template\Features\[import projectfeaturename]\Files\Lists\[oldlist name]\Schema.xml ファイルが存在しません。
解像度
リスト インスタンスをインポートすると、CustomSchema という名前の属性がリスト インスタンスの Elements.xml ファイルに追加されます。 Elements.xml には、リスト インスタンス用のカスタム schema.xml のパスが含まれます。 Visual Studio でリスト インスタンスの名前を変更すると、カスタム schema.xml の配置パスは変更されますが、CustomSchema 属性のパス値は更新されません。 この結果、機能がアクティブ化されるときに、リスト インスタンスは、CustomSchema 属性に指定された古いパスでは schema.xml ファイルを検出できません。
この問題を解決するには、CustomSchema 属性の schema.xml ファイルの配置場所のパスを更新します。
SharePoint デバッグ セッションが IIS によって終了する
この問題は、Visual Studio SharePoint ソリューション内にブレークポイントを設定し、F5 キーを押してソリューションを実行した後、ブレークポイントで 90 秒以上停止した場合に発生します。
エラー メッセージ
デバッグ対象の Web サーバー プロセスは、インターネット インフォメーション サービス (IIS) によって停止されました。 IIS のアプリケーション プールの ping の設定を構成することによって、この問題を回避できます。 詳細については、ヘルプを参照してください。
解像度
既定では、IIS アプリケーション プールは、アプリケーションから応答が返るまで 90 秒間待機した後、アプリケーションを閉じます。 このプロセスは、アプリケーションの "ping" として知られています。 この問題を解決するには、待機時間を増やすか、アプリケーションの ping を完全に無効にします。
IIS アプリケーション プールの設定にアクセスするには
IIS マネージャーを開きます。
[接続] ペインで SharePoint サーバー ノードを展開し、[アプリケーション プール] ノードを選択します。
[アプリケーション プール] ページで、SharePoint アプリケーション プール (通常は "SharePoint - 80") を選択した後、[操作] ペインで [詳細設定] リンクを選択します。
IIS がタイムアウトするまでの待機時間を長くするには、[Ping 最大応答時間 (秒)] を、90 秒より大きな値に変更します。
IIS の ping を無効にするには、[Ping の有効化] を [False] に設定します。
自動取り消しで孤立状態のリスト インスタンスが SharePoint に残る
この問題は、次の手順に従った場合に発生します。
リスト インスタンスがあるリスト定義を Visual Studio で作成します。
F5 キーを押してソリューションを実行します。
デバッグを停止するか、SharePoint サイトを閉じます。
SharePoint サイトを再度開き、リスト インスタンスを開きます。
エラー メッセージ
Server Error in '/' Application.
解像度
このエラーは、SharePoint ソリューションのデバッグ セッションを閉じた後、自動取り消し機能によってソリューションが取り消されたために発生します。 取り消しにより、リスト定義は SharePoint から削除されますが、リスト インスタンスは削除されません。 リスト インスタンスは、基になるリスト定義を必要とします。
この問題を解決するには、メニュー バーの [ビルド]>[配置] を選択して、ソリューションを配置します。 (F5 キーを押してソリューションをデバッグしないでください)。次に、SharePoint 内のリスト インスタンスを削除します。
元の SharePoint ソリューションがエクスポートしたバージョンによって置換される
エクスポートした SharePoint ソリューションを Visual Studio にインポートした後、そのソリューションをエクスポート元のサイトに配置した場合、元の SharePoint ソリューションが置換されます。 この問題は、ソリューションの配置先を元のソリューションがアクティブ化されていないサーバーにすると、発生しません。
エラー メッセージ
なし。
解像度
エクスポート元のサイトでソリューションが上書きされないようにするには、ソリューション ID の GUID と Visual Studio プロジェクトにインポートしたすべての機能の機能 ID を変更します。
デバッグ開始時にエラーが表示される
Visual Studio で SharePoint ソリューションのデバッグを開始すると、特定のキーがディクショナリに存在しないので Visual Studio で Web.config ファイルを読み込むことができないというエラーが発生します。
エラー メッセージ
Web.config 構成ファイルを読み込むことができませんでした。 ファイルをチェックして、形式が正しくない XML 要素を修正した後、再試行してください。 次のエラーが発生しています: 特定のキーがディクショナリに存在しません。
解像度
この問題を解決するには、Visual Studio 内の SharePoint プロジェクトの [サイト URL] プロパティの値が、Web アプリケーションの代替アクセス マッピング用の既定のゾーンに割り当てられた URL と一致することを確認します。 URL でイントラネットなどの他のゾーンを使用すると、エラーは解消されません。 プロジェクトのサイト URL と既定のゾーンの URL は一致している必要があります。 代替アクセス マッピングにアクセスするには、SharePoint 2010 サーバーの全体管理ユーティリティを開き、[アプリケーション構成の管理] リンクを選択し、[Web アプリケーション] の下の [代替アクセス マッピングの構成] リンクを選択します。 詳細については、「Web アプリケーション用の領域を作成する」を参照してください。
関連するコンテンツ
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示