チュートリアル:.NET SDK を使用して検索結果を並べ替える

[アーティクル]
01/26/2021

このチュートリアルシリーズ全体を通して、結果が返され、既定の順序で表示されています。このチュートリアルでは、プライマリおよびセカンダリの並べ替え条件を追加します。最後の例では、数値に基づく並べ替えの代わりに、カスタムスコアリングプロファイルに基づいて結果を順位付けする方法を示します。 複合型 の表示についても少し踏み込んで説明します。

このチュートリアルでは、以下の内容を学習します。

1 つのプロパティに基づいて結果を並べ替える
複数のプロパティに基づいて結果を並べ替える
スコアリングプロファイルに基づいて結果を並べ替える

概要

このチュートリアルでは、検索結果へのページングの追加に関するチュートリアルで作成した無限スクロールプロジェクトを拡張します。

このチュートリアルのコードの完成版は、次のプロジェクトにあります。

5-order-results (GitHub)

前提条件

2b-add-infinite-scroll (GitHub) ソリューション。このプロジェクトは、前のチュートリアルで作成した独自のバージョンでも、GitHub からコピーしたものでもかまいません。

1 つのプロパティに基づいて結果を並べ替える

ホテルの評価のように、1 つのプロパティに基づいて結果を並べ替える場合、並べ替えた結果が必要なだけでなく、順序が正しいことの確証も必要です。結果に Rating フィールドを追加すると、結果が正しく並べ替えられていることを確認できます。

この演習では、結果の表示に少し情報を追加します。各ホテルの最も安い宿泊料金、最も高い宿泊料金です。

並べ替えを有効にするために修正が必要なモデルはありません。更新が必要なのは、ビューとコントローラーのみです。まず、ホームコントローラーを開きます。

OrderBy プロパティを検索パラメーターに追加する

HomeController.cs で、OrderBy オプションを追加し、降順の並べ替え順序を指定した Rating プロパティを含めます。 Index(SearchData model) メソッドで、次の行を検索パラメーターに追加します。
```
options.OrderBy.Add("Rating desc");
```
注意

既定の順序は昇順ですが、asc をプロパティに追加してこれを明確化できます。降順は desc を追加することで指定されます。
ここでアプリを実行し、何か一般的な検索語を入力します。開発者もユーザーも、結果を検証する簡単な方法を持ち合わせていないため、結果が正しい順序がどうかはわかりません。

結果が評価に基づいて並べ替えられていることを明確にしましょう。まず、hotels.css ファイルの box1 および box2 クラスを次のクラスに置き換えます (これらのクラスはすべて、このチュートリアルに必要な新しいクラスです)。

textarea.box1A {
    width: 324px;
    height: 32px;
    border: none;
    background-color: azure;
    font-size: 14pt;
    color: blue;
    padding-left: 5px;
    text-align: left;
}

textarea.box1B {
    width: 324px;
    height: 32px;
    border: none;
    background-color: azure;
    font-size: 14pt;
    color: blue;
    text-align: right;
    padding-right: 5px;
}

textarea.box2A {
    width: 324px;
    height: 32px;
    border: none;
    background-color: azure;
    font-size: 12pt;
    color: blue;
    padding-left: 5px;
    text-align: left;
}

textarea.box2B {
    width: 324px;
    height: 32px;
    border: none;
    background-color: azure;
    font-size: 12pt;
    color: blue;
    text-align: right;
    padding-right: 5px;
}

textarea.box3 {
    width: 648px;
    height: 100px;
    border: none;
    background-color: azure;
    font-size: 12pt;
    padding-left: 5px;
    margin-bottom: 24px;
}

ヒント

通常、ブラウザーは css ファイルをキャッシュしますが、これによって古い css ファイルが使用され、編集が無視される可能性があります。これを回避するための良い方法は、バージョンパラメーターを持つクエリ文字列をリンクに追加することです。次に例を示します。

  <link rel="stylesheet" href="~/css/hotels.css?v1.1" />

ブラウザーで古い css ファイルが使用されていると思われる場合、バージョン番号を更新します。

