変換されたクラシック ページを検証する

より多くのページを処理する前に、代表的な変換ウェーブ内のすべてのページを検証します。 コマンドまたは HTTP 200 応答が成功しても、生成されたページが期待されるコンテンツを保持したことが証明されません。

予想される結果をCaptureする

変換の前に、次のレコードを記録します。

  • ソース URL と予期されるターゲット URL。
  • ページの種類とレイアウト。
  • 表示されるテキストと見出し。
  • Web パーツとその重要な構成。
  • リンク、画像、ファイル、リスト、埋め込みコンテンツ。
  • メタデータ、アクセス許可、パブリケーションの状態、ページがホーム ページかどうか。

評価行を保持し、このベースラインを使用して行を classicpagewebparts.csv します。

委任された AllSites.Manage 最初のウェーブ パスでは、ライブラリからアクセス許可を継承し、生成されたページを下書きとして保持するページを選択します。 一意のソースアクセス許可を保持する必要がある場合は、アクセス許可のコピーをスキップするのではなく、確認された AllSites.FullControl パスを使用します。

変換結果を確認する

各ページについて:

  1. PnP 変換ログで、エラー、スキップされた Web パーツ、フォールバック マッピング、およびアクセス許可コピー メッセージを確認します。
  2. クラシック ソース ページがまだ存在し、予期される名前が保持されていることを確認します。
  3. 必要なモダン ページが存在することを確認して開きます。
  4. 表示されるテキスト、Web パーツ、セクション、列、順序を比較します。
  5. リンク、イメージ、ドキュメント、リスト ビュー、およびその他の依存関係をテストします。
  6. 必要なメタデータ、作成者と変更された値、アクセス許可、コメント、およびパブリケーションの状態を比較します。
  7. 次のページを処理する前に、結果と証拠を記録します。

不完全な出力を検出する

次の場合は、ページを失敗として扱います。

  • ターゲット ページが空白であるか、タイトルのみが含まれています。
  • 予期されるテキストまたは必要な Web パーツがありません。
  • Web パーツは存在しますが、間違ったリスト、ファイル、サイト、ユーザー、または用語を指しています。
  • レイアウトまたはページ ヘッダーは、ページがビジネス目的を満たさないようにします。
  • 必要なメタデータまたはアクセス許可が保持されませんでした。
  • 変換ログに未解決のエラーが含まれています。

MappingPercentage=100場合でも、Assessment がWebPartCount=0報告したページを手動で検査します。 また、ランタイム データまたはマッピング関数によって変換エラーが引き続き発生する可能性があるため、完全にマップされたと報告されたページも検証します。

ウェーブ結果を記録する

試行したページごとに 1 つのレコードを使用します。

フィールド 用途
ScanId ページを評価の証拠にリンクします。
SiteUrl, WebUrl, PageUrl ソース ページを識別します。
PlannedTargetPageUrl, TargetPageUrl レビューされたプランと作成されたターゲットを識別します。
PageType, Layout 同等の結果をグループ化します。
MappingPercentage, UnmappedWebParts 計画シグナルを保持します。
TransformationStatus Skipped、PreflightPassed、Created または Failed。
LogPath ページの正確な PnP 変換ログをポイントします。
ValidationStatus Pending、 Passed、または Failed。
ValidationNotes 不足しているコンテンツ、マッピングの問題、およびフォローアップ作業を記録します。
ValidatedBy, ValidatedAt 承認所有権を記録します。

展開するかどうかを決定する

次の場合にのみウェーブを展開します。

  • すべての代表的なソース ページは引き続き使用できます。
  • 承認されたすべてのターゲット ページは、コンテンツと動作の検証に合格します。
  • 下書きターゲットは、承認後にのみ発行されます。
  • 一般的なブロックには、文書化された修復またはマッピングがあります。
  • 失敗したページまたは部分的なページは、次のウェーブから除外されます。
  • 次のウェーブには、所有者、ロールバック 計画、および保持ログがあります。

ページが失敗した場合は、同等のページの処理を停止します。 ログとソース Web パーツを確認し、必要に応じてマッピングまたは候補ルールを更新し、再開する前に 1 つの代表ページを再試行します。

下書きページが承認されたら、ページ編集エクスペリエンスまたは現在の Set-PnPPage-Publish オプションを使用して発行します。

ウェーブを展開する

すべての代表ページを検証した後:

  1. 各代表結果を ValidationStatus=Passedに設定します。
  2. ValidationNotes、ValidatedBy、ISO-8601 ValidatedAt タイムスタンプを入力します。
  3. ユーザーが承認した追加のグループ化された行から approved-pages.csv を作成します。
  4. 元の代表的なマニフェストと検証された結果を使用して Convert-SelectedPages.ps1 -PreflightOnly を実行します。
  5. すべてのプレフライト行が渡された後にのみ、ライブ拡張を実行します。
  6. 展開されたウェーブで生成されたすべてのページを検証してから、発行します。

代表的な結果が見つからない、古い、渡されない、または別の PnP PowerShell またはスクリプト プロファイルに基づいている場合、スクリプトは拡張をブロックします。

次の手順

  1. 失敗したページを修復バックログに返します。
  2. 渡されたページ パターンを approved-pages.csv に追加し、拡張スクリプトを実行します。

リファレンス

  • Last updated on