クラシック ページ評価レポートを解釈する

クラシック評価では、ページ固有の CSV ファイルと共有 CSV ファイルがエクスポートされます。 Windows では、既定の report コマンドも ClassicAssessmentReport.pbitを作成します。

このガイダンスでは、 Pages ビューとスキャン カバレッジ ビューについて説明します。 共有クラシック テンプレートには、他のコンポーネントと互換性のタブが含まれていますが、このページ評価の範囲外です。

最初にスキャン カバレッジを検証する

ページの準備を解釈する前に、予想されるスコープが完了したことを確認します。

  1. スキャンの概要、scans.csv、history.csvを使用して、評価の状態とメッセージを確認します。
  2. sitecollections.csvとwebs.csvを使用して、失敗した場所、未完了の場所、または異常に遅い場所を特定します。
  3. 評価で完全なテナント スコープ、 --siteslist、または --sitesfileが使用されているかどうかを確認します。
  4. アクティビティ数 classicpageauditusage.csv 使用する前に、カバレッジの状態を確認します。

完了した評価には、引き続きサイトまたは Web エラーが含まれている可能性があります。 欠落している場所は、クラシック コンテンツが存在しないことを示す結果としてではなく、カバレッジ ギャップとして扱います。

共通ファイル スキーマと結合キーについては、「 共通評価 CSV リファレンス」を参照してください。

ページの優先順位付け

現在の [Pages Power BI] タブでは、ページの種類、URL、変更日、修復コードなど、基本的なページ インベントリ フィールドが使用されます。

エンリッチされた準備フィールドに classicpages.csv を使用し、次の方法でページをセグメント化します。

  • ページの種類。
  • ホーム ページの状態。
  • 最終変更日と修飾子。
  • Web パーツの数。
  • マッピングの割合。
  • マップされていない Web パーツの種類。

このインベントリを classicpageauditusage.csv と組み合わせて、頻繁に使用されるページを古いコンテンツや使用頻度の低いコンテンツと区別します。

現在の埋め込み Power BI モデルには、エンリッチされたホーム ページ、Web パーツ、マッピング、監査、またはページ準備ロールアップ フィールドは含まれていません。 これらのフィールドを CSV ファイル内で直接分析するか、ビジュアルで使用する前に Power BI モデルを拡張します。

監査の使用状況は、未加工の Web 分析カウンターではなく、計画シグナルです。 常にチェック QueryStatus:

状態 意味
succeeded 要求された監査ウィンドウが完了しました。
partial 1 つ以上の監査サブクエリが失敗しました。 カウントは下限です。
failed 監査コレクションに失敗しました。 カウントは使用できません。
skipped サポートされていないクラウドなど、サイトに対して監査コレクションが実行されませんでした。
error スキャン後の予期しない例外が発生しました。 SkipReasonと評価ログを確認します。

重要

ソブリン クラウド評価では、ページ監査の使用状況は提供されません。 使用行の欠落またはスキップは、ゼロ アクティビティとして解釈しないでください。 ModifiedAt、既知のページの重要度、ビジネス所有者の入力に優先順位を付けます。

サイトの監査クエリが成功した場合、ページ行がない場合は、要求されたウィンドウでそのページに一致するイベントが返されなかったことを意味します。 サイトのカバレッジが成功したことを確認した後にのみ、存在しない行をゼロ アクティビティとして扱います。

SkipReasonが QueryTimeout で始まる場合、評価の 90 分間の待機中に Microsoft Purview はクエリを完了しませんでした。 監査チャンクが成功しなかった場合、行には QueryStatus=failedがあります。ゼロカウントは、アクティビティの証拠としてではなく、失敗したカバレッジとして扱います。 これは、監査アクセス許可が見つからない NoPermissionとは異なります。

ページタイプのカバレッジについて

Wiki、Web パーツ、および発行ページは、詳細な Web パーツの抽出とマッピング分析を受け取ります。

ブログ、ASPX、Delve ブログ の各ページが検出され、記録されますが、同じマッピング準備エンリッチメントを受け取りません。 これらのページの種類の既定または空のマッピング値を、完了した準備分析として解釈しないでください。

