Встраивание документов

Встраивайте редактируемое содержимое в другой продукт Office, сохраняя его редактор.

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

Принцип: родительская и дочерняя Unit

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

100%

Отношения и контент сохраняются отдельно. Редактирование ячейки во встроенной электронной таблице обновляет детский лист. Перемещение или изменение размера блока обновляет якорь, хранящийся в хосте.

Поддерживаемые места вставки

Родительский продуктМесто вставкиТипичное применение
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 могут читать диапазоны листов или поля относительной таблицы, а поля формулы реляционной таблицы также могут ссылаться на лист. Когда доступны исходные данные и уведомления об изменениях, соответствующие правки запускают перерасчет.

100%
Сценарий и формулаПроверенный результат
Итог бюджета в 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 являются соответствующими Фасадами.

TypeScript
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, когда вам нужен редактор детского продукта.

К списку возможностей

Насколько полезно это руководство?

© 2026 DreamNum Co., Ltd.