Экспорт XML в InDesign
Экспорт содержимого документа в XML
Прежде чем экспортировать содержимое из документа InDesign в XML, выполните следующие действия.
Создайте или загрузите теги элементов.
Примените теги к элементам на страницах документа.
При необходимости настройте иерархию размеченных тегами элементов в палитре «Структура».
В документ можно экспортировать либо все XML-содержимое, либо его часть. Экспорту подлежит только содержимое, которое размечено тегами.
Примечание.При экспорте документа, содержащего таблицы, необходимо разметить их тегами, в противном случае InDesign не экспортирует их в XML.
Чтобы экспортировать только часть документа, выделите в палитре «Структура» тот элемент, с которого должен начаться экспорт.
Выберите меню «Файл» > «Экспорт».
В поле «Тип файла» (Windows) или «Формат» (Mac OS) диалогового окна Сохранить как выберите «XML».
Введите имя, укажите расположение XML-файла и нажмите кнопку «Сохранить».
На вкладке «Общие» диалогового окна «Экспорт XML» выберите один из следующих параметров.
Включить объявление определения типа документа.
Вместе с XML-файлом экспортирует ссылку на DTD-файл. Этот параметр доступен только в том случае, если в палитре «Структура» присутствует элемент DOCTYPE.
Просмотр XML с помощью
По окончании экспорта открывает файл в браузере, программе редактирования XML-файлов или в текстовом редакторе. Выберите браузер или программу из списка.
Экспорт от выделенного элемента
Начинает процедуру экспорта с элемента, выделенного в палитре «Структура». Этот параметр доступен только в том случае, если до выполнения команды «Файл» > «Экспортировать» был выделен элемент.
Экспорт неразмеченных таблиц в качестве CALS XML
Экспортирует неразмеченные таблицы в формате CALS XML. Для выполнения экспорта таблица должна находиться в размеченном фрейме, при этом сама таблица не должна быть размечена.
Заново сопоставить разрывы, пробелы и специальные символы
Производит экспорт разрывов, пробелов и специальных символов в виде символьных сущностей с десятичными кодами.
Применить XSLT
Применяет таблицу стилей, задавая трансформацию экспортируемого XML (например, в HTML или XML-дерево, имеющее другую структуру). Нажмите кнопку «Обзор» (Windows) или «Выбрать» (Mac OS) и выберите в файловой системе XSLT-файл. При установке значения по умолчанию «Использовать таблицу стилей из XML» будет использоваться инструкция преобразования XSLT, если она указана в XML, который применяется при экспорте.
В меню «Кодировка» выберите тип кодировки.
Чтобы указать параметры экспорта для изображений, перейдите на вкладку «Изображения» и выберите один или несколько из следующих параметров.
Исходные изображения
Помещает копию исходного изображения во вложенную папку Images.
Оптимизированные исходные изображения
Оптимизирует и сжимает файлы исходных изображений и помещает их копии во вложенную папку «Images».
Оптимизированные отформатированные изображения
Оптимизирует файлы исходных изображений, к которым было применено трансформирование (например, поворот или масштабирование), и помещает их во вложенную папку «Images». Например, если документ содержит два изображения (обрезанное и необрезанное), то во вложенную папку «Images» будет оптимизировано и скопировано только обрезанное изображение.
Если на предыдущем шаге был выбран параметр «Оптимизированные исходные изображения» или «Оптимизированные отформатированные изображения», необходимо задать параметры оптимизации изображений.
Нажмите кнопку «Экспорт».
Не все специальные символы поддерживаются в XML (например, символ автоматической нумерации страниц). Если InDesign не может включить символ в экспортируемый XML-файл, то выдается соответствующее предупреждение. Такое предупреждение выдается также в том случае, если таблица не была размечена тегами.
Параметры экспорта оптимизированных изображений
При выборе на вкладке «Изображения» диалогового окна «Экспорт XML» режима «Оптимизированные исходные изображения» или «Оптимизированные отформатированные изображения» становятся доступными следующие параметры.
Преобразование изображения
Указывает, в какой формат должны быть преобразованы изображения. Если выбрать «Автоматически», InDesign на основе анализа изображения выбирает наиболее подходящий тип файла. Возможно, потребуется задать параметры сжатия GIF и JPEG.
Параметры GIF
Определяют форматирование изображений при преобразовании в формат GIF в процессе экспорта. Можно задать следующие параметры.
Палитра
Задает цветовую палитру, которой должно соответствовать изображение после преобразования. Выберите палитру для окончательного формата отображения XML-содержимого. Палитра «Адаптивная (без дизеринга)» хорошо подходит для изображений, содержащих преимущественно сплошные тона, а также в тех случаях, когда окончательный вывод будет производиться для нескольких форматов.
Чересстрочная
Загружает не все изображение за один проход, а каждую вторую его строку при каждом проходе. Данный параметр обеспечивает быструю загрузку изображения для просмотра, а каждый последующий проход повышает разрешение изображения, пока не будет достигнуто полное качество.
Параметры JPEG
Определяет параметры формата для изображений, преобразуемых в формат JPEG в процессе экспорта. Можно задать следующие параметры.
Качество изображений
Определяет качество преобразуемого изображения.
Способ форматирования
Задает способ форматирования изображения JPEG при загрузке. В режиме «Базовый» изображение загружается за один проход в своем исходном качестве. Таким образом, при открытии файл отображается в исходном качестве. При использовании этого формата загрузка файла может занять больше времени, чем при использовании формата «Прогрессивный». В режиме «Прогрессивный» изображение загружается за несколько проходов. При первом проходе загружается версия с низким разрешением, а с каждым последующим проходом разрешение повышается до тех пор, пока не будет достигнуто исходное качество изображения.
Сохранение тегов только как XML
Сохранение только тегов позволяет впоследствии загрузить и использовать их в документе InDesign.
Выберите в меню палитры «Теги» команду «Сохранить теги».
Введите имя, укажите расположение и нажмите кнопку «Сохранить».
Все теги из документа, вместе с назначенными им цветами, сохраняются в XML-файле.
Редактирование экспортированного XML-файла
После создания и экспорта XML-файла из программы InDesign в него могут быть внесены изменения одним из следующих способов.
- Для внесения изменений непосредственно в XML-файл откройте его в текстовом или XML-редакторе.
- Чтобы вносимые изменения сохранились и в исходном документе, откройте файл InDesign, из которого был экспортирован XML. После внесения в содержимое документа InDesign изменений его снова можно экспортировать в XML (если необходимо заменить XML-файл, укажите то же самое имя).
Связанные материалы
- Создание и загрузка XML-тегов
- Разметка содержимого для XML
- Изменение расположения структурных элементов
Вход в учетную запись
Войти
Управление учетной записьюЭкспорт файлов Pages, Numbers или Keynote в Microsoft Word, Excel, PowerPoint, PDF и многое другое
Вы также можете открыть файлы Word, Excel, PowerPoint и другие типы файлов в Pages, Numbers и Keynote.
iPhone или iPad
Mac
iCloud
Экспорт и открытие файлов в Pages, Numbers и Keynote на iPhone и iPad
Чтобы открыть файл Pages, Numbers или Keynote в Word, Excel или PowerPoint, экспортируйте файл в соответствующий формат с помощью Pages, Numbers или Keynote. Вы также можете открыть файлы Word, Excel или PowerPoint в Pages, Numbers или Keynote.
Pages, Numbers и Keynote также поддерживают множество других форматов файлов
Экспорт файла на iPhone или iPad
После экспорта файла вы можете отправить экспортированный файл с помощью приложения «Почта», «Сообщения», AirDrop или другого доступного приложения либо сохранить файл на своем устройстве или в iCloud Drive.
- Откройте файл Pages, Numbers или Keynote, который требуется экспортировать.
- Нажмите имя документа на панели инструментов. Если имя документа не отображается, нажмите кнопку «Еще» .
- Нажмите «Экспортировать».
- Выберите требуемый формат:
- Если необходимо открыть документ Pages в Word, выберите Word.
- Если необходимо открыть электронную таблицу Numbers в Excel, выберите Excel.
- Если необходимо открыть презентацию Keynote в PowerPoint, выберите PowerPoint.
- Также можно выполнять экспорт в PDF и различные другие форматы файлов в зависимости от используемого приложения iWork.
- Выберите любые дополнительные параметры, затем нажмите «Экспортировать». Если появится окно «Экспорт сведений», в котором показано, что может отличаться в экспортируемой версии файла, нажмите «Продолжить».
- Чтобы отправить или сохранить экспортированный файл, выполните указанные ниже действия.
- Выберите способ отправки файла (например, с помощью приложения «Почта» или «Сообщения»), а затем отправьте файл.
- Чтобы сохранить файл на устройстве или в iCloud Drive, нажмите «Сохранить в Файлы», а затем выберите местоположение.
Также можно экспортировать и отправить или сохранить файл с помощью меню «Доступ» на панели инструментов.
- Нажмите кнопку «Поделиться» на панели инструментов, а затем выберите «Экспорт и отправка».
- Выберите формат и любые дополнительные параметры для этого формата, а затем нажмите «Экспортировать».
- Чтобы отправить или сохранить экспортированный файл, выполните указанные ниже действия.
- Выберите способ отправки файла (например, с помощью приложения «Почта» или «Сообщения»), а затем отправьте файл.
- Чтобы сохранить файл на устройстве или в iCloud Drive, нажмите «Сохранить в Файлы», а затем выберите местоположение.
Открытие файлов Word, Excel или PowerPoint в Pages, Numbers или Keynote на iPhone или iPad
Чтобы открыть файлы Word, Excel или PowerPoint в Pages, Numbers или Keynote на iPhone или iPad, нажмите на файл в менеджере документов. Если менеджер документов не отображается, нажмите кнопку «Назад» , а затем выберите файл, который нужно открыть. Если файл недоступен для выбора, у него несовместимый формат.
В Pages, Numbers или Keynote также можно открывать файлы из других приложений, таких как «Файлы», или из сообщений электронной почты.
- Откройте другое приложение и выберите документ или вложение.
- Нажмите кнопку «Поделиться» .
- Нажмите кнопку «Скопировать в Pages». Исходный файл не удаляется.
При открытии файла может отображаться сообщение о том, что документ будет выглядеть иначе. Например, появится уведомление Pages о том, что не хватает некоторых шрифтов. Чтобы открыть документ в Pages, нажмите кнопку «Готово».
Экспорт и открытие файлов в Pages, Numbers и Keynote на компьютере Mac
Чтобы открыть файл Pages, Numbers или Keynote в Word, Excel или PowerPoint, экспортируйте файл в соответствующий формат с помощью Pages, Numbers или Keynote. Вы также можете открыть файлы Word, Excel или PowerPoint в Pages, Numbers или Keynote.
Pages, Numbers и Keynote также поддерживают множество других форматов файлов
Экспорт файла на компьютере Mac
После экспорта файла вы можете отправить экспортированный файл с помощью приложения «Почта», «Сообщения», AirDrop или другого доступного приложения либо сохранить файл на своем компьютере Mac или в iCloud Drive. Откройте файл Pages, Numbers или Keynote, который требуется экспортировать.
- Откройте «Файл» > «Экспортировать в» и выберите формат.
- Если необходимо открыть документ Pages в Word, выберите Word.
- Если необходимо открыть электронную таблицу Numbers в Excel, выберите Excel.
- Если необходимо открыть презентацию Keynote в PowerPoint, выберите PowerPoint.
- Также можно выполнять экспорт в PDF и различные другие форматы файлов в зависимости от используемого приложения iWork.
- Выберите любые дополнительные параметры.
- Чтобы отправить или сохранить экспортированный файл, выполните указанные ниже действия.
- Чтобы поделиться файлом, нажмите «Отправить копию», а затем выберите способ отправки файла (например, с помощью приложения «Почта» или «Сообщения»).
- Чтобы сохранить файл на устройстве или в iCloud Drive, нажмите «Сохранить», а затем выберите местоположение.
Также можно экспортировать и отправить или сохранить файл с помощью меню «Доступ» на панели инструментов.
- Нажмите «Поделиться» на панели инструментов, а затем щелкните «Экспорт и отправка».
- Выберите формат и любые дополнительные параметры для этого формата.
- Чтобы отправить или сохранить экспортированный файл, выполните указанные ниже действия.
- Чтобы поделиться файлом, нажмите «Отправить копию», а затем выберите способ отправки файла (например, с помощью приложения «Почта» или «Сообщения»).
- Чтобы сохранить файл на устройстве или в iCloud Drive, нажмите «Сохранить», выберите местоположение и щелкните «Экспортировать».
Открытие файлов Word, Excel или PowerPoint в Pages, Numbers или Keynote на компьютере Mac
Файлы можно открывать из меню Finder или приложения Pages, Numbers или Keynote.
- В меню Finder щелкните файл, удерживая нажатой клавишу Control, выберите «Открыть с помощью», затем выберите Pages, Numbers или Keynote.
- В приложении Pages, Numbers или Keynote выберите «Файл» > «Открыть», выберите файл и нажмите «Открыть». Если файл недоступен для выбора, у него несовместимый формат.
При открытии файла может отображаться сообщение о том, что файл будет выглядеть иначе. Например, появится уведомление приложения о том, что не хватает некоторых шрифтов. Могут также отображаться предупреждения при открытии документов, созданных в более ранних версиях приложения.
Экспорт и открытие файлов в Pages, Numbers или Keynote для iCloud
Приложение Pages для iCloud позволяет открывать и редактировать файлы в поддерживаемом браузере на компьютере Mac или компьютере с Windows, а также делиться ими. Проверьте совместимость форматов файлов с приложением Pages для iCloud. Если у вас нет устройства Apple, узнайте, как создать идентификатор Apple ID.
Экспорт файла в Pages, Numbers или Keynote для iCloud
- Выполните вход на веб-сайте iCloud.com с помощью идентификатора Apple ID.
- Выберите приложение iWork, которое вы хотите открыть.
- В менеджере документов, электронных таблиц или презентаций нажмите кнопку «Еще» для файла, который необходимо экспортировать, а затем выберите пункт «Загрузить копию». Если документ открыт, нажмите кнопку «Инструменты» на панели инструментов и выберите пункт «Загрузить копию».
- Выберите формат документа. Файл загружается в папку загрузки браузера по умолчанию.
Открытие файла в Pages, Numbers или Keynote для iCloud
- Выполните вход на веб-сайте iCloud.com с помощью идентификатора Apple ID.
- Выберите приложение iWork, которое вы хотите открыть.
- Перетащите файл, который вы хотите открыть, в менеджер документов, электронных таблиц или презентаций в своем браузере. Или нажмите кнопку «Выгрузить» , выберите файл и нажмите «Выгрузить».
- Дважды нажмите файл.
Проверка совместимости файловых форматов
Вы можете экспортировать и открывать файлы в различных форматах с помощью приложений Pages, Numbers и Keynote.
Совместимость файловых форматов в Pages
Вы можете экспортировать документы Pages в следующие форматы:
- Microsoft Word: Office Open XML (DOCX)1
- EPUB (на iPhone, iPad и компьютере Mac)
- Rich Text Format (RTF/RTFD) (на iPhone, iPad и компьютере Mac)
- обычные текстовые файлы (TXT) (на iPhone, iPad и компьютере Mac)
- Pages ’09 (только на компьютере Mac)2
Эти форматы файлов можно открыть в приложении Pages на iPhone, iPad, компьютере Mac и на веб-сайте iCloud. com:
- файлы любой версии Pages;
- Microsoft Word: Office Open XML (DOCX)
- Rich Text Format (RTF/RTFD)
- обычные текстовые файлы (TXT)
Совместимость файловых форматов в Numbers
Вы можете экспортировать электронные таблицы Numbers в следующие форматы:
- Microsoft Excel Office Open XML (XLSX)1
- файлы CSV (разделенные запятыми значения).
- файлы с разделением табуляцией (TSV) (на iPhone, iPad и компьютере Mac)
- Numbers ’09 (только на компьютере Mac)
Форматы, поддерживаемые в Numbers на iPhone, iPad, компьютере Mac и на веб-сайте iCloud.com:
- файлы Numbers любой версии;
- Microsoft Excel Office Open XML (XLSX)
- файлы CSV (разделенные запятыми значения).
- текстовые файлы с разделением табуляцией или с полями фиксированной ширины.
Совместимость файловых форматов в Keynote
Вы можете экспортировать презентации Keynote в следующие форматы:
- Microsoft PowerPoint Office Open XML (PPTX)1
- изображение (JPEG, PNG или TIFF) (на iPhone, iPad и компьютере Mac)
- анимированный файл GIF (на iPhone, iPad и компьютере Mac)
- видео (MOV) (на iPhone, iPad и компьютере Mac)
- видео (M4V) (только на компьютере Mac)
- Keynote ’09 (только на компьютере Mac)
- HTML (только на компьютере Mac)
Эти форматы файлов можно открыть в приложении Keynote на iPhone, iPad, компьютере Mac и на веб-сайте iCloud. com:
- файлы любой версии Keynote;
- Microsoft PowerPoint: Office Open XML (PPTX)
1. Если вам требуется экспорт в устаревшем формате файлов Microsoft Office, например DOC, XLS или PPT, вы можете выбрать современный формат XML, а затем открыть файл в соответствующем приложении Office для экспорта в нужном формате.
2. Если необходимо конвертировать документ Pages в формат, совместимый с версией Pages ’09, узнайте больше об изменениях, связанных с экспортом в iWork ’09.
Информация о продуктах, произведенных не компанией Apple, или о независимых веб-сайтах, неподконтрольных и не тестируемых компанией Apple, не носит рекомендательного или одобрительного характера. Компания Apple не несет никакой ответственности за выбор, функциональность и использование веб-сайтов или продукции сторонних производителей. Компания Apple также не несет ответственности за точность или достоверность данных, размещенных на веб-сайтах сторонних производителей. Обратитесь к поставщику за дополнительной информацией.
Дата публикации:
Надстройка SharePoint— Памятка XML разрешений | Сумит Агравал | ng-sp
Опубликовано в·
Чтение: 3 мин.·
19 марта 2018 г.Документация по разрешениям надстроек подробная и весьма полезная для разработчиков. Но это не очень удобно для пользователя. Этот пост задуман как шпаргалка по XML-файлам разрешений, которые можно использовать напрямую.
Если вы не хотите использовать разрешение только для приложений, удалите AllowAppOnlyPolicy=»t rue ” из этих XML-файлов
Если надстройке предоставлено разрешение на одну из областей, это разрешение применяется ко всем дочерним элементам области.
1) Предоставление доступа на уровне арендатора:
Доступ на уровне арендатора может быть предоставлен только администраторами арендатора . URL-адрес для предоставления этого доступа всегда https://tenantName-admin.sharepoint.com/_layouts/appinv.aspx
Например: https://sumitagrawal-admin.sharepoint.com/_layouts/appinv.aspx
Полный доступ на уровне клиента
Right="FullControl" />
AppPermissionRequests>
Управление контролем на уровне клиента
Right="Manage" />
Аналогично, для Write используйте Right=»Write» , а для Read используйте Right=»Read»
Обратите внимание, что Scope=»http://sharepoint/content/tenant » указывает, что разрешение предоставляется для продукта SharePoint → Контент, что означает базу данных контента SharePoint → арендатор является областью уровня клиента.
2) Предоставить доступ на уровне семейства веб-сайтов
Для этого требуются разрешения администратора семейства веб-сайтов, чтобы иметь возможность предоставлять доступ в семействе веб-сайтов. размах
Используемый URL-адрес: SiteCollectionUrl/_layouts/appinv.aspx
Например: https://sumitagrawal.sharepoint.com/sites/dev/_layouts/appinv.aspx для предоставления доступа к семействам сайтов sites/dev.
Полный доступ на уровне семейства сайтов
9 0043
Right="FullControl" />
Управление контролем на уровне семейства веб-сайтов
Right="Manage" />
То же самое для Read и Доступ для записи .
Определение области http://sharepoint/content/sitecollection теперь должно говорить само за себя.3) Обеспечить доступ на уровне веб-сайта/уровня сайта/уровня подсайта
Это немного сложно, загвоздка здесь в том, чтобы вызывать appinv.aspx из контекста Интернета, а не из контекста семейства сайтов.
Например: https://sumitagrawal.sharepoint.com/sites/dev/subsite1/_layouts/15/appinv.aspx
Здесь «sites/dev» — это семейство сайтов, а subsite1 — это дочерний сайт в этом семействе сайтов. .Что происходит, когда доступ на веб-уровень предоставляется с URL-адреса семейства веб-сайтов?
В этом случае доступ предоставляется корневому веб-сайту, который имеет тот же URL-адрес, что и семейство веб-сайтов.Полный доступ на веб-уровне
Right="FullControl" />
То же самое и с Управление , Чтение и Запись . Просто обновите Right= до соответствующего значения.
4) Предоставление доступа к списку/библиотеке
Вызов appinv.aspx так же, как и для доступа на веб-уровне.
Например: https://sumitagrawal.sharepoint.com/sites/dev/subsite1/_layouts/15/appinv.aspxПолный доступ к списку/библиотеке
< AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web/list"
Right="FullControl" />
То же самое в случае с Manage , Read и Напишите . Просто обновите Right= до соответствующего значения.
Есть еще один шаг для списка/библиотеки, это выбор, к какому списку/библиотеке мы хотим предоставить доступ. Это будет задано, когда мы доверяем приложению:Как предоставить доступ к нескольким спискам/библиотекам?
Вам необходимо несколько раз вызывать URL-адрес https://sumitagrawal. sharepoint.com/sites/dev/subsite1/_layouts/15/appinv.aspx и предоставлять один и тот же XML-разрешение и каждый раз выбирать другой список/библиотеку.1) Предоставление доступа к службе поиска
Разрешение службы поиска является особым случаем. Поскольку служба поиска сканирует все данные, и пользователь должен иметь возможность видеть только те результаты в результатах поиска, на которые у пользователя есть разрешения, AllowAppOnlyPolicy недействителен для разрешения на поиск. Кроме того, существует только одна область разрешений, QueryAsUserIgnoreAppPrincipal
Это разрешение должно быть предоставлено из области URL-адреса администратора арендатора.
например: https://sumitagrawal-admin.sharepoint.com/_layouts/appinv.aspx
Right="QueryAsUserIgnoreAppPrincipal" />
Также обратите внимание, что продукт SharePoint 900 17 и теперь вместо из контента у нас есть поиск, который означает доступ к базе данных поиска SharePoint.
Нет другого уровня разрешений для службы поиска.2) Обеспечить доступ к таксономии
Для таксономии могут быть предоставлены только права на чтение и запись. Таксономия поддерживает разрешения только для приложений.
Right="Read" />
Другой вариант: Right=”Write” 9 0003
3) Предоставление доступа к службе Business Connectivity
Business Connectivity поддерживает только доступ для чтения, а разрешение xml:
Right="Read" />
Помимо этого, есть и другие, такие как новости канал, профиль пользователя, сервер проекта и т. д.
C) Общие сведения о политике AppOnly
При проверке подлинности приложений поддерживаются 3 политики:
Политика только для пользователя: SharePoint проверяет только разрешения для пользователя
Политика пользователя и надстройки: SharePoint проверяет разрешения как пользователя, так и принципала надстройки
Политика только надстройки: (также называемая политикой только для приложений) SharePoint проверяет только разрешения принципала надстройки
Некоторые API требуют контекста пользователя и не могут выполняться с политикой только надстроек, такой как служба поиска.
- Статья
Прежде чем читать эту статью, вы должны сначала ознакомиться с разделом Авторизация и проверка подлинности надстроек SharePoint.
Надстройка SharePoint запрашивает необходимые разрешения во время установки у пользователя, который ее устанавливает. Разработчик надстройки должен запросить через файл манифеста надстройки разрешения, необходимые для запуска конкретной надстройки. (Устройства и веб-приложения, которые обращаются к SharePoint, но не установлены на веб-сайтах SharePoint, должны получить разрешения во время выполнения от пользователя, выполняющего надстройку. Дополнительные сведения см. в разделе Поток кода авторизации OAuth для надстроек SharePoint. )
Пользователи могут предоставлять только те разрешения, которые у них есть. Пользователь должен предоставить все разрешения, запрашиваемые надстройкой, или не предоставлять никаких разрешений. Выборочные гранты невозможны. (Для надстроек, которые запрашивают разрешения на лету, только пользователь с разрешениями на управление ресурсами SharePoint, к которым надстройка пытается получить доступ, может запускать надстройку, даже если надстройка запрашивает только меньшие разрешения, например Чтение.)
Разрешения, предоставленные надстройке, также хранятся в базе данных контента фермы SharePoint или в клиенте SharePoint Online. Они не хранятся в защищенной службе маркеров, такой как служба управления доступом Microsoft Azure (ACS). Когда пользователь впервые предоставляет надстройке разрешения, SharePoint получает информацию о надстройке от ACS. Затем SharePoint сохраняет основную информацию о надстройке в службе управления надстройками и базе данных контента вместе с разрешениями надстройки. Дополнительные сведения о ACS см. в статье Создание надстроек SharePoint, использующих авторизацию с низким уровнем доверия.
Важно
Azure Access Control (ACS), служба Azure Active Directory (Azure AD), будет прекращена 7 ноября 2018 г. Этот вывод не влияет на модель надстройки SharePoint, которая использует https: //accounts.accesscontrol.windows.net
имя хоста (на которое не влияет этот вывод). Дополнительные сведения см. в статье Влияние вывода из эксплуатации Azure Access Control для надстроек SharePoint.
Если объект, для которого надстройке было предоставлено разрешение, удаляется, соответствующие разрешения также удаляются. Когда объект, для которого надстройке было предоставлено разрешение, повторно используется, SharePoint не изменяет соответствующее разрешение. Это сделано для того, чтобы при восстановлении объекта из корзины грант оставался нетронутым.
При удалении надстройки все разрешения, предоставленные этой надстройке в области, из которой она была удалена, отменяются. Это делается для того, чтобы надстройка не могла использовать свои учетные данные для продолжения удаленного доступа к защищенным ресурсам SharePoint после того, как пользователь удалит надстройку из SharePoint.
Типы разрешений надстройки и области разрешений
Надстройка SharePoint использует запросы разрешений, чтобы указать разрешения, необходимые для правильной работы. Запросы разрешений указывают как права, необходимые надстройке, так и область, в которой ей требуются права. Эти разрешения запрашиваются как часть манифеста надстройки.
Области запроса разрешения указывают расположение в иерархии SharePoint, к которому применяется запрос разрешения.
Примечание
Надстройка SharePoint имеет собственное удостоверение и является участником безопасности, называемым участником надстройки. Подобно пользователям и группам, субъект надстройки имеет определенные разрешения или права. Субъект надстройки имеет права на полный доступ к сайту надстройки, поэтому ему нужно только запрашивать разрешения для ресурсов SharePoint на хост-сайте или в других местах за пределами сайта надстройки. Дополнительные сведения о сайте надстройки см. в разделах Важные аспекты архитектуры надстройки SharePoint и среды разработки, а также Размещающие сайты, сайты надстроек и компоненты SharePoint в SharePoint.
SharePoint поддерживает четыре различных области разрешений в рамках базы данных контента и арендатора, как показано в таблице 1. Области разрешений именуются с помощью URI, включая префикс «http:», но они не являются URL-адресами и не содержат заполнителей. Области разрешений в этой таблице и в этой статье представляют собой буквенные строки.
Таблица 1. URI и описания области запроса разрешения надстройки SharePoint
Область | Область URI | Описание |
---|---|---|
Аренда | http://sharepoint/content/tenant | Аренда, в которой установлена надстройка. Включает всех дочерних элементов этой области. |
Коллекция сайтов | http://sharepoint/content/sitecollection | Семейство веб-сайтов, в котором установлена надстройка. Включает всех дочерних элементов этой области. |
Веб-сайт | http://sharepoint/content/sitecollection/web | Веб-сайт, на котором установлена надстройка. Включает всех дочерних элементов этой области. |
Список | http://sharepoint/content/sitecollection/web/list | Единый список на веб-сайте, на котором установлена надстройка. Когда пользователю, устанавливающему надстройку, предлагается предоставить разрешения, диалоговое окно позволяет пользователю выбрать один список, для которого надстройке предоставляются разрешения. Если надстройке требуется разрешение более чем на один список, она должна запросить разрешение на веб-область. Кроме того, поскольку вы, разработчик, не можете контролировать, какой список выбирает пользователь, или сообщать пользователю, какой из них выбрать, вы должны использовать веб-область, если есть список, к которому ваша надстройка должна иметь доступ разрешение (но есть способ сузить выбор пользователя до определенных подмножеств списков; см. Область запроса разрешения с соответствующими свойствами.) |
Если надстройке предоставлено разрешение на одну из областей, разрешение применяется ко всем дочерним элементам области. Например, если надстройке предоставляется разрешение на веб-сайт, надстройка также получает разрешение на каждый список, содержащийся на веб-сайте, и на все элементы списка, которые есть в каждом списке.
Поскольку запросы разрешений выполняются без информации о топологии семейства веб-сайтов, в котором установлена надстройка, область действия выражается в виде типа, а не в виде URL-адреса конкретного экземпляра. Эти типы областей выражены как URI. Разрешения на ресурсы, хранящиеся в базе данных контента SharePoint, упорядочены по следующему URI: http://sharepoint/content
.
Различия между правами разрешений надстройки и правами пользователя
Разрешения указывают действия, которые надстройке разрешено выполнять в запрошенной области. SharePoint поддерживает четыре уровня прав в базе данных контента. Для каждой области надстройка может иметь следующие права:
- Чтение
- Написать
- Управление
- Полный контроль
Примечание
Дополнительные сведения о правах на чтение, запись, управление и полный контроль см. в разделе Планирование управления разрешениями надстроек.
Примечание
Эти права соответствуют уровням разрешений пользователя по умолчанию в SharePoint: Читатель, Участник, Дизайнер и Полный доступ. Дополнительные сведения об уровнях разрешений пользователей см. в разделе Разрешения пользователей и уровни разрешений. Имена прав на надстройки не совпадают с именами прав на роли пользователей SharePoint, чтобы избежать путаницы между правами на роли пользователей и правами на надстройки. Поскольку настройка разрешений, связанных с ролями пользователей SharePoint, не влияет на уровни запросов разрешений надстроек, имена прав надстроек не соответствуют соответствующим ролям пользователей SharePoint, за исключением полного доступа, который нельзя настроить с помощью управления разрешениями. пользовательский интерфейс.
Дополнительно:
Только для поиска надстройка может иметь право запроса.
Для некоторых областей Microsoft Project Server 2013 также имеется право SubmitStatus или право на повышение уровня. Для большинства областей Project Server 2013 доступны только чтение и запись. Дополнительные сведения см. в разделе Общие сведения о типах разрешений надстройки и областях разрешений в этой статье.
Для таксономии доступны только права на чтение и запись.
Примечание
Приложения Магазина Office имеют некоторые ограничения в отношении того, какие права может запрашивать надстройка. Дополнительные сведения см. в разделе Типы разрешений надстройки и области разрешений выше в этой статье.
В отличие от ролей пользователей SharePoint, эти уровни прав нельзя настраивать. Это делается для того, чтобы когда надстройке предоставляется запрос на разрешение, ей гарантируется предсказуемый набор возможностей, и ей не нужно учитывать возможность предоставления меньшего разрешения, чем она ожидает.
Пользователь не может предоставить надстройке разрешения, которых у него нет. Если пользователь пытается установить надстройку, которая запрашивает больше разрешений, чем есть у пользователя, пользователю отображается сообщение об ошибке, информирующее его о том, что у него недостаточно разрешений, чтобы предоставить надстройке ее запрос.
Разрешения, неизвестные SharePoint, игнорируются. Это означает, что если надстройка запрашивает разрешение, которое SharePoint не распознает, надстройка по-прежнему может быть установлена, но пользователю не предлагается предоставить разрешение, и разрешение не предоставляется надстройке.
Доступные области и разрешения, а также ограничения разрешений для приложений Магазина Office
Различные области имеют разные наборы прав, которые доступны надстройке для запроса. В этом разделе описаны наборы прав, доступных для каждой области. Кроме того, в нем указаны ограничения для надстроек SharePoint, которые продаются через Магазин Office.
Права приложений Магазина Office
Для приложений Магазина Office разрешены только права на чтение, запись и управление. Если вы попытаетесь отправить приложение в Магазин Office, требующее прав FullControl, отправка вашего приложения будет заблокирована. Поскольку блокировка находится в конвейере отправки Магазина Office, приложения, запрашивающие больше разрешений, чем Управление, по-прежнему могут быть развернуты через каталог надстроек.
Области запроса разрешений для содержимого списков и содержимого библиотек
В таблице 2 показаны области запроса разрешений для содержимого списков и библиотек, а также перечислены права, которые можно указать для URI каждой области.
Примечание
URI, используемые в таблице 2, являются литеральными значениями.
Таблица 2. URI области разрешения надстройки SharePoint и доступные права
URI области | Имеющиеся права |
---|---|
http://sharepoint/content/sitecollection | Чтение, запись, управление, полный контроль |
http://sharepoint/content/sitecollection/web | Чтение, запись, управление, полный контроль |
http://sharepoint/content/sitecollection/web/list | Чтение, запись, управление, полный контроль |
http://sharepoint/content/tenant | Чтение, запись, управление, полный контроль |
В следующем коде показано, как вы используете области разрешений и права в файле AppManifest. xml. В первом примере надстройка запрашивает доступ на запись к области списка.
<Приложение xmlns="http://schemas.microsoft.com/sharepoint/2012/app/manifest" ProductID="{4a07f3bd-803d-45f2-a710-b9e944c3396e}" Версия = "1.0.0.0" SharePointMinVersion="15.0.0.0" Имя = "Моя Образцовая Надстройка" > <Свойства>Мой образец надстройки ~remoteAppUrl/Home.aspx?{StandardTokens} Свойства>приложение>
В следующем коде показана надстройка, которая запрашивает доступ на чтение к веб-области и доступ на запись к области списка.
<Приложение xmlns="http://schemas. microsoft.com/sharepoint/2012/app/manifest" ProductID="{4a07f3bd-803d-45f2-a710-b9e944c3396e}" Версия = "1.0.0.0" SharePointMinVersion="15.0.0.0" Имя = "Моя Образцовая Надстройка" > <Свойства>Мой образец надстройки ~remoteAppUrl/Home.aspx?{StandardTokens} Свойства>приложение>
Области запросов разрешений для других функций SharePoint перечислены в следующих таблицах.
Примечание
URI, используемые в таблицах, являются литеральными значениями.
В таблице 3 показана область запроса разрешения для Business Connectivity Services (BCS). В нем также перечислены права, которые можно указать для этого универсального кода ресурса (URI) области.
Таблица 3. URI области запроса разрешения надстройки BCS и доступные права
URI области | Имеющиеся права |
---|---|
http://sharepoint/bcs/connection | Читать |
Примечание
Дополнительные сведения об области запроса разрешения надстройки BCS см. в разделе Службы Business Connectivity Services в SharePoint.
В таблице 4 показана область запроса разрешения для поиска. В нем также перечислены права, которые можно указать для этого универсального кода ресурса (URI) области.
Таблица 4. URI области запроса разрешения надстройки поиска и доступные права
URI области | Доступные права |
---|---|
http://sharepoint/поиск | QueryAsUserIgnoreAppPrincipal |
Примечание
Дополнительные сведения об области запроса разрешения надстройки поиска см. в разделе Поиск в SharePoint.
В таблице 5 показана область запроса разрешения для Project Server 2013. В ней также перечислены права, которые можно указать для каждого универсального кода ресурса (URI) области. > [!ПРИМЕЧАНИЕ] > Надстройка, использующая функции и службы Project Server 2013, должна тестироваться в среде, в которой есть необходимые функции и службы Project Server. Сборка поставщика разрешений Project Server 2013, которая знает об областях разрешений Project Server 2013, не устанавливается по умолчанию вместе с SharePoint Server. Дополнительные сведения см. в документации для разработчиков Project Server 2013.Таблица 5. URI области запроса разрешения надстройки Project Server и доступные права
Область | Имеющиеся права |
---|---|
http://sharepoint/projectserver | Управление |
http://sharepoint/projectserver/projects | Чтение, запись |
http://sharepoint/projectserver/projects/project | Чтение, запись |
http://sharepoint/projectserver/enterpriseresources | Чтение, запись |
http://sharepoint/projectserver/statusing | Состояние отправки |
http://sharepoint/projectserver/reporting | Читать |
http://sharepoint/projectserver/рабочий процесс | Поднять |
Таблица 6. URI области запроса разрешений надстройки социальных функций и доступные права
Имя области | Описание | Имеющиеся права |
---|---|---|
Профили пользователей http://sharepoint/social/tenant | Область запроса разрешения, используемая для доступа ко всем профилям пользователей. Можно изменить только изображение профиля; все остальные свойства профиля пользователя доступны только для чтения для надстроек SharePoint. Должен быть установлен администратором арендатора. | Чтение, запись, управление, полный контроль |
Основной http://sharepoint/social/core | Область запроса разрешения, используемая для доступа к отслеживаемому контенту пользователя и общим метаданным, используемым функциями микроблогов. Эта область применима только к личным сайтам, поддерживающим следующий контент. Если приложение устанавливается на любом другом типе сайта, используйте область клиента. | Чтение, запись, управление, полный контроль |
Лента новостей http://sharepoint/social/microfeed | Область запроса разрешения, используемая для доступа к ленте пользователя или ленте команды. Эта область применима к личным сайтам, поддерживающим ведение микроблогов, или к сайтам групп, на которых активирована функция веб-канала . Если приложение устанавливается на любом другом типе сайта, используйте область клиента. | Чтение, запись, управление, полный контроль |
http://sharepoint/social/trimming | Эта область запроса разрешения используется для определения того, следует ли отображать в приложениях контент, защищенный системой безопасности, в ленте социальных сетей. Если это разрешение с высоким уровнем доверия не предоставлено, некоторый контент (например, действия с документами и сайтами, на которые у приложения нет разрешений) будет обрезан из данных веб-канала, которые возвращаются в приложение, даже если у пользователя есть достаточные разрешения. Это разрешение необходимо вручную добавить в файл манифеста приложения. | Чтение, запись, управление, полный контроль |
Примечание
Дополнительные сведения о области запроса разрешений надстройки социальных функций см. в разделе Запросы разрешений надстройки для доступа к социальным функциям.
В таблице 7 показана область запроса разрешения для таксономии. В нем также перечислены права, которые можно указать для этого универсального кода ресурса (URI) области.
Таблица 7. URI области запроса разрешения надстройки таксономии и доступные права
URI области действия | Имеющиеся права |
---|---|
http://sharepoint/taxonomy | Чтение, запись |
Примечание
Дополнительные сведения о области запроса разрешений надстройки таксономии см. в разделе Добавление возможностей SharePoint.
Область запроса разрешения со связанными свойствами
Область запроса разрешения списка имеет дополнительное необязательное свойство. Область списка может принимать свойство с именем BaseTemplateId и целочисленное значение, соответствующее базовому шаблону списка, как показано в следующем образце разметки. Без идентификатора базового шаблона пользователь, устанавливающий надстройку, может предоставить ему разрешение на один список из всех списков в Интернете. Указание идентификатора базового шаблона ограничивает выбор пользователя набором списков, которые соответствуют тому, что указано в свойстве BaseTemplateId .
Свойство BaseTemplateId является дочерним элементом, а не атрибутом Элемент AppPermissionRequest . В следующем коде показано, как использовать свойство BaseTemplateId .
<Имя свойства="BaseTemplateId" Значение="101"/>
Таблица 8. Область запроса разрешения со связанными свойствами
URI области | Недвижимость | Тип |
---|---|---|
http://sharepoint/content/sitecollection/web/list | Базовый идентификатор шаблона | Целое число |
Примечание
Дополнительные сведения о BaseTemplateId и соответствующем целочисленном значении для базового шаблона списка см. в описании атрибута Type элемента списка (списка).
Управление разрешениями надстроек и устранение неполадок
Надстройки SharePoint, установленные в SharePoint, получают разрешения при установке. Надстройки, установленные на других платформах, но имеющие доступ к SharePoint, получают разрешения во время выполнения от пользователя, запускающего надстройку. Иногда надстройка первого типа может потерять свои разрешения. Вы можете повторно предоставить разрешения надстройке, выполнив следующие действия:
На странице «Контент сайта» веб-сайта, где надстройка потеряла разрешения, выберите значок 9.Кнопка 0015... на плитке надстройки. Откроется выноска либо со ссылкой РАЗРЕШЕНИЯ , либо с другой кнопкой ... .
Выберите ссылку PERMISSIONS , если она есть, и пропустите следующий шаг, либо нажмите кнопку ....
Выберите ссылку Разрешения .
На открывшейся странице выберите здесь в последнем предложении. Это повторно предоставляет надстройке ее разрешения и перенаправляет браузер обратно на страницу 9.0015 Содержимое сайта страница.
Перейдите по адресу
http://{SharePointWebSite}_layouts/15/AppInv.aspx
, гдеВведите идентификатор надстройки, также называемый идентификатором клиента, в поле Идентификатор надстройки , а затем выберите Поиск . Затем другие поля формы заполняются информацией о надстройке.
Заполните поле Permission Request XML запросами разрешений точно так же, как вы вводите их в манифесте надстройки. Примеры см. в разделе Области запроса разрешений для содержимого списка и содержимого библиотеки. Полную информацию о синтаксисе см. в разделе Элемент AppPermissionRequest.
Ваш комментарий будет первым