Delve ブログ ページは classicpages.csv に表示されますが、現在の Web ページとサイト ページ数のロールアップには含まれていません。

マッピング結果を解釈する

MappingPercentage は、埋め込みマッピング モデルで使用可能なマッピングを持つ抽出された Web パーツの割合です。

  • 抽出された Web パーツのないページは、規則によって 100% です。
  • 100% の結果は、抽出されたすべての Web パーツの種類にマッピングがあることを意味します。 変換後のビジュアル、データ、アクセス許可、またはビジネス動作のパリティは保証されません。
  • WebPartCount 0 より大きい 100 未満の値は、修復、置換、またはカスタム マッピングを必要とする 1 つ以上の Web パーツの種類を識別します。
  • Wiki、Web パーツ、または発行ページの場合、 WebPartCount=0 と MappingPercentage=0 は、マッピング計算が実行される前に抽出が失敗したことを示すことができます。 評価ログで Failed to assess the web parts of classic pageを確認します。

ページごとの決定には、 classicpagewebparts.csv を使用します。

  • IsMappable は、Web パーツに使用できない使用可能なマッピングがあることを意味します。
  • WebPartProperties は、 --exportwebpartproperties が選択されている場合にのみ設定されます。
  • 行、列、ゾーン、順序、非表示、閉じた値は、現在のページ レイアウトの説明に役立ちます。

classicwebpartunique.csvを使用して、多数のページに影響を与える Web パーツの種類を特定します。 InMappingFile が IsMappableよりも弱い: 型にマッピング ファイルにエントリがあることを意味するだけです。

現在の評価の実装では、 ScriptEditorWebPart と SimpleFormWebPart のコミュニティ マッピングが意図的に使用不可として扱われます。 また、ディスク上のマッピング ファイルのオーバーライドもサポートされていません。

この評価結果は、既定の準備モデルがそれらの Web パーツを承認しないことを意味します。 PnP 変換では、必要に応じて、そのソリューションがインストールされ、 -UseCommunityScriptEditor が選択された後に、スクリプト エディターと Simple Form コンテンツをオープンソースのコミュニティ スクリプト エディターにルーティングできます。

注意

スクリプト エディターは、ページでカスタム コードを実行できます。 これは、セキュリティ レビューと個別に検証されたページを使用して、高度な修復決定として扱います。 評価駆動型バッチ スクリプトでは、コミュニティ スクリプト エディターは有効になりません。

「クラシック Web パーツマッピング」を参照してください。

次のアクションを決定する

テーブルを上から下に評価し、最初に一致する行を使用します。 マッピングベースの決定は、カバレッジとページタイプのルーティングが完了した後にのみ適用されます。

評価結果 Decision 次のアクション
サイト コレクションまたは Web が完了しませんでした カバレッジがブロックされました ページ数または準備状況を解釈する前に、スキャン エラーを解決します。
ページの種類は、ブログ、ASPX、または Delve ブログです マッピング スコアは操作できません 準備率を使用するのではなく、 ページタイプのサポート ガイダンス に従ってください。
ページの種類が [発行中] 高度なバックログ 別のターゲットとプロシージャを定義する前に、レイアウトと不足しているポータル レベルの入力を確認します。
Wiki または Web パーツ ページはホーム ページです 個別の承認が必要 最初のウェーブから除外し、変換の前に URL、ナビゲーション、ロールバックの動作を定義します。
Wiki または Web パーツ ページにエンリッチメント エラーが WebPartCount=0 され、 MappingPercentage=0 がある ページ スキャンに失敗しました ページを選択する前に、ログを確認し、Assessment を再実行します。
Wiki または Web パーツ ページには、 WebPartCount=0 と MappingPercentage=100 手動レビューが必要 ソース ページを開き、評価で表示されたコンテンツが見つからなかったかどうかを確認します。 自動ウェーブに配置しないでください。
Wiki または Web パーツ ページに WebPartCount>0、 MappingPercentage=100、マップされていない Web パーツがありません 代表パイロット候補 レイアウトと順序付けされた Web パーツ署名でグループ化し、下書きを変換し、結果を検証します。
Wiki または Web パーツ ページに MappingPercentage<100 または 1 つ以上のページがある UnmappedWebParts 修復が必要 ブロックしている Web パーツを置き換えるか、変換の前にカスタム マッピングを定義して個別に検証します。

