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 der Aufgabe dar.

Extends
OfficeExtension.ClientObject

Hinweise

API-Satz: ExcelApi BETA (NUR VORSCHAU)

Verwendet von

Eigenschaften

assignee

Stellt den Benutzer dar, der der Aufgabe für eine assign Änderungsaktion zugewiesen wurde, oder den Benutzer, dem die Aufgabe für eine unassign Änderungsaktion nicht zugewiesen wurde.
changedBy

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

Stellt die ID des Kommentars oder der Kommentarantwort dar, mit der die Aufgabenänderung verknüpft ist.
context

Der dem Objekt zugeordnete Anforderungskontext. Dadurch wird der Prozess des Add-Ins mit dem Prozess der Office-Hostanwendung verbunden.
createdDateTime

Stellt das Erstellungsdatum und die Erstellungszeit des Änderungsdatensatzes der Aufgabe dar. Alle Datumsangaben sind in UTC angegeben.
dueDateTime

Stellt das Fälligkeitsdatum und die Uhrzeit der Aufgabe dar. Er wird für die setSchedule Änderungsaktion verwendet. Die Zeitzone UTC wird verwendet. Sie kann so eingestellt werden, dass null das Fälligkeitsdatum und die Uhrzeit entfernt werden. Es sollte zusammen mit startDateTime festgelegt werden, um Konflikte zu vermeiden.
id

Die eindeutige GUID der Aufgabenänderung
percentComplete

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

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

Stellt das Startdatum und die Startzeit der Aufgabe dar. Er wird für die setSchedule Änderungsaktion verwendet. Die Zeitzone UTC wird verwendet. Sie kann so eingestellt werden, dass null das Startdatum und die Startuhrzeit entfernt werden. Es sollte zusammen mit dueDateTime festgelegt werden, um Konflikte zu vermeiden.
title

Stellt den Titel der Aufgabe dar. Er wird für die setTitle Änderungsaktion verwendet.
type

Stellt den Aktionstyp des Aufgabenänderungsdatensatzes dar. Einige Beispiele für Aktionstypen sind assign, undo, und setPriority.
undoChangeId

Stellt die Eigenschaft dar, die DocumentTaskChange.id für die undo Änderungsaktion rückgängig gemacht 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 Sie eine neue 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 sie übergeben wird.) Während das ursprüngliche Excel.DocumentTaskChange Objekt ein API-Objekt ist, gibt die toJSON Methode ein einfaches JavaScript-Objekt (als Excel.Interfaces.DocumentTaskChangeData) zurück, das flache Kopien aller geladenen untergeordneten Eigenschaften des ursprünglichen Objekts 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 wurde, oder den Benutzer, dem die Aufgabe für eine unassign Änderungsaktion nicht 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 Kommentars oder der Kommentarantwort dar, mit der die Aufgabenänderung verknüpft 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 dem Objekt zugeordnete Anforderungskontext. 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 Änderungsdatensatzes der Aufgabe 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 Uhrzeit der Aufgabe dar. Er wird für die setSchedule Änderungsaktion verwendet. Die Zeitzone UTC wird verwendet. Sie kann so eingestellt werden, dass null das Fälligkeitsdatum und die Uhrzeit entfernt werden. 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 Aufgabenänderung

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 Fertigstellungsprozentsatz der Aufgabe dar. Er wird für die setPercentComplete Änderungsaktion verwendet. Dies ist ein Wert zwischen 0 und 100, wobei 100 für eine abgeschlossene Aufgabe steht. Wenn Sie diesen Wert in 100 ändern, wird auch der zugehörige Kommentar abgeschlossen. Wenn Sie die Vervollständigung von 100 auf einen niedrigeren Wert ändern, wird der zugehörige Kommentar reaktiviert.

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 der Aufgabe dar. Er wird für die setPriority Änderungsaktion verwendet. Dies ist ein Wert zwischen 0 und 10, wobei 5 die Standardpriorität ist, wenn nicht festgelegt, und wobei 0 für die höchste Priorität steht.

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 der Aufgabe dar. Er wird für die setSchedule Änderungsaktion verwendet. Die Zeitzone UTC wird verwendet. Sie kann so eingestellt werden, dass null das Startdatum und die Startuhrzeit entfernt werden. 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 der Aufgabe dar. Er wird für die setTitle Änderungsaktion 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 Aufgabenänderungsdatensatzes dar. Einige Beispiele für Aktionstypen sind assign, undo, und 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 Eigenschaft dar, die DocumentTaskChange.id für die undo Änderungsaktion rückgängig gemacht 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 für die zu ladenden Eigenschaften des Objekts bereit.

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 Kommas getrennte Zeichenfolge, die die zu ladenden Eigenschaften angibt, und propertyNamesAndPaths.expand eine durch Kommas 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 Sie eine neue 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 sie übergeben wird.) Während das ursprüngliche Excel.DocumentTaskChange Objekt ein API-Objekt ist, gibt die toJSON Methode ein einfaches JavaScript-Objekt (als Excel.Interfaces.DocumentTaskChangeData) zurück, das flache Kopien aller geladenen untergeordneten Eigenschaften des ursprünglichen Objekts enthält.

toJSON(): Excel.Interfaces.DocumentTaskChangeData;

Gibt zurück

Excel.Interfaces.DocumentTaskChangeData