Index(SearchData model) メソッドで、Select パラメーターに Rating プロパティを追加して、結果に次の 3 つのフィールドが含まれるようにします。
```
options.Select.Add("HotelName");
options.Select.Add("Description");
options.Select.Add("Rating");
```

ビュー (index.cshtml) を開き、レンダリングループ (  ) を次のコードに置き換えます。

<!-- Show the hotel data. -->
@for (var i = 0; i < result.Count; i++)
{
    var ratingText = $"Rating: {result[i].Document.Rating}";

    // Display the hotel details.
    @Html.TextArea($"name{i}", result[i].Document.HotelName, new { @class = "box1A" })
    @Html.TextArea($"rating{i}", ratingText, new { @class = "box1B" })
    @Html.TextArea($"desc{i}", fullDescription, new { @class = "box3" })
}

最初に表示されるページと、無限スクロールを介して呼び出される後続のページのどちらでも、評価が確認できる必要があります。これら 2 つの状況のうち後者では、コントローラーの Next アクションとビューの scrolled 関数の両方を更新する必要があります。コントローラーから始めて、Next メソッドを次のコードに変更します。このコードは評価テキストを作成および伝達します。

public async Task<ActionResult> Next(SearchData model)
{
    // Set the next page setting, and call the Index(model) action.
    model.paging = "next";
    await Index(model);

    // Create an empty list.
    var nextHotels = new List<string>();

    // Add a hotel details to the list.
    await foreach (var result in model.resultList.GetResultsAsync())
    {
        var ratingText = $"Rating: {result.Document.Rating}";
        var rateText = $"Rates from ${result.Document.cheapest} to ${result.Document.expensive}";

        string fullDescription = result.Document.Description;

        // Add strings to the list.
        nextHotels.Add(result.Document.HotelName);
        nextHotels.Add(ratingText);
        nextHotels.Add(fullDescription);
    }

    // Rather than return a view, return the list of data.
    return new JsonResult(nextHotels);
}

次に、評価テキストを表示するために、ビューの scrolled 関数を更新します。

<script>
    function scrolled() {
        if (myDiv.offsetHeight + myDiv.scrollTop >= myDiv.scrollHeight) {
            $.getJSON("/Home/Next", function (data) {
                var div = document.getElementById('myDiv');

                // Append the returned data to the current list of hotels.
                for (var i = 0; i < data.length; i += 3) {
                    div.innerHTML += '\n<textarea class="box1A">' + data[i] + '</textarea>';
                    div.innerHTML += '\n<textarea class="box1B">' + data[i + 1] + '</textarea>';
                    div.innerHTML += '\n<textarea class="box3">' + data[i + 2] + '</textarea>';
                }
            });
        }
    }
</script>

ここで、アプリをもう一度実行します。 "wifi" などの一般的な言葉で検索し、結果がホテルの評価の降順で並べ替えられていることを確認します。

複数のホテルの評価が同じであり、それらはデータが見つかった順という不定の順序で表示されます。

並べ替えの 2 番目のレベルを追加することを検討する前に、宿泊料金の範囲を表示するためのコードを追加しましょう。このコードを追加することで、複合型 からデータを抽出する方法に加えて、料金に基づいた結果の並べ替え (安い順) について論じることができます。

宿泊料金の範囲をビューに追加する

最低および最高の宿泊料金を含むプロパティを Hotel.cs モデルに追加します。
```
// Room rate range
public double cheapest { get; set; }
public double expensive { get; set; }
```

ホームコントローラーで、Index(SearchData model) アクションの最後に宿泊料金を計算します。一時データの保存よりも後に計算を追加してください。

// Ensure TempData is stored for the next call.
TempData["page"] = page;
TempData["searchfor"] = model.searchText;

// Calculate the room rate ranges.
await foreach (var result in model.resultList.GetResultsAsync())
{
    var cheapest = 0d;
    var expensive = 0d;

    foreach (var room in result.Document.Rooms)
    {
        var rate = room.BaseRate;
        if (rate < cheapest || cheapest == 0)
        {
            cheapest = (double)rate;
        }
        if (rate > expensive)
        {
            expensive = (double)rate;
        }
    }
    model.resultList.Results[n].Document.cheapest = cheapest;
    model.resultList.Results[n].Document.expensive = expensive;
}

コントローラーの Index(SearchData model) アクションメソッドの Select パラメーターに Rooms プロパティを追加します。
```
options.Select.Add("Rooms");
```

ビューのレンダリングループを変更して、結果の 1 ページ目に料金範囲を表示するようにします。

<!-- Show the hotel data. -->
@for (var i = 0; i < result.Count; i++)
{
    var rateText = $"Rates from ${result[i].Document.cheapest} to ${result[i].Document.expensive}";
    var ratingText = $"Rating: {result[i].Document.Rating}";

    string fullDescription = result[i].Document.Description;

    // Display the hotel details.
    @Html.TextArea($"name{i}", result[i].Document.HotelName, new { @class = "box1A" })
    @Html.TextArea($"rating{i}", ratingText, new { @class = "box1B" })
    @Html.TextArea($"rates{i}", rateText, new { @class = "box2A" })
    @Html.TextArea($"desc{i}", fullDescription, new { @class = "box3" })
}

ホームコントローラーの Next メソッドを変更して、結果の後続ページの料金範囲を伝達するようにします。

public async Task<ActionResult> Next(SearchData model)
{
    // Set the next page setting, and call the Index(model) action.
    model.paging = "next";
    await Index(model);

    // Create an empty list.
    var nextHotels = new List<string>();

    // Add a hotel details to the list.
    await foreach (var result in model.resultList.GetResultsAsync())
    {
        var ratingText = $"Rating: {result.Document.Rating}";
        var rateText = $"Rates from ${result.Document.cheapest} to ${result.Document.expensive}";

        string fullDescription = result.Document.Description;

        // Add strings to the list.
        nextHotels.Add(result.Document.HotelName);
        nextHotels.Add(ratingText);
        nextHotels.Add(rateText);
        nextHotels.Add(fullDescription);
    }

    // Rather than return a view, return the list of data.
    return new JsonResult(nextHotels);
}

ビューの scrolled 関数を更新して、宿泊料金のテキストを処理するようにします。

<script>
    function scrolled() {
        if (myDiv.offsetHeight + myDiv.scrollTop >= myDiv.scrollHeight) {
            $.getJSON("/Home/Next", function (data) {
                var div = document.getElementById('myDiv');

                // Append the returned data to the current list of hotels.
                for (var i = 0; i < data.length; i += 4) {
                    div.innerHTML += '\n<textarea class="box1A">' + data[i] + '</textarea>';
                    div.innerHTML += '\n<textarea class="box1B">' + data[i + 1] + '</textarea>';
                    div.innerHTML += '\n<textarea class="box2A">' + data[i + 2] + '</textarea>';
                    div.innerHTML += '\n<textarea class="box3">' + data[i + 4] + '</textarea>';
                }
            });
        }
    }
</script>

アプリを実行し、宿泊料金の範囲が表示されていることを確認します。

検索パラメーターの OrderBy プロパティは、客室が既に料金順で並べ替えられている場合でも、最安の宿泊料金を提供するための Rooms.BaseRate のようなエントリを受け付けません。このケースでは、客室が料金で並べ替えられることはありません。サンプルデータセットのホテルを宿泊料金で並べ替えて表示するためには、ホームコントローラーで結果を並べ替えて、これらの結果を希望の順序でビューに送信する必要があります。

複数の値に基づいて結果を並べ替える

ここでの問題は、同じ評価のホテルをどのように区別するかです。 1 つの方法として、ホテルが最後に改装された時期に基づいて二次並べ替えを実行し、最近改装されたホテルが結果の上位に表示されるようにします。

並べ替えの第 2 レベルを追加するには、Index(SearchData model) メソッドで、検索結果と OrderBy に LastRenovationDate を追加します。
```
options.Select.Add("LastRenovationDate");

options.OrderBy.Add("LastRenovationDate desc");
```
ヒント

OrderBy リストにはプロパティをいくつでも入力できます。ホテルの評価と改装日が同じである場合に、それらを区別するための 3 番目のプロパティを入力できます。

ここでも、並べ替えが正しいことを確認するためだけに、改装日をビューに表示する必要があります。改装のような事象については、年だけで十分でしょう。ビューのレンダリングループを次のコードに変更します。

