Partager via


IWorkItemFormService interface

Service hôte pour interagir avec le formulaire d’élément de travail actif (élément de travail actuellement affiché dans l’interface utilisateur). Le service de formulaire dépend du contexte actuel de l’élément de travail actif. Génère une erreur lorsqu’il n’y a pas d’élément de travail ouvert.

Méthodes

addWorkItemRelations(WorkItemRelation[])

Ajoute des liens d’autres éléments de travail ou artefacts (par exemple, des commits, des liens hypertexte) à l’élément de travail. La pièce jointe n’est actuellement pas prise en charge par cette fonction.

beginSaveWorkItem(() => void, () => void)

@deprecated: Utilisez enregistrer

clearError()

Efface le jeu d’erreur défini par la méthode setError et débloque l’enregistrement de l’élément de travail dans le formulaire.

getAllowedFieldValues(string)

Obtient les valeurs autorisées pour le champ sur l’élément de travail actif.

getDirtyFields(boolean)

Obtient les champs qui ont été modifiés par l’utilisateur ou par une règle d’élément de travail et qui sont dans un état sale.

getFields()

Obtient les champs d’élément de travail actifs.

getFieldValue(string, boolean)

Obtient la valeur de champ de l’élément de travail actif.

getFieldValue(string, WorkItemOptions)

Obtient la valeur de champ de l’élément de travail actif.

getFieldValues(string[], boolean)

Obtient les valeurs de champ de l’élément de travail actif.

getFieldValues(string[], WorkItemOptions)

Obtient les valeurs de champ de l’élément de travail actif.

getId()

Obtient l’ID de l’élément de travail actif.

getIdentityFieldValue(string, WorkItemOptions)

Obtient la valeur du champ d’identité de l’élément de travail actif.

getInvalidFields()

Obtient les champs qui ne sont pas valides en fonction des règles d’élément de travail. Ces champs doivent être modifiés avant que l’élément de travail puisse être enregistré.

getRevision()

Obtient la dernière révision de l’élément de travail actif.

getWorkItemRelations()

Retourne un tableau de liens d’élément de travail vers d’autres éléments de travail ou artefacts (par exemple, des commits, des liens hypertexte). La pièce jointe n’est actuellement pas prise en charge par cette fonction.

getWorkItemRelationTypes()

Retourne un tableau de types de relations d’élément de travail.

getWorkItemResourceUrl(number)

Retourne l’URL de l’API REST de la ressource d’élément de travail spécifiée.

hasActiveWorkItem()

Retourne true si l’élément de travail actif est disponible.

isDirty()

Retourne true si l’élément de travail actif est sale.

isNew()

Retourne true si l’élément de travail actif est nouveau.

isValid()

Retourne true si les champs d’élément de travail actifs sont tous valides.

refresh()

Actualise l’élément de travail actif. Invite l’utilisateur si l’élément de travail est sale.

removeWorkItemRelations(WorkItemRelation[])

Supprime des liens vers d’autres éléments de travail ou artefacts (par exemple, des commits, des liens hypertexte) de l’élément de travail. La pièce jointe n’est actuellement pas prise en charge par cette fonction.

reset()

Réinitialisez les modifications apportées à l’élément de travail actif. Invite l’utilisateur à confirmer.

save()

Enregistre l’élément de travail actif.

setError(string)

Marque l’élément de travail comme non valide et désactivez l’enregistrement de l’élément de travail dans le formulaire.

setFieldValue(string, Object)

Définit la valeur de champ de l’élément de travail actif.

setFieldValues({[fieldName: string]: Object})

Définit les valeurs de champ de l’élément de travail actif.

Détails de la méthode

addWorkItemRelations(WorkItemRelation[])

Ajoute des liens d’autres éléments de travail ou artefacts (par exemple, des commits, des liens hypertexte) à l’élément de travail. La pièce jointe n’est actuellement pas prise en charge par cette fonction.

function addWorkItemRelations(workItemRelations: WorkItemRelation[]): Promise<void>

Paramètres

workItemRelations

WorkItemRelation[]

Liens d’élément de travail à ajouter.

Retours

Promise<void>

Une promesse vide.

beginSaveWorkItem(() => void, () => void)

@deprecated: Utilisez enregistrer

function beginSaveWorkItem(successCallback: () => void, errorCallback: () => void): Promise<void>

Paramètres

successCallback

() => void

errorCallback

() => void

Retours

Promise<void>

clearError()

Efface le jeu d’erreur défini par la méthode setError et débloque l’enregistrement de l’élément de travail dans le formulaire.

