Поделиться через


Обзор API облачной среды универсальной печати

Универсальная печать — это современное решение печати, которое можно использовать в организациях для управления инфраструктурой печати через облачные службы от Майкрософт.

Снимок экрана с изображением главной страницы универсальной печати на портале Azure

Зачем нужна универсальная печать?

Универсальная печать — это функции печати Windows Server, перенесенные в облако Microsoft 365, благодаря которым организации теперь могут обойтись без локальных серверов печати и не устанавливать драйверы печати на устройствах. Кроме того, в рамках универсальной печати предусмотрены дополнительные функции, например, группы безопасности для доступа к принтеру, обнаружение принтеров на основе расположения и расширенными возможностями для администраторов.

По мере внедрения универсальной печати в организациях организации и независимые поставщики программного обеспечения могут использовать API универсальной печати в Microsoft Graph, чтобы создавать и расширять приложения для поддержки новых сценариев.

Благодаря перемещению инфраструктуры печати в облако печатать документы можно непосредственно из веб-приложений и мобильных приложений.

  • Пользователи могут отправлять задания печати в printerShare.
  • Кроме того, администраторы принтера могут отправлять задания печати на принтер для выполнения предварительного тестирования, прежде чем предоставить организации общий доступ к принтеру.

Выполните указанные ниже действия, чтобы отправить задания печати в printerShare.

  1. Создайте задание печати и сохраните идентификатор полученного документа.
  2. Создайте uploadSession для документа.
  3. Отправьте байты в созданный сеанс отправки.
  4. Запустите задание печати.

Управление принтерами

Отследить принтеры организации, настройки принтеров и их использование — непростая задача. Благодаря API универсальной печати можно интегрировать эти три направления.

Комфорт при замене и обновлении оборудования для печати

Принтеры не видны пользователям до тех пор, пока они не будут общими, что позволяет администраторам точно контролировать, какое оборудование принтера доступно в данный момент времени.

При общем доступе к принтеру создается ресурс printerShare, который в любой момент можно обновить для перевода на другой принтер, что упрощает замену неисправного оборудования для печати и отправку принтеров в текущий ремонт.

Чтобы применить эту возможность в своем приложении, перейдите в Обновление printerShare и обновите ссылку printer на printerShare.

Включить печать с авторизацией

API универсальной печати Microsoft Graph позволяет приложению поддерживать печать по запросу. Чтобы настроить печать по запросу, необходимо регистрировать триггеры, которые уведомляют приложение (через взаимодействие между службами) о возникновении определенных событий печати, например о запуске задания печати.

Эти триггеры позволяют приложению прерывать рабочий процесс печати для выполнения таких задач, как перенаправление заданий на различные принтеры и изменение полезных данных документа.

Выполните следующие действия, чтобы включить печать по запросу:

  1. Создайте printTaskDefinition с помощью разрешений приложения. Это абстрактное определение задачи используется для создания задачи, которая будет содержать задание для приложения. Необходимо определить по крайней мере одно определение задачи для каждого клиента, которое можно связать с любым количеством принтеров в клиенте с помощью триггеров задач (см. Шаг 4).

  2. Зарегистрируйте один или несколько виртуальных принтеров с помощью маркера проверки подлинности администратора и nullphysicalDeviceId. "Виртуальный принтер" представляет собой объект принтера в Universal Print без прикрепленного физического устройства. Обычно пользователи выполняют печать на виртуальных принтерах, а затем выполняют задания печати на физическом устройстве печати. См. шаг 6.

  3. Обновляйте атрибуты вашего виртуального принтера с помощью разрешений приложения и типа носителя application/ipp (см. примеры).

  4. Создайте триггер задачи для вашего виртуального принтера с помощью администраторского маркера проверки подлинности, который будет использоваться для сопоставления определения задачи с виртуальным принтером. Идентификатор appId, используемый для создания маркера доступа, должен быть тем же идентификатором appId, который был использован для создания определения задачи.

  5. Когда задание печати отправляется на виртуальный принтер, оно приостанавливается из-за printTaskTrigger. Будут созданы printTask с состоянием processing на основе связанного printTaskDefinition.

  6. Когда пользователь проводит пальцем по значку физического устройства принтера, принтер уведомляет ваше приложение. В это время приложение может получить задания связанного виртуального принтера и отфильтровать список на задания, созданные текущим пользователем.

  7. При выборе пользователем одного или нескольких заданий для печати, приложение может перенаправить задание (-я) печати на физический принтер, и задание запустит печать. Вызов на перенаправление будет успешным только в том случае, если присутствует printTask в состоянии processing в связанном принтере, запущенном триггером, который был создан этим приложением в Шаге 4. После перенаправления задания, задача автоматически будет настроена на состояние completed.

Справочные материалы по API

Ищете справочные материалы по API для этой службы?

Предоставление отзывов

Мы будем рады узнать ваше мнение об API универсальной печати. Укажите свои предложения на форуме идей платформы для разработчиков Microsoft 365.