Excel.DocumentTaskChange class

Paket:

excel

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Stellt eine aufgezeichnete Änderung an der Aufgabe dar.

Extends

OfficeExtension.ClientObject

Hinweise

[ API-Satz: ExcelApi BETA (NUR VORSCHAU) ]

Eigenschaften

assignee	Stellt den Benutzer dar, der der Aufgabe für eine assign Änderungsaktion zugewiesen ist, oder den Benutzer, der der Aufgabe für eine Änderungsaktion unassign zugewiesen wurde.
changedBy	Stellt die Identität des Benutzers dar, der die Aufgabenänderung vorgenommen hat.
commentId	Stellt die ID des comment oder commentReply dar, an dem die Aufgabenänderung verankert ist.
context	Der Anforderungskontext, der dem -Objekt zugeordnet ist. Dadurch wird der Prozess des Add-Ins mit dem Prozess der Office-Hostanwendung verbunden.
createdDateTime	Stellt das Erstellungsdatum und die Erstellungszeit des Vorgangsänderungsdatensatzes dar. Alle Datumsangaben sind in UTC angegeben.
dueDateTime	Stellt das Fälligkeitsdatum und die Fälligkeitszeit des Vorgangs dar. Sie wird für die Änderungsaktion setSchedule verwendet. Sie befindet sich in der UTC-Zeitzone. Sie kann auf null festgelegt werden, um das Fälligkeitsdatum und die Fälligkeitszeit zu entfernen. Es sollte zusammen mit startDateTime festgelegt werden, um Konflikte zu vermeiden.
id	Die eindeutige GUID der Aufgabe ändert sich.
percentComplete	Stellt den Abschlussprozentsatz des Vorgangs dar. Sie wird für die Änderungsaktion setPercentComplete verwendet. Dies ist ein Wert zwischen 0 und 100, wobei 100 eine abgeschlossene Aufgabe darstellt. Wenn Sie diesen Wert in 100 ändern, wird auch der zugehörige Kommentar abgeschlossen. Das Ändern der Vervollständigung von 100 in einen niedrigeren Wert reaktiviert den zugehörigen Kommentar.
priority	Stellt die Priorität des Vorgangs dar. Sie wird für die Änderungsaktion setPriority verwendet. Dies ist ein Wert zwischen 0 und 10, wobei 5 die Standardpriorität ist, wenn nicht festgelegt, und 0 steht für die höchste Priorität.
startDateTime	Stellt das Startdatum und die Startzeit des Vorgangs dar. Sie wird für die Änderungsaktion setSchedule verwendet. Sie befindet sich in der UTC-Zeitzone. Sie kann auf null festgelegt werden, um das Startdatum und die Startzeit zu entfernen. Es sollte zusammen mit dueDateTime festgelegt werden, um Konflikte zu vermeiden.
title	Stellt den Titel des Vorgangs dar. Sie wird für die Änderungsaktion setTitle verwendet.
type	Stellt den Aktionstyp des Vorgangsänderungsdatensatzes dar. Beispiele für Aktionstypen sind assign, undound setPriority.
undoChangeId	Stellt die DocumentTaskChange.id Eigenschaft dar, die für die undo Änderungsaktion rückgängig wurde.

Methoden

load(options)	Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.
load(propertyNames)	Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.
load(propertyNamesAndPaths)	Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.
newObject(context)	Erstellen einer neuen instance des Excel.DocumentTaskChange-Objekts
toJSON()	Überschreibt die JavaScript-Methode toJSON() , um eine nützlichere Ausgabe bereitzustellen, wenn ein API-Objekt an JSON.stringify()übergeben wird. (JSON.stringifyruft wiederum die toJSON -Methode des Objekts auf, das an das Objekt übergeben wird.) Während das ursprüngliche Excel.DocumentTaskChange-Objekt ein API-Objekt ist, gibt die toJSON Methode ein einfaches JavaScript-Objekt (typisiert als Excel.Interfaces.DocumentTaskChangeData) zurück, das flache Kopien aller geladenen untergeordneten Eigenschaften aus dem ursprünglichen Objekt enthält.

Details zur Eigenschaft

assignee

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Stellt den Benutzer dar, der der Aufgabe für eine assign Änderungsaktion zugewiesen ist, oder den Benutzer, der der Aufgabe für eine Änderungsaktion unassign zugewiesen wurde.

readonly assignee: Excel.EmailIdentity;

Eigenschaftswert

Excel.EmailIdentity

Hinweise

[ API-Satz: ExcelApi BETA (NUR VORSCHAU) ]

changedBy

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Stellt die Identität des Benutzers dar, der die Aufgabenänderung vorgenommen hat.

readonly changedBy: Excel.EmailIdentity;

Eigenschaftswert

Excel.EmailIdentity

Hinweise

[ API-Satz: ExcelApi BETA (NUR VORSCHAU) ]

commentId

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Stellt die ID des comment oder commentReply dar, an dem die Aufgabenänderung verankert ist.

readonly commentId: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: ExcelApi BETA (NUR VORSCHAU) ]

context

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Der Anforderungskontext, der dem -Objekt zugeordnet ist. Dadurch wird der Prozess des Add-Ins mit dem Prozess der Office-Hostanwendung verbunden.

context: RequestContext;

Eigenschaftswert

Excel.RequestContext

createdDateTime

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Stellt das Erstellungsdatum und die Erstellungszeit des Vorgangsänderungsdatensatzes dar. Alle Datumsangaben sind in UTC angegeben.

readonly createdDateTime: Date;

Eigenschaftswert

Date

Hinweise

[ API-Satz: ExcelApi BETA (NUR VORSCHAU) ]

