CmsContentScaffolding パッケージを使用した単体テストの最適化

単体テストは、ビジネス ロジックのためだけでなく、コンテンツやコンテンツ作成用に定義されたルール (利用可能なコンテンツ タイプ、検証など) についても作成する必要があります。 そうすることで、Optimizely ソリューションはコンテンツ タイプやルールの変更に対する復元力が高まります。

通常、継続的に使用されるローカル開発 DB またはテスト DB があり、テスト コンテンツは Optimizely で作成され、バックエンド開発ではコンテンツ タイプと検証ルールが継続的に変更されるため、コンテンツが最初から作成されたかのように検証されることはほとんどありません。 そのため、テスト コンテンツがクライアントが作成できる現実的なイメージを表しているという誤った考えにつながる可能性がありますが、クライアントがコンテンツの作成を開始するとすぐに、ステージング環境でこれらの問題が発生し始めます。

コンテンツ単体テストで得られる利点は、変更が導入されるとすぐに目的のサイト構造と検証ルールを検証し、常に空の DB から最初から開始し、コントローラー出力モデルに必要なデータがすべて含まれていることを検証することです。 コンテンツ構造の概要を簡単に説明するために、単純な流暢な構文を使用する CmsContentScaffolding というライブラリがあります。 完全なサイト構造を作成し、大量のページを簡単に作成し、テスト用のコンテンツを準備できます。

Nuget パッケージとして追加され、以下を使用してサービスの依存関係が登録されました。 services.AddCmsContentScaffolding();、続いて Iアプリケーションビルダー 拡張メソッド appBuilder.UseCmsContentScaffolding(builderOptions: o => {}, builder: b => {});。 次の 2 つのセクションがあります。 ビルダーオプション (使用言語、サイトホスト、サイト名、ページドラフトの公開または作成のみ、ユーザーとロールなどのグローバルオプションを提供します…) ビルダー コンテンツ作成のメソッドを公開します。 の別のセクションを使用して、複数のサイトを作成できます。 appBuilder.UseCmsContentScaffolding(builderOptions: o => {}, builder: b => {});。 Builder には、コンテンツの作成を開始する開始点として機能する UseAssets(ContentReference.SiteBlockFolder) と UsePages(ContentReference.RootPage) の 2 つの主要なメソッドがあります。

さらに、CmsContentScaffolding.Shared.Resources と呼ばれる、偽のテキスト、画像、ビデオ用のヘルパー メソッドを備えたパッケージもあります。

UseCmsContentScaffolding メソッドには多くのオプションがあり、次のようになります。

app.UseCmsContentScaffolding(
    builderOptions: o =>
    {
        o.Language = CultureInfo.GetCultureInfo("sr");
        o.StartPageType = typeof(StartPage);
        o.BuildMode = BuildMode.Append;
    },
    builder: b =>
    {
        var teaser2Ref = ContentReference.EmptyReference;
        var teaser3Ref = ContentReference.EmptyReference;
        var articlePageRef = ContentReference.EmptyReference;

        b.UseAssets(ContentReference.SiteBlockFolder)
        .WithFolder("Folder 1", l1 =>
        {
            l1
            .WithFolder("Folder 1_1", l2 =>
            {
                l2.WithBlock("Teaser 1", out teaser2Ref, x =>
                {
                    x.Heading = "Teaser 1 Heading";
                    x.Text = ResourceHelpers.Faker.Lorem.Paragraph();
                    x.Image = PropertyHelpers.GetOrAddMedia("Image 2", ".png", ResourceHelpers.GetImageStream());
                });
            })
            .WithMedia(x => x.Name = "Test video", ResourceHelpers.GetVideoStream(), ".mp4")
            .WithBlock("Teaser 3", out teaser3Ref, x =>
            {
                x.Heading = "Test";
                x.Text = ResourceHelpers.Faker.Lorem.Paragraph();
                x.Image = PropertyHelpers.GetOrAddMedia("Image 2", ".png", ResourceHelpers.GetImageStream());
            });
        })
        .WithContent(x => x.Name = "Folder1")
        .WithContent(x => x.Name = "Image 1");

       b.UsePages(ContentReference.RootPage)
        .WithStartPage(p =>
        {
            p.Name = "Home Page";
            p.MainContentArea
            .AddExistingItems(teaser2Ref, teaser3Ref)
            .AddItem("Start Page Teaser", b =>
            {
                b.Heading = ResourceHelpers.Faker.Lorem.Slug();
                b.Text = ResourceHelpers.Faker.Lorem.Paragraph();
                b.Image = PropertyHelpers.GetOrAddMedia("Image 2", ".png", ResourceHelpers.GetImageStream());
            });
        }, CultureInfo.GetCultureInfo("sv"), t =>
        {
            t.Name = "Start Page [SV]";
        }, l1 =>
        {
            l1
            .WithPage(out articlePageRef, p =>
            {
                p.Name = "article1";
                p.MetaTitle = ResourceHelpers.Faker.Lorem.Slug();
                p.TeaserText = ResourceHelpers.Faker.Lorem.Paragraph();
                p.MainBody
                .AddStringFragment(ResourceHelpers.Faker.Lorem.Paragraphs())
                .AddContentFragment(PropertyHelpers.GetOrAddMedia("Image 1", ".png", ResourceHelpers.GetImageStream()))
                .AddStringFragment(ResourceHelpers.Faker.Lorem.Paragraphs());
                p.PageImage = PropertyHelpers.GetOrAddMedia("Image 1", ".png", ResourceHelpers.GetImageStream());
                p.MainContentArea
                .AddItem("Jumbotron Block", b =>
                {
                    b.ButtonText = ResourceHelpers.Faker.Lorem.Slug();
                    b.ButtonLink = new Url(ResourceHelpers.Faker.Internet.Url());
                    b.Heading = ResourceHelpers.Faker.Lorem.Slug();
                })
                .AddItem(options: i =>
                {
                    i.Name = "Test Image";
                    i.ContentLink = PropertyHelpers.GetOrAddMedia("Image 1", ".png", ResourceHelpers.GetImageStream());
                })
                .AddExistingItem(teaser3Ref);
            })
            .WithPages(p =>
            {
                p.Name = "Article 33";
                p.MetaTitle = ResourceHelpers.Faker.Lorem.Slug();
                p.TeaserText = ResourceHelpers.Faker.Lorem.Paragraph();
                p.MainBody.AddStringFragment(ResourceHelpers.Faker.Lorem.Paragraphs(10));
                p.MainContentArea.AddExistingItem(teaser2Ref);
            }, 100);
        })
       .WithPages(p =>
        {
            p.Name = ResourceHelpers.Faker.Lorem.Slug(2);
            p.MainContentArea
            .AddItems(b =>
            {
                b.Heading = ResourceHelpers.Faker.Lorem.Slug();
                b.Text = ResourceHelpers.Faker.Lorem.Paragraph();
                b.Image = PropertyHelpers.GetOrAddMedia("Image 1", ".png", ResourceHelpers.GetImageStream());
            }, 10);
        }, 10)
    });