<!-- Show the hotel data. -->
@for (var i = 0; i < result.Count; i++)
{
    var rateText = $"Rates from ${result[i].Document.cheapest} to ${result[i].Document.expensive}";
    var lastRenovatedText = $"Last renovated: { result[i].Document.LastRenovationDate.Value.Year}";
    var ratingText = $"Rating: {result[i].Document.Rating}";

    string fullDescription = result[i].Document.Description;

    // Display the hotel details.
    @Html.TextArea($"name{i}", result[i].Document.HotelName, new { @class = "box1A" })
    @Html.TextArea($"rating{i}", ratingText, new { @class = "box1B" })
    @Html.TextArea($"rates{i}", rateText, new { @class = "box2A" })
    @Html.TextArea($"renovation{i}", lastRenovatedText, new { @class = "box2B" })
    @Html.TextArea($"desc{i}", fullDescription, new { @class = "box3" })
}

ホームコントローラーの Next メソッドを変更して、最終改装日の年の部分を転送するようにします。

    public async Task<ActionResult> Next(SearchData model)
    {
        // Set the next page setting, and call the Index(model) action.
        model.paging = "next";
        await Index(model);

        // Create an empty list.
        var nextHotels = new List<string>();

        // Add a hotel details to the list.
        await foreach (var result in model.resultList.GetResultsAsync())
        {
            var ratingText = $"Rating: {result.Document.Rating}";
            var rateText = $"Rates from ${result.Document.cheapest} to ${result.Document.expensive}";
            var lastRenovatedText = $"Last renovated: {result.Document.LastRenovationDate.Value.Year}";

            string fullDescription = result.Document.Description;

            // Add strings to the list.
            nextHotels.Add(result.Document.HotelName);
            nextHotels.Add(ratingText);
            nextHotels.Add(rateText);
            nextHotels.Add(lastRenovatedText);
            nextHotels.Add(fullDescription);
        }

        // Rather than return a view, return the list of data.
        return new JsonResult(nextHotels);
    }

ビューの scrolled 関数を変更して、改装テキストを表示するようにします。

<script>
    function scrolled() {
        if (myDiv.offsetHeight + myDiv.scrollTop >= myDiv.scrollHeight) {
            $.getJSON("/Home/Next", function (data) {
                var div = document.getElementById('myDiv');

                // Append the returned data to the current list of hotels.
                for (var i = 0; i < data.length; i += 5) {
                    div.innerHTML += '\n<textarea class="box1A">' + data[i] + '</textarea>';
                    div.innerHTML += '\n<textarea class="box1B">' + data[i + 1] + '</textarea>';
                    div.innerHTML += '\n<textarea class="box2A">' + data[i + 2] + '</textarea>';
                    div.innerHTML += '\n<textarea class="box2B">' + data[i + 3] + '</textarea>';
                    div.innerHTML += '\n<textarea class="box3">' + data[i + 4] + '</textarea>';
                }
            });
        }
    }
</script>

アプリケーションを実行します。 "pool" (プール) や "view" (眺望) などの一般的な言葉を検索し、同じ評価のホテルが改装日の降順で表示されていることを確認します。

スコアリングプロファイルに基づいて結果を並べ替える

このチュートリアルでこれまで示した例は、数値 (評価と改装日) で並べ替える方法を示しており、"正確な" 並べ替えシーケンスを提供します。ただし、検索やデータによっては、2 つのデータ要素の比較がこれまでのように簡単にはいかない場合があります。フルテキスト検索クエリの場合、Cognitive Search には、"ランク付け" の概念があります。結果をランク付けする方法に影響を与える "スコアリングプロファイル" を指定すると、より複雑な定性的比較を提供できます。

スコアリングプロファイルは、インデックススキーマで定義されます。 hotels データに対して複数のスコアリングプロファイルがセットアップされています。スコアリングプロファイルの定義方法を見てから、それに基づいた検索を行うためのコードを記述してみましょう。

スコアリングプロファイルの定義方法