function clearError(): Promise<void>

Retours

Promise<void>

getAllowedFieldValues(string)

Obtient les valeurs autorisées pour le champ sur l’élément de travail actif.

function getAllowedFieldValues(fieldReferenceName: string): Promise<Object[]>

Paramètres

fieldReferenceName

string

Nom de la référence de champ

Retours

Promise<Object[]>

Promesse qui retourne un tableau de valeurs autorisées.

getDirtyFields(boolean)

Obtient les champs qui ont été modifiés par l’utilisateur ou par une règle d’élément de travail et qui sont dans un état sale.

function getDirtyFields(includeSystemChanges?: boolean): Promise<WorkItemField[]>

Paramètres

includeSystemChanges

boolean

Valeur booléenne indiquant si le résultat doit inclure des modifications définies par les règles d’élément de travail.

Retours

Promise<WorkItemField[]>

Promesse qui retourne un tableau de sale champs d’élément de travail.

getFields()

Obtient les champs d’élément de travail actifs.

function getFields(): Promise<WorkItemField[]>

Retours

Promise<WorkItemField[]>

Promesse qui retourne un tableau de champ d’élément de travail.

getFieldValue(string, boolean)

Avertissement

Cette API est à présent déconseillée.

Please use options instead of returnOriginalValue

Obtient la valeur de champ de l’élément de travail actif.

function getFieldValue(fieldReferenceName: string, returnOriginalValue?: boolean): Promise<Object>

Paramètres

fieldReferenceName

string

Nom de la référence de champ

returnOriginalValue

boolean

(Facultatif) Si la valeur est false, obtient les valeurs de champ non enregistrées. La valeur par défaut est false.

Retours

Promise<Object>

Promesse qui retourne la valeur du champ d’élément de travail.

getFieldValue(string, WorkItemOptions)

Obtient la valeur de champ de l’élément de travail actif.

function getFieldValue(fieldReferenceName: string, options?: WorkItemOptions): Promise<Object>

Paramètres

fieldReferenceName

string

Nom de la référence de champ

options
WorkItemOptions

options d’élément de travail

Retours

Promise<Object>

Promesse qui retourne la valeur du champ d’élément de travail.

getFieldValues(string[], boolean)

Avertissement

Cette API est à présent déconseillée.

Please use options instead of returnOriginalValue

Obtient les valeurs de champ de l’élément de travail actif.

function getFieldValues(fieldReferenceNames: string[], returnOriginalValue?: boolean): Promise<{[fieldName: string]: Object}>

Paramètres

fieldReferenceNames

string[]

Arrary de noms de référence de champ

returnOriginalValue

boolean

(Facultatif) Si la valeur est false, obtient les valeurs de champ non enregistrées. La valeur par défaut est false.

Retours

Promise<{[fieldName: string]: Object}>

Promesse qui retourne un dictionnaire de valeurs de champ d’élément de travail (refName aux paires valeurs).

getFieldValues(string[], WorkItemOptions)

Obtient les valeurs de champ de l’élément de travail actif.

function getFieldValues(fieldReferenceNames: string[], options?: WorkItemOptions): Promise<{[fieldName: string]: Object}>

Paramètres

fieldReferenceNames

string[]

Arrary de noms de référence de champ

options
WorkItemOptions

options d’élément de travail

Retours

Promise<{[fieldName: string]: Object}>

Promesse qui retourne un dictionnaire de valeurs de champ d’élément de travail (refName aux paires valeurs).

getId()

Obtient l’ID de l’élément de travail actif.

function getId(): Promise<number>

Retours

Promise<number>

Promesse qui retourne l’ID d’élément de travail actif.

getIdentityFieldValue(string, WorkItemOptions)

Obtient la valeur du champ d’identité de l’élément de travail actif.

function getIdentityFieldValue(fieldReferenceName: string, options?: WorkItemOptions): Promise<IdentityRef>

Paramètres

fieldReferenceName

string

Nom de la référence de champ

options
WorkItemOptions

options d’élément de travail

Retours

Promise<IdentityRef>

Promesse qui retourne la valeur du champ d’élément de travail.

getInvalidFields()

Obtient les champs qui ne sont pas valides en fonction des règles d’élément de travail. Ces champs doivent être modifiés avant que l’élément de travail puisse être enregistré.

function getInvalidFields(): Promise<WorkItemField[]>

Retours

Promise<WorkItemField[]>

Promesse qui retourne un tableau de champs d’élément de travail non valides.

getRevision()

