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
add |
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. |
begin |
@deprecated: Utilisez enregistrer |
clear |
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. |
get |
Obtient les valeurs autorisées pour le champ sur l’élément de travail actif. |
get |
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. |
get |
Obtient les champs d’élément de travail actifs. |
get |
Obtient la valeur de champ de l’élément de travail actif. |
get |
Obtient la valeur de champ de l’élément de travail actif. |
get |
Obtient les valeurs de champ de l’élément de travail actif. |
get |
Obtient les valeurs de champ de l’élément de travail actif. |
get |
Obtient l’ID de l’élément de travail actif. |
get |
Obtient la valeur du champ d’identité de l’élément de travail actif. |
get |
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é. |
get |
Obtient la dernière révision de l’élément de travail actif. |
get |
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. |
get |
Retourne un tableau de types de relations d’élément de travail. |
get |
Retourne l’URL de l’API REST de la ressource d’élément de travail spécifiée. |
has |
Retourne true si l’élément de travail actif est disponible. |
is |
Retourne true si l’élément de travail actif est sale. |
is |
Retourne true si l’élément de travail actif est nouveau. |
is |
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. |
remove |
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. |
set |
Marque l’élément de travail comme non valide et désactivez l’enregistrement de l’élément de travail dans le formulaire. |
set |
Définit la valeur de champ de l’élément de travail actif. |
set |
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
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
Promise<WorkItemRelationType[]>
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
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).