スコアリングプロファイルは、設計時に検索インデックスで定義されます。 Microsoft がホストする読み取り専用の hotels インデックスには、3 つのスコアリングプロファイルがあります。このセクションでは、スコアリングプロファイルについて説明し、コードでの使用方法を示します。

hotels データセットの既定のスコアリングプロファイルを次に示します。これは、OrderBy または ScoringProfile パラメーターを指定しない場合に使用されます。このプロファイルは、検索テキストがホテル名、説明、またはタグ (アメニティ) のリストに含まれている場合、ホテルの スコア を上げます。スコアリングの重みが特定のフィールドを優遇するしくみに注目してください。検索テキストが、下のリストにない別のフィールドに含まれている場合、その重みは 1 になります。言うまでもなく、スコアが高いほど、結果がビューで上位に表示されます。
```
{
   "name": "boostByField",
   "text": {
       "weights": {
           "Tags": 3,
           "HotelName": 2,
           "Description": 1.5,
           "Description_fr": 1.5,
       }
   }
}
```
次に示す別のスコアリングプロファイルでは、指定されたパラメーターに、タグ (ここでは "アメニティ" と呼びます) のリストが 1 つ以上含まれている場合に、スコアが大幅に上がります。このプロファイルの重要な点は、テキストを含むパラメーターの指定が必須であることです。パラメーターが空、または指定されていない場合、エラーが発生します。
```
{
    "name":"boostAmenities",
    "functions":[
        {
        "fieldName":"Tags",
        "freshness":null,
        "interpolation":"linear",
        "magnitude":null,
        "distance":null,
        "tag":{
            "tagsParameter":"amenities"
        },
        "type":"tag",
        "boost":5
        }
    ],
    "functionAggregation":0
},
```

この 3 番目のプロファイルでは、ホテルの評価によってスコアが大幅に上がります。最終改装日もスコアを上げますが、そのデータが現在の日付から 730 日 (2 年) 以内の場合に限られます。

{
    "name":"renovatedAndHighlyRated",
    "functions":[
        {
        "fieldName":"Rating",
        "freshness":null,
        "interpolation":"linear",
        "magnitude":{
            "boostingRangeStart":0,
            "boostingRangeEnd":5,
            "constantBoostBeyondRange":false
        },
        "distance":null,
        "tag":null,
        "type":"magnitude",
        "boost":20
        },
        {
        "fieldName":"LastRenovationDate",
        "freshness":{
            "boostingDuration":"P730D"
        },
        "interpolation":"quadratic",
        "magnitude":null,
        "distance":null,
        "tag":null,
        "type":"freshness",
        "boost":10
        }
    ],
    "functionAggregation":0
}

それでは、これらのプロファイルが想定どおりに機能するかどうかを確認しましょう。

プロファイルを比較するためのコードをビューに追加する

index.cshtml ファイルを開き、<body> セクションを次のコードに置き換えます。

<body>