Obtient la dernière révision de l’élément de travail actif.

function getRevision(): Promise<number>

Retours

Promise<number>

Promesse qui retourne l’ID de révision le plus récent de l’élément de travail actif.

getWorkItemRelations()

Retourne un tableau de liens d’élément de travail vers d’autres éléments de travail ou artefacts (par exemple, des commits, des liens hypertexte). La pièce jointe n’est actuellement pas prise en charge par cette fonction.

function getWorkItemRelations(): Promise<WorkItemRelation[]>

Retours

Promise<WorkItemRelation[]>

Promesse qui retourne un tableau de relations d’élément de travail de l’élément de travail actif.

getWorkItemRelationTypes()

Retourne un tableau de types de relations d’élément de travail.

function getWorkItemRelationTypes(): Promise<WorkItemRelationType[]>

Retours

Promesse qui retourne un tableau de types de relations d’élément de travail.

getWorkItemResourceUrl(number)

Retourne l’URL de l’API REST de la ressource d’élément de travail spécifiée.

function getWorkItemResourceUrl(workItemId: number): Promise<string>

Paramètres

workItemId

number

ID de l’élément de travail pour lequel l’URL de ressource est demandée.

Retours

Promise<string>

Promesse qui retourne l’URL de ressource demandée de l’élément de travail.

hasActiveWorkItem()

Retourne true si l’élément de travail actif est disponible.

function hasActiveWorkItem(): Promise<boolean>

Retours

Promise<boolean>

Une promesse qui retourne une valeur booléenne indique si l’élément de travail actif est disponible.

isDirty()

Retourne true si l’élément de travail actif est sale.

function isDirty(): Promise<boolean>

Retours

Promise<boolean>

Une promesse qui retourne une valeur booléenne indique si l’élément de travail actif est sale.

isNew()

Retourne true si l’élément de travail actif est nouveau.

function isNew(): Promise<boolean>

Retours

Promise<boolean>

Une promesse qui retourne une valeur booléenne indique si l’élément de travail actif est nouveau.

isValid()

Retourne true si les champs d’élément de travail actifs sont tous valides.

function isValid(): Promise<boolean>

Retours

Promise<boolean>

Une promesse qui retourne une valeur booléenne indique si toutes les valeurs de champ sont valides.

refresh()

Actualise l’élément de travail actif. Invite l’utilisateur si l’élément de travail est sale.

function refresh(): Promise<void>

Retours

Promise<void>

removeWorkItemRelations(WorkItemRelation[])

Supprime des liens vers d’autres éléments de travail ou artefacts (par exemple, des commits, des liens hypertexte) de l’élément de travail. La pièce jointe n’est actuellement pas prise en charge par cette fonction.

function removeWorkItemRelations(workItemRelations: WorkItemRelation[]): Promise<void>

Paramètres

workItemRelations

WorkItemRelation[]

Liens d’élément de travail à supprimer.

Retours

Promise<void>

Une promesse vide.

reset()

Réinitialisez les modifications apportées à l’élément de travail actif. Invite l’utilisateur à confirmer.

function reset(): Promise<void>

Retours

Promise<void>

save()

Enregistre l’élément de travail actif.

function save(): Promise<void>

Retours

Promise<void>

Promesse qui est résolue si l’élément de travail est correctement enregistré et rejeté en cas d’échec.

setError(string)

Marque l’élément de travail comme non valide et désactivez l’enregistrement de l’élément de travail dans le formulaire.

function setError(errorMessage: string): Promise<void>

Paramètres

errorMessage

string

Message d’erreur personnalisé qui s’affiche au-dessus du formulaire d’élément de travail.

Retours

Promise<void>

setFieldValue(string, Object)

Définit la valeur de champ de l’élément de travail actif.

function setFieldValue(fieldReferenceName: string, value: Object): Promise<boolean>

Paramètres

fieldReferenceName

string

Nom de la référence de champ

value

Object

Valeur du champ

Retours

Promise<boolean>

Une promesse qui retourne une valeur booléenne indique si la fonction s’est terminée correctement.

setFieldValues({[fieldName: string]: Object})

Définit les valeurs de champ de l’élément de travail actif.

function setFieldValues(fields: {[fieldName: string]: Object}): Promise<{[fieldName: string]: boolean}>

Paramètres

fields

{[fieldName: string]: Object}

Dictionnaire de champs refName/values

Retours

Promise<{[fieldName: string]: boolean}>

Promesse qui retourne un dictionnaire de résultats de mise à jour de la valeur de champ (refName aux paires de résultats).