Схема содержимого приложений

Статья
07/20/2023

содержимое приложения или аппконтент-ms, схема для приложений Windows, позволяет разработчикам усовершенствовать поиск в приложении, предоставляя дополнительные сведения о содержимом приложения в индексе поиска Windows.

Принцип работы

чтобы запросить Windows индексировать данные приложения для поиска в приложении, создайте папку с именем "indexed" в локалфолдер и сохраните файлы, которые нужно проиндексировать. Windows индексирует содержимое файла и метаданные (свойства) в этой "индексированной" папке и всех ее вложенных папках.

Чтобы использовать схему аппконтент-MS для индексирования сведений о файле или элементе, создайте файл аппконтент-MS и добавьте его в папку локалфолдер\индексед приложения (это необходимо сделать во время выполнения после установки приложения). когда приложение использует Windows. служба хранилища. Поиск API-интерфейсов для выполнения запросов к индексированной папке. в результате поиска будут включены сведения из файлов аппконтент – MS.

сведения в файлах аппконтент-ms используются только в том случае, если приложение, содержащее эти файлы, использует Windows. служба хранилища. Поисковый API для выполнения поиска; эти сведения не отображаются в Windows пользовательском интерфейсе или в других приложениях, например.

В этом примере показан простой файл аппконтент-MS, описывающий элемент с именем Sample 1.

Обратите внимание, что файл содержит элементы, не определенные в схеме аппконтент-MS: IndexerSampleInformation и IndexerSampleSpecificElement . Файл аппконтент-MS должен иметь корневой узел, который инкапсулирует все индексируемые данные, но вы можете назвать этот узел любым нужным данным.

<?xml version="1.0" encoding="utf-8"?>
<IndexerSampleInformation>
  <Properties xmlns="http://schemas.microsoft.com/Search/2013/ApplicationContent">
    <Name>Sample 1</Name>
    <Keywords>
      <Keyword xml:lang="en-US">Sample 1 - keyword 1</Keyword>
      <Keyword>Sample 1 - keyword 2</Keyword>
    </Keywords>
    <Comment>Sample 1 comment</Comment>
    <AdditionalProperties>
      <Property Key="System.Title">Sample 1 Title</Property>
      <Property xml:lang="en-US" Key="System.Contact.EmailAddresses">
        <Value>bryan@contoso.com</Value>
        <Value>vincent@contoso.com</Value>
      </Property>
    </AdditionalProperties>
  </Properties>
  <IndexerSampleSpecificElement sc:IndexableContent="true" 
    xmlns:sc="http://schemas.microsoft.com/Search/2013/ApplicationContent">
    The text included here will be indexed, enabling full-text search.
  </IndexerSampleSpecificElement>
</IndexerSampleInformation>

можно даже указать Windows поиска, чтобы индексировать содержимое произвольных элементов. Просто используйте атрибут индексаблеконтент , чтобы указать, что поиск будет индексировать содержимое. в предыдущем примере Windows поиск будет индексировать содержимое индексерсамплеспеЦифицелемент, так как атрибут индексаблеконтент имеет значение true:

  <IndexerSampleSpecificElement sc:IndexableContent="true" 
    xmlns:sc="http://schemas.microsoft.com/Search/2013/ApplicationContent">
    The text included here will be indexed, enabling full-text search.
  </IndexerSampleSpecificElement>

По умолчанию поиск будет рассматривать содержимое как текстовое содержимое; Если содержимое является Base64, используйте атрибут ContentType , чтобы указать тип MIME.

В следующем примере показано, как скопировать файл аппконтент-MS в папку Локалфолдер\индексед приложения. Код копирует все найденные файлы из папки аппконтент-MS приложения в папку Локалфолдер\индексед. (Можно также создать новые файлы аппконтент-MS непосредственно в индексированной папке, а не копировать их из другого расположения.)

/// <summary>
/// For the purposes of this sample, the appcontent-ms files are stored in an "appcontent-ms" folder in the
/// install directory. These are then copied into the app&#39;s "LocalState\Indexed" folder, which exposes them
/// to the indexer.
/// </summary>
public async static Task<string> AddAppContentFilesToIndexedFolder()
{
    var localFolder = Windows.Storage.ApplicationData.Current.LocalFolder;
    var installDirectory = Windows.ApplicationModel.Package.Current.InstalledLocation;
    var outputString = "Items added to the \"Indexed\" folder:";
    var appContentFolder = await installDirectory.GetFolderAsync("appcontent-ms");
    var indexedFolder = await localFolder.CreateFolderAsync(
        "Indexed", Windows.Storage.CreationCollisionOption.OpenIfExists);
    var files = await appContentFolder.GetFilesAsync();
    foreach (var file in files)
    {
        outputString += "\n" + file.DisplayName + file.FileType;
        await file.CopyAsync(indexedFolder, 
            file.Name, Windows.Storage.NameCollisionOption.ReplaceExisting);
    }
    return outputString;
}

// For the purposes of this sample, the appcontent-ms files are stored in an "appcontent-ms" folder
// in the install directory.  These are then copied into the app&#39;s "LocalState\Indexed" folder,
// which exposes them to the indexer.
function _addAppContentFilesToIndexedFolder() {
    var localFolder = appData.localFolder,
        appcontentFolder,
        indexedFolder,
        installDirectory = Windows.ApplicationModel.Package.current.installedLocation;
    var output = "Items added to the \"Indexed\" folder:\n";
    installDirectory.getFolderAsync("appcontent-ms").then(function (retrievedAppcontentFolder) {
        appcontentFolder = retrievedAppcontentFolder;
        return localFolder.createFolderAsync(
            "Indexed", Windows.Storage.CreationCollisionOption.openIfExists);
    }).then(function (retrievedIndexedFolder) {
        indexedFolder = retrievedIndexedFolder;
        return appcontentFolder.getFilesAsync(appcontentFolder);
    }).then(function (files) {
        var promiseArray = [];
        for (var i = 0, len = files.length; i < len; i++) {
            promiseArray[i] = files[i].copyAsync(indexedFolder, 
                files[i].name, Windows.Storage.NameCollisionOption.replaceExisting);
            output += files[i].displayName + files[i].fileType;
            if (i < len - 1) {
                output += "\n";
            }
        }
        return WinJS.Promise.join(promiseArray);
    }).done(function () {
        WinJS.log &amp;&amp; WinJS.log(output, "sample", "status");
    });
}

Полный код см. в примере индексатора.

Справочник по элементам

В следующей таблице перечислены все элементы этой схемы, отсортированные в алфавитном порядке по имени.

Элемент	Описание
AdditionalProperties	Содержит дополнительные свойства, описывающие элемент.
Комментарий	Содержит системный комментарий , описывающий элемент.
Ключевое слово	Одно из ключевых слов System. keywords , описывающее элемент.
Ключевые слова	Содержит ключевое слово System. keywords , описывающее элемент.
имя;	Задает System. ItemName \System. итемнамедисплай элемента.
Свойства	содержит свойства, описывающие элемент в индексе поиска Windows.
Свойство	Свойство, описывающее элемент.
Значение	Значение, которое будет индексироваться для свойства.

Атрибуты для элементов конкретного приложения

Используйте эти атрибуты для индексирования содержимого в собственных XML-элементах конкретного приложения.

attribute	Описание
ContentType	Установка этого свойства для элемента означает, что содержимое элемента обрабатывается как кодировка Base64 указанного типа MIME или типа содержимого и индексируется с помощью обработчика для этого типа содержимого.
IndexableContent	Указывает, что текст элемента должен индексироваться для поиска, но не связан со свойством. Обратите внимание, что свойства можно получить позже с помощью ключа свойства, но текстовое содержимое не может быть.