@using (Html.BeginForm("Index", "Home", FormMethod.Post))
{
    <table>
        <tr>
            <td></td>
            <td>
                <h1 class="sampleTitle">
                    <img src="~/images/azure-logo.png" width="80" />
                    Hotels Search - Order Results
                </h1>
            </td>
        </tr>
        <tr>
            <td></td>
            <td>
                <!-- Display the search text box, with the search icon to the right of it. -->
                <div class="searchBoxForm">
                    @Html.TextBoxFor(m => m.searchText, new { @class = "searchBox" }) <input class="searchBoxSubmit" type="submit" value="">
                </div>

                <div class="searchBoxForm">
                    <b>&nbsp;Order:&nbsp;</b>
                    @Html.RadioButtonFor(m => m.scoring, "Default") Default&nbsp;&nbsp;
                    @Html.RadioButtonFor(m => m.scoring, "RatingRenovation") By numerical Rating&nbsp;&nbsp;
                    @Html.RadioButtonFor(m => m.scoring, "boostAmenities") By Amenities&nbsp;&nbsp;
                    @Html.RadioButtonFor(m => m.scoring, "renovatedAndHighlyRated") By Renovated date/Rating profile&nbsp;&nbsp;
                </div>
            </td>
        </tr>

        <tr>
            <td valign="top">
                <div id="facetplace" class="facetchecks">

                    @if (Model != null && Model.facetText != null)
                    {
                        <h5 class="facetheader">Amenities:</h5>
                        <ul class="facetlist">
                            @for (var c = 0; c < Model.facetText.Length; c++)
                            {
                                <li> @Html.CheckBoxFor(m => m.facetOn[c], new { @id = "check" + c.ToString() }) @Model.facetText[c] </li>
                            }

                        </ul>
                    }
                </div>
            </td>
            <td>
                @if (Model != null && Model.resultList != null)
                {
                    // Show the total result count.
                    <p class="sampleText">
                        @Html.DisplayFor(m => m.resultList.Count) Results <br />
                    </p>

                    <div id="myDiv" style="width: 800px; height: 450px; overflow-y: scroll;" onscroll="scrolled()">

                        <!-- Show the hotel data. -->
                        @for (var i = 0; i < Model.resultList.Results.Count; i++)
                        {
                            var rateText = $"Rates from ${Model.resultList.Results[i].Document.cheapest} to ${Model.resultList.Results[i].Document.expensive}";
                            var lastRenovatedText = $"Last renovated: { Model.resultList.Results[i].Document.LastRenovationDate.Value.Year}";
                            var ratingText = $"Rating: {Model.resultList.Results[i].Document.Rating}";

                            string amenities = string.Join(", ", Model.resultList.Results[i].Document.Tags);
                            string fullDescription = Model.resultList.Results[i].Document.Description;
                            fullDescription += $"\nAmenities: {amenities}";

                            // Display the hotel details.
                            @Html.TextArea($"name{i}", Model.resultList.Results[i].Document.HotelName, new { @class = "box1A" })
                            @Html.TextArea($"rating{i}", ratingText, new { @class = "box1B" })
                            @Html.TextArea($"rates{i}", rateText, new { @class = "box2A" })
                            @Html.TextArea($"renovation{i}", lastRenovatedText, new { @class = "box2B" })
                            @Html.TextArea($"desc{i}", fullDescription, new { @class = "box3" })
                        }
                    </div>

                    <script>
                        function scrolled() {
                            if (myDiv.offsetHeight + myDiv.scrollTop >= myDiv.scrollHeight) {
                                $.getJSON("/Home/Next", function (data) {
                                    var div = document.getElementById('myDiv');

                                    // Append the returned data to the current list of hotels.
                                    for (var i = 0; i < data.length; i += 5) {
                                        div.innerHTML += '\n<textarea class="box1A">' + data[i] + '</textarea>';
                                        div.innerHTML += '<textarea class="box1B">' + data[i + 1] + '</textarea>';
                                        div.innerHTML += '\n<textarea class="box2A">' + data[i + 2] + '</textarea>';
                                        div.innerHTML += '<textarea class="box2B">' + data[i + 3] + '</textarea>';
                                        div.innerHTML += '\n<textarea class="box3">' + data[i + 4] + '</textarea>';
                                    }
                                });
                            }
                        }
                    </script>
                }
            </td>
        </tr>
    </table>
}
</body>

SearchData.cs ファイルを開き、SearchData クラスを次のコードに置き換えます。

public class SearchData
{
    public SearchData()
    {
    }

    // Constructor to initialize the list of facets sent from the controller.
    public SearchData(List<string> facets)
    {
        facetText = new string[facets.Count];

        for (int i = 0; i < facets.Count; i++)
        {
            facetText[i] = facets[i];
        }
    }

    // Array to hold the text for each amenity.
    public string[] facetText { get; set; }

    // Array to hold the setting for each amenitity.
    public bool[] facetOn { get; set; }

    // The text to search for.
    public string searchText { get; set; }

    // Record if the next page is requested.
    public string paging { get; set; }

    // The list of results.
    public DocumentSearchResult<Hotel> resultList;

    public string scoring { get; set; }       
}

hotels.css ファイルを開き、次の HTML クラスを追加します。

.facetlist {
    list-style: none;
}

.facetchecks {
    width: 250px;
    display: normal;
    color: #666;
    margin: 10px;
    padding: 5px;
}

.facetheader {
    font-size: 10pt;
    font-weight: bold;
    color: darkgreen;
}

