Office.AppointmentForm interface
Das AppointmentForm -Objekt wird verwendet, um auf den aktuell ausgewählten Termin zuzugreifen.
Hinweise
Mindestberechtigungsstufe: eingeschränkt
Anwendbarer Outlook-Modus: Compose oder Lesen
Beispiele
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/55-display-items/display-new-appointment.yaml
const start = new Date();
const end = new Date();
end.setHours(start.getHours() + 1);
// The async version is only available starting with requirement set 1.9,
// and provides a callback when the new appointment form has been created.
Office.context.mailbox.displayNewAppointmentFormAsync(
{
requiredAttendees: ["bob@contoso.com"],
optionalAttendees: ["sam@contoso.com"],
start: start,
end: end,
location: "Home",
subject: "meeting",
resources: ["projector@contoso.com"],
body: "Hello World!"
},
function(asyncResult) {
console.log(JSON.stringify(asyncResult));
}
);
Eigenschaften
| body | Ruft ein Objekt ab, das Methoden zum Bearbeiten des Textkörpers eines Elements bereitstellt. |
| end | Ruft Datum und Zeit für das Ende des Termins ab oder legt diese fest. Die Lesemodus Die Verfassenmodus Die Wenn Sie die |
| location | Ruft den Ort eines Termins ab bzw. legt ihn fest. Lesemodus Die Verfassenmodus Die |
| optional |
Bietet Zugriff auf die optionalen Teilnehmer eines Ereignisses. Der Typ des Objekts und die Zugriffsebene hängen vom Modus des aktuellen Elements ab. Lesemodus Die
Verfassenmodus Die |
| required |
Bietet Zugriff auf die erforderlichen Teilnehmer eines Ereignisses. Der Typ des Objekts und die Zugriffsebene hängen vom Modus des aktuellen Elements ab. Lesemodus Die
Verfassenmodus Die |
| resources | Ermöglicht den Zugriff auf die Ressourcen eines Ereignisses. Gibt ein Array von Zeichenfolgen zurück, die die für den Termin erforderlichen Ressourcen enthalten. |
| start | Ruft Datum und Zeit für den Beginn des Termins ab oder legt Datum und Uhrzeit fest. Die Lesemodus Die Verfassenmodus Die Wenn Sie die |
| subject | Ruft die Beschreibung ab, die im Betrefffeld eines Elements angezeigt wird, oder legt sie fest. Die Lesemodus Die Verfassenmodus Die |
Details zur Eigenschaft
body
Ruft ein Objekt ab, das Methoden zum Bearbeiten des Textkörpers eines Elements bereitstellt.
body: Body | string;Eigenschaftswert
Office.Body | string
Hinweise
Mindestberechtigungsstufe: Element lesen
Anwendbarer Outlook-Modus: Compose oder Lesen
end
Ruft Datum und Zeit für das Ende des Termins ab oder legt diese fest.
Die end-Eigenschaft wird als Datums- und Uhrzeitwert in UTC ausgedrückt. Sie können die convertToLocalClientTime -Methode verwenden, um den end Eigenschaftswert in das lokale Datum und die lokale Uhrzeit des Clients zu konvertieren.
Lesemodus
Die end-Eigenschaft gibt ein Date-Objekt zurück.
Verfassenmodus
Die end-Eigenschaft gibt ein Time-Objekt zurück.
Wenn Sie die Time.setAsync-Methode verwenden, um die Endzeit im Verfassenmodus festzulegen, sollten Sie die convertToUtcClientTime-Methode verwenden, um die Ortszeit auf dem Client für den Server in UTC umzuwandeln.
end: Time | Date;Eigenschaftswert
Office.Time | Date
Hinweise
Mindestberechtigungsstufe: Element lesen
Anwendbarer Outlook-Modus: Compose oder Lesen
location
Ruft den Ort eines Termins ab bzw. legt ihn fest.
Lesemodus
Die location-Eigenschaft gibt eine Zeichenfolge zurück, die den Ort des Termins enthält.
Verfassenmodus
Die location-Eigenschaft gibt ein Location-Objekt zurück, das Methoden zum Abrufen und Festlegen des Orts für einen Termin bereitstellt.
location: Location | string;Eigenschaftswert
Office.Location | string
Hinweise
Mindestberechtigungsstufe: Element lesen
Anwendbarer Outlook-Modus: Compose oder Lesen
optionalAttendees
Bietet Zugriff auf die optionalen Teilnehmer eines Ereignisses. Der Typ des Objekts und die Zugriffsebene hängen vom Modus des aktuellen Elements ab.
Lesemodus
Die optionalAttendees -Eigenschaft gibt ein Array zurück, das ein EmailAddressDetails-Objekt für jeden optionalen Teilnehmer an der Besprechung enthält. Größenbeschränkungen für Sammlungen:
Webbrowser, neue Mac-Benutzeroberfläche, Android: Kein Limit
Windows (neu und klassisch): 500 Mitglieder
Windows (klassisch – in der Vorschau ab Version 2511 (Build 19426.20000)): 1.000 Mitglieder
Klassische Mac-Benutzeroberfläche: 100 Mitglieder
Verfassenmodus
Die optionalAttendees-Eigenschaft gibt ein Recipients-Objekt zurück, das Methoden zum Abrufen oder Aktualisieren der optionalen Teilnehmer für eine Besprechung bereitstellt. Je nach Client/Plattform (z. B. Windows, Mac usw.) gelten jedoch Grenzwerte für die Anzahl der Empfänger, die Sie abrufen oder aktualisieren können. Weitere Informationen finden Sie im Recipients-Objekt .
optionalAttendees: Recipients[] | EmailAddressDetails[];Eigenschaftswert
Hinweise
Mindestberechtigungsstufe: Element lesen
Anwendbarer Outlook-Modus: Compose oder Lesen
requiredAttendees
Bietet Zugriff auf die erforderlichen Teilnehmer eines Ereignisses. Der Typ des Objekts und die Zugriffsebene hängen vom Modus des aktuellen Elements ab.
Lesemodus
Die requiredAttendees -Eigenschaft gibt ein Array zurück, das ein EmailAddressDetails-Objekt für jeden erforderlichen Teilnehmer an der Besprechung enthält. Größenbeschränkungen für Sammlungen:
Webbrowser, neue Mac-Benutzeroberfläche, Android: Kein Limit
Windows: 500 Mitglieder
Windows (klassisch – in der Vorschau ab Version 2511 (Build 19426.20000)): 1.000 Mitglieder
Klassische Mac-Benutzeroberfläche: 100 Mitglieder
Verfassenmodus
Die requiredAttendees-Eigenschaft gibt ein Recipients-Objekt zurück, das Methoden zum Abrufen oder Aktualisieren der erforderlichen Teilnehmer für eine Besprechung bereitstellt. Je nach Client/Plattform (z. B. Windows, Mac usw.) gelten jedoch Grenzwerte für die Anzahl der Empfänger, die Sie abrufen oder aktualisieren können. Weitere Informationen finden Sie im Recipients-Objekt .
requiredAttendees: Recipients[] | EmailAddressDetails[];Eigenschaftswert
Hinweise
Mindestberechtigungsstufe: Element lesen
Anwendbarer Outlook-Modus: Compose oder Lesen
resources
Ermöglicht den Zugriff auf die Ressourcen eines Ereignisses. Gibt ein Array von Zeichenfolgen zurück, die die für den Termin erforderlichen Ressourcen enthalten.
resources: string[];Eigenschaftswert
string[]
Hinweise
Mindestberechtigungsstufe: Element lesen
Anwendbarer Outlook-Modus: Compose oder Lesen
start
Ruft Datum und Zeit für den Beginn des Termins ab oder legt Datum und Uhrzeit fest.
Die start-Eigenschaft wird als Datums- und Uhrzeitwert in UTC ausgedrückt. Sie können die convertToLocalClientTime -Methode verwenden, um den Wert in das lokale Datum und die lokale Uhrzeit des Clients zu konvertieren.
Lesemodus
Die start-Eigenschaft gibt ein Date-Objekt zurück.
Verfassenmodus
Die start-Eigenschaft gibt ein Time-Objekt zurück.
Wenn Sie die Time.setAsync-Methode verwenden, um die Startzeit im Verfassenmodus festzulegen, sollten Sie die convertToUtcClientTime-Methode verwenden, um die Ortszeit auf dem Client für den Server in UTC umzuwandeln.
start: Time | Date;Eigenschaftswert
Office.Time | Date
Hinweise
Mindestberechtigungsstufe: Element lesen
Anwendbarer Outlook-Modus: Compose oder Lesen
subject
Ruft die Beschreibung ab, die im Betrefffeld eines Elements angezeigt wird, oder legt sie fest.
Die subject-Eigenschaft ruft den gesamten Betreff des Elements ab oder legt ihn fest – so, wie er vom E-Mail-Server gesendet wird.
Lesemodus
Die subject-Eigenschaft gibt eine Zeichenfolge zurück. Verwenden Sie die normalizedSubject -Eigenschaft, um den Betreff abzüglich aller führenden Präfixe wie RE: und FW:abzurufen.
Verfassenmodus
Die subject-Eigenschaft gibt ein Subject-Objekt zurück, das Methoden zum Abrufen und Festlegen des Betreffs bereitstellt.
subject: Subject | string;Eigenschaftswert
Office.Subject | string
Hinweise
Mindestberechtigungsstufe: Element lesen
Anwendbarer Outlook-Modus: Compose oder Lesen