Что такое pnp файл
В этой статье представлен модуль подготовки PnP, который был первоначально выпущен в апреле 2015 г. в рамках проекта OfficeDev PnP и ежемесячно обновляется в соответствии расписанием выпусков основной библиотеки Office Dev PnP.
Платформа подготовки PnP & Модуль подготовки PnP — это решения с открытым исходным кодом и активной поддержкой сообщества. SLA для поддержки инструмента с открытым исходным кодом со стороны Майкрософт отсутствует.
Начнем с основной цели — создания модуля подготовки. С появлением Microsoft Office 365 и Microsoft SharePoint Online разработчики столкнулись с новой моделью облачных надстроек как новым способом создания настраиваемых программных решений для Microsoft SharePoint, SharePoint Online и Office 365 в целом. Однако, хотя в прошлом разработчики предоставляли настраиваемые артефакты с помощью инфраструктуры возможностей на основе CAML/XML, либо с помощью решений с кодом полного доверия (FTC), либо с решениями для песочницы, подготовка артефактов в новой модели облачной надстройки должна быть выполнена с помощью метода "удаленная подготовка". Что означает удаленная подготовка? Это означает использование одного из доступных API (REST или CSOM) для подготовки артефактов вместо использования инфраструктуры возможностей.
Что делать, если вы хотите смоделировать и подготовить артефакты с помощью тестовой и производственной среды, или что делать, если вы хотите автоматизировать подготовку артефактов, просто потому, что вы хотите продать настройки нескольким клиентам? Аналогичным образом, что делать, если вы хотите определить настраиваемый шаблон сайта, который можно повторно использовать в нескольких экземплярах сайтов, таких как сайты, ориентированные на клиента или сайты, ориентированные на проекты?
Используя новый механизм подготовки PnP, можно смоделировать сайт, настроив конструктор столбцов сайта, типов контента, определений и экземпляров списков, страниц и многого другого с помощью веб-браузера. После этого можно экспортировать все, что вы сделали, в формат шаблона подготовки (XML, JSON или контейнер, называемый файлом PnP), и применить этот шаблон к максимальному количеству целевых сайтов.
Однако что, если вы хотите подготовить другие артефакты, такие как Microsoft Teams? Или пользователей Azure AD? Модуль подготовки PnP может сделать всю работу за вас.
Создание файла PnP
Самый простой способ создать файл PnP — извлечь шаблон с сайта и задать расширение. PnP. Командлет выполнит все необходимые действия за вас:
PnP PowerShell — это решение с открытым исходным кодом, поддержка которого предоставляется активным сообществом. Для инструментов с открытым исходным кодом не существует соглашения об уровне обслуживания в отношении поддержки корпорацией Майкрософт.
Однако это не даст вам возможности легко изменить шаблон. Более оптимальный способ:
- Создайте файл конфигурации и убедитесь в том, что для persistAssetFiles свойства установлено значение true , при желании указав извлечение библиотек, таких как SiteAssets, Shared Documents, WebSettings (для логотипа и т. Д.).
- Создайте новую папку в вашей файловой системе и перейдите к ней с помощью PowerShell.
- Извлеките шаблон в виде XML-файла и предоставьте файл конфигурации:
- Вы заметите, что в вашей папке будет создана одна или несколько дополнительных папок. Они содержат сами файлы. При открытии XML-файла вы заметите элементы, указывающие на эти файлы.
- Считайте шаблон в объект в памяти и сохраните его как PnP-файл:
Вы также можете сохранить шаблон клиента с помощью замены PnP PowerShell Read-PnPProvisioningTemplate с Read-PnPTenantTemplate и Save-PnPProvisioningTemplate с Save-PnPTenantTemplate . Дополнительные сведения о шаблонах клиентов см. в разделе Шаблоны клиента подготовки PnP.
If you have a template which contains file references (through the element) you will have to distribute both the xml file and the files that are referred to. While this of course works, it is very easy to miss files when copying them to another location.
The PnP Provisioning Framework & PnP Provisioning Engine are open-source solutions with active community providing support for it. There is no SLA for the open-source tool support from Microsoft.
For this reason we introduced a specific Office Open XML format called a 'pnp file'. Effectively it is a zip file with a specific structure in it. If you rename the .pnp file to have a .zip extension you can simply open the file and have a look in it.
Два типа шаблонов
В основном существует два типа шаблонов, которые понимает механизм: Шаблоны сайтов (также называемые шаблонами подготовки) и расширенная версия: Шаблоны клиентов.
Когда был представлен модуль, единственным доступным типом шаблона был шаблон сайта. Через несколько лет был представлен шаблон клиента, который отличается способностью подготавливать артефакты за пределами сайтов SharePoint. Шаблон клиента, например, позволяет подготовить группу Microsoft Teams, пользователей Azure AD, дизайны сайтов и сценарии сайтов, темы с областью действия клиента и т. д. В отличие от шаблонов сайта, вы можете создать так называемую "последовательность" в шаблоне клиента и создать семейства сайтов.
Вкратце: шаблон клиента — это шаблон сайта, который может содержать артефакты для подготовки к уровню клиента.
Использование командлетов PowerShell
PnP PowerShell — это решение с открытым исходным кодом, поддержка которого предоставляется активным сообществом. Для инструментов с открытым исходным кодом не существует соглашения об уровне обслуживания в отношении поддержки корпорацией Майкрософт.
Чтобы использовать командлеты PowerShell для SharePoint Online или SharePoint, перейдите к обзору PnP PowerShell и установите модуль SharePoint PnP PowerShell.
После подключения среды PowerShell к SharePoint Online с помощью командлета Connect-PnPOnline можно использовать следующий командлет PowerShell:
Аргумент –Out указывает командлету, где сохранить шаблон подготовки.
Результатом извлечения и сохранения шаблона является, в зависимости от расширения, используемого в командлете (в настоящее время мы поддерживаем XML и .pnp) файла. Если вы выбрали сохранение шаблона в формате XML, он будет выглядеть примерно так, как показано ниже (обратите внимание, что шаблон не является полным и является лишь примером структуры XML):
Есть много параметров конфигурации, которые можно установить для извлечения шаблона. Объяснение этого можно найти в статье Настройка подсистемы подготовки PnP.
Как видите, элементы XML довольно понятны. Схема XML, используемая в примере, ссылается на версию схемы подготовки PnP 201909, которая была определена вместе с сообществом PnP SharePoint и которую можно найти на GitHub в разделе PnP-Provisioning-Schema. В том же репозитории также можно найти автоматически созданный документ markdown (MD), описывающий основные элементы, типы и атрибуты, доступные для определения шаблона подготовки XML вручную.
Применение шаблона клиента
Шаблон клиента очень похож на шаблон сайта с дополнительными элементами, один из которых является фундаментальным — последовательность.
Последовательность — это конфигурация одного или нескольких семейств веб-сайтов, которые необходимо создать. Ознакомьтесь со следующим фрагментом шаблона:
Как видите, последовательность определяется на том же уровне, что и элемент . Последовательность может содержать один или несколько сайтов, а также определять дочерние сайты. Для каждого сайта можно обращаться к одному или нескольким шаблонам, которые будут применяться после создания сайта. Вы обращаетесь к шаблону по его идентификатору, и в этом примере шаблоны находятся в том же XML-файле.
Чтобы применить шаблон клиента к клиенту введите:
Дополнительные сведения о шаблонах клиентов см. в разделе Шаблоны клиента подготовки PnP.
Как открыть файл PNP?
Проблемы с доступом к PNP могут быть вызваны разными причинами. Что важно, все распространенные проблемы, связанные с файлами с расширением PNP, могут решать сами пользователи. Процесс быстрый и не требует участия ИТ-специалиста. Ниже приведен список рекомендаций, которые помогут вам выявить и решить проблемы, связанные с файлами.
Шаг 1. Получить Pegasus Mail
Проблемы с открытием и работой с файлами PNP, скорее всего, связаны с отсутствием надлежащего программного обеспечения, совместимого с файлами PNP на вашем компьютере. Решение этой проблемы очень простое. Загрузите Pegasus Mail и установите его на свое устройство. Полный список программ, сгруппированных по операционным системам, можно найти выше. Самый безопасный способ загрузки Pegasus Mail установлен - для этого зайдите на сайт разработчика (David Harris) и загрузите программное обеспечение, используя предоставленные ссылки.
Шаг 2. Проверьте версию Pegasus Mail и обновите при необходимости
Вы по-прежнему не можете получить доступ к файлам PNP, хотя Pegasus Mail установлен в вашей системе? Убедитесь, что программное обеспечение обновлено. Иногда разработчики программного обеспечения вводят новые форматы вместо уже поддерживаемых вместе с новыми версиями своих приложений. Это может быть одной из причин, по которой PNP файлы не совместимы с Pegasus Mail. Последняя версия Pegasus Mail должна поддерживать все форматы файлов, которые совместимы со старыми версиями программного обеспечения.
Шаг 3. Назначьте Pegasus Mail для PNP файлов
Если проблема не была решена на предыдущем шаге, вам следует связать PNP файлы с последней версией Pegasus Mail, установленной на вашем устройстве. Метод довольно прост и мало меняется в разных операционных системах.
Выбор приложения первого выбора в Windows
- Нажатие правой кнопки мыши на PNP откроет меню, из которого вы должны выбрать опцию Открыть с помощью
- Далее выберите опцию Выбрать другое приложение а затем с помощью Еще приложения откройте список доступных приложений.
- Наконец, выберите Найти другое приложение на этом. , укажите папку, в которой установлен Pegasus Mail, установите флажок Всегда использовать это приложение для открытия PNP файлы свой выбор, нажав кнопку ОК
Выбор приложения первого выбора в Mac OS
Шаг 4. Проверьте PNP на наличие ошибок
Вы внимательно следили за шагами, перечисленными в пунктах 1-3, но проблема все еще присутствует? Вы должны проверить, является ли файл правильным PNP файлом. Проблемы с открытием файла могут возникнуть по разным причинам.
1. Проверьте PNP файл на наличие вирусов или вредоносных программ.
Если файл заражен, вредоносная программа, находящаяся в файле PNP, препятствует попыткам открыть его. Сканируйте файл PNP и ваш компьютер на наличие вредоносных программ или вирусов. Если файл PNP действительно заражен, следуйте инструкциям ниже.
2. Проверьте, не поврежден ли файл
3. Убедитесь, что у вас есть соответствующие права доступа
Некоторые файлы требуют повышенных прав доступа для их открытия. Выйдите из своей текущей учетной записи и войдите в учетную запись с достаточными правами доступа. Затем откройте файл Pegasus Mail POP3 Server Side Filter Rule.
4. Убедитесь, что ваше устройство соответствует требованиям для возможности открытия Pegasus Mail
5. Убедитесь, что у вас установлены последние версии драйверов, системных обновлений и исправлений
Последние версии программ и драйверов могут помочь вам решить проблемы с файлами Pegasus Mail POP3 Server Side Filter Rule и обеспечить безопасность вашего устройства и операционной системы. Возможно, что одно из доступных обновлений системы или драйверов может решить проблемы с файлами PNP, влияющими на более старые версии данного программного обеспечения.
Вы хотите помочь?
Если у Вас есть дополнительная информация о расширение файла PNP мы будем признательны, если Вы поделитесь ею с пользователями нашего сайта. Воспользуйтесь формуляром, находящимся здесь и отправьте нам свою информацию о файле PNP.
CAD-системы
Как уже было заявлено в разделе «Услуги» файл центров элементов «pick and place» с расширением .pnp может быть выполнен программными средствами системы автоматизированного проектирования P-CAD лишь в том случае, если в библиотеки P-CAD изначально заложены посадочные места компонентов оптимизированные под монтаж автоматическим установщиком компонентов. Однако такое не всегда возможно и получается на практике по ряду причин. Поэтому когда такая необходимость возникает, я предлагаю услуги по созданию практически с нуля файла координат центров компонентов PNP для установки на печатную плату.
Рисунок 1 – Пример компоновки верхней стороны печатной платы для создания файла .pnp (pick and place) программы автоматической установки автоматом ПМИ элементов на плату Рисунок 2 – Пример компоновки нижней стороны печатной платы для создания файла .pnp (pick and place) программы автоматической установки автоматом ПМИ элементов на плату
Для создания файла pick and place нужно иметь лишь исходную информацию в виде gerber файла, либо файла печатной платы с расширением .pcb. При необходимости я могу запросить от вас дополнительно недостающую информацию (зависит от каждого конкретного случая).
По данным файлам для вас будут рассчитаны координаты элементов X и Y. Пример созданного файла PNP можно посмотреть на рисунке 3,4,5. Также для правильного обсчета координат центров элементов для файла pick and place (PNP) необходимо сообщить где находится машинный ноль автоматического установщика компонентов и в какую сторону направлены координаты X и Y. В качестве примера у некоторых установщиков система координат может находиться в правом нижнем углу, координата X увеличиваться справа-налево, а Y снизу-вверх.
Рисунок 3 – Пример программы pick and place для верхней стороны печатной платы Рисунок 4 – Пример программы pick and place для нижней стороны печатной платы (часть 1) Рисунок 5 – Пример программы pick and place для нижней стороны печатной платы (часть 2)
Данный пример созданного файла PNP не ограничивается лишь позиционными обозначениями и координатами, а является по сути полноценной созданной программой pick and place для автоматического установщика компонентов.
Данный пример содержит обозначения корпусов компонентов в библиотеке автоматического установщика – Part Name, а также угол поворота компонента для правильной установки на печатную плату.
В большинстве случаев, как и в данном примере выполнения PNP файла этого достаточно для того, чтобы все элементы, присутствующие в программе, были установлены на печатную плату.
Если у вас есть шаблон, который содержит ссылки на файлы (через элемент ), вам придется распространить как файл xml , так и файлы, на которые есть ссылки. Хотя это определенно работает, очень легко пропустить файлы при их копировании в другое место.
Платформа подготовки PnP & Модуль подготовки PnP — это решения с открытым исходным кодом и активной поддержкой сообщества. SLA для поддержки инструмента с открытым исходным кодом со стороны Майкрософт отсутствует.
По этой причине мы ввели специальный формат Office Open XML, который называется pnp-файлом. По сути, это zip-файл с определенной структурой. Если вы переименуете .pnp-файл в расширение .zip, вы можете просто открыть файл и посмотреть в нем.
Применение шаблона подготовки
Теперь, когда вы знаете, что такое шаблон подготовки, вы готовы к его применению к целевому сайту.
Допустим, вы создали еще одно новое семейство информационных сайтов в SharePoint Online, как показано на следующем рисунке.
По умолчанию сайт будет выглядеть, как на следующем рисунке, который является макетом по умолчанию для информационного сайта.
Теперь вы можете применить настраиваемый шаблон сайта с помощью командлета PnP PowerShell
Аргумент –Path относится к исходному файлу шаблона, который командлет автоматически применяет к сайту, подключенному в данный момент (подразумевается командлет Connect-PnPOnline ).
Эмпирическое правило заключается в следующем: при применении шаблона сайта, целевой сайт должен быть создан и работать. Если вы хотите создать сайт «на лету» с помощью шаблона, необходимо будет создать шаблон клиента. Дополнительные сведения о шаблонах клиентов см. ниже.
Дополнительные статьи
Это всего лишь вводная статья. Важно понимать, что при использовании модуля подготовки PnP можно также предоставлять таксономии и использовать переменные и маркеры, которые можно заменять во время выполнения, в зависимости от того, подготовка чего идет (например, идентификаторов списков, параметров или идентификаторов терминов). Вы можете вызвать модуль подготовки из служб заданий таймера, надстроек, размещаемых у поставщика, внешних сайтов и т.д. Наконец, вы можете использовать механизм подготовки PnP для перемещения артефактов из тестовых или промежуточной сред в производственные среды.
Обязательно ознакомьтесь с другими статьями для более сложных тем.
Файлы
Если вы откроете папку «Файлы» в заархивированной папке, вы увидите множество странных имён файлов, основанных на Guid (Глобальный уникальный идентификатор)
Сам шаблон находится в этом списке, он имеет расширение .xml. Другие файлы — это файлы, на которые вы ссылаетесь в XML-шаблоне.
Каждый файл был переименован и получил уникальное имя. Причина этого в том, что формат файла Office Open XML не позволяет использовать вложенные папки в этой структуре, но что, если в вашем шаблоне есть 2 разных файла, каждый из которых имеет одно и то же имя? Скажем, у вас есть файл с именем project.docx, который перейдет в библиотеку «Общие документы», и у вас есть другой файл project.docx, который перейдет в «Документы проекта»? По этой причине мы переименовываем файлы, чтобы они имели уникальное имя.
Когда мы применяем шаблон, мы используем таблицу подстановки, чтобы найти фактическое имя файла. Эта таблица подстановки находится в папке ProvisioningTemplate и называется files-map.xml .
Это пример содержимого этого файла:
Вы увидите, что для каждого файла, найденного в папке Files , есть соответствующая запись в файле files-map.xml .
Создайте шаблона сайта
Как уже было сказано, самый простой способ создать настраиваемый шаблон подготовки — это создать новое семейство веб-сайтов в SharePoint Online, настроить артефакты (столбцы сайта, типы контента, списки, страницы и т. д.) и сохранить результат в качестве шаблона подготовки.
Допустим, вы определили пример сайта с настраиваемой домашней страницей:
Помимо настраиваемой домашней страницы вы создали несколько событий в готовом списке событий:
Чтобы экспортировать этот сайт в качестве шаблона подготовки, можно использовать код PowerShell или CSOM с некоторыми методами расширения, которые предоставляются основной библиотекой OfficeDev PnP.
Требования и подведение итогов
Для воспроизведения модуля подготовки PnP в локальной среде, необходимо иметь как минимум установленный накопительный пакет обновления SharePoint 2013 за март 2015 года, поскольку этот модуль использует некоторые возможности клиентской объектной модели, которые недоступны в предыдущих версиях продукта. Если вы ориентированы на SharePoint Online, требования автоматически будут выполнены благодаря модели "Программное обеспечение как услуга".
Воспроизводите модуль подготовки PnP, поделитесь с нами своими отзывами и наслаждайтесь будущим модели надстроек SharePoint и удаленной подготовки!
Программы, которые поддерживают PNP расширение файла
Следующий список функций PNP -совместимых программ. Файлы с расширением PNP, как и любые другие форматы файлов, можно найти в любой операционной системе. Указанные файлы могут быть переданы на другие устройства, будь то мобильные или стационарные, но не все системы могут быть способны правильно обрабатывать такие файлы.
Files
If you open the Files folder in the zipped folder you'll see a lot of strange filenames, all based upon a Guid (Globally Unique Identifier)
The template itself is located in this list, it has an .xml extension. The other files you see are actually files you refer to in your XML template.
Every file has been renamed to have a unique file name. The reason for this is that the Office Open XML file format does not allow for subfolders in this structure, but what if you have 2 different files referred to in your template, each having the same file name? Say you have a file called project.docx that goes to your Shared Documents library and you have another project.docx file that goes to a Project Documents library? For this reason we rename the files to have a unique filename.
When we apply the template we make use of a lookup table to find the actual filename. That lookup table is located in the ProvisioningTemplate folder and is called files-map.xml .
This is an example of the contents of that file:
You'll see that for every file you find in the Files folder we have a matching entry in the files-map.xml file.
Creating a PnP file
The easiest way to create a PnP file is to extract a template from a site and specify the .pnp extension. The cmdlet will do the work for you:
PnP PowerShell is an open-source solution with active community providing support for it. There is no SLA for the open-source tool support from Microsoft.
This will however not give you the ability to modify the template easily. The better way is:
- Create a configuration file and make sure to at least set the persistAssetFiles property to true , optionally specifying to extract libraries like SiteAssets, Shared Documents, WebSettings (for the logo etc.).
- Create a new folder on your file system and navigate to that folder with PowerShell.
- Extract a template as an XML file and provide the configuration file:
- You will notice that one or more additional folders will have been created in your folder. These contain the actual files. When you open the XML file you'll notice elements pointing to those files.
- Read the template into an in-memory object and save it as an PnP file:
You can also save a tenant template using PnP PowerShell substitute Read-PnPProvisioningTemplate with Read-PnPTenantTemplate and Save-PnPProvisioningTemplate with Save-PnPTenantTemplate . Refer to PnP Provisioning Tenant Template for more information about Tenant templates.
Программы, обслуживающие файл PNP
Windows
Редактирование вручную
В принципе, можно вручную отредактировать файл .pnp, распаковав zip-файл в папку, обновив файлы, добавив файлы, изменив файл files-map.xml , но мы рекомендуем вам использовать PnP PowerShell для выполнения нужных действий.
Manually editing
In principle it is possible to manually edit the .pnp file by extracting the zip file to a folder, updating the files, adding files, modifying the files-map.xml file, but we recommend that you use PnP PowerShell to actually do the work for you.
Читайте также: