Понимание и использование доменов (Руководство по структуре обработки контента) — Документация по продукту MarkLogic 10
Понимание и использование доменов (Руководство по структуре обработки контента) — Документация по продукту MarkLogic 10Загрузка оглавления…
« Предыдущая глава
Следующая глава »
В этой главе описываются домены в среде обработки контента MarkLogic Server, и она включает следующие разделы:
- Обзор доменов
- Область действия домена и контекст оценки кода
- Правила для доменов
- Создание и изменение доменов
- Присоединение и отсоединение конвейеров от доменов
Обзор доменов
Приложения часто выполняют одни и те же операции по обработке содержимого набора документов. Например, у вас может быть набор XML-документов из одного источника, и вам нужно выполнить одинаковую обработку для каждого из этих документов.
Платформа обработки контента MarkLogic Server использует доменов для описания группы документов, к которым должны применяться одни и те же операции обработки контента.
Вы можете использовать домены для осмысленного разделения наборов документов и применять одинаковую обработку содержимого ко всем документам в заданном наборе документов. Например, если у вас есть один набор документов, исходящий от компании X в определенной форме, и другой набор документов, исходящий от компании Y в другой форме, вы можете определить отдельный набор обработки контента для каждого набора документов. Затем вы можете создать домены для каждого набора документов, выполняя соответствующие операции обработки содержимого последовательности для каждого типа документа.
Область действия домена и контекст оценки кода
Приложение для обработки контента можно рассматривать как состоящее из двух частей:
- Документы (контент), обрабатываемые приложением.
- Код, составляющий приложение.
Каждый домен содержит информацию о конфигурации для документов (отвечая на вопрос:
- Область действия домена
- Контекст оценки
- Область домена может инкапсулировать логику обработки
Область действия домена
Область действия домена определяет документы, к которым применяется этот домен. Область действия домена определяется на странице «Конфигурация домена» интерфейса администратора.
В интерфейсе администратора раскрывающийся список области документа указывает, применяется ли домен к отдельному документу, каталогу или коллекции. Каждый домен может иметь только одну из этих областей документа; если вам нужно более одной из этих областей документа, вы можете создать несколько доменов.
Поле uri указывает URI для документа, каталога или коллекции, указанных в области документа .
глубина 9Раскрывающийся список 0064 применяется только в том случае, если вы укажете область документа и укажете либо каталога 0 , чтобы указать только документы в непосредственном каталоге, либо бесконечность , чтобы указать документы в любом каталоге, который является потомком указанного URI каталога.
Контекст оценки
При создании домена Content Processing Framework автоматически создает набор триггеров для отслеживания событий (создание, обновление, удаление, изменение свойств и доступ к базе данных в сети). Запросы, которые выполняются триггерами, выполняются в указанных контекст оценки . Это важно, потому что любой код обработки контента, который использует этот домен, также в конечном итоге оценивает свои модули в этом контексте.
Поскольку код обработки содержимого выполняется в указанном контексте, любой импорт модулей в коде обработки содержимого (например, для ваших модулей условий и действий) разрешается относительно указанной базы данных и корня URI.
Область действия домена может инкапсулировать логику обработки
Поскольку обработка содержимого происходит только для документов в пределах области действия домена, любой код обработки содержимого может работать в предположении, что все документы, которые он видит, требуют обработки. Этот факт упрощает код обработки, поскольку ему не нужно включать сложную логику, чтобы определить, нуждается ли документ в обработке. Тот факт, что документ находится в области действия определенного домена, обеспечивает всю логику, необходимую для определения того, что он нуждается в обработке.
Правила для доменов
В этом разделе описаны следующие правила для доменов:
- Не перекрывать домены
- Примечания к домену коллекции
Не перекрывать домены
Если вы используете несколько доменов, убедитесь, что два домена не перекрываются; то есть домен не должен включать никаких документов, которые включены в другой домен. Если у вас есть перекрывающиеся домены, документы могут быть обработаны дважды, что может привести к неожиданным результатам.
Например, если у вас есть домен, определенный с бесконечной областью каталога в каталоге /myDomain , и если у вас есть другой домен с бесконечной областью каталогов в каталоге /myDomain/docs , то любые документы в каталоге /myDomain/docs применяются к обоим доменам, поэтому они будут обрабатываться дважды. Если вы создаете перекрывающийся домен, интерфейс администратора выдает предупреждение. Хотя их можно создать, MarkLogic рекомендует не использовать перекрывающиеся домены.
Если вы используете область коллекции в своих доменах, не всегда может быть очевидно, что ваши домены перекрываются. Документы могут принадлежать нескольким коллекциям, и вы можете добавлять или удалять документы из коллекции. Кроме того, новый документ может быть создан в коллекции на основе коллекций по умолчанию пользователя, создавшего документ. Будьте осторожны с неожиданным перекрытием доменов при использовании доменов области сбора.
Примечания области действия домена собрания
Если вы используете домен области собрания для указания документов для преобразования, любые новые документы, созданные в процессе преобразования, также должны создаваться как часть собрания, указанного в домене.
Если они не являются частью коллекции, они не будут распознаваться доменом для дальнейшей обработки.
Ниже приведены некоторые способы убедиться, что документы являются частью одной или нескольких коллекций:
- Установите
наследует параметр collectionsна уровне базы данных доtrueи убедитесь, что родительский каталог принадлежит коллекции. - Пользователь, который инициирует обработку содержимого (т. е. пользователь, который изначально создает документы для обработки, путем перетаскивания в папку WebDAV или каким-либо другим способом), может указать коллекцию в качестве коллекции по умолчанию (или коллекция по умолчанию, прикрепленная к роли, которой назначен пользователь).
- Вы можете явно установить коллекцию для документа (например, в коде модуля XQuery или через XDBC).
Область домена коллекции подходит для некоторых типов приложений, особенно когда вы не можете всегда контролировать URI документа.
Поскольку домены с областью действия коллекции могут продолжить следующую фазу обработки только в том случае, если новый или измененный документ является частью этой коллекции, вы можете использовать коллекции как способ перемещения документов в различные наборы обработки и из них.
Создание и изменение доменов
Интерфейс администратора используется для создания и изменения доменов. Выполните следующие шаги, чтобы создать домен:
- В меню Интерфейс администратора щелкните ссылку Базы данных, а затем щелкните имя базы данных, к которой вы хотите добавить домен.
- Под именем базы данных щелкните Обработка содержимого.
- Если для вашей базы данных уже установлена обработка контента, в дереве навигации вы увидите ссылки для доменов и конвейеров. Щелкните Домены.
Если обработка содержимого не установлена, установите ее, как описано в разделе Установка платформы обработки содержимого в базе данных.
- Перейдите на вкладку «Создать». Появится страница создания домена.
- Введите доменное имя
- Укажите область домена
- Укажите контекст оценки
- Нажмите OK.
Дополнительные сведения о контексте оценки см. в разделе Контекст оценки.Домен создан. Чтобы использовать домен, необходимо подключить конвейер.
Аналогично, вы можете использовать интерфейс администратора для выбора существующего домена и изменения информации о его конфигурации.
Присоединение и отсоединение конвейеров от доменов
Чтобы выполнить конвейер, его необходимо сначала присоединить к домену. Дополнительные сведения о конвейерах см. в разделе Понимание и использование конвейеров.
Выполните следующие действия, чтобы присоединить или отсоединить конвейеры от домена:
- В интерфейсе администратора выберите домен, к которому вы хотите добавить конвейер (например, Базы данных > myDatabase > myDomain).
- В домене выберите Pipelines. Появится экран Domain Pipeline .
- Отметьте все конвейеры, которые вы хотите подключить к домену, и снимите флажки со всех конвейеров, которые вы хотите отсоединить от домена. Для большинства доменов следует выбрать конвейер
обработки изменений состояниядля подключения, а также любые другие используемые вами конвейеры (включая любые созданные вами настраиваемые конвейеры). - Если вы хотите подключить к домену несколько конвейеров, установите флажок для других.
- Нажмите OK.
Для большинства доменов следует выбрать конвейер Подключенные конвейеры отображаются в верхней части списка Конфигурация конвейера домена. Обратите внимание, что конвейер может быть подключен к нескольким доменам одновременно.
« Предыдущая глава
Следующая глава »
Область выраженийдля итогов, агрегатов и встроенных коллекций в отчете с разбивкой на страницы — Microsoft Report Builder и Power BI Report Builder
- Статья
- 12 минут на чтение
Применяется к: ✔️ Microsoft Report Builder (SSRS) ✔️ Power BI Report Builder ✔️ Report Designer в SQL Server Data Tools
При написании выражений вы обнаружите, что термин область действия используется в нескольких контекстах в отчетах с разбивкой на страницы.
Область может указывать данные, используемые для оценки выражения, набор текстовых полей на отображаемой странице, набор элементов отчета, которые могут быть показаны или скрыты на основе переключателя. Вы увидите термин
Область данных Область данных — это иерархия областей, которые использует обработчик отчетов, поскольку он объединяет данные отчета и структуру отчета, а также создает области данных, такие как таблицы и диаграммы, на которых отображаются данные. Понимание области данных поможет вам получить нужные результаты, если вы сделаете следующее:
Напишите выражения, использующие агрегатные функции Укажите, какие данные следует агрегировать.
Расположение выражения в отчете влияет на то, какие данные входят в область действия агрегатных вычислений.Добавление спарклайнов в таблицу или матрицу Укажите минимальный и максимальный диапазон осей диаграммы для выравнивания вложенных экземпляров в таблице или матрице.
Добавление индикаторов в таблицу или матрицу Укажите минимальный и максимальный масштаб для датчика для выравнивания вложенных экземпляров в таблице или матрице.
Запись выражений сортировки Укажите содержащую область, которую можно использовать для синхронизации порядка сортировки между несколькими связанными элементами отчета.
Область действия ячейки Область действия ячейки — это набор групп строк и столбцов в области данных табликса, к которой принадлежит ячейка. По умолчанию каждая ячейка табликса содержит текстовое поле. Значение текстового поля является выражением.
Область действия элемента отчета Область действия элемента отчета относится к набору элементов на отображаемой странице отчета. Процессор отчетов объединяет данные и элементы макета отчета для создания скомпилированного определения отчета. Во время этого процесса области данных, такие как таблицы и матрицы, расширяются по мере необходимости для отображения всех данных отчета. Затем скомпилированный отчет обрабатывается средством визуализации отчетов. Средство подготовки отчетов определяет, какие элементы отчета будут отображаться на каждой странице. На сервере отчетов каждая страница визуализируется по мере того, как вы ее просматриваете. При экспорте отчета отображаются все страницы. Понимание области действия элемента отчета поможет вам получить нужные результаты при следующих действиях:
Добавить элементы переключения Укажите текстовое поле, чтобы добавить переключатель, управляющий видимостью элемента отчета.
Вы можете добавить переключатель только к текстовым полям, которые находятся в области действия элемента отчета, который вы хотите переключить.Запись выражений в верхних и нижних колонтитулах Указание значений в выражениях в текстовых полях или других элементах отчета, отображаемых на отображаемой странице.
Вы можете добавить переключатель только к текстовым полям, которые находятся в области действия элемента отчета, который вы хотите переключить.Понимание областей поможет вам успешно писать выражения, дающие нужные результаты.
Примечание
Файлы определения отчетов с разбивкой на страницы (RDL) можно создавать и изменять в построителе отчетов Microsoft, построителе отчетов Power BI и в конструкторе отчетов в SQL Server Data Tools.
Общие сведения об области данных и иерархии данных
Область данных определяет набор данных отчета. Область данных имеет естественную иерархию с неотъемлемыми отношениями сдерживания. Области, расположенные выше по иерархии, содержат области, расположенные ниже по иерархии. В следующем списке областей данных описана иерархия в порядке от наибольшего количества данных к наименьшему количеству данных:
Наборы данных после применения фильтров набора данных Указывает набор данных отчета, связанный с областью данных или с элементом отчета в теле отчета.
Данные, используемые для агрегирования, берутся из набора данных отчета после применения выражений фильтра набора данных. Для общих наборов данных это означает как фильтры в определении общего набора данных, так и фильтры в экземпляре общего набора данных в отчете.Области данных Указывает данные из области данных после применения фильтра области данных и выражений сортировки. Групповые фильтры не используются при расчете агрегатов для областей данных.
Группы областей данных после применения групповых фильтров Указывает данные после применения групповых выражений и групповых фильтров к родительской группе и дочерним группам. Для таблицы это группы строк и столбцов. Для диаграммы это серии и группы категорий. В целях определения ограничения области каждая родительская группа содержит свои дочерние группы.
Вложенные области данных Задает данные для вложенной области данных в контексте ячейки, к которой они были добавлены, и после применения фильтра вложенной области данных и выражений сортировки.
Группы строк и столбцов для вложенных областей данных Указывает данные после применения выражений групп вложенных областей данных и групповых фильтров.
Данные, используемые для агрегирования, берутся из набора данных отчета после применения выражений фильтра набора данных. Для общих наборов данных это означает как фильтры в определении общего набора данных, так и фильтры в экземпляре общего набора данных в отчете.
Понимание содержащих и содержащих областей важно при написании выражений, включающих агрегатные функции.
Область действия ячейки и выражения
Когда вы указываете область действия, вы указываете обработчику отчетов, какие данные следует использовать для агрегированного расчета. В зависимости от выражения и местоположения выражения допустимыми областями действия могут быть , содержащий области , также известные как родительские области, или , содержащие области , также известные как дочерние или вложенные области. Как правило, вы не можете указать отдельный экземпляр группы в агрегированном вычислении. Вы можете указать агрегат для всех экземпляров группы.
Поскольку обработчик отчетов объединяет данные из набора данных отчета с областью данных табликса, он оценивает групповые выражения и создает строки и столбцы, необходимые для представления экземпляров групп.
Значение выражений в текстовом поле каждой ячейки табликса оценивается в контексте области действия ячейки. В зависимости от структуры табликса ячейка может принадлежать нескольким группам строк и группам столбцов. Для агрегатных функций можно указать, какую область использовать, используя одну из следующих областей:
Область по умолчанию Данные, находящиеся в области действия вычислений, когда обработчик отчетов оценивает выражение. Область по умолчанию — это самый внутренний набор групп, к которым принадлежит ячейка или точка данных. Для области данных табликса набор может включать группы строк и столбцов. Для области данных диаграммы набор может включать группы категорий и рядов.
Именованная область Имя набора данных, области данных или группы областей данных, которые входят в область действия выражения. Для агрегатных вычислений можно указать содержащую область. Вы не можете указать именованную область для группы строк и группы столбцов в одном выражении.
Вы не можете указать содержащуюся область, если выражение не предназначено для агрегата агрегата.Следующее выражение создает интервал лет между SellStartDate и LastReceiptDate. Эти поля находятся в двух разных наборах данных, DataSet1 и DataSet2. Первая функция (построитель отчетов и службы SSRS), которая является агрегатной функцией, возвращает первое значение SellStartDate в DataSet1 и первое значение LastReceiptDate в DataSet2.
=DATEDIFF("гггг", First(Fields!SellStartDate.Value, "DataSet1"), First(Fields!LastReceiptDate.Value, "DataSet2"))Область домена Также называется областью синхронизации. Тип области данных, который применяется к оценке выражений для вложенных областей данных. Область домена используется для указания агрегатов по всем экземплярам группы, чтобы вложенные экземпляры можно было выровнять и легко сравнить. Например, вы можете выровнять диапазон и высоту спарклайнов, встроенных в таблицу, чтобы значения совпадали.
Вы не можете указать содержащуюся область, если выражение не предназначено для агрегата агрегата.
В некоторых местах отчета необходимо указать область. Например, для текстового поля в области конструктора необходимо указать имя используемого набора данных: = Макс.(Поля!Продажи.Значение;"Набор данных1") . В других местах существует неявная область действия по умолчанию. Например, если вы не укажете агрегат для текстового поля в области группы, будет использоваться агрегат по умолчанию First.
В каждой теме агрегатной функции перечислены области действия, допустимые для ее использования. Дополнительные сведения см. в разделе Справочник по агрегатным функциям (построитель отчетов и службы SSRS).
Пример агрегатных выражений для области табличных данных
Для написания выражений, определяющих области действия, отличные от значений по умолчанию, требуется некоторая практика. Чтобы помочь вам понять различные области, используйте следующий рисунок и таблицу. На рисунке обозначена каждая ячейка в таблице с информацией о продажах, которая отображает количество проданных товаров по годам и кварталам, а также по территориям продаж.
Обратите внимание на визуальные подсказки на маркерах строк и маркерах столбцов, которые отображают структуру групп строк и столбцов, указывая на вложенные группы. Таблица имеет следующую структуру:
Заголовок таблицы, содержащий угловую ячейку и три строки, содержащие заголовки групп столбцов.
Две вложенные группы строк на основе категории Cat и подкатегории SubCat.
Две вложенные группы столбцов на основе года с именем Year и квартала с именем Qtr.
Один столбец статических итогов с меткой Итоги.
Одна смежная группа столбцов на основе территории продаж с названием «Территория».
Заголовок столбца для группы территорий разделен на две ячейки для отображения. В первой ячейке отображается название территории и итоговые суммы, а во второй ячейке содержится текст-заполнитель, в котором рассчитывается процентный вклад каждой территории во все продажи.
Предположим, что набор данных называется DataSet1, а таблица — Tablix1.
В следующей таблице перечислены метки ячеек, область действия по умолчанию и примеры. Значения для текста-заполнителя показаны в синтаксисе выражения.
| Сотовый | Область действия по умолчанию | Этикетки-заполнители | Текст или значения заполнителя |
|---|---|---|---|
| С01 | Табликс1 | [Сумма(кол-во)] | Агрегаты и область действия |
| С02 | Внешняя группа столбцов «Год» | [Год] ([Кол-во Годов]) | =Поля!Год.Значение |
| С03 | Табликс1 | [Сумма(кол-во)] | Итоги |
| С04 | Одноранговая группа столбцов «Территория» | ([Всего]) | Территория |
| С05 | Внутренняя группа «Qtr» | [Qtr] ([QtrQty]) | Q |
| С06 | Одноранговая группа столбцов «Территория» | [Территория] ([Tty]) [Pct] | =Fields!Territory.Value |
| С07 | Группа внешних рядов «Кошка» | [Кат.] [Сумма(кол-во)] | =Поля!Cat.Value |
| С08 | То же, что C07 | ||
| С09 | Группа внешних строк «Cat» и группа внутренних столбцов «Qtr» | [Сумма(кол-во)] | = Сумма (Поля! Кол-во. |
| С10 | То же, что C07 | <<Выражение>> | = Сумма(Полей!Кол-во.Значение) & ": " & ФорматПроцент(Сумма(Полей!Кол-во.Значение)/Сумма(Полей!Кол-во.Значение,"Табликс1"),0) & " из " & Сумма(Полей !Qty.Value,"Табликс1") |
| С11 | Внешняя группа строк «Кот» и группа столбцов «Территория» | <<Выражение>> | = Сумма(Полей!Кол-во.Значение) & ": " & ФорматПроцент(Сумма(Полей!Кол-во.Значение)/Сумма(Полей!Кол-во.Значение,"Территория"),0) & " of " & Сумма(Полей !Qty.Value,"Территория") |
| С12 | Группа внутренних рядов «Subcat» | [Подкатегория] [Сумма(кол-во)] | =Поля!SubCat.Value |
| С13 | Группа внутренних строк «Subcat» и группа внутренних столбцов «Qtr» | [Сумма(кол-во)] | = Сумма (Поля! Кол-во. |
| С14 | Группа внутренних рядов «Subcat» | <<Выражение>> | = Сумма(Полей!Кол-во.Значение) & ": " & ФорматПроцент(Сумма(Полей!Кол-во.Значение)/Сумма(Полей!Кол-во.Значение,"Cat"),0) & " of " & Сумма(Полей !Qty.Value,"Cat") |
| С15 | Группа внутренних строк «Подкатегория» и группа столбцов «Территория» | <<Выражение>> | = Сумма(Полей!Кол-во.Значение) & ": " & ФорматПроцент(Код.РасчетПроцентов(Сумма(Полей!Кол-во.Значение),Сумма(Полей!Кол-во.Значение,"Кошка")),0) & " из " & Sum(Fields!Qty.Value,"Cat") |
Значение) 
Значение) 
Значение) Дополнительные сведения об интерпретации визуальных подсказок в областях данных табликса см. в разделе Ячейки, строки и столбцы области данных табликса (построитель отчетов) и службы SSRS. Дополнительные сведения об области данных табликса см. в разделе Ячейки, строки и столбцы области данных табликса (построитель отчетов) и службы SSRS.
Дополнительные сведения о выражениях и агрегатах см. в разделах Использование выражений в отчетах (построитель отчетов и службы SSRS) и Справочник по функциям агрегатов (построитель отчетов и службы SSRS).
Синхронизация шкал для спарклайнов
Чтобы сравнить значения во времени на горизонтальной оси для спарклайновой диаграммы, вложенной в таблицу или матрицу, можно синхронизировать значения группы категорий. Это называется выравниванием осей. При выборе параметра выравнивания осей отчет автоматически устанавливает минимальное и максимальное значения для оси и предоставляет заполнители для агрегированных значений, которые не существуют в каждой категории. Это приводит к тому, что значения в спарклайне выстраиваются в линию по каждой категории и позволяют сравнивать значения для каждой строки агрегированных данных. Выбирая эту опцию, вы изменяете область оценки выражения на область домена . Установка области домена для вложенной диаграммы также косвенно управляет назначением цвета для каждой категории в легенде.
Например, в спарклайне, показывающем еженедельные тренды, предположим, что в одном городе есть данные о продажах за 3 месяца, а в другом — за 12 месяцев. Без синхронизированных весов спарклайн для первого города имел бы только 3 столбца, и они были бы намного шире и занимали бы то же место, что и набор столбцов за 12 месяцев для второго города.
Дополнительные сведения см. в разделе Выравнивание данных на диаграмме в таблице или матрице (построитель отчетов и службы SSRS).
Синхронизация диапазонов для индикаторов
Чтобы указать значения данных, которые будут использоваться для набора индикаторов, необходимо указать область действия. В зависимости от макета области данных, содержащей индикатор, вы указываете область или содержащую область. Например, в строке заголовка группы, связанной с продажами категории, набор стрелок (вверх, вниз, вбок) может указывать значения продаж относительно порога. Область действия — это имя таблицы или матрицы, содержащей индикаторы.
Дополнительные сведения см. в разделе Установка области синхронизации (построитель отчетов и службы SSRS).
Указание областей в верхнем или нижнем колонтитуле страницы
Чтобы отобразить разные данные на каждой странице отчета, вы добавляете выражения к элементу отчета, который должен находиться на отображаемой странице. Поскольку отчет разбивается на страницы во время визуализации, только во время визуализации можно определить, какие элементы существуют на странице. Например, ячейка в строке сведений имеет текстовое поле, которое имеет множество экземпляров на странице.
Для этой цели существует глобальная коллекция под названием ReportItems. Это набор текстовых полей на текущей странице.
Дополнительные сведения см. в разделах Верхние и нижние колонтитулы страниц (построитель отчетов и службы SSRS) и Ссылки на коллекцию ReportItems (построитель отчетов и службы SSRS).
Указание переключателя для детализации и условной видимости
Переключатели — это изображения со знаком плюс или минус, которые добавляются в текстовое поле и которые пользователь может щелкнуть, чтобы отобразить или скрыть другие элементы отчета.
Видимость для большинства свойств элемента отчета можно указать, к какому элементу отчета добавить переключатель. Переключаемый элемент должен находиться в более высокой области охвата, чем элемент, который нужно показать или скрыть.
В области данных табликса, чтобы создать эффект детализации, когда вы щелкаете текстовое поле, чтобы развернуть таблицу, чтобы показать больше данных, вы должны установить свойство Видимость в группе и выбрать в качестве переключателя текстовое поле в заголовок группы, связанный с содержащей группой.
Дополнительные сведения см. в разделе Добавление действия развертывания или свертывания к элементу (построитель отчетов и службы SSRS).
Указание выражения сортировки для синхронизации порядка сортировки
При добавлении кнопки интерактивной сортировки в столбец таблицы можно синхронизировать сортировку для нескольких элементов, имеющих общую область действия. Например, вы можете добавить кнопку сортировки в заголовок столбца в матрице и указать содержащую область как имя набора данных, привязанного к матрице.