スコアリングプロファイルを指定するためのコードをコントローラーに追加する

ホームコントローラーファイルを開きます。 (リストの作成を補助するために) 次の using ステートメントを追加します。
```
using System.Linq;
```

この例では、初期ビューの取得に加えて追加処理を実行するために、Index の初回呼び出しが必要です。このメソッドは、ビューに表示する最大 20 のアメニティを検索します。

    public async Task<ActionResult> Index()
    {
        InitSearch();

        // Set up the facets call in the search parameters.
        SearchOptions options = new SearchOptions();
        // Search for up to 20 amenities.
        options.Facets.Add("Tags,count:20");

        SearchResults<Hotel> searchResult = await _searchClient.SearchAsync<Hotel>("*", options);

        // Convert the results to a list that can be displayed in the client.
        List<string> facets = searchResult.Facets["Tags"].Select(x => x.Value.ToString()).ToList();

        // Initiate a model with a list of facets for the first view.
        SearchData model = new SearchData(facets);

        // Save the facet text for the next view.
        SaveFacets(model, false);

        // Render the view including the facets.
        return View(model);
    }

ファセットを一時ストレージに保存し、それらを一時ストレージから復旧してモデルにデータを入力するために、2 つのプライベートメソッドが必要です。

    // Save the facet text to temporary storage, optionally saving the state of the check boxes.
    private void SaveFacets(SearchData model, bool saveChecks = false)
    {
        for (int i = 0; i < model.facetText.Length; i++)
        {
            TempData["facet" + i.ToString()] = model.facetText[i];
            if (saveChecks)
            {
                TempData["faceton" + i.ToString()] = model.facetOn[i];
            }
        }
        TempData["facetcount"] = model.facetText.Length;
    }

    // Recover the facet text to a model, optionally recoving the state of the check boxes.
    private void RecoverFacets(SearchData model, bool recoverChecks = false)
    {
        // Create arrays of the appropriate length.
        model.facetText = new string[(int)TempData["facetcount"]];
        if (recoverChecks)
        {
            model.facetOn = new bool[(int)TempData["facetcount"]];
        }

        for (int i = 0; i < (int)TempData["facetcount"]; i++)
        {
            model.facetText[i] = TempData["facet" + i.ToString()].ToString();
            if (recoverChecks)
            {
                model.facetOn[i] = (bool)TempData["faceton" + i.ToString()];
            }
        }
    }

必要に応じて、OrderBy および ScoringProfile パラメーターを設定する必要があります。既存の Index(SearchData model) メソッドを次のものに置き換えます。

