Share via


Excel.DocumentTaskChange class

Notes

Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.

Représente une modification enregistrée de la tâche.

Extends

Remarques

[ Ensemble d’API : ExcelApi BETA (PRÉVERSION UNIQUEMENT) ]

Propriétés

assignee

Représente l’utilisateur affecté à la tâche pour une assign action de modification, ou l’utilisateur non affecté à la tâche pour une unassign action de modification.

changedBy

Représente l’identité de l’utilisateur qui a modifié la tâche.

commentId

Représente l’ID du comment ou commentReply auquel la modification de tâche est ancrée.

context

Contexte de requête associé à l’objet . Cela connecte le processus du complément au processus de l’application hôte Office.

createdDateTime

Représente la date et l’heure de création de l’enregistrement de modification de tâche. Toutes les dates sont au format UTC.

dueDateTime

Représente la date et l’heure d’échéance de la tâche. Il est utilisé pour l’action de setSchedule modification. Il est dans le fuseau horaire UTC. Il peut être défini sur null pour supprimer la date et l’heure d’échéance. Il doit être défini avec startDateTime pour éviter les conflits.

id

GUID unique de la modification de la tâche.

percentComplete

Représente le pourcentage d’achèvement de la tâche. Il est utilisé pour l’action de setPercentComplete modification. Il s’agit d’une valeur comprise entre 0 et 100, où 100 représente une tâche terminée. La modification de cette valeur sur 100 complète également le commentaire associé. La modification de la saisie semi-automatique de 100 à une valeur inférieure réactive le commentaire associé.

priority

Représente la priorité de la tâche. Il est utilisé pour l’action de setPriority modification. Il s’agit d’une valeur comprise entre 0 et 10, 5 étant la priorité par défaut si elle n’est pas définie, et où 0 représente la priorité la plus élevée.

startDateTime

Représente la date et l’heure de début de la tâche. Il est utilisé pour l’action de setSchedule modification. Il est dans le fuseau horaire UTC. Il peut être défini sur null pour supprimer la date et l’heure de début. Il doit être défini avec dueDateTime pour éviter les conflits.

title

Représente le titre de la tâche. Il est utilisé pour l’action de setTitle modification.

type

Représente le type d’action de l’enregistrement de modification de tâche. Voici quelques exemples de types d’action : assign, undoet setPriority.

undoChangeId

Représente la DocumentTaskChange.id propriété qui a été annulée pour l’action de undo modification.

Méthodes

load(options)

Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.

load(propertyNames)

Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.

load(propertyNamesAndPaths)

Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.

newObject(context)

Créer un instance de l’objet Excel.DocumentTaskChange

toJSON()

Remplace la méthode JavaScript toJSON() afin de fournir une sortie plus utile lorsqu’un objet API est passé à JSON.stringify(). (JSON.stringifyappelle à son tour la toJSON méthode de l’objet qui lui est passé.) Alors que l’objet Excel.DocumentTaskChange d’origine est un objet API, la toJSON méthode renvoie un objet JavaScript brut (tapé en tant Excel.Interfaces.DocumentTaskChangeDataque ) qui contient des copies superficielles de toutes les propriétés enfants chargées de l’objet d’origine.

Détails de la propriété

assignee

Notes

Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.

Représente l’utilisateur affecté à la tâche pour une assign action de modification, ou l’utilisateur non affecté à la tâche pour une unassign action de modification.

readonly assignee: Excel.EmailIdentity;

Valeur de propriété

Remarques

[ Ensemble d’API : ExcelApi BETA (PRÉVERSION UNIQUEMENT) ]

changedBy

Notes

Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.

Représente l’identité de l’utilisateur qui a modifié la tâche.

readonly changedBy: Excel.EmailIdentity;

Valeur de propriété

Remarques

[ Ensemble d’API : ExcelApi BETA (PRÉVERSION UNIQUEMENT) ]

commentId

Notes

Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.

Représente l’ID du comment ou commentReply auquel la modification de tâche est ancrée.

readonly commentId: string;

Valeur de propriété

string

Remarques

[ Ensemble d’API : ExcelApi BETA (PRÉVERSION UNIQUEMENT) ]

context

Notes

Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.

Contexte de requête associé à l’objet . Cela connecte le processus du complément au processus de l’application hôte Office.

context: RequestContext;

Valeur de propriété

createdDateTime

Notes

Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.

Représente la date et l’heure de création de l’enregistrement de modification de tâche. Toutes les dates sont au format UTC.

readonly createdDateTime: Date;

Valeur de propriété

Date

Remarques

[ Ensemble d’API : ExcelApi BETA (PRÉVERSION UNIQUEMENT) ]

dueDateTime

Notes

Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.

Représente la date et l’heure d’échéance de la tâche. Il est utilisé pour l’action de setSchedule modification. Il est dans le fuseau horaire UTC. Il peut être défini sur null pour supprimer la date et l’heure d’échéance. Il doit être défini avec startDateTime pour éviter les conflits.

readonly dueDateTime: Date;

Valeur de propriété

Date

Remarques

[ Ensemble d’API : ExcelApi BETA (PRÉVERSION UNIQUEMENT) ]

id

Notes

Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.

GUID unique de la modification de la tâche.

readonly id: string;

Valeur de propriété

string

Remarques

[ Ensemble d’API : ExcelApi BETA (PRÉVERSION UNIQUEMENT) ]

percentComplete

Notes

Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.

Représente le pourcentage d’achèvement de la tâche. Il est utilisé pour l’action de setPercentComplete modification. Il s’agit d’une valeur comprise entre 0 et 100, où 100 représente une tâche terminée. La modification de cette valeur sur 100 complète également le commentaire associé. La modification de la saisie semi-automatique de 100 à une valeur inférieure réactive le commentaire associé.

readonly percentComplete: number;

Valeur de propriété

number

Remarques

[ Ensemble d’API : ExcelApi BETA (PRÉVERSION UNIQUEMENT) ]

priority

Notes

Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.

Représente la priorité de la tâche. Il est utilisé pour l’action de setPriority modification. Il s’agit d’une valeur comprise entre 0 et 10, 5 étant la priorité par défaut si elle n’est pas définie, et où 0 représente la priorité la plus élevée.

readonly priority: number;

Valeur de propriété

number

Remarques

[ Ensemble d’API : ExcelApi BETA (PRÉVERSION UNIQUEMENT) ]

startDateTime

Notes

Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.

Représente la date et l’heure de début de la tâche. Il est utilisé pour l’action de setSchedule modification. Il est dans le fuseau horaire UTC. Il peut être défini sur null pour supprimer la date et l’heure de début. Il doit être défini avec dueDateTime pour éviter les conflits.

readonly startDateTime: Date;

Valeur de propriété

Date

Remarques

[ Ensemble d’API : ExcelApi BETA (PRÉVERSION UNIQUEMENT) ]

title

Notes

Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.

Représente le titre de la tâche. Il est utilisé pour l’action de setTitle modification.

readonly title: string;

Valeur de propriété

string

Remarques

[ Ensemble d’API : ExcelApi BETA (PRÉVERSION UNIQUEMENT) ]

type

Notes

Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.

Représente le type d’action de l’enregistrement de modification de tâche. Voici quelques exemples de types d’action : assign, undoet setPriority.

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

Valeur de propriété

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

Remarques

[ Ensemble d’API : ExcelApi BETA (PRÉVERSION UNIQUEMENT) ]

undoChangeId

Notes

Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.

Représente la DocumentTaskChange.id propriété qui a été annulée pour l’action de undo modification.

readonly undoChangeId: string;

Valeur de propriété

string

Remarques

[ Ensemble d’API : ExcelApi BETA (PRÉVERSION UNIQUEMENT) ]

Détails de la méthode

load(options)

Notes

Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.

Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.

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

Paramètres

options
Excel.Interfaces.DocumentTaskChangeLoadOptions

Fournit des options pour les propriétés de l’objet à charger.

Retours

load(propertyNames)

Notes

Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.

Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.

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

Paramètres

propertyNames

string | string[]

Chaîne délimitée par des virgules ou tableau de chaînes qui spécifient les propriétés à charger.

Retours

load(propertyNamesAndPaths)

Notes

Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.

Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.

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

Paramètres

propertyNamesAndPaths

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

propertyNamesAndPaths.select est une chaîne délimitée par des virgules qui spécifie les propriétés à charger, et propertyNamesAndPaths.expand est une chaîne délimitée par des virgules qui spécifie les propriétés de navigation à charger.

Retours

newObject(context)

Notes

Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.

Créer un instance de l’objet Excel.DocumentTaskChange

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

Paramètres

Retours

toJSON()

Notes

Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.

Remplace la méthode JavaScript toJSON() afin de fournir une sortie plus utile lorsqu’un objet API est passé à JSON.stringify(). (JSON.stringifyappelle à son tour la toJSON méthode de l’objet qui lui est passé.) Alors que l’objet Excel.DocumentTaskChange d’origine est un objet API, la toJSON méthode renvoie un objet JavaScript brut (tapé en tant Excel.Interfaces.DocumentTaskChangeDataque ) qui contient des copies superficielles de toutes les propriétés enfants chargées de l’objet d’origine.

toJSON(): Excel.Interfaces.DocumentTaskChangeData;

Retours