Вставка данных в текст при создании встречи или сообщения в Outlook
Используйте асинхронные методы (Body.getAsync, Body.getTypeAsync, Body.prependAsync, Body.setAsync и Body.setSelectedDataAsync) для получения типа текста и вставки данных в текст создаваемой встречи или сообщения. Эти асинхронные методы доступны только для создания надстроек. Чтобы использовать эти методы, убедитесь, что манифест надстройки настроен соответствующим образом, чтобы Outlook активировал надстройку в формах создания, как описано в разделе Создание надстроек Outlook для форм создания.
В Outlook пользователь может создавать сообщения (текстовые, а также в формате HTML и RTF) и встречи (в формате HTML). Прежде чем вставлять данные, необходимо сначала проверить поддерживаемый формат элемента, вызвав getTypeAsync , так как может потребоваться выполнить дополнительные действия. Возвращаемое getTypeAsync значение зависит от исходного формата элемента, а также от поддержки операционной системы устройства и приложения для редактирования в формате HTML. После проверки формата элемента задайте coercionType параметр prependAsync или setSelectedDataAsync , соответственно, чтобы вставить данные, как показано в следующей таблице. Если не указать аргумент и setSelectedDataAsync предположить, prependAsync что вставляемые данные в текстовом формате.
| Данные для вставки | Формат элемента, возвращенный методом getTypeAsync | CoercionType для использования |
|---|---|---|
| Текст | Текст 1 | Текст |
| HTML | Текст 1 | Текст 2 |
| Текст | HTML | Текст или HTML |
| HTML | HTML | HTML |
1 На планшетах и смартфонах возвращает текст, getTypeAsync если операционная система или приложение не поддерживает редактирование элемента, который был создан в ФОРМАТЕ HTML, в формате HTML.
2 Если вставляемые данные являются HTML и getTypeAsync возвращают тип текста для текущего почтового элемента, необходимо реорганизовать данные как текстовые и задать для параметра coercionType Office.CoercionType.Text значение . Если просто вставить HTML-данные в текстовый элемент, приложение отобразит html-теги в виде текста. Если вы попытаетесь вставить html-данные и присвоить значение coercionType Office.CoercionType.Html , вы получите сообщение об ошибке.
В дополнение к параметру coercionType , как и большинство асинхронных методов в API JavaScript для Office, getTypeAsync , prependAsync и setSelectedDataAsync принимают другие необязательные входные параметры. Дополнительные сведения о том, как указать эти необязательные входные параметры, см. в разделе Передача необязательных параметров в асинхронные методы статьи Асинхронное программирование в надстройках Office.
Вставка данных в текущей позиции курсора
В этом разделе показан пример кода, который используется getTypeAsync для проверки типа текста создаваемого элемента, а затем используется setSelectedDataAsync для вставки данных в текущее расположение курсора.
Необходимо передать строку данных в качестве входного параметра в setSelectedDataAsync . В зависимости от типа текста элемента можно указать эту строку в виде текста или HTML соответственно. Как упоминалось ранее, при необходимости можно указать тип данных для вставки в coercionType параметр . Чтобы получить состояние и результаты , передайте функцию обратного setSelectedDataAsync вызова и необязательные входные параметры в метод, а затем извлеките необходимые сведения из выходного параметра asyncResult обратного вызова. В случае успешного выполнения метода можно получить тип текста элемента из asyncResult.value свойства , то есть «text» или «html».
Если пользователь не поместил курсор в текст элемента, setSelectedDataAsync вставляет данные в верхнюю часть текста. Если пользователь выбрал текст в тексте элемента, setSelectedDataAsync он заменяет выделенный текст указанными данными. Обратите внимание, что setSelectedDataAsync может завершиться ошибкой, если пользователь одновременно изменяет позицию курсора при создании элемента. Максимальное число символов, которые можно вставить за один раз — 1 000 000.
let item; // Confirms that the Office.js library is loaded. Office.onReady((info) => < if (info.host === Office.HostType.Outlook) < item = Office.context.mailbox.item; setItemBody(); >>); // Inserts data at the current cursor position. function setItemBody() < // Identify the body type of the mail item. item.body.getTypeAsync((asyncResult) => < if (asyncResult.status === Office.AsyncResultStatus.Failed) < console.log(asyncResult.error.message); return; >// Insert data of the appropriate type into the body. if (asyncResult.value === Office.CoercionType.Html) < // Insert HTML into the body. item.body.setSelectedDataAsync( "Kindly note we now open 7 days a week.", < coercionType: Office.CoercionType.Html, asyncContext: < optionalVariable1: 1, optionalVariable2: 2 >>, (asyncResult) => < if (asyncResult.status === Office.AsyncResultStatus.Failed) < console.log(asyncResult.error.message); return; >/* Run additional operations appropriate to your scenario and use the optionalVariable1 and optionalVariable2 values as needed. */ >); > else < // Insert plain text into the body. item.body.setSelectedDataAsync( "Kindly note we now open 7 days a week.", < coercionType: Office.CoercionType.Text, asyncContext: < optionalVariable1: 1, optionalVariable2: 2 >>, (asyncResult) => < if (asyncResult.status === Office.AsyncResultStatus.Failed) < console.log(asyncResult.error.message); return; >/* Run additional operations appropriate to your scenario and use the optionalVariable1 and optionalVariable2 values as needed. */ >); > >); > Вставка данных в начале текста элемента
Кроме того, можно использовать prependAsync для вставки данных в начале текста элемента и игнорировать текущее расположение курсора. Кроме точки вставки, prependAsync и setSelectedDataAsync ведут себя аналогичным образом. Сначала необходимо проверка тип текста сообщения, чтобы избежать привязки HTML-данных к сообщению в текстовом формате. Затем передайте строку данных, которая будет добавлена в текстовом или HTML-формате, в prependAsync . Максимальное число символов, которые можно вставить в начало за один раз — 1 000 000.
Следующий код JavaScript сначала вызывает getTypeAsync для проверки типа текста элемента. Затем в зависимости от типа данные вставляются в виде HTML-кода или текста в верхнюю часть текста.
let item; // Confirms that the Office.js library is loaded. Office.onReady((info) => < if (info.host === Office.HostType.Outlook) < item = Office.context.mailbox.item; prependItemBody(); >>); // Prepends data to the body of the item being composed. function prependItemBody() < // Identify the body type of the mail item. item.body.getTypeAsync((asyncResult) => < if (asyncResult.status === Office.AsyncResultStatus.Failed) < console.log(asyncResult.error.message); return; >// Prepend data of the appropriate type to the body. if (asyncResult.value === Office.CoercionType.Html) < // Prepend HTML to the body. item.body.prependAsync( 'Greetings!', < coercionType: Office.CoercionType.Html, asyncContext: < optionalVariable1: 1, optionalVariable2: 2 >>, (asyncResult) => < if (asyncResult.status === Office.AsyncResultStatus.Failed) < console.log(asyncResult.error.message); return; >/* Run additional operations appropriate to your scenario and use the optionalVariable1 and optionalVariable2 values as needed. */ >); > else < // Prepend plain text to the body. item.body.prependAsync( 'Greetings!', < coercionType: Office.CoercionType.Text, asyncContext: < optionalVariable1: 1, optionalVariable2: 2 >>, (asyncResult) => < if (asyncResult.status === Office.AsyncResultStatus.Failed) < console.log(asyncResult.error.message); return; >/* Run additional operations appropriate to your scenario and use the optionalVariable1 and optionalVariable2 values as needed. */ >); > >); > См. также
- Просмотр и изменение данных элемента в форме создания элементов Outlook
- Просмотр и изменение данных элемента Outlook в формах просмотра и создания
- Создание надстроек Outlook для форм создания
- Асинхронное программирование надстроек Office
- Просмотр, изменение или добавление получателей при создании встречи или сообщения в Outlook
- Просмотр или изменение темы при создании встречи или сообщения в Outlook
- Просмотр или изменение расположения при создании встречи в Outlook
- Просмотр или изменение времени при создании встречи в Outlook
Отправление писем в html-формате из MS Outlook 2010
Возможность работы с отправлениями в виде html-писем в Outlook-е надёжно встроена. Настолько надёжно, что навскидку искать можно очень долго, во избежание чего мы и пройдём этот путь здесь вместе.
Сразу вставим ремарку, что для корректного отображения изображений, встроенных в тело вашего html-письма, ссылки на них должны вести к серверу. Соответственно, и хранение картинок должно быть организовано на сервере, а не на локальном жёстком диске вашего компьютера.
Видео
Загружаем html-письмо в Outlook-2010
В открытом окне программы кликаем по кнопке интерфейса «Создать сообщение» слева вверху
В раскрывшемся окне создания сообщения в главном меню выбираем группу команд «Вставка», а в ней — команду «Вложить файл»
Через открывшееся диалоговое окно вставки файла добираемся до заготовки своего письма. Выбираем его кликом мыши и раскрываем список (под треугольником) рядом с кнопкой «Вставить», где выбираем команду «Вставить как текст». Это инициирует загрузку кода и текста нашего html-шаблона в тело письма
Прежде, чем перейти к редактированию письма (если в том есть необходимость), следуя правилам хорошего тона электронной переписки, укажите тему письма и адресата, или адресатов, которым оно направляется.
Редактируем содержимое html-сообщения
Редактирование текста во вновь созданном сообщении интуитивно понятно: просто ставим курсор в нужную позицию среди текста, и производим правку: добавляем, выделяем, исправляем — поступаем, как с обычным текстом.
Доступ к редактированию ссылок осуществляется из контекстного меню. Кликаем по объекту или тексту, содержащему гиперссылку правой кнопкой мыши, и выбираем команду «Изменить гиперссылку»
В раскрывшемся окне «Изменение гиперссылки» в строке «Адрес» вносим необходимые изменения
Совершенно по аналогии гиперссылку можно удалить через клик в соответствующем пункте контекстного меню, или добавить, добравшись через него же до упомянутой выше строки «Адрес»
Работа с изображениями html-сообщений в Outlook-2010 требует предварительной подготовки нужных нам изображений. В привычном для вас графическом редакторе следует подогнать физические размеры вашей новой картинки, те, что измеряются в пикселях, под размер изображения, уже встроенного в тело используемого html-шаблона.
Затем, кликнув правой кнопкой на изображении в письме, выбираем в появившемся контекстном меню команду «Изменить рисунок»
Через раскрывшееся окно «Вставка рисунка» выбираем нужный файл и нажатием «Вставить» замещаем им в нашем html-письме первоначальную картинку.
Вставка же совершенно нового изображения тоже допустима. Для того чтобы внедрить в наше сообщение картинку в добавление к имеющимся, выбираем группу команд «Вставка», а в ней — «Рисунок»
Это откроет окно «Вставка рисунка», в котором и надо найти нужный нам, и завершить действие нажатием команды «Вставить».
После всех этих манипуляций, наверняка, наше письмо станет эталоном совершенства. Что ж, остаётся только дать ему путёвку в жизнь. Еще раз, для уверенности, проверяем адреса наших получателей, наличие темы, и — жмём «Отправить»
Изменение формата сообщения на HTML, RTF или обычный текст
Вы можете изменить формат сообщения при ответе на него или его пересылке. Например, если кто-то отправляет вам сообщение в виде обычного текста, можно ответить на него или переслать его в формате HTML или RTF.
То, как сообщение отображается для человека, получившего его, зависит от его почтовой программы. Например, если почтовая программа получателя настроена для преобразования сообщений, ваше письмо в формате HTML может быть преобразовано в формат обычного текста.
Доступные типы формата сообщений
Outlook предлагает три формата сообщений. Вы можете выбрать формат в зависимости от того, хотите ли использовать полужирный или курсивный текст, цвета, маркеры или фотографии в тексте сообщения.
У каждого формата есть свои преимущества.
HTML
Это стандартный формат сообщений в Outlook. Его нужно использовать, если вы хотите создавать сообщения, которые выглядят как обычные документы с различными шрифтами, цветами, маркированными и нумерованными списками, а также добавлять в текст сообщения изображения.
Обычный текст
Этот формат поддерживается всеми почтовыми программами, но в нем нет полужирного шрифта или курсива, цветных шрифтов и другого форматирования текста. Формат обычного текста также не позволяет добавлять изображения в текст сообщения, хотя их можно включать в виде вложений.
RTF
Важно: Формат HTML — это текущий формат создания по умолчанию в Outlook. RTF — это устаревший формат, и мы не планируем его усовершенствовать. В этом смысле использование RTF в зашифрованных сообщениях не рекомендуется и может столкнуться с проблемами преобразования.
RTF — это формат Майкрософт, который поддерживается только следующими почтовыми приложениями:
- клиент Microsoft Exchange версий 4.0 и 5.0;
- все версии Outlook.
Формат RTF можно применять при отправке сообщений внутри организации, в которой используется Microsoft Exchange, но мы рекомендуем использовать HTML. На самом деле, когда вы отправляете сообщение в формате RTF кому-то за пределами организации, Outlook автоматически преобразует его в HTML, поэтому форматирование и вложения сохраняются. Outlook также автоматически форматирует сообщения, которые содержат кнопки голосования, и преобразует задачи и приглашения на собрания в формат iCalendar.
Формат RTF позволяет добавлять маркированные списки, выравнивать текст и использовать другие возможности, включая добавление связанных объектов. Вложения в сообщениях формата RTF отображаются в виде значков в тексте. В HTML-сообщениях они указываются под темой.
Примечание: Сообщения RTF, зашифрованные с помощью меток, сталкиваются с ограничениями и могут быть подвержены проблемам с преобразованием.
Как отправить HTML письмо из Microsoft Outlook, Mozilla Thunderbird
В данной статье мы опишем способ отправки HTML писем из почтовых программ Microsoft Outllook 2007, 2010 и Mozilla Thunderbird.
Отправка письма в Microsoft Outllook 2007
Откройте Outlook 2007 и нажмите на кнопку «Создать» в левом верхнем углу. Откроется окно создания письма. Для того, чтобы вставить Вашу верстку, нажмите на кнопку «Вложить файл» в верхнем меню. Выберите файл с Вашим письмом. Затем нажмите на стрелку справа от «Вставить» и в выпавшем меню выберите пункт «Вставить как текст». Ваша верстка загружена в программу.
Отправка письма в Microsoft Outllook 2010
Откройте программу и нажмите “Создать сообщение” в левом верхнем углу. Далее необходимо перейти в верхней панели во вкладку “Вставка”, и нажать “Вложить файл”. Выберите Вашу верстку и нажмите на треугольник справа от кнопки “Вставить”. Выберите “Вставить как текст” и письмо будет загружено в сообщение.
Отправка письма в Mozilla Thunderbird
Создайте письмо: нажмите «Создать» в верхнем меню. Нажмите в пустом письме по области для текста и станет доступен пункт “Вставить” в верхнем меню. В нем выберите «HTML…». Далее скопируйте код Вашей верстки в открывшееся окно программы.