public async Task<ActionResult> Index(SearchData model)
{
    try
    {
        InitSearch();

        int page;

        if (model.paging != null && model.paging == "next")
        {
            // Recover the facet text, and the facet check box settings.
            RecoverFacets(model, true);

            // Increment the page.
            page = (int)TempData["page"] + 1;

            // Recover the search text.
            model.searchText = TempData["searchfor"].ToString();
        }
        else
        {
            // First search with text. 
            // Recover the facet text, but ignore the check box settings, and use the current model settings.
            RecoverFacets(model, false);

            // First call. Check for valid text input, and valid scoring profile.
            if (model.searchText == null)
            {
                model.searchText = "";
            }
            if (model.scoring == null)
            {
                model.scoring = "Default";
            }
            page = 0;
        }

        // Setup the search parameters.
        var options = new SearchOptions
        {
            SearchMode = SearchMode.All,

            // Skip past results that have already been returned.
            Skip = page * GlobalVariables.ResultsPerPage,

            // Take only the next page worth of results.
            Size = GlobalVariables.ResultsPerPage,

            // Include the total number of results.
            IncludeTotalCount = true,
        };
        // Select the data properties to be returned.
        options.Select.Add("HotelName");
        options.Select.Add("Description");
        options.Select.Add("Tags");
        options.Select.Add("Rooms");
        options.Select.Add("Rating");
        options.Select.Add("LastRenovationDate");

        List<string> parameters = new List<string>();
        // Set the ordering based on the user's radio button selection.
        switch (model.scoring)
        {
            case "RatingRenovation":
                // Set the ordering/scoring parameters.
                options.OrderBy.Add("Rating desc");
                options.OrderBy.Add("LastRenovationDate desc");
                break;

            case "boostAmenities":
                {
                    options.ScoringProfile = model.scoring;

                    // Create a string list of amenities that have been clicked.
                    for (int a = 0; a < model.facetOn.Length; a++)
                    {
                        if (model.facetOn[a])
                        {
                            parameters.Add(model.facetText[a]);
                        }
                    }

                    if (parameters.Count > 0)
                    {
                        options.ScoringParameters.Add($"amenities-{ string.Join(',', parameters)}");
                    }
                    else
                    {
                        // No amenities selected, so set profile back to default.
                        options.ScoringProfile = "";
                    }
                }
                break;

            case "renovatedAndHighlyRated":
                options.ScoringProfile = model.scoring;
                break;

            default:
                break;
        }

        // For efficiency, the search call should be asynchronous, so use SearchAsync rather than Search.
        model.resultList = await _searchClient.SearchAsync<Hotel>(model.searchText, options);

        // Ensure TempData is stored for the next call.
        TempData["page"] = page;
        TempData["searchfor"] = model.searchText;
        TempData["scoring"] = model.scoring;
        SaveFacets(model, true);

        // Calculate the room rate ranges.
        await foreach (var result in model.resultList.GetResultsAsync())
        {
            var cheapest = 0d;
            var expensive = 0d;

            foreach (var room in result.Document.Rooms)
            {
                var rate = room.BaseRate;
                if (rate < cheapest || cheapest == 0)
                {
                    cheapest = (double)rate;
                }
                if (rate > expensive)
                {
                    expensive = (double)rate;
                }
            }

            result.Document.cheapest = cheapest;
            result.Document.expensive = expensive;
        }
    }
    catch
    {
        return View("Error", new ErrorViewModel { RequestId = "1" });
    }

    return View("Index", model);
}

それぞれの switch 選択のコメントを最後まで読んでください。

複数のプロパティに基づいた並べ替えに関する前のセクションの追加コードを完了した場合、Next アクションに変更を加える必要はありません。

アプリを実行してテストする

アプリケーションを実行します。すべてのアメニティがビューに表示されます。
並べ替える場合、"By numerical Rating" (評価の数字順) を選択すると、このチュートリアルで既に実装した数値による並べ替えを実行できます。このとき、評価が同じホテルの表示順は改装日によって決まります。
ここで "By amenities" (アメニティ順) プロファイルを試してみましょう。さまざまなアメニティを選択し、結果リストで、それらのアメニティを備えたホテルの表示順が上がることを確認します。
"By Renovated date/Rating profile" (改装日/評価順プロファイル) を試して、期待する結果が得られるかどうか確認します。最近改装されたホテルのみ、freshness (新しさ) が上昇するはずです。

リソース

詳細については、次の「スコアリングプロファイルを Azure Cognitive Search のインデックスに追加する」を参照してください。

重要なポイント

このプロジェクトの重要なポイントを示します。

ユーザーが期待するのは、最も関連性の高いものが最初に来るように検索結果が並べ替えられることです。
並べ替えが簡単になるようにデータを構造化する必要があります。追加コードなしで並べ替えを実行できるほどデータが構造化されていないため、"最も安い" ものを最初に表示する並べ替えが簡単にはできませんでした。
より上のレベルでの並べ替えで値が同じである結果を差別化するために、並べ替えを複数のレベルにすることができます。
当然ながら、(ある地点からの距離のように) 昇順で並べ替える結果もあれば、(宿泊客の評価のように) 降順で並べ替える結果もあります。
スコアリングプロファイルは、データセットに対して数値での比較が利用できない、またはそれによって適切な結果が得られない場合に定義できます。個々の結果にスコアを付けると、結果をインテリジェントに並べ替えて表示するために役立ちます。

次のステップ

この一連の C# チュートリアルを完了しました。Azure Cognitive Search API に関する貴重な知識が得られたことでしょう。

さらなるリファレンスやチュートリアルについては、Microsoft Learn トレーニングカタログや、Azure Cognitive Search ドキュメントのその他のチュートリアルをぜひ参考にしてください。