ロールアップを使用する

classicwebsummaries.csvとclassicsitesummaries.csvを使用して、以下を識別します。

  • クラシック ページが最も多い Web とサイト コレクション。
  • 完全にマップ可能な Web パーツまたはマップされていない Web パーツを含むページ。
  • Web パーツを含むページ全体の平均マッピング率。
  • URL、ナビゲーション、ロールバックの計画に個別の承認済みバックログが必要なホーム ページ。

ロールアップはシーケンス処理に役立ちますが、修復の決定を行う前にページと Web パーツの CSV ファイルに戻ります。

発行ポータルを確認する

classicpublishingsitesummaries.csv は、サイト コレクション レベルの発行の概要を提供します。 詳細な従来の Web レベルの発行構成は含まれません。

発行ページ変換を計画する前に、「 発行ポータルカバレッジについて」 を参照してください。

評価から変換への移行

レポートを変換バックログに変換します。

  1. 失敗または不完全なスキャン場所を除外します。
  2. アクティブなページと重要なホーム ページに優先順位を付ける。
  3. ページの種類、レイアウト、マップされていない Web パーツの組み合わせでページをグループ化します。
  4. 大きな波を変換する前に、一般的なブロッカーを解決します。
  5. CSV ページ ID を PnP PowerShell ソース接続とコマンドレット パラメーターにマップします。
  6. スケールアウトする前に、代表的なサンプルを変換し、結果を検証します。

CSV フィールドを PnP PowerShell にマップする

CSV フィールド 変換の使用
SiteUrl + WebUrl Connect-PnPOnlineのソース Web URL を作成します。
PageUrl + ListUrl ライブラリと省略可能なフォルダーを含むページ ファイル名を派生させます。
PageName 従来のブログ ページの -Identity としてページ タイトルを使用します。
PageType Wiki/Web パーツ、発行、またはブログ変換パスにルーティングします。
Layout 発行ページのページ レイアウト マッピングを選択または検証します。

Assessment アプリは読み取り専用です。 ソースまたはターゲット Web でページを作成または更新するには、アクセス許可を持つ個別の PnP PowerShell 接続を使用します。

変換タスクを続行する

フィールド マッピングを使用して、正確な評価行を承認し、予想されるコンテンツを記録します。 次に、現在のアプリケーション、アクセス許可、ソース ID、ドラフト出力、ログ記録、検証のセーフガードについて、 PnP PowerShell を使用して選択したクラシック ページを変換 するに従います。

他のページの種類を意図的にルーティングする:

  • PublishingPage: -PublishingPage、ターゲット Web、および 発行ページ レイアウト モデルを使用します。
  • BlogPage: -BlogPage、 PageName をブログ タイトル ID として使用し、ターゲット Web を使用します。 ブログ行には、Wiki、Web パーツ、および発行ページで説明されている詳細なマッピング準備エンリッチメントは受け取りません。
  • ASPXPage と DelveBlogPage: この自動変換キューから除外します。ページ評価では、同等の準備パスは提供されません。

PnP PowerShell を使用して選択したクラシック ページを変換してから、変換された各ページを検証します。 カスタム Web パーツ マッピングの ページ変換モデル と、ページ レイアウトを 発行 するための発行モデルを使用します。

Power BI と CSV

Power BI テンプレートは、CSV 出力に対する視覚化レイヤーです。 CSV ファイルは、次のソースのままです。

  • 自動化された追及機能が追加されています。
  • スキーマ レベルの検証。
  • ページ、Web パーツ、使用状況、Web、およびサイト レコードに参加する。
  • レビュー可能な証拠を保持スナップショット。

Power BI テンプレートの生成には Windows が必要です。 CSV の生成は、Windows、macOS、およびLinuxで機能します。

リファレンス

  • Last updated on