Отправлять приглашения на собрания Outlook без Outlook? - PullRequest
37 голосов
/ 20 января 2009

Мне просто интересно, можно ли отправлять приглашения на собрания людям, не установив Outlook на сервер и не используя COM Interop (которого я хочу избежать на сервере любой ценой).

У нас Exchange 2003 в домене Windows 2003, и все пользователи являются пользователями домена. Я полагаю, что могу отправить «круглый iCal / vCal» или что-то в этом роде, но мне интересно, существует ли правильный стандартный способ отправки приглашений на собрания через Exchange без Outlook?

Это C # /. Net, если это имеет значение.

Ответы [ 5 ]

49 голосов
/ 20 января 2009

Способ отправки приглашения на собрание в Outlook (и его распознание) выглядит следующим образом:

  • подготовьте файл iCalendar, обязательно установите эти дополнительные свойства, так как они нужны Outlook:
  • подготовить multipart/alternative почту:
    • Часть 1: text/html (или как вам угодно) - это отображается для «обычных» почтовых читателей или в качестве запасного варианта и содержит сводную информацию о событии в удобочитаемой форме
    • Часть 2: text/calendar; method=REQUEST, содержит содержимое файла ics (параметр заголовка method должен соответствовать методу в ics). Не упустите правильную кодировку текста, объявление параметра заголовка charset не повредит.
    • Часть 3: При желании прикрепите сам файл .ics, чтобы обычные читатели почты могли предложить пользователю что-нибудь щелкнуть. Outlook на самом деле не требует вложения, потому что он просто читает часть text/calendar.
  • Отправьте письмо пользователю Outlook. Если вы все сделали правильно, письмо отобразится в виде приглашения на собрание, с кнопками посещаемости и автоматической записью в календаре пользователей после принятия.
  • Настройте что-то, что обрабатывает ответы (они отправляются организатору собрания). Мне пока не удалось настроить автоматическое отслеживание посетителей для работы с почтовым ящиком Exchange, поскольку событие не существует в календаре организаторов. Outlook требует UID и SEQUENCES, чтобы соответствовать его ожиданиям, но с UID, который вы создали, это вряд ли сработает.

Для получения дополнительной информации о деталях и особенностях формата файла ics обязательно посетите выдержки из спецификаций iCalendar от Masahide Kanzaki . Они свет в темноте, намного лучше, чем грызть ваш путь через RFC 2445 . Но опять же, может быть, есть удобная библиотека для .NET.

8 голосов
/ 17 октября 2012

См. Библиотеку DDay.iCal C # на sourceforge:
http://sourceforge.net/projects/dday-ical/

Тогда прочитайте эту кодовую статью проекта:
http://www.codeproject.com/Articles/17980/Adding-iCalendar-Support-to-Your-Program-Part-1

И прочитайте это:
Экспорт события с C # в формат iCalendar и vCalendar

5 голосов
/ 19 августа 2014

iCalendar - это отличное решение общего назначения, а библиотека DDay.iCal - отличный способ сделать это из .NET, но я считаю, Exchange Web Services (EWS) - лучшее решение в контекст исходного вопроса (Exchange, C # /. NET).

А если вы используете язык .NET, такой как C #, вам следует использовать оболочку EWS Managed API , которая значительно упрощает работу с EWS.

Начиная с документов , как использовать управляемый API EWS для создания собрания и отправки запроса приглашенным:

// Create the appointment.
Appointment appointment = new Appointment(service);

// Set properties on the appointment. Add two required attendees and one optional attendee.
appointment.Subject = "Status Meeting";
appointment.Body = "The purpose of this meeting is to discuss status.";
appointment.Start = new DateTime(2009, 3, 1, 9, 0, 0);
appointment.End = appointment.Start.AddHours(2);
appointment.Location = "Conf Room";
appointment.RequiredAttendees.Add("user1@contoso.com");
appointment.RequiredAttendees.Add("user2@contoso.com");
appointment.OptionalAttendees.Add("user3@contoso.com");

// Send the meeting request to all attendees and save a copy in the Sent Items folder.
appointment.Save(SendInvitationsMode.SendToAllAndSaveCopy);
4 голосов
/ 24 апреля 2014

Приведенный ниже код отправит приглашение на собрание таким образом, что Outlook отобразит кнопки «Принять / Отклонить».

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

Также обратите внимание, что вам необходимо заменить CREATED, DTSTART, DTEND, DTSTAMP, LAST-MODIFIED. Это дата / время UTC.

    var m = new MailMessage();

    m.Subject = "Meeting";

    m.Body = "";

    string iCal = 
@"BEGIN:VCALENDAR
PRODID:-//Microsoft Corporation//Outlook 14.0 MIMEDIR//EN
VERSION:2.0
METHOD:PUBLISH
X-MS-OLK-FORCEINSPECTOROPEN:TRUE
BEGIN:VEVENT
CLASS:PUBLIC
CREATED:20140423T045933Z
DESCRIPTION:desc
DTEND:20140430T080000Z
DTSTAMP:20140423T045933Z
DTSTART:20140430T060000Z
LAST-MODIFIED:20140423T045933Z
LOCATION:location...
PRIORITY:5
SEQUENCE:0
SUMMARY;LANGUAGE=en-us:Summary...
TRANSP:OPAQUE
UID:D8BFD357-88A7-455C-86BC-C2CECA9AC5C6
X-MICROSOFT-CDO-BUSYSTATUS:BUSY
X-MICROSOFT-CDO-IMPORTANCE:1
X-MICROSOFT-DISALLOW-COUNTER:FALSE
X-MS-OLK-AUTOFILLLOCATION:FALSE
X-MS-OLK-CONFTYPE:0
BEGIN:VALARM
TRIGGER:-PT60M
ACTION:DISPLAY
DESCRIPTION:Reminder
END:VALARM
END:VEVENT
END:VCALENDAR";

    using (var iCalView = AlternateView.CreateAlternateViewFromString(iCal, new System.Net.Mime.ContentType("text/calendar")))
    {
        m.AlternateViews.Add(iCalView);

        var c = new SmtpClient();

        // Send message
        c.Send(m);
    }

Предполагается, что в вашем конфигурационном файле настроен локальный SMTP-сервер:

  <system.net>
    <mailSettings>
      <smtp deliveryMethod="Network" from="no-reply@example.com">
        <network defaultCredentials="true" host="smtp.example.local" />
      </smtp>
    </mailSettings>
  </system.net>
3 голосов
/ 04 октября 2014

Вы можете отправлять приглашения на собрания по почте в Outlook, используя Стандарт iCal (RFC 5545)

Вы не можете отправлять вещи таким образом. Вы можете отправлять «Встречи», но они выглядят в Outlook как приложения .ics, которые должны приниматься «вслепую».

Приглашения на собрание появляются в Outlook с хорошим предварительным просмотром и могут быть приняты или отклонены. Программа отправки может изменить или отменить собрание после его отправки.

Легко создать действительный элемент iCal с помощью библиотеки DDay.iCal .Net

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

Код создает письмо с:

  • текстовое тело для простых почтовых клиентов
  • Тело HTML для diplay в современных почтовых клиентах
  • приглашение на собрание iCal в качестве AlternateView (будет отображаться в Outlook)
  • приглашение на собрание iCal в качестве вложения (может использоваться в почтовых клиентах, отличных от outlook)

Код показывает, как добавить:

  • текст описания в виде HTML, выглядит лучше в перспективе
  • Приоритет, видимость (общедоступный / частный / конфиденциальный)
  • опциональный органайзер (будет отображаться в outlook вместо отправителя почты)
  • опциональные участники
  • опциональный будильник
  • дополнительные приложения к собранию. будет отображаться в календаре outlook

Некоторые важные детали:

  • отправитель почты (или дополнительный органайзер) и получатель почты должны отличаться, чтобы сделать эту работу в outlook
  • МЕТОД в .ics и МЕТОД в Mime.ContentType должны совпадать
  • Встреча должна состояться в будущем, чтобы сделать эту работу в перспективе
  • часть .ics должна быть последней альтернативной частью в письме MIME

Точные подробности о том, как outlook интерпретирует файлы .ics, подробно описаны в [MS-OXCICAL]: алгоритм преобразования объектов iCalendar в Appointment

Мы будем использовать эти сборки:

using System;
using System.IO;
using System.Net.Mail;
using DDay.iCal;
using DDay.iCal.Serialization.iCalendar;

Для DDay.iCal достаточно загрузить двоичные файлы DDay.iCal . Если вы хотите добавить некоторые функции, лучше всего взглянуть на исходники DDay.iCal, поскольку документация устарела, и источники содержат довольно полные тесты, в которых описаны все его функции.

const string filepath = @"C:\temp\ical.test.ics";
// use PUBLISH for appointments
// use REQUEST for meeting requests
const string METHOD = "REQUEST";

// Properties of the meeting request
// keep guid in sending program to modify or cancel the request later
Guid uid = Guid.Parse("2B127C67-73B3-43C5-A804-5666C2CA23C9");
string VisBetreff = "This is the subject of the meeting request";
string TerminVerantwortlicherEmail = "mr.asker@myorg.com";
string bodyPlainText = "This is the simple iCal plain text msg";
string bodyHtml = "This is the simple <b>iCal HTML message</b>";
string location = "Meeting room 101";
// 1: High
// 5: Normal
// 9: low
int priority = 1;
//=====================================
MailMessage message = new MailMessage();

message.From = new MailAddress("sender@myorg.com");
message.To.Add(new MailAddress(TerminVerantwortlicherEmail));
message.Subject = "[VIS-Termin] " + VisBetreff;

// Plain Text Version
message.Body = bodyPlainText;

// HTML Version
string htmlBody = bodyHtml;
AlternateView HTMLV = AlternateView.CreateAlternateViewFromString(htmlBody,
  new System.Net.Mime.ContentType("text/html"));

// iCal
IICalendar iCal = new iCalendar();
iCal.Method = METHOD;
iCal.ProductID = "My Metting Product";            

// Create an event and attach it to the iCalendar.
Event evt = iCal.Create<Event>();
evt.UID = uid.ToString();

evt.Class = "PUBLIC";
// Needed by Outlook
evt.Created = new iCalDateTime(DateTime.Now);

evt.DTStamp = new iCalDateTime(DateTime.Now);
evt.Transparency = TransparencyType.Transparent;

// Set the event start / end times
evt.Start = new iCalDateTime(2014, 10, 3, 8, 0, 0); 
evt.End = new iCalDateTime(2014, 10, 3, 8, 15, 0); 
evt.Location = location;

//var organizer = new Organizer("the.organizer@myCompany.com");
//evt.Organizer = organizer;

// Set the longer description of the event, plain text
evt.Description = bodyPlainText;

// Event description HTML text
// X-ALT-DESC;FMTTYPE=text/html
var prop = new CalendarProperty("X-ALT-DESC");
prop.AddParameter("FMTTYPE", "text/html");
prop.AddValue(bodyHtml);
evt.AddProperty(prop);

// Set the one-line summary of the event
evt.Summary = VisBetreff;
evt.Priority = priority;

//--- attendes are optional
IAttendee at = new Attendee("mailto:Peter.Black@MyOrg.com");
at.ParticipationStatus = "NEEDS-ACTION";
at.RSVP = true;
at.Role = "REQ-PARTICIPANT";
evt.Attendees.Add(at);

// Let’s also add an alarm on this event so we can be reminded of it later.
Alarm alarm = new Alarm();

// Display the alarm somewhere on the screen.
alarm.Action = AlarmAction.Display;

// This is the text that will be displayed for the alarm.
alarm.Summary = "Upcoming meeting: " + VisBetreff;

// The alarm is set to occur 30 minutes before the event
alarm.Trigger = new Trigger(TimeSpan.FromMinutes(-30));

//--- Attachments
string filename = "Test.docx";

// Add an attachment to this event
IAttachment attachment = new DDay.iCal.Attachment();
attachment.Data = ReadBinary(@"C:\temp\Test.docx");
attachment.Parameters.Add("X-FILENAME", filename);
evt.Attachments.Add(attachment);

iCalendarSerializer serializer = new iCalendarSerializer();
serializer.Serialize(iCal, filepath);

// the .ics File as a string
string iCalStr = serializer.SerializeToString(iCal);

// .ics as AlternateView (used by Outlook)
// text/calendar part: method=REQUEST
System.Net.Mime.ContentType calendarType = 
  new System.Net.Mime.ContentType("text/calendar");
calendarType.Parameters.Add("method", METHOD);
AlternateView ICSview =
  AlternateView.CreateAlternateViewFromString(iCalStr, calendarType);

// Compose
message.AlternateViews.Add(HTMLV);
message.AlternateViews.Add(ICSview); // must be the last part

// .ics as Attachment (used by mail clients other than Outlook)
Byte[] bytes = System.Text.Encoding.ASCII.GetBytes(iCalStr);
var ms = new System.IO.MemoryStream(bytes);
var a = new System.Net.Mail.Attachment(ms,
  "VIS-Termin.ics", "text/calendar");
message.Attachments.Add(a);     

// Send Mail
SmtpClient client = new SmtpClient();
client.Send(message);

Здесь функция ReadBinary ():

private static byte[] ReadBinary(string fileName)
{
    byte[] binaryData = null;
    using (FileStream reader = new FileStream(fileName,
      FileMode.Open, FileAccess.Read))
    {
        binaryData = new byte[reader.Length];
        reader.Read(binaryData, 0, (int)reader.Length);
    }
    return binaryData;
}

Проще всего настроить SmtpClient в файле конфигурации следующим образом:

<configuration>
  ...
  <system.net>  
    <mailSettings>
      <smtp>
        <network host="mysmtp.server.com" port="25" userName="mySmtpUserName" password="myPassword" />
      </smtp>
    </mailSettings>
  </system.net>
  ...
...