dueDateTime

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Stellt das Fälligkeitsdatum und die Fälligkeitszeit des Vorgangs dar. Sie wird für die Änderungsaktion setSchedule verwendet. Sie befindet sich in der UTC-Zeitzone. Sie kann auf null festgelegt werden, um das Fälligkeitsdatum und die Fälligkeitszeit zu entfernen. Es sollte zusammen mit startDateTime festgelegt werden, um Konflikte zu vermeiden.

readonly dueDateTime: Date;

Eigenschaftswert

Date

Hinweise

[ API-Satz: ExcelApi BETA (NUR VORSCHAU) ]

id

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Die eindeutige GUID der Aufgabe ändert sich.

readonly id: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: ExcelApi BETA (NUR VORSCHAU) ]

percentComplete

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Stellt den Abschlussprozentsatz des Vorgangs dar. Sie wird für die Änderungsaktion setPercentComplete verwendet. Dies ist ein Wert zwischen 0 und 100, wobei 100 eine abgeschlossene Aufgabe darstellt. Wenn Sie diesen Wert in 100 ändern, wird auch der zugehörige Kommentar abgeschlossen. Das Ändern der Vervollständigung von 100 in einen niedrigeren Wert reaktiviert den zugehörigen Kommentar.

readonly percentComplete: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: ExcelApi BETA (NUR VORSCHAU) ]

priority

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Stellt die Priorität des Vorgangs dar. Sie wird für die Änderungsaktion setPriority verwendet. Dies ist ein Wert zwischen 0 und 10, wobei 5 die Standardpriorität ist, wenn nicht festgelegt, und 0 steht für die höchste Priorität.

readonly priority: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: ExcelApi BETA (NUR VORSCHAU) ]

startDateTime

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Stellt das Startdatum und die Startzeit des Vorgangs dar. Sie wird für die Änderungsaktion setSchedule verwendet. Sie befindet sich in der UTC-Zeitzone. Sie kann auf null festgelegt werden, um das Startdatum und die Startzeit zu entfernen. Es sollte zusammen mit dueDateTime festgelegt werden, um Konflikte zu vermeiden.

readonly startDateTime: Date;

Eigenschaftswert

Date

Hinweise

[ API-Satz: ExcelApi BETA (NUR VORSCHAU) ]

title

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Stellt den Titel des Vorgangs dar. Sie wird für die Änderungsaktion setTitle verwendet.

readonly title: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: ExcelApi BETA (NUR VORSCHAU) ]

type

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Stellt den Aktionstyp des Vorgangsänderungsdatensatzes dar. Beispiele für Aktionstypen sind assign, undound setPriority.

readonly type: Excel.DocumentTaskChangeAction | "unknown" | "create" | "assign" | "unassign" | "unassignAll" | "setSchedule" | "setPercentComplete" | "setPriority" | "remove" | "restore" | "setTitle" | "undo";

Eigenschaftswert

Excel.DocumentTaskChangeAction | "unknown" | "create" | "assign" | "unassign" | "unassignAll" | "setSchedule" | "setPercentComplete" | "setPriority" | "remove" | "restore" | "setTitle" | "undo"

Hinweise

[ API-Satz: ExcelApi BETA (NUR VORSCHAU) ]

undoChangeId

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Stellt die DocumentTaskChange.id Eigenschaft dar, die für die undo Änderungsaktion rückgängig wurde.

readonly undoChangeId: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: ExcelApi BETA (NUR VORSCHAU) ]

Details zur Methode

load(options)

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.

load(options?: Excel.Interfaces.DocumentTaskChangeLoadOptions): Excel.DocumentTaskChange;

Parameter

options

Excel.Interfaces.DocumentTaskChangeLoadOptions

Stellt Optionen dafür bereit, welche Eigenschaften des -Objekts geladen werden sollen.

Gibt zurück

Excel.DocumentTaskChange

load(propertyNames)

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.

load(propertyNames?: string | string[]): Excel.DocumentTaskChange;

Parameter

propertyNames

string | string[]

Eine durch Trennzeichen getrennte Zeichenfolge oder ein Array von Zeichenfolgen, die die zu ladenden Eigenschaften angeben.

Gibt zurück

Excel.DocumentTaskChange

load(propertyNamesAndPaths)

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): Excel.DocumentTaskChange;

Parameter

propertyNamesAndPaths

{ select?: string; expand?: string; }

propertyNamesAndPaths.select ist eine durch Trennzeichen getrennte Zeichenfolge, die die zu ladenden Eigenschaften angibt, und propertyNamesAndPaths.expand eine durch Trennzeichen getrennte Zeichenfolge, die die zu ladenden Navigationseigenschaften angibt.

Gibt zurück

Excel.DocumentTaskChange

newObject(context)

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Erstellen einer neuen instance des Excel.DocumentTaskChange-Objekts

static newObject(context: OfficeExtension.ClientRequestContext): Excel.DocumentTaskChange;

Parameter

context

OfficeExtension.ClientRequestContext

Gibt zurück

Excel.DocumentTaskChange

toJSON()

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Überschreibt die JavaScript-Methode toJSON() , um eine nützlichere Ausgabe bereitzustellen, wenn ein API-Objekt an JSON.stringify()übergeben wird. (JSON.stringifyruft wiederum die toJSON -Methode des Objekts auf, das an das Objekt übergeben wird.) Während das ursprüngliche Excel.DocumentTaskChange-Objekt ein API-Objekt ist, gibt die toJSON Methode ein einfaches JavaScript-Objekt (typisiert als Excel.Interfaces.DocumentTaskChangeData) zurück, das flache Kopien aller geladenen untergeordneten Eigenschaften aus dem ursprünglichen Objekt enthält.

toJSON(): Excel.Interfaces.DocumentTaskChangeData;

Gibt zurück

Excel.Interfaces.DocumentTaskChangeData