Office.CustomProperties interface
Das CustomProperties
-Objekt stellt benutzerdefinierte Eigenschaften dar, die für ein bestimmtes E-Mail-Element und für ein Outlook-Add-In spezifisch sind. Beispielsweise kann ein Add-In erforderlich sein, um einige Daten zu speichern, die für die aktuelle Nachricht spezifisch sind, die das Add-In aktiviert hat. Wenn der Benutzer die gleiche Nachricht in Zukunft erneut abruft und das Add-In erneut aktiviert, kann das Add-In die Daten abrufen, die als benutzerdefinierte Eigenschaften gespeichert wurden.
Weitere Informationen zu CustomProperties
finden Sie unter Abrufen und Festlegen von Add-In-Metadaten für ein Outlook-Add-In.
Hinweise
Beachten Sie folgendes, wenn Sie benutzerdefinierte Eigenschaften in Ihrem Add-In verwenden:
Benutzerdefinierte Eigenschaften, die im Verfassenmodus gespeichert werden, werden nicht an Empfänger des E-Mail-Elements übertragen. Wenn eine Nachricht oder ein Termin mit benutzerdefinierten Eigenschaften gesendet wird, kann über das Element im Ordner Gesendete Elemente auf ihre Eigenschaften zugegriffen werden. Wenn Sie benutzerdefinierte Daten für Empfänger zugänglich machen möchten, sollten Sie stattdessen InternetHeaders verwenden.
Die maximale Länge eines
CustomProperties
JSON-Objekts beträgt 2500 Zeichen.Outlook auf Mac speichert keine benutzerdefinierten Eigenschaften zwischen. Wenn das Netzwerk des Benutzers ausfällt, können E-Mail-Add-Ins nicht auf ihre benutzerdefinierten Eigenschaften zugreifen.
Mindestberechtigungsstufe: Element lesen
Anwendbarer Outlook-Modus: Verfassen oder Lesen
Methoden
get(name) | Gibt den Wert der angegebenen benutzerdefinierten Eigenschaft zurück. |
remove(name) | Entfernt die angegebene Eigenschaft aus der Auflistung benutzerdefinierter Eigenschaften. Damit die Eigenschaft dauerhaft entfernt wird, müssen Sie die |
save |
Speichert benutzerdefinierte Eigenschaften in einer Nachricht oder einem Termin. Sie müssen die Es empfiehlt sich, die Rückruffunktion auf Fehler von zu überprüfen und zu |
save |
Speichert benutzerdefinierte Eigenschaften in einer Nachricht oder einem Termin. Sie müssen die Es empfiehlt sich, die Rückruffunktion auf Fehler von zu überprüfen und zu |
set(name, value) | Legt die angegebene Eigenschaft auf den angegebenen Wert fest. Die Die |
Details zur Methode
get(name)
Gibt den Wert der angegebenen benutzerdefinierten Eigenschaft zurück.
get(name: string): any;
Parameter
- name
-
string
Der Name der benutzerdefinierten Eigenschaft, die zurückgegeben werden soll.
Gibt zurück
any
Der Wert der angegebenen benutzerdefinierten Eigenschaft.
Hinweise
Mindestberechtigungsstufe: Element lesen
Anwendbarer Outlook-Modus: Verfassen oder Lesen
Beispiele
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/15-item-custom-properties/load-set-get-save.yaml
const propertyName = $("#propertyName").val();
const propertyValue = customProps.get(propertyName);
$("#propertyValue").val(propertyValue);
console.log(`The value of custom property "${propertyName}" is "${propertyValue}".`);
remove(name)
Entfernt die angegebene Eigenschaft aus der Auflistung benutzerdefinierter Eigenschaften.
Damit die Eigenschaft dauerhaft entfernt wird, müssen Sie die saveAsync
-Methode des CustomProperties
-Objekts aufrufen.
remove(name: string): void;
Parameter
- name
-
string
Der name
der zu entfernenden Eigenschaft.
Gibt zurück
void
Hinweise
Mindestberechtigungsstufe: Element lesen
Anwendbarer Outlook-Modus: Verfassen oder Lesen
Beispiele
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/15-item-custom-properties/load-set-get-save.yaml
const propertyName = $("#propertyName").val();
customProps.remove(propertyName);
console.log(`Custom property "${propertyName}" removed.`);
saveAsync(callback, asyncContext)
Speichert benutzerdefinierte Eigenschaften in einer Nachricht oder einem Termin.
Sie müssen die saveAsync
-Methode aufrufen, um alle mit der set
-Methode oder der remove
-Methode des CustomProperties
-Objekts vorgenommenen Änderungen beizubehalten. Die Speichernaktion ist asynchron.
Es empfiehlt sich, die Rückruffunktion auf Fehler von zu überprüfen und zu saveAsync
behandeln. Insbesondere kann ein Lese-Add-In aktiviert werden, während sich der Benutzer in einem Leseformular in einem verbundenen Zustand befindet und der Benutzer anschließend getrennt wird. Wenn das Add-In im getrennten Zustand aufruft saveAsync
, saveAsync
würde einen Fehler zurückgeben. Die Rückruffunktion sollte diesen Fehler entsprechend behandeln.
saveAsync(callback: (asyncResult: Office.AsyncResult<void>) => void, asyncContext?: any): void;
Parameter
- callback
-
(asyncResult: Office.AsyncResult<void>) => void
Wenn die -Methode abgeschlossen ist, wird die im callback
-Parameter übergebene Funktion mit einem einzelnen Parameter vom Typ Office.AsyncResult
aufgerufen.
- asyncContext
-
any
Optional. Alle Zustandsdaten, die an die Rückruffunktion übergeben werden.
Gibt zurück
void
Hinweise
Wichtig: In Outlook unter Windows werden benutzerdefinierte Eigenschaften, die während des Verfassenmodus gespeichert wurden, nur beibehalten, nachdem das zusammengestellte Element geschlossen wurde oder nach Office.context.mailbox.item.saveAsync
dem Aufruf aufgerufen wurde.
Mindestberechtigungsstufe: Element lesen
Anwendbarer Outlook-Modus: Verfassen oder Lesen
Beispiele
// The following JavaScript code sample shows how to asynchronously use
// the loadCustomPropertiesAsync method to load custom properties that
// are specific to the current item, and the saveAsync method to save
// these to the mail item. After loading the custom properties,
// the code sample uses the get method to read the custom property myProp,
// the set method to write the custom property myProp, and then finally
// calls the saveAsync method to save the custom properties.
// The initialize function is required for all add-ins.
Office.initialize = function () {
// Checks for the DOM to load using the jQuery ready method.
$(document).ready(function () {
// After the DOM is loaded, add-in-specific code can run.
const item = Office.context.mailbox.item;
item.loadCustomPropertiesAsync(customPropsCallback);
});
};
function customPropsCallback(asyncResult) {
const customProps = asyncResult.value;
const myProp = customProps.get("myProp");
console.log("myProp: " + myProp); // First run on current item will return `undefined`.
// Set myProp custom property.
customProps.set("myProp", "value");
customProps.saveAsync(saveCallback);
}
function saveCallback(asyncResult) {
if (asyncResult.status === Office.AsyncResultStatus.Failed) {
console.error(asyncResult.error.message);
}
else {
// Async call to save custom properties completed.
// Proceed to do the appropriate for your add-in.
}
}
saveAsync(asyncContext)
Speichert benutzerdefinierte Eigenschaften in einer Nachricht oder einem Termin.
Sie müssen die saveAsync
-Methode aufrufen, um alle mit der set
-Methode oder der remove
-Methode des CustomProperties
-Objekts vorgenommenen Änderungen beizubehalten. Die Speichernaktion ist asynchron.
Es empfiehlt sich, die Rückruffunktion auf Fehler von zu überprüfen und zu saveAsync
behandeln. Insbesondere kann ein Lese-Add-In aktiviert werden, während sich der Benutzer in einem Leseformular in einem verbundenen Zustand befindet und der Benutzer anschließend getrennt wird. Wenn das Add-In im getrennten Zustand aufruft saveAsync
, saveAsync
würde einen Fehler zurückgeben. Die Rückruffunktion sollte diesen Fehler entsprechend behandeln.
saveAsync(asyncContext?: any): void;
Parameter
- asyncContext
-
any
Optional. Alle Zustandsdaten, die an die Rückruffunktion übergeben werden.
Gibt zurück
void
Hinweise
Mindestberechtigungsstufe: Element lesen
Anwendbarer Outlook-Modus: Verfassen oder Lesen
set(name, value)
Legt die angegebene Eigenschaft auf den angegebenen Wert fest.
Die set
-Methode legt die angegebene Eigenschaft auf den angegebenen Wert fest. Um sicherzustellen, dass die set-Eigenschaft und der -Wert für das E-Mail-Element beibehalten werden, müssen Sie die saveAsync
-Methode aufrufen.
Die set
-Methode erstellt eine neue Eigenschaft, wenn die angegebene Eigenschaft noch nicht vorhanden ist. Andernfalls wird der vorhandene Wert durch den neuen Wert ersetzt. Der value
Parameter kann einen beliebigen Typ aufweisen. Er wird jedoch immer als Zeichenfolge an den Server übergeben.
set(name: string, value: string): void;
Parameter
- name
-
string
Der Name der festzulegenden Eigenschaft.
- value
-
string
Der Wert der festzulegenden Eigenschaft.
Gibt zurück
void
Hinweise
Mindestberechtigungsstufe: Element lesen
Anwendbarer Outlook-Modus: Verfassen oder Lesen
Beispiele
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/15-item-custom-properties/load-set-get-save.yaml
const propertyName = $("#propertyName").val();
const propertyValue = $("#propertyValue").val();
customProps.set(propertyName, propertyValue);
console.log(`Custom property "${propertyName}" set to value "${propertyValue}".`);
Office Add-ins
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für