Составитель документов

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

Этот соединитель доступен в следующих продуктах и регионах:

Услуга	Class	Регионы
Copilot Studio	Премия	Все регионы Power Automate , кроме следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)
Логические приложения	Стандарт	Все регионы Logic Apps , кроме следующих:      — Регионы Azure для государственных организаций      — Регионы Azure Для Китая      - Министерство обороны США (DoD)
Power Apps	Премия	Все регионы Power Apps , кроме следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)
Power Automate	Премия	Все регионы Power Automate , кроме следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)

Контакт
Имя	Составитель документов
URL	https://documentdrafter.com
Адрес электронной почты	support@documentdrafter.com

Метаданные соединителя
Publisher	Составитель документов
Веб-сайт	https://documentdrafter.com
Политика конфиденциальности	https://documentdrafter.com/privacy/
Категории	Сотрудничество; ИТ-операции

Соединитель черновика документов

Соединитель черновика документов позволяет создавать и управлять рабочими процессами для автоматизированных процессов документов.

Предпосылки

Обязательный: подписка на черновик документов и доступ к порталу.

Как получить доступ?

Для демонстрации обратитесь к нам по адресу documentdrafter.com

Создание подключения

Подключитесь с помощью маркера, полученного на портале черновика документов.

Поддерживаемые операции

Соединитель поддерживает несколько операций:

Triggers

• Button press: инициирует рабочий процесс при нажатии кнопки в анкете.
• Link submission: запускает рабочий процесс при отправке анкеты по URL-адресу.

Действия

• Create and Fill Questionnaire: заполнение анкеты с помощью данных JSON.
• Create Questionnaire: настройте новую анкету.
• Get Link to a Questionnaire: получение ссылки для доступа к анкете.
• Get Documents: получение документов, созданных на основе анкеты.
• Get Questionnaire Information: доступ к информации, введенной в анкету.
• Get Tags for a Questionnaire: просмотрите все теги, назначенные анкете.
• Get information on flow states and triggers: поток может иметь несколько состояний с несколькими триггерами. Это действие извлекает эти сведения на основе ключа потока.
• Get link to a questionnaire: создает новую глубокую ссылку на анкету.
• Set current state for a questionnaire: поток может иметь несколько состояний. Это действие позволяет изменить состояние анкеты.
• Grant users or groups access to a questionnaire: предоставление пользователям или группам доступа к анкете.
• Revoke access to a questionnaire for all users and groups:Отмена доступа к анкете для всех пользователей и групп.
• Get or Create a Workspace: проверяет наличие существующей рабочей области по имени. Если рабочая область не найдена, а для параметра Create if not found задано значение true, создается новая рабочая область. Он возвращает состояние "Существует рабочая область" и, если применимо, имя, идентификатор и путь рабочей области. Необязательный параметр позволяет копировать стили и папки из другой главной рабочей области.
• Get or Create a Folder: проверяет наличие папки по имени в указанной рабочей области. Если папка не найдена, а для параметра Create if not found задано значение true, создается новая папка. Он возвращает состояние "Папка существует" и, если применимо, имя папки, идентификатор и путь.
• Save Static Files to a Workspace: сохраняет статические файлы в указанной рабочей области и папке в формате base64. Он возвращает имя, идентификатор и путь к сохраненного файла.
• Get or Create a User: проверяет наличие пользователя по адресу электронной почты. Если пользователь не найден и параметр Create, если параметр не найден, имеет значение true, создается новый пользователь. Он возвращает состояние "Пользователь существует" и, если применимо, идентификатор и имя пользователя. Необязательные параметры позволяют отключить созданное системой сообщение электронной почты приглашения и получить временный пароль для пользовательского потока электронной почты. Можно также указать группу для добавления нового пользователя.
• Get or Create a Group: проверяет наличие существующей группы по имени. Если группа не найдена, а для параметра Create if not found задано значение true, создается новая группа. Он возвращает состояние "Группа существует" и, если применимо, идентификатор и имя группы.
• Add Access for a Group: добавляет доступ к группе в указанную рабочую область или папку. Он возвращает состояние Access Exists и, если применимо, подтверждает, что доступ предоставлен. Его можно использовать для проверки существующего доступа без добавления.

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:

По умолчанию	Параметры для создания подключения.	Все регионы	Недоступен для совместного использования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя	Тип	Description	Обязательно
Ключ API	securestring	Ключ API для этого соединителя	True

Ограничения регулирования

Имя	Вызовы	Период обновления
Вызовы API для каждого подключения	100	60 секунд

Действия

Заполнение всех тегов для анкеты	Получение тегов анкеты
Отмена доступа к анкете для всех пользователей и групп	Отмена доступа к анкете для всех пользователей и групп
Получение документов	Получение файлов документов на основе идентификатора документа
Получение или создание группы	Получение сведений о группе и ее создание, если она не существует
Получение или создание доступа к папке	Получение сведений о доступе к папке и его создании, если он не существует
Получение или создание папки	Получение сведений о папке и ее создание, если она не существует
Получение или создание пользователя	Получение сведений о пользователе и его создание, если оно не существует
Получение или создание рабочей области	Получение сведений о рабочей области и ее создание, если она не существует
Получение сведений о анкете	Получение переменных для одного шаблона
Получение сведений о потоке	Получение сведений о потоке на основе ключа потока
Получение ссылки на анкету	Создает новую глубокую ссылку на анкету
Получить анонимную ссылку на анкету	Получение глубокой связи для анкеты для внешней общей папки
Предоставление пользователям или группам доступа к анкете	Предоставление пользователям или группам доступа к анкете
Создание и заполнение анкеты с помощью данных JSON	Создайте и заполните анкету, отправив JSON-файл. После этого действия можно использовать действия получения документов или получения сведений о анкетах.
Создание новой анкеты	Создание нового вопроса на выбранном шаблоне
Сохранение статического файла в папку	Сохраняет статический файл в указанную папку
Установка текущего состояния для анкеты	Поток может иметь несколько состояний. Это действие позволяет изменить состояние анкеты.

Заполнение всех тегов для анкеты

Идентификатор операции:

GetTagsForQuestionnaire

Получение тегов анкеты

Параметры

Имя	Ключ	Обязательно	Тип	Описание
URL-адрес портала черновика документов	SiteUrl	True	string	Например, contenso.documentdrafter.com
Идентификатор документа для анкеты	DocumentId		string	Идентификатор документа для анкеты
Электронная почта пользователя	CreateUser	True	string	Электронная почта пользователя, активировающего поток

Возвращаемое значение

Имя	Путь	Тип	Описание
items	items	array of object	Список тегов для анкеты
tag	items.tag	string	Тег для элемента данных
ответ	items.answer	string	Ответ на элемент с тегами

Отмена доступа к анкете для всех пользователей и групп

Идентификатор операции:

DeleteAllShareLinksOnDocument

Отмена доступа к анкете для всех пользователей и групп

Параметры

Имя	Ключ	Обязательно	Тип	Описание
URL-адрес портала черновика документов	SiteUrl	True	string	Например, contenso.documentdrafter.com
Идентификатор документа	DocumentId	True	string	Единый уникальный идентификатор для всех созданных документов
Электронная почта пользователя	CreateUser	True	string	Электронная почта пользователя, активировающего поток

Возвращаемое значение

описание out

response

object

Получение документов

Идентификатор операции:

GetDocuments

Получение файлов документов на основе идентификатора документа

Параметры

Имя	Ключ	Обязательно	Тип	Описание
URL-адрес портала черновика документов	SiteUrl	True	string	Например, contenso.documentdrafter.com
Идентификатор документа	DocumentId	True	string	Единый уникальный идентификатор для всех созданных документов
Электронная почта пользователя	CreateUser	True	string	Электронная почта пользователя, активировающего поток
Docx или PDF	OutputFormat	True	string	Формат созданных документов.

Возвращаемое значение

Имя	Путь	Тип	Описание
Имя анкеты	QuestionnaireName	string	Имя анкеты
Имя документа (один документ)	FirstFileName	string	Имя документа (только для одного документа)
Содержимое документа (один документ)	FirstFileContentBytes	string	Объект в кодировке Base64 для содержимого документа
Files	Files	array of object	Коллекция файлов, созданных для документа
Имена всех документов (несколько документов)	Files.Name	string	Список имен для всех документов
Содержимое для всех документов (несколько документов)	Files.ContentBytes	string	Список объектов в кодировке Base64 для содержимого всех документов

Получение или создание группы

Идентификатор операции:

GetCreateGroup

Получение сведений о группе и ее создание, если она не существует

Параметры

Имя	Ключ	Обязательно	Тип	Описание
URL-адрес портала черновика документов	SiteUrl	True	string	Например, contenso.documentdrafter.com
Создание, если не найдено	CreateIfNotFound	True	boolean	Создайте объект, если он не существует
Имя группы черновика документов	GroupNamePath	True	string	Имя группы
Роль черновика документов	Role		string	Роль пользователя

Возвращаемое значение

Имя	Путь	Тип	Описание
Идентификатор	Id	string	Уникальный идентификатор группы
Имя	Name	string	Указывает имя группы
Состояние	Status	string	Текущее состояние группы

Получение или создание доступа к папке

Идентификатор операции:

GetCreateAccessFolder

Получение сведений о доступе к папке и его создании, если он не существует

Параметры

Имя	Ключ	Обязательно	Тип	Описание
URL-адрес портала черновика документов	SiteUrl	True	string	Например, contenso.documentdrafter.com
Создание, если не найдено	CreateIfNotFound	True	boolean	Создайте объект, если он не существует
Имя группы черновика документов	GroupNamePath	True	string	Имя группы
Идентификатор папки черновика документа	FolderId	True	string	Идентификатор папки

Возвращаемое значение

Имя	Путь	Тип	Описание
Состояние	Status	string	Текущее состояние доступа

Получение или создание папки

Идентификатор операции:

GetCreateFolder

Получение сведений о папке и ее создание, если она не существует

Параметры

Имя	Ключ	Обязательно	Тип	Описание
URL-адрес портала черновика документов	SiteUrl	True	string	Например, contenso.documentdrafter.com
Создание, если не найдено	CreateIfNotFound	True	boolean	Создайте объект, если он не существует
Имя папки "Черновик документа"	FolderName	True	string	Имя папки
Родительская папка проекта документа или идентификатор рабочей области	ParentId	True	string	Идентификатор родительской папки или рабочей области

Возвращаемое значение

Имя	Путь	Тип	Описание
Идентификатор	Id	string	Уникальный идентификатор папки
Имя	Name	string	Имя папки
Путь	Path	string	Путь к папке
Состояние	Status	string	Текущее состояние папки

Получение или создание пользователя

Идентификатор операции:

GetCreateUser

Получение сведений о пользователе и его создание, если оно не существует

Параметры

Имя	Ключ	Обязательно	Тип	Описание
URL-адрес портала черновика документов	SiteUrl	True	string	Например, contenso.documentdrafter.com
Создание, если не найдено	CreateIfNotFound	True	boolean	Создайте объект, если он не существует
Имя группы черновика документов	GroupName	True	string	Имя группы
Электронная почта пользователя черновика документов	Email	True	string	Электронная почта пользователя
Приглашение на отправку черновика документов пользователю	sendInvite	True	boolean	Отправка приглашения пользователю

Возвращаемое значение

Имя	Путь	Тип	Описание
Состояние	Status	string	Текущее состояние пользователя
Идентификатор	Id	string	Уникальный идентификатор пользователя
Имя	Name	string	Имя пользователя
Пароль	Password	string	Пароль пользователя (возвращается только при создании и не отправляет приглашения).

Получение или создание рабочей области

Идентификатор операции:

GetCreateWorkspace

Получение сведений о рабочей области и ее создание, если она не существует

Параметры

Имя	Ключ	Обязательно	Тип	Описание
URL-адрес портала черновика документов	SiteUrl	True	string	Например, contenso.documentdrafter.com
Имя рабочей области	WorkspaceNameRoute	True	string	Имя рабочей области
Создание, если не найдено	CreateIfNotFound	True	boolean	Создайте объект, если он не существует
Главная рабочая область	MasterWorkSpace		string	Выберите главную рабочую область из раскрывающегося списка
Копирование стиля из главной рабочей области	CopyStyling		boolean	Копирование стиля из главной рабочей области
Копирование папок из главной рабочей области	CopyFolders		boolean	Копирование структуры папок из главной рабочей области

Возвращаемое значение

Имя	Путь	Тип	Описание
Идентификатор	Id	string	Уникальный идентификатор рабочей области
Имя	Name	string	Имя рабочей области
Путь	Path	string	Путь к рабочей области
Состояние	Status	string	Текущее состояние рабочей области

Получение сведений о анкете

Идентификатор операции:

GetVariablesForTemplate

Получение переменных для одного шаблона

Параметры

Имя	Ключ	Обязательно	Тип	Описание
URL-адрес портала черновика документов	SiteUrl	True	string	Например, contenso.documentdrafter.com
Идентификатор документа	DocumentId	True	string	Единый уникальный идентификатор для всех созданных документов
Workspace	WorkSpace	True	string	Выбор рабочей области из раскрывающегося списка
Анкета	TemplateId	True	string	Выбор шаблона из раскрывающегося списка
Электронная почта пользователя	CreateUser	True	string	Электронная почта пользователя, активировающего поток

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Получение сведений о потоке

Идентификатор операции:

GetFlowInformation

Получение сведений о потоке на основе ключа потока

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Ключ потока	FlowKey	True	string	Ключ потока черновика документов
URL-адрес портала черновика документов	SiteUrl	True	string	Например, contenso.documentdrafter.com

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Получение ссылки на анкету

Идентификатор операции:

GetExternalShareLinkV2

Создает новую глубокую ссылку на анкету

Параметры

Имя	Ключ	Обязательно	Тип	Описание
URL-адрес портала черновика документов	SiteUrl	True	string	Например, contenso.documentdrafter.com
Идентификатор документа	DocumentId	True	string	Единый уникальный идентификатор для всех созданных документов
Электронная почта пользователя для ссылки	Email	True	string	Электронная почта пользователей для ссылки
Электронная почта пользователя	CreateUser	True	string	Электронная почта пользователя, активировающего поток

Возвращаемое значение

Возвращает ссылку общего ресурса

Link

string

Получить анонимную ссылку на анкету

Идентификатор операции:

GetExternalShareLink

Получение глубокой связи для анкеты для внешней общей папки

Параметры

Имя	Ключ	Обязательно	Тип	Описание
URL-адрес портала черновика документов	SiteUrl	True	string	Например, contenso.documentdrafter.com
Идентификатор документа	DocumentId	True	string	Единый уникальный идентификатор для всех созданных документов
Введите ссылку для идентификации ссылки	Scope	True	string	Указание ссылки для ссылки на действие триггера
Ссылка действительна в днях	ExpireDays	True	integer	Допустимое количество дней, в течение которых указана ссылка
Электронная почта пользователя	CreateUser	True	string	Электронная почта пользователя, активировающего поток

Возвращаемое значение

Возвращает ссылку общего ресурса

Link

string

Предоставление пользователям или группам доступа к анкете

Идентификатор операции:

FlowAddShare

Предоставление пользователям или группам доступа к анкете

Параметры

Имя	Ключ	Обязательно	Тип	Описание
URL-адрес портала черновика документов	SiteUrl	True	string	Например, contenso.documentdrafter.com
Идентификатор документа	DocumentId	True	string	Единый уникальный идентификатор для всех созданных документов
Электронная почта пользователя	CreateUser	True	string	Электронная почта пользователя, активировающего поток
Группа или почта	GroupOrMail	True	string	Группа или почта
Доступ к выбранным вопросам	SelectedQuestions		boolean	Включение доступа к выбранным вопросам, по умолчанию — полный доступ

Возвращаемое значение

описание out

response

object

Создание и заполнение анкеты с помощью данных JSON

Идентификатор операции:

ProcessJson

Создайте и заполните анкету, отправив JSON-файл. После этого действия можно использовать действия получения документов или получения сведений о анкетах.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
URL-адрес портала черновика документов	SiteUrl	True	string	Например, contenso.documentdrafter.com
Workspace	WorkSpace	True	string	Выбор рабочей области из раскрывающегося списка
Анкета	TemplateId	True	string	Выбор шаблона из раскрывающегося списка
Электронная почта пользователя	CreateUser	True	string	Электронная почта пользователя, активировающего поток
Данные JSON	JsonData	True	string	Данные JSON для заполнения анкеты

Возвращаемое значение

Имя	Путь	Тип	Описание
Идентификатор документа	documentId	string	Идентификатор документа

Создание новой анкеты

Идентификатор операции:

CreateQuestionnaire

Создание нового вопроса на выбранном шаблоне

Параметры

Имя	Ключ	Обязательно	Тип	Описание
URL-адрес портала черновика документов	SiteUrl	True	string	Например, contenso.documentdrafter.com
Workspace	WorkSpace	True	string	Выбор рабочей области из раскрывающегося списка
Анкета	TemplateId	True	string	Выбор шаблона из раскрывающегося списка
Электронная почта пользователя	CreateUser	True	string	Электронная почта пользователя, активировающего поток

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Сохранение статического файла в папку

Идентификатор операции:

SaveStaticFileToFolder

Сохраняет статический файл в указанную папку

Параметры

Имя	Ключ	Обязательно	Тип	Описание
URL-адрес портала черновика документов	SiteUrl	True	string	Например, contenso.documentdrafter.com
Идентификатор папки черновика документа	FolderId	True	string	Идентификатор папки
Имя файла черновика документа с расширением	FileName	True	string	Имя файла для отправки, включая расширение
Файл черновика документов в base64	FileBase64	True	string	Файл для отправки в формате Base64

Возвращаемое значение

Имя	Путь	Тип	Описание
Идентификатор	Id	string	Уникальный идентификатор папки
Имя	Name	string	Имя папки
Путь	Path	string	Путь к папке
Состояние	Status	string	Текущее состояние папки

Установка текущего состояния для анкеты

Идентификатор операции:

FlowSetState

Поток может иметь несколько состояний. Это действие позволяет изменить состояние анкеты.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
URL-адрес портала черновика документов	SiteUrl	True	string	Например, contenso.documentdrafter.com
Идентификатор документа	DocumentId	True	string	Единый уникальный идентификатор для всех созданных документов
Ключ потока	FlowKey	True	string	Ключ потока черновика документов
Государство	State	True	string	Состояние потока
Электронная почта пользователя	CreateUser	True	string	Электронная почта пользователя, активировающего поток

Возвращаемое значение

описание out

response

object

Триггеры

Дождитесь отправки из внешней ссылки общего ресурса	Этот триггер ожидает отправки анкеты из внешней ссылки общего ресурса
Триггер потока на кнопке анкеты	Этот триггер проверяет платформу черновика документов для нового триггера пользовательского потока на основе ключа потока

Дождитесь отправки из внешней ссылки общего ресурса

Идентификатор операции:

TriggerSubmitPolling

Этот триггер ожидает отправки анкеты из внешней ссылки общего ресурса

Параметры

Имя	Ключ	Обязательно	Тип	Описание
URL-адрес портала черновика документов	SiteUrl	True	string	Например, contenso.documentdrafter.com
Введите ссылку для идентификации ссылки	Scope	True	string	Указание ссылки для ссылки на действие триггера

Возвращаемое значение

Имя	Путь	Тип	Описание
items	items	array of object
статус	items.status	string	Состояние задания (завершено, время ожидания)
documentId	items.documentId	string	Уникальный идентификатор документа

Триггер потока на кнопке анкеты

Идентификатор операции:

FlowTriggerPolling

Этот триггер проверяет платформу черновика документов для нового триггера пользовательского потока на основе ключа потока

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Ключ потока	FlowKey	True	string	Ключ потока черновика документов
URL-адрес портала черновика документов	SiteUrl	True	string	Например, contenso.documentdrafter.com

Возвращаемое значение

Имя	Путь	Тип	Описание
items	items	array of object	items
Электронная почта пользователя	items.createUser	string	Электронная почта пользователя, активировающего поток
Идентификатор документа	items.documentId	string	Единый уникальный идентификатор для всех созданных документов
Метка времени потока	items.triggerTime	string	Метка времени при активации потока.
Имя анкеты	items.documentName	string	Имя анкеты, активируя поток
Текущий ключ состояния	items.stateKey	string	Документ текущего ключа состояния
Ключ триггера	items.triggerKey	string	Триггерный ключ для события
Данные для события	items.additionalData	string	Триггер данных для события
Электронная почта источника	items.OriginCreateUser	string	Электронная почта пользователя, создающего анкету

Определения

струна

Это базовый тип данных string.

объект

Это тип object.