Формат определяется шаблоном автоматически
Kaspersky Threat Intelligence Portal пытается автоматически определить тип исполняемого файла.
Возможные типы файлов приведены ниже. Список типов файлов может быть изменен при обновлении компонента.
- Документ Microsoft Word;
- Документ Microsoft Word Open XML с поддержкой макросов;
- Документ Microsoft Word Open XML;
- Шаблон файла Microsoft Word;
- Шаблон документа Microsoft Word Open XML;
- Файл архива Java;
- Файл JavaScript;
- Fichier Encoded JavaScript;
- Файл ярлыка, используемый Microsoft Windows для указания на исполняемый файл;
- Пакет установщика Microsoft Windows;
- Формат Adobe® Portable Document Format;
- Формат Portable Executable для исполняемых файлов в 64-разрядных операционных системах;
- Формат Portable Executable для файлов Панели управления в 64-разрядных операционных системах;
- Формат Portable Executable для динамических библиотек (DLL) в 64-разрядных операционных системах;
- Формат Portable Executable для исполняемых файлов в 64-разрядных операционных системах;
- Формат Portable Executable для служб в 64-разрядных операционных системах;
- Формат Portable Executable для исполняемых файлов в операционных системах MS-DOS® и Windows;
- Формат Portable Executable для файлов Панели управления;
- Формат Portable Executable для динамических библиотек (DLL);
- Формат Portable Executable для исполняемых файлов в операционных системах MS-DOS и Windows;
- Формат Portable Executable для служб;
- Шаблон презентации Microsoft PowerPoint® Open XML с поддержкой макросов;
- Шаблон презентации Microsoft PowerPoint Open XML;
- Файл надстройки для Microsoft PowerPoint;
- Слайд-шоу Microsoft PowerPoint Open XML с поддержкой макросов;
- Слайд-шоу Microsoft PowerPoint Open XML;
- Презентация Microsoft PowerPoint;
- Презентация Microsoft PowerPoint Open XML с поддержкой макросов;
- Презентация Microsoft PowerPoint Open XML;
- Документ Microsoft Publisher;
- Файл в формате RTF (Rich Text Format);
- Файл фильма Shockwave® Flash®;
- Файл зашифрованного сценария VBScript;
- Файл VBScript;
- Документ Microsoft Visio®;
- Файл сценария Windows;
- Надстройка Microsoft Excel® Open XML с поддержкой макросов;
- Электронная таблица Microsoft Excel;
- Двоичная электронная таблица Microsoft Excel;
- Электронная таблица Microsoft Excel Open XML с поддержкой макросов;
- Электронная таблица Microsoft Excel Open XML;
- Шаблон электронной таблицы Microsoft Excel Open XML с поддержкой макросов;
- Шаблон электронной таблицы Microsoft Excel Open XML.
Общие сведения о формах и шаблонах форм
Примечание: Мы стараемся как можно оперативнее обеспечивать вас актуальными справочными материалами на вашем языке. Эта страница переведена автоматически, поэтому ее текст может содержать неточности и грамматические ошибки. Для нас важно, чтобы эта статья была вам полезна. Просим вас уделить пару секунд и сообщить, помогла ли она вам, с помощью кнопок внизу страницы. Для удобства также приводим ссылку на оригинал (на английском языке) .
При разработке файл шаблона форм (XSN), вы создаете один файл, содержащий несколько файлов поддержки. С другой стороны при заполнении формы вашей пользователями, фактически заполнении формы (XML) файла, основанный на шаблоне формы.
В этой статье
- Что вы разрабатываете: шаблон формы
- Что заполнение пользователей: форма
- Компоненты шаблона формы
Что вы разрабатываете: шаблон формы
Создание шаблонов форм в режиме конструктора, который является среда разработки InfoPath. Шаблон формы — файл с расширением имени файла XSN. Файл XSN определяет структуру данных, внешний вид и поведение готовых форм (файлы XML).
Шаблон формы определяет операции, включая:
- Элементы управления, метки и пояснительный текст, которые будут отображаться в форме.
- Способ поведение элементов управления при взаимодействии с ними пользователей. Например может сделать определенного раздела появляются, когда пользователь выбирает установите флажок и исчезают, когда пользователь снимает флажок.
- Имеет ли форма дополнительные представления. Например при разработке формы заявки о возможно одно просматривать для электрических Подрядчик, другое представление для получения агент, а третий для человек, кто утверждает или отклоняет приложения.
- Как и где хранятся данные в форме. Например шаблон формы может предназначен позволить пользователям отправлять данные в базу данных, непосредственно или с помощью веб-службы. Или может иметь пользователям сохранять их формы в общую папку.
- Шрифты, цвета и другие элементы оформления, которые используются в форме.
- Могут ли пользователи настраивать форму. Например можно разрешить пользователям добавлять строки в повторяющуюся таблицу, повторяющийся раздел или дополнительный раздел.
- Уведомление пользователей при их делают ошибки в форме или забывайте заполните необходимые поля.
После завершения внешнего вида шаблона формы, можно сделать его доступным пользователям путем его публикации в виде файла XSN.
Совет: Дополнение к разработке шаблонов форм, можно также создать шаблон частей, которые являются настраиваемых элементов управления, которые можно использовать в других шаблонов форм или документы Microsoft Office. Например можно создать блока шаблона, в том числе поля для сбора контактные данные. Часть шаблона, затем можно использовать несколько шаблонов форм с другой. Найти ссылки на дополнительные сведения о шаблоне частей в разделе См.
Что заполнение пользователей: форма
Форма InfoPath является XML-файл, содержащий XML-данные. Все формы InfoPath основаны на шаблоны форм.
Чтобы показана взаимосвязь между шаблона формы и формы представьте конструирования шаблона формы заявки приложения для электрических подрядчикам для использования. Каждый заявки приложение, которое заполняет электрических Подрядчик представляет собой форму. Что формы является просто XML-файл, содержащий данные (и только данные), который был введен в форму. Все другие действия, образующие формы предоставляются шаблоном формы. Это означает, что при каждом пользователей открыть форму, эту форму необходимо найти и использовать его связан шаблон формы для правильной. В противном случае — при открытии формы пользователей они могут видеть только разметку XML-теги и данные.
Чтобы связать шаблон формы и на его основе формы, InfoPath включает несколько строк кода, называемых команды обработки, в верхней части каждого файла формы. Этот код связывает файл формы с шаблоном формы.
Компоненты шаблона формы
Шаблон формы — одного файла, содержащего вспомогательные файлы, например файлы, которые определяют, как элементы управления в шаблоне формы должно отображаться, файлы для графических объектов, появляющихся на шаблоне формы и несколько программирования файлы, которые обеспечивают поведения настраиваемые формы шаблон. Эти файлы поддержки называются файлы формы. При разработке шаблона формы, можно просматривать и работать с файлами форм, образующие шаблон формы, извлечения и сохраните эти файлы формы в папку.
Вспомогательные файлы, образующие шаблона формы можно добавить один или несколько файлов схема XML файл преобразования XSL (XSLT) для каждого представления в шаблоне формы, XML-файл с данными, которая появляется по умолчанию при первом открытии формы, основанного на этой temp формы Задержка файлы скрипта или сборки управляемого кода и файл определения формы называется Manifest.xsf.
Ознакомление со файлы, образующие шаблона формы, можно использовать следующую процедуру для просмотра исходных файлов для шаблона формы.
Просмотр файлов формы для шаблона формы
- Создание шаблона на новую пустую форму.
- В меню файл выберите Сохранить как исходные файлы.
- В диалоговом окне Обзор папок выбрать существующую папку, в которых нужно сохранить файлы формы, или создайте новую папку и нажмите кнопку ОК. InfoPath сохраняет копию шаблона формы как набор файлов во вложенной папке.
- В Проводнике Windows перейдите в папку, содержащую файлы.
В следующей таблице описаны вспомогательных файлов шаблона формы. Эти файлы всегда включаются в шаблоне формы.
Расширение имени файла
Файл определения формы
Файл, содержащий сведения о как шаблона формы будут помещены друг с другом, включая XML-схемы, он использует и файлы ресурсов, которые она содержит. При создании нового шаблона формы InfoPath автоматически создает этот файл. Создание и изменение шаблона формы, файл автоматически обновляется отобразятся внесенные изменения.
Файл или файлы, которые ограничивают и проверка данных в шаблоне формы. Содержимое файлов XML-схемы — элементы, атрибуты и т. д., представленной групп и полей в области задач Источник данных. Каждый источник данных, связанное с шаблоном формы, включая основной источник данных, имеет соответствующий XSD-файла.
Преобразование XSL (XSLT) файлов, использующие для представления, просмотра и преобразования в HTML отображаемых данных, содержащихся в форму, заполните пользователей. При работе с различных представлений одних шаблона формы фактически вы находитесь на разные HTML-представления (или преобразования) данных, отображаемых в форме.
Файл, содержащий данные, которые должны отображаться в определенных элементов управления по умолчанию. Пользователи видят эти данные при первом открытии формы, пока они выберите разные значения в элементах управления.
Кроме файлов в предыдущей таблице шаблона формы можно добавлять файлы в таблице ниже в зависимости от шаблона формы конструктор.
Расширение имени файла
файлы HTM, GIF, .bmp и другим пользователям
Файлы, которые используются для отображения настраиваемых областях задач или изображений в шаблоне формы.
с расширением js, .vbs
Файлы, содержащие сценарии для реализации определенного поведения формы. Эти файлы сценария являются Microsoft JScript или файлов Microsoft Visual Basic Scripting Edition (VBScript).
DLL, .exe, .cab и другим пользователям
Внешние файлы, содержащие программный код и дополнительный бизнес-логики. Например при создании пользовательский элемент управления для шаблона формы, может потребоваться программы установки для автоматической установки и регистрации этого элемента управления на компьютерах пользователей. Двоичные файлы не создаются в InfoPath, но в программами, такими как Microsoft Visual Studio .NET.
Когда вы вносите изменения в шаблон формы InfoPath автоматически обновляет файлы формы. Тем не менее если вы являетесь опыт работы с XML или являются Опытные разработчики форм, можно извлечь отдельные файлы формы и настроить их вручную. Например может потребоваться вручную изменить набор файлов формы в следующих случаях:
- Вы хотите повторно использовать шаблон формы схемы XML (XSD-файл) в другой программе Microsoft Office. Например можно добавить InfoPath XSD-файла в библиотеку схем в Microsoft Office Word 2007. Затем можно сопоставить элементы из InfoPath XSD-файла с содержимым документа.
- Вы хотите создать панель инструментов в шаблоне формы, содержащей пользовательские команды Помимо встроенной команды, которые поставляются вместе с приложением InfoPath. Чтобы сделать это, необходимо изменить шаблон формы файл определения формы (.xsf).
- Вы хотите сделать форматирование связанных расширения для шаблона формы, которые недоступны в приложении InfoPath, например добавить фоновый рисунок (GIF-файла) к кнопке. Чтобы сделать это, вам нужно отредактировать файл преобразование XML (.xsl) формы.
Описание структуры и синтаксиса шаблонов ARM
В этой статье описывается структура шаблона Azure Resource Manager (ARM). Статья содержит информацию о разных разделах шаблона и свойствах, которые доступны в этих разделах.
Эта статья предназначена для пользователей, у которых есть опыт работы с шаблонами ARM. Она содержит подробные сведения о структуре шаблона. Пошаговые инструкции по созданию шаблона см. в статье Учебник. Создание и развертывание первого шаблона ARM. Чтобы узнать больше о шаблонах ARM с помощью управляемого набора модулей Microsoft Learn, см. статью Развертывание ресурсов и управление ими в Azure с помощью шаблонов ARM.
Bicep — это новый язык, который предлагает те же возможности, что и шаблоны ARM, но имеет более простой в использовании синтаксис. Если вы рассматриваете инфраструктуру в качестве параметров кода, рекомендуем Bicep.
Чтобы узнать больше о разделах файла Bicep, ознакомьтесь со статьей Описание структуры и синтаксиса файлов Bicep.
Формат шаблона
Шаблон с самой простой структурой содержит следующие элементы:
< "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", "languageVersion": "", "contentVersion": "", "apiProfile": "", "definitions": < >, "parameters": < >, "variables": < >, "functions": [ ], "resources": [ ], /* or "resources": < >with languageVersion 2.0 */ "outputs": < >> | Имя элемента | Обязательно | Описание |
|---|---|---|
| $schema | Да | Расположение файла схемы в нотации объектов JavaScript (JSON), в котором описывается версия языка шаблона. Номер используемой вами версии зависит от области развертывания и вашего редактора JSON. |
Если вы используете Visual Studio Code с расширением инструментов Azure Resource Manager, установите последнюю версию для развертывания групп ресурсов:
https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#
Другие редакторы (в том числе Visual Studio) могут не подойти для обработки этой схемы. Для таких редакторов используйте:
https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#
Для развертывания подписок используйте:
https://schema.management.azure.com/schemas/2018-05-01/subscriptionDeploymentTemplate.json#
Для развертывания групп управления используйте:
https://schema.management.azure.com/schemas/2019-08-01/managementGroupDeploymentTemplate.json#
Свойство профиля API особенно полезно при развертывании шаблона в других средах, например Azure Stack и глобальной среде Azure. Используйте версию профиля API, чтобы шаблон автоматически применял версии, поддерживаемые в обеих средах. Список текущих версий профиля API и определенных в нем версий API ресурсов см. в статье Профиль API.
Каждый элемент содержит свойства, которые можно задать. В этой статье подробнее описаны разделы шаблона.
Определения
definitions В разделе шаблона укажите схемы, используемые для проверки значений массива и объекта. Definitions может использоваться только с languageVersion 2.0.
"definitions": < "", "allowedValues": [ "" ], "minValue": , "maxValue": , "minLength": , "maxLength": , "prefixItems": , "items": , "properties": , "additionalProperties": , "discriminator": , "nullable": , "metadata": < "description": "" > > > | Имя элемента | Обязательно | Описание |
|---|---|---|
| definition-name | Да | Имя определения типа. Должно быть допустимым идентификатором JavaScript. |
| тип | Да | Тип определения типа. Допустимые типы и значения: string, securestring, int, bool, object, secureObject и array. См. статью Типы данных в шаблонах ARM. |
| allowedValues | Нет | Массив допустимых значений для определения типа, чтобы убедиться, что указано правильное значение. |
| minValue | Нет | Минимальное значение для определений типов int, это значение является инклюзивным. |
| maxValue | Нет | Максимальное значение для определений типов int, это значение является инклюзивным. |
| minLength | Нет | Минимальная длина определений строковых, безопасных строк и типов массива. Это значение является инклюзивным. |
| maxLength | Нет | Максимальная длина определений строковых, безопасных строк и типов массива. Это значение является инклюзивным. |
| prefixItems | Нет | Схема для проверки элемента массива по тому же индексу. |
| items | Нет | Схема, применяемая ко всем элементам массива, индекс которого больше наибольшего prefixItems индекса ограничения, или логическое значение для управления элементами массива, индекс которого больше наибольшего prefixItems индекса ограничения. |
| properties | Нет | Схема для проверки объекта. |
| additionalProperties | Нет | Схема, применяемая ко всем свойствам, не упомянутым в ограничении properties , или логическая для принятия любых свойств, не определенных в ограничении properties . |
| discriminator | Нет | Схема, применяемая на основе свойства дискриминатора. |
| допускающие значения NULL | Нет | Логическое значение, указывающее, что значение может быть пустым или опущено. |
| description | Нет | Описание определения типа, которое отображается для пользователей на портале. Дополнительные сведения см. в разделе комментариев в шаблонах. |
Примеры использования определений типов см. в разделе Определения типов в шаблонах ARM.
Параметры
В разделе parameters шаблона указываются значения, которые вы можете вводить во время развертывания ресурсов. В шаблоне можно использовать только 256 параметров . Вы можете сократить число параметров, используя объекты с несколькими свойствами.
Доступные свойства для параметра
"parameters": < "" : < "type" : "", "defaultValue": "", "allowedValues": [ "" ], "minValue": , "maxValue": , "minLength": , "maxLength": , "prefixItems": , "items": , "properties": , "additionalProperties": , "discriminator": , "nullable": , "metadata": < "description": "" > > > | Имя элемента | Обязательно | Описание |
|---|---|---|
| parameter-name | Да | Имя параметра. Должно быть допустимым идентификатором JavaScript. |
| тип | Да | Тип значения параметра. Допустимые типы и значения: string, securestring, int, bool, object, secureObject и array. См. статью Типы данных в шаблонах ARM. |
| defaultValue | Нет | Значение параметра, используемое по умолчанию, если пользователь не задал иное значение. |
| allowedValues | Нет | Массив допустимых значений параметра, по которому сверяются правильные значения. |
| minValue | Нет | Минимальное значение для параметров типа int. Это включающее значение. |
| maxValue | Нет | Максимальное значение для параметров типа int. Это включающее значение. |
| minLength | Нет | Минимальная длина (включительно) параметров типа string, secure string и array. |
| maxLength | Нет | Максимальная длина (включительно) параметров типа string, secure string и array. |
| prefixItems | Нет | Определение типа для проверки элемента массива по тому же индексу. prefixItems поддерживается только в languageVersion 2.0. |
| items | Нет | Схема, применяемая ко всем элементам массива, индекс которого больше наибольшего prefixItems индекса ограничения, или логическое значение для управления элементами массива, индекс которого больше наибольшего prefixItems индекса ограничения. items поддерживается только в languageVersion 2.0. |
| properties | Нет | Схема для проверки объекта. properties поддерживается только в languageVersion 2.0. |
| additionalProperties | Нет | Схема, применяемая ко всем свойствам, не упомянутым в ограничении properties , или логическая для принятия любых свойств, не определенных в ограничении properties . additionalProperties поддерживается только в languageVersion 2.0. |
| discriminator | Нет | Схема, применяемая на основе свойства дискриминатора. discriminator поддерживается только в languageVersion 2.0. |
| допускающие значения NULL | Нет | Логическое значение, указывающее, что значение может быть пустым или опущено. nullable поддерживается только в languageVersion 2.0. |
| description | Нет | Описание параметра, отображаемого для пользователей на портале. Дополнительные сведения см. в разделе комментариев в шаблонах. |
Примеры использования параметров см. в статье Параметры в шаблонах ARM.
Переменные
В разделе variables указываются значения, которые можно использовать в разных частях шаблона. Переменные определять не обязательно, однако они часто упрощают шаблон, снижая число сложных выражений. Формат каждой переменной соответствует одному из типов данных. В шаблоне есть только 256 переменных .
В приведенном ниже примере показаны доступные параметры для определения переменных.
"variables": < "": "", "": < >, "": < "copy": [ < "name": "", "count": , "input": > ] >, "copy": [ < "name": "", "count": , "input": > ] > Сведения о том, как задать несколько значений для переменной с помощью свойства copy , см. в статье Итерация переменной в шаблонах ARM.
Примеры использования переменных см. в статье Переменные в шаблонах ARM.
Функции
В шаблоне можно создать свои собственные функции. Эти функции доступны для использования в шаблоне. Как правило, определяются сложные выражения, которые вы не хотите повторять в шаблоне. Создаются определяемые пользователем функции на основе выражений и функции, которые поддерживаются в шаблонах.
При определении пользовательской функции есть несколько ограничений:
- Функция не может обращаться к переменным.
- Функция может использовать только параметры, определенные в самой функции. При использовании функции parameters внутри пользовательской функции доступны только параметры этой функции.
- Функция не может вызывать другие функции, определяемые пользователем.
- Для функции нельзя использовать ссылочную функцию.
- Для параметров этой функции нельзя задавать значения по умолчанию.
"functions": [ < "namespace": "", "members": < "": < "parameters": [ < "name": "", "type": "" > ], "output": < "type": "", "value": "" > > > > ], | Имя элемента | Обязательно | Описание |
|---|---|---|
| namespace | Да | Пространство имен для пользовательских функций. Используется для предотвращения конфликтов имен с функциями шаблона. |
| function-name | Да | Имя пользовательской функции. При вызове функции объедините ее имя с пространством имен. Например, чтобы вызвать функцию с именем uniqueName в пространстве имен contoso, используйте имя «[contoso.uniqueName()]» . |
| parameter-name | Нет | Имя параметра, используемого в пользовательской функции. |
| значение параметра | Нет | Тип значения параметра. Допустимые типы и значения: string, securestring, int, bool, object, secureObject и array. |
| output-type | Да | Тип выходного значения. Выходные значения поддерживают те же типы, что и входные параметры функции. |
| output-value | Да | Выражение языка шаблона, которое оценивается и возвращается из функции. |
Примеры использования пользовательских функций см. в статье Пользовательские функции в шаблоне ARM.
В Bicep не поддерживаются определяемые пользователем функции. Bicep поддерживает различные функции и операторы.
Ресурсы
В разделе resources определяются ресурсы, которые развертываются или обновляются. В шаблоне доступно не более 800 ресурсов .
Ресурсы определяются с помощью следующей структуры:
"resources": [ < "condition": "", "type": "", "apiVersion": "", "name": "", "comments": "", "location": "", "dependsOn": [ "" ], "tags": < "": "", "": "" >, "identity": < "type": "", "userAssignedIdentities": < "": <> > >, "sku": < "name": "", "tier": "", "size": "", "family": "", "capacity": >, "kind": "", "scope": "", "copy": < "name": "", "count": , "mode": "", "batchSize": >, "plan": < "name": "", "promotionCode": "", "publisher": "", "product": "", "version": "" >, "properties": < "", "copy": [ < "name": , "count": , "input": <>> ] >, "resources": [ "" ] > ] | Имя элемента | Обязательно | Описание |
|---|---|---|
| condition | Нет | Логическое значение, указывающее, подготавливается ли ресурс во время этого развертывания. Если установлено значение true , при развертывании создается ресурс. Если установлено значение false , при развертывании ресурс не создается. См. статью Условное развертывание в шаблонах ARM. |
| тип | Да | Тип ресурса. Это значение представляет собой сочетание пространства имен поставщика ресурсов и типа ресурса (например, Microsoft.Storage/storageAccounts ). Чтобы определить доступные значения, см. справочник по шаблонам. Для дочернего ресурса формат типа зависит от того, вложен он в родительский ресурс или определен за его пределами. См. о настройке имени и типа дочернего ресурса. |
| версия_API | Да | Версия REST API, которая будет использована для создания ресурса. При создании нового шаблона укажите в качестве значения последнюю версию развертываемого ресурса. Пока шаблон работает надлежащим образом, продолжайте использовать ту же версию API. Продолжая использовать ту же версию API, вы можете не опасаться того, что с новой версией API изменится принцип работы шаблона. Рекомендуем обновлять версию API только в том случае, если требуется использовать новую функцию, появившуюся в более поздней версии. Чтобы определить доступные значения, см. справочник по шаблонам. |
| name | Да | Имя ресурса. Имя должно соответствовать ограничениям компонентов URI, определенным в RFC3986. Службы Azure, предоставляющие имя ресурса внешним пользователям, проверяют это имя, чтобы убедиться, что это не попытка подделки другого удостоверения. Для дочернего ресурса формат имени зависит от того, вложен он в родительский ресурс или определен за его пределами. См. о настройке имени и типа дочернего ресурса. |
| comments | Нет | Заметки по ресурсам в шаблоне. Дополнительные сведения см. в разделе комментариев в шаблонах. |
| location | Различается | Поддерживаемые географические расположения указанного ресурса. Вы можете выбрать любое из доступных расположений. Но обычно имеет смысл выбрать расположение, которое находится недалеко от пользователей. Кроме того, целесообразно разместить взаимодействующие ресурсы в одном регионе. Большинству типов ресурсов нужно расположение, но некоторым типам (например, назначению роли) оно не требуется. См. статью Задание расположения ресурса в шаблоне ARM. |
| Свойство dependsOn | Нет | Ресурсы, которые должны быть развернуты перед развертыванием этого ресурса. Resource Manager оценивает зависимости между ресурсами и развертывает эти ресурсы в правильном порядке. Если ресурсы не зависят друг от друга, они развертываются параллельно. Значение может представлять собой разделенный запятыми список имен ресурсов или уникальных идентификаторов ресурсов. Выводится только список ресурсов, развертываемых в этом шаблоне. Ресурсы, которые не определены в этом шаблоне, уже должны существовать. Избегайте добавления ненужных зависимостей, так как это может замедлить развертывание и привести к созданию циклических зависимостей. Руководство по установке зависимостей см. в статье Определение порядка развертывания ресурсов в шаблонах ARM. |
| tags | Нет | Теги, связанные с ресурсом. Примените теги, чтобы логически организовать ресурсы в подписке. |
| удостоверение | Нет | Некоторые ресурсы поддерживают управляемые удостоверения для ресурсов Azure. У них на корневом уровне объявления ресурса есть объект Identity. Вы можете указать, назначается ли удостоверение пользователем или системой. Для назначаемых пользователем удостоверений укажите список идентификаторов ресурсов для удостоверений. Задайте для ключа идентификатор ресурса, а для значения — пустой объект. Дополнительные сведения см. в статье Настройка управляемых удостоверений для ресурсов Azure на виртуальной машине Azure с помощью шаблонов. |
| sku | нет | В некоторых ресурсах допускается использовать значения, определяющие номер SKU для развертывания. Например, можно указать тип избыточности для учетной записи хранения. |
| kind | Нет | В некоторых ресурсах допускается использовать значение, которое определяет тип развертываемого ресурса. Например, можно указать тип создаваемого экземпляра Azure Cosmos DB. |
| область | Нет | Свойство scope доступно только для типов ресурсов расширений. С его помощью можно указать область действия, отличную от области развертывания. См. статью Настройка области для ресурсов расширения в шаблонах ARM. |
| copy | Нет | Количество создаваемых ресурсов (если нужно несколько экземпляров). Параллельный режим используется по умолчанию. Используйте последовательный режим, если вы не хотите развертывать все ресурсы одновременно. Дополнительные сведения см. в статье Создание нескольких экземпляров ресурсов в Azure Resource Manager. |
| План | Нет | В некоторых ресурсах допускается использовать значения, определяющие номер плана для развертывания. Например, можно указать образ Marketplace для виртуальной машины. |
| properties | Нет | Параметры конфигурации ресурса. Значения свойств совпадают со значениями, указываемыми в тексте запроса для операции REST API (метод PUT) для создания ресурса. Кроме того, можно указать массив copy для создания нескольких экземпляров свойства. Чтобы определить доступные значения, см. справочник по шаблонам. |
| ресурсов | нет | Дочерние ресурсы, которые зависят от определяемого ресурса. Следует указать только те типы ресурсов, которые разрешены в схеме родительского ресурса. Зависимость от родительского ресурса не подразумевается. Ее необходимо определить явным образом. См. о настройке имени и типа дочернего ресурса. |
Для поддержки символьного имени Bicep в шаблонах ARM JSON добавьте languageVersion вместе с версией или более новой версией 2.0 и измените определение ресурса с массива на объект .
Дополнительные сведения см. в статье о ресурсах DSC.
Выходные данные
В разделе outputs указываются значения, которые возвращаются после развертывания. Как правило, возвращаются значения из развернутых ресурсов. В шаблоне доступно только 64 выходных данных .
В следующем примере показана структура определения выходных данных:
"outputs": < "": < "condition": "", "type": "", "value": "", "copy": < "count": , "input": > > > | Имя элемента | Обязательно | Описание |
|---|---|---|
| output-name | Да | Имя выходного значения. Должно быть допустимым идентификатором JavaScript. |
| condition | Нет | Логическое значение, которое указывает, возвращается ли выходное значение. Если установлено значение true , то при развертывании значение является частью выходных данных. Если установлено значение false , при развертывании выходное значение не создается. Когда не задано, по умолчанию используется значение true . |
| тип | Да | Тип выходного значения. Выходные значения поддерживает те же типы, что и входные параметры шаблона. Если указан тип выходных данных securestring, значение не отображается в журнале развертывания и его невозможно получить из другого шаблона. Чтобы использовать значение секрета в нескольких шаблонах, храните секрет в Key Vault и ссылайтесь на него в файле параметров. Дополнительные сведения см. в статье Использование Azure Key Vault для передачи защищенного значения параметра во время развертывания. |
| value | Нет | Выражение на языке шаблона, которое вычисляется и возвращается в качестве выходного значения. Укажите value или copy. |
| copy | Нет | Используется для возврата нескольких значений выходных данных. Укажите value или copy. Дополнительные сведения см. в статье Итерация выходных данных в шаблонах ARM. |
Примеры использования выходных данных см. в статье Выходные данные в шаблонах ARM.
Комментарии и метаданные
Есть несколько вариантов добавления комментариев и метаданных к шаблону.
Комментарии
Для встроенных комментариев можно использовать символы // или /* . */ . В Visual Studio Code сохраните файлы параметров с комментариями в качестве типа json with comments (JSONC), в противном случае появится сообщение об ошибке «Комментарии в JSON не разрешены».
При развертывании шаблонов с комментариями с помощью Azure CLI используйте версию 2.3.0 или более позднюю и укажите параметр —handle-extended-json-format .
В Visual Studio Code расширение инструментов Azure Resource Manager может автоматически определять шаблоны ARM и менять режим языка. Если в правом нижнем углу окна Visual Studio Code отображается надпись Шаблон Azure Resource Manager, то вы можете использовать встроенные комментарии. В таком случае встроенные комментарии больше не будут помечены как недопустимые.
Метаданные
Вы можете добавить объект metadata практически в любом месте шаблона. Resource Manager игнорирует объект, но ваш редактор JSON может предупредить вас, что свойство недопустимо. Определите необходимые свойства в объекте.
Для parameters добавьте объект metadata со свойством description .
"parameters": < "adminUsername": < "type": "string", "metadata": < "description": "User name for the Virtual Machine." >>, При развертывании шаблона через портал текст, который вы указываете в описании, автоматически используется в качестве подсказки для этого параметра.
Для resources добавьте элемент comments или объект metadata . В приведенном ниже примере показаны элемент comments и объект metadata .
"resources": [ < "type": "Microsoft.Storage/storageAccounts", "apiVersion": "2022-09-01", "name": "[format('', 'storage', uniqueString(resourceGroup().id))]", "comments": "Storage account used to store VM disks", "location": "[parameters('location')]", "metadata": < "comments": "These tags are needed for policy compliance." >, "tags": < "Dept": "[parameters('deptName')]", "Environment": "[parameters('environment')]" >, "sku": < "name": "Standard_LRS" >, "kind": "Storage", "properties": <> > ] Для outputs добавьте объект metadata к выходному значению.
"outputs": < "hostname": < "type": "string", "value": "[reference(variables('publicIPAddressName')).dnsSettings.fqdn]", "metadata": < "comments": "Return the fully qualified domain name" >>, Добавить объект metadata в пользовательские функции невозможно.
Многострочные строки
Строку можно разбить на несколько строк. Обратите внимание на свойство location и один из комментариев в приведенном ниже примере JSON.
Для развертывания шаблонов с многострочными литералами используйте Azure PowerShell или Azure CLI. Что касается CLI, используйте версию не ниже 2.3.0 и укажите переключатель —handle-extended-json-format .
Многострочные литералы не поддерживаются при развертывании шаблона через портал Azure, конвейер DevOps или REST API.
languageVersion 2.0
В рабочих средах не рекомендуется использовать любой languageVersion вариант, -experimental так как экспериментальные функции могут быть изменены в любое время.
Текущий выпуск расширения Azure Resource Manager Tools для Visual Studio Code не распознает усовершенствования, внесенные в languageVersion 2.0.
Чтобы использовать languageVersion 2.0, добавьте «languageVersion»: «2.0» в шаблон:
Улучшения и изменения, которые поступают в languageVersion 2.0:
- Используйте символьные имена в шаблоне ARM JSON. Дополнительные сведения см. в разделе Использование символьного имени.
- Используйте символьные имена в циклах копирования ресурсов. См . раздел Использование символьного имени.
- Используйте символьные имена в dependsOn массивах. См. раздел DependsOn и Зависимость от ресурсов в цикле.
- Используйте в функции символьные имена вместо имени reference ресурса. См. справочные материалы.
- Функция references(), которая возвращает массив объектов , представляющих состояния среды выполнения коллекции ресурсов. См. ссылки.
- Используйте свойство ресурса «существующий», чтобы объявить существующие ресурсы для arm для чтения, а не для развертывания ресурса. См . раздел Объявление существующих ресурсов.
- Создание определяемых пользователем типов. См. определение типа.
- Дополнительные ограничения проверки агрегатных типов, которые будут использоваться в параметрах и выходных данных.
- Значение по умолчанию для expressionEvaluationOptions свойства — inner . Значение outer заблокировано. См. раздел Область вычисления выражений во вложенных шаблонах.
- Функция deployment возвращает ограниченное подмножество свойств. См. статью Развертывание.
- Если ресурс Deployments используется в развертывании с символьным именем, используйте apiVersion 2020-09-01 или более поздней версии.
- В определении ресурса двойное экранирование значений в выражении больше не требуется. См. раздел Escape-символы.
Следующие шаги
- Полные шаблоны для различных типов решений доступны на странице Шаблоны быстрого запуска Azure.
- Дополнительные сведения о функциях, которые можно использовать в шаблонах, см. в статье Функции шаблонов ARM.
- Инструкции по объединению нескольких шаблонов при развертывании см. в статье Использование связанных и вложенных шаблонов при развертывании ресурсов Azure.
- Дополнительные рекомендации по созданию шаблонов см. в статье Рекомендации по работе с шаблонами ARM.
- Ответы на распространенные вопросы см. в разделе Часто задаваемые вопросы о шаблонах ARM.
Страницы-шаблоны
Беспристрастный язык. Мы заменяем неинклюзивный язык в InDesign 2022 (версия 17.0) и далее, чтобы отразить основополагающие ценности Adobe в отношении инклюзивности. Любая ссылка на эталонную страницу (Master page) заменяется ссылкой на страницу-шаблон (Parent page) в наших статьях справки для английского, датского, венгерского, испанского, итальянского, бразильского варианта португальского, португальского и японского языков.
О шаблонах, порядке размещения и слоях
Шаблон (ранее известный как мастер-страница) — это своего рода фон, который можно быстро применить ко многим страницам. Объекты, содержащиеся в шаблоне, отображаются на всех страницах, к которым применяется шаблон. Элементы шаблона на страницах документа обведены точечным пунктиром. Любые изменения шаблона автоматически применяются к связанным с ним страницам, которые обычно содержат повторяющиеся логотипы, номера страниц, верхние и нижние колонтитулы. Они также могут содержать пустые текстовые и графические фреймы, которые выступают в роли заполнителей на страницах документа. Элемент шаблона на странице документа выделить нельзя, если только не произведено его изменение.
Подобно страницам документа шаблоны могут иметь несколько слоев. Объекты одного слоя имеют собственный порядок размещения в пределах этого слоя. Объекты слоя страницы-шаблона располагаются за объектами, назначенными для этого же слоя на странице документа.
Чтобы элемент шаблона отображался перед объектами страницы документа, назначьте для объекта шаблона более высокий слой. Элемент шаблона более высокого слоя будет отображаться перед всеми объектами, содержащимися в более низких слоях. При объединении всех слоев произойдет перемещение элементов шаблона под объекты, содержащиеся на страницах документа.
Подсказки и рекомендации по шаблонам
- Создавая различные шаблоны и применяя их по очереди к макетам страницы, имеющим стандартное содержимое, можно сравнивать любые дизайнерские идеи.
- Для быстрого проектирования документов можно сохранять наборы шаблонов в шаблоне документа, наряду со стилями абзацев и шрифтов, библиотеками цветов и другими стилями и типами.
- При изменении параметров столбцов или полей шаблона или применении нового шаблона, содержащего другие параметры столбцов и полей, объекты страницы можно автоматически настроить в соответствии с новым макетом. См. раздел Автоматическая настройка макета.
- Если в шаблон вставлена автоматическая нумерация страниц, правильный номер страницы отображается для каждого раздела документа, к которому применяется шаблон. См. раздел Добавление основной нумерации страниц.
Создание шаблонов
По умолчанию каждый созданный документ имеет страницу-шаблон. Дополнительные шаблоны можно создавать обычным способом либо на основе имеющегося шаблона или страницы документа После того как к страницам применен шаблон, все вносимые в него изменения напрямую переносятся на страницы и шаблоны документа, которые на нем основаны. При тщательном проектировании таким образом можно легко вносить изменения в макеты нескольких страниц по всему документу.