Встраивание документов
Встраивайте редактируемое содержимое в другой продукт Office, сохраняя его редактор.
Встроенные блоки помещают один продукт Univer внутрь другого. Проектный документ может содержать бюджеты и задачи, слайд может нести рабочую электронную таблицу, а холст может представлять планы вместе с заметками. Встроенный контент сохраняет свою собственную модель данных и свой родной редактор, поэтому активация блока перемещает фокус и меню в детский блок.
Принцип: родительская и дочерняя Unit
принимающая группа сохраняет размещение и размер блока, ссылку на дочерний блок и вид по умолчанию. Детская группа хранит фактические ячейки, абзацы или записи. Загрузка блока разрешает эту ссылку, загружает дочерний блок, и монтирует его редактор внутри хоста. Подразделение может быть рабочей книгой, документом, презентацией, реляционной таблицей или холстом.
Отношения и контент сохраняются отдельно. Редактирование ячейки во встроенной электронной таблице обновляет детский лист. Перемещение или изменение размера блока обновляет якорь, хранящийся в хосте.
Поддерживаемые места вставки
| Родительский продукт | Место вставки | Типичное применение |
|---|---|---|
| Sheet | Плавающий объект или вкладка в книгу | Краткое описание рядом с моделью расчета или базой данных задач на отдельной вкладке. |
| Doc | Блок в основном тексте | Рассказы, бюджеты и задачи на одной странице проекта. |
| Slide | Плавающий объект или страница презентации | Редактируемые исходные данные рядом с выводом. |
| Relational Table | Элемент списка таблиц | Проектная документация, которая хранится в базе данных бизнеса. |
| Canvases | Плавающий объект на холсте | Данные, предложения и обсуждение на одном холсте. |
Пять примеров родительских продуктов
Приведенные ниже примеры были получены через Facade API и запечатлены в браузере, поэтому интерфейс выполнен на английском языке. В каждом случае используются независимые дочерние блоки, а весь контент и фигуры являются выборочными данными.
Sheet: расчёты и пояснительный документ
Центр управления в сумме тратит налево и встраивает полный Doc направо. Его вкладка Пусковой трекер открывает Относительную таблицу. Эта компоновка подходит для ценообразования, операций и финансовых учебников, которые должны хранить предположения, расчеты и письменное решение в одном месте. Ближайшим эквивалентом является Вставить объект документа в Excel.
Doc: страница проекта с бюджетом и задачами
Тело содержит бюджетный лист, за которым следует относительная таблица, поэтому читатели могут изучить модель и поддерживать задачи в контексте.Расположение напоминает Встроенные базы данных Notion, за исключением того, что бюджет по-прежнему работает на движке формулы листа, а задачи сохраняют поля и представления относительной таблицы.
Slide: исходные данные на странице обзора
На одном слайде размещены бюджетный лист, таблица реляционных задач и метрика бюджета по формуле. Взаимодействие сопоставимо с Встраивание Excel в PowerPoint: рецензенты могут начать с заключения и вернуться к редактируемой модели данных. Изображенный бюджет обновился до $62 100.
Relational Table: описание внутри базы
В CRM, трекере проектов или базе данных операций это позволяет людям перемещаться между структурированной работой и ее письменным контекстом. Это запись в таблице-списке, и она автоматически не создает документ для каждой записи.
Canvases: общий холст планирования
Полотно сочетает в себе бюджетный лист, предложение Doc и сводку расходов, основанную на формуле. Это подходит для проектных залов, обзоров и исследовательских полотен, которые нуждаются в исходных данных и контексте во время обсуждения.
Как связаны формулы
Встраивание покрывает отображение и редактирование; вычисление происходит из ссылок. Вставка блока не создает сводную формулу, поэтому сначала должны быть настроены перекрестные ссылки. Как только они будут установлены, ячейки листов и формулы-управляемые формы в Doc, Slide и Canvases могут читать диапазоны листов или поля относительной таблицы, а поля формулы реляционной таблицы также могут ссылаться на лист. Когда доступны исходные данные и уведомления об изменениях, соответствующие правки запускают перерасчет.
| Сценарий и формула | Проверенный результат |
|---|---|
Итог бюджета в Slide: =SUM('[Leadership Budget]Budget'!C5:C8) | Изменение C7 с 17,100 на 18,000 обновляет итог: 61,200 → 62,100. |
Сумма Relational Table в Sheet: =SUM([Control Tasks]!Launch_tasks[Cost]) | Изменение одного Cost с 4,000 на 4,500 обновляет итог: 18,000 → 18,500. |
Имена формул служат в качестве читаемых квалификаторов, и интеграция должна также сохранять стабильные идентификаторы единиц. Используйте getFormula().buildReference() для создания ссылки вместе с внешним отображением, которое ему требуется. Для таблицы в реляционной таблице используйте table.getFormulaName() вместо конкатенирования имени дисплея или ID. Формы, управляемые формулой, используют shape.setFormula({ formula, externalReferences }); прочитайте результат после завершения расчета. См. Фасад Формулы, Форменный фасад и Формулы относительной таблицы.
Создание и интеграция
Зарегистрируйте хост-продукт, детский продукт и их пользовательский интерфейс в том же экземпляре Univer, затем добавьте пользовательский интерфейс Embed и Embed.Приведенный ниже пример вставляет существующий лист в корпус Doc; hostDocument и budgetWorkbook являются соответствующими Фасадами.
import '@univerjs-pro/embed/facade'const block = univerAPI.createEmbed({ host: { unitId: hostDocument.getId(), surface: univerAPI.Enum.FEmbedHostSurface.DocBlock, }, content: { unitType: univerAPI.Enum.UniverInstanceType.UNIVER_SHEET, ref: `#unit=${encodeURIComponent(budgetWorkbook.getId())}&type=sheet`, },})const embeddedWorkbook = await block.loadAsync()createEmbed() создает связь и якорь хоста. loadAsync() загружает дочерний блок и возвращает его Фасад. displayTarget выбирает начальную рабочую таблицу, страницу слайда или просмотр реляционной таблицы. встраиваемый путеводитель охватывает плагины, стили, локализации и загрузчики. Встроенный Facade охватывает другие поверхности и методы.
Сохранение, совместная работа и ограничения
- Ведущий Snapshot сохраняет ссылки, размещение и настройки отображения, но не упаковывает последний контент ребенка автоматически.Удаление блока не удаляет документ ребенка.
- Server SDK предоставляет детские снимки и сопутствующие им сервисы совместной работы. С
@univerjs-pro/collaboration-embedбраузер загружает ребенка и присоединяется к его сеансу совместной работы... Родители и дети сохраняют отдельные изменения и версии. - Приложение разрешает ссылки, загружает данные и разрешает доступ. Возможность открыть хост сама по себе не предоставляет прав редактирования на ребенка.
- Типы Sheet, Doc, Slide, Relational Table и Canvases могут быть встроены друг в друга. PDF, встраивание одного и того же типа и более глубокое вложение исключены. В рамках одного времени выполнения Univer детский блок может принадлежать только одному активному встраиванию.
Используйте двухстороннее связывание для управления собственными входами приложения, метриками и диаграммами из электронной таблицы. Используйте Embed Block, когда вам нужен редактор детского продукта.
Насколько полезно это руководство?