IWorkItemFormService interface

Pacote:

azure-devops-extension-api

Serviço de host para interagir com o formulário de item de trabalho atualmente ativo (item de trabalho exibido atualmente na interface do usuário). O serviço de formulário depende do contexto atual do item de trabalho ativo. Lançará um erro quando não houver nenhum item de trabalho aberto.

Métodos

addWorkItemRelations(WorkItemRelation[])	Adiciona links de outros itens de trabalho ou artefatos (por exemplo, confirmações, hiperlinks) para o item de trabalho. No momento, o anexo não é suportado por esta função.
beginSaveWorkItem(() => void, () => void)	@deprecated: Por favor, use salvar
clearError()	Limpa o erro definido pelo método setError e desbloqueia o salvamento do item de trabalho no formulário.
getAllowedFieldValues(string)	Obtém os valores permitidos para o campo no item de trabalho ativo.
getDirtyFields(boolean)	Obtém campos que foram alterados pelo usuário ou por uma regra de item de trabalho e estão em um estado sujo.
getFields()	Obtém campos de item de trabalho ativos.
getFieldValue(string, boolean)	Obtém o valor do campo do item de trabalho ativo.
getFieldValue(string, WorkItemOptions)	Obtém o valor do campo do item de trabalho ativo.
getFieldValues(string[], boolean)	Obtém valores de campo do item de trabalho ativo.
getFieldValues(string[], WorkItemOptions)	Obtém valores de campo do item de trabalho ativo.
getId()	Obtém a id do item de trabalho ativo.
getIdentityFieldValue(string, WorkItemOptions)	Obtém o valor do campo de identidade do item de trabalho ativo.
getInvalidFields()	Obtém campos que estão em um estado inválido de acordo com as regras de item de trabalho. Esses campos precisam ser alterados antes que o item de trabalho possa ser salvo.
getRevision()	Obtém a última revisão do item de trabalho ativo.
getWorkItemRelations()	Retorna uma matriz de links de item de trabalho para outros itens de trabalho ou artefatos (por exemplo, confirmações, hiperlinks). No momento, o anexo não é suportado por esta função.
getWorkItemRelationTypes()	Retorna uma matriz de tipos de relação de item de trabalho.
getWorkItemResourceUrl(number)	Retorna a URL da API REST do recurso de item de trabalho especificado.
hasActiveWorkItem()	Retorna true se o item de trabalho ativo estiver disponível.
isDirty()	Retorna true se o item de trabalho ativo estiver sujo.
isNew()	Retorna true se o item de trabalho ativo for novo.
isValid()	Retorna true se os campos de item de trabalho ativos forem todos válidos.
refresh()	Atualiza o item de trabalho ativo. Avisará o usuário se o item de trabalho estiver sujo.
removeWorkItemRelations(WorkItemRelation[])	Remove links para outros itens de trabalho ou artefatos (por exemplo, confirmações, hiperlinks) do item de trabalho. No momento, o anexo não é suportado por esta função.
reset()	Redefina todas as alterações no item de trabalho ativo. Solicitará que o usuário confirme.
save()	Salva o item de trabalho ativo.
setError(string)	Marca o item de trabalho como inválido e desabilita o salvamento no formulário.
setFieldValue(string, Object)	Define o valor do campo do item de trabalho ativo.
setFieldValues({[fieldName: string]: Object})	Define valores de campo do item de trabalho ativo.

Detalhes de Método

addWorkItemRelations(WorkItemRelation[])

Adiciona links de outros itens de trabalho ou artefatos (por exemplo, confirmações, hiperlinks) para o item de trabalho. No momento, o anexo não é suportado por esta função.

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

Parâmetros

workItemRelations

WorkItemRelation[]

Links de item de trabalho para adicionar.

Devoluções

Promise<void>

Uma promessa vazia.

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

@deprecated: Por favor, use salvar

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

Parâmetros

successCallback

() => void

errorCallback

() => void

Devoluções

Promise<void>

clearError()

Limpa o erro definido pelo método setError e desbloqueia o salvamento do item de trabalho no formulário.

function clearError(): Promise<void>

Devoluções

Promise<void>

getAllowedFieldValues(string)

Obtém os valores permitidos para o campo no item de trabalho ativo.

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

Parâmetros

fieldReferenceName

string

Nome de referência do campo

Devoluções

Promise<Object[]>

Uma promessa que retorna uma matriz de valores permitidos.

getDirtyFields(boolean)

Obtém campos que foram alterados pelo usuário ou por uma regra de item de trabalho e estão em um estado sujo.

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

Parâmetros

includeSystemChanges

boolean

Um valor booleano que indica se o resultado deve incluir alterações definidas por regras de item de trabalho.

Devoluções

Promise<WorkItemField[]>

Uma promessa que retorna uma matriz de campos de item de trabalho sujo.

getFields()

Obtém campos de item de trabalho ativos.

function getFields(): Promise<WorkItemField[]>

Devoluções

Promise<WorkItemField[]>

Uma promessa que retorna uma matriz de campo de item de trabalho.

getFieldValue(string, boolean)

Aviso

Esta API foi preterida.

Please use options instead of returnOriginalValue

Obtém o valor do campo do item de trabalho ativo.

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

Parâmetros

fieldReferenceName

string

Nome de referência do campo

returnOriginalValue

boolean

(Opcional) Se false, obtém valores de campo não salvos. O valor padrão é falso.

Devoluções

Promise<Object>

Uma promessa que retorna o valor do campo de item de trabalho.

getFieldValue(string, WorkItemOptions)

Obtém o valor do campo do item de trabalho ativo.

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

Parâmetros

fieldReferenceName

string

Nome de referência do campo

options

WorkItemOptions

Opções de item de trabalho

Devoluções

Promise<Object>

Uma promessa que retorna o valor do campo de item de trabalho.

getFieldValues(string[], boolean)

Aviso

Esta API foi preterida.

Please use options instead of returnOriginalValue

Obtém valores de campo do item de trabalho ativo.

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

Parâmetros

fieldReferenceNames

string[]

Uma série de nomes de referência de campo

returnOriginalValue

boolean

(Opcional) Se false, obtém valores de campo não salvos. O valor padrão é falso.

Devoluções

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

Uma promessa que retorna um dicionário de valores de campo de item de trabalho (refName para pares de valores).

getFieldValues(string[], WorkItemOptions)

Obtém valores de campo do item de trabalho ativo.

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

Parâmetros

fieldReferenceNames

string[]

Uma série de nomes de referência de campo

options

WorkItemOptions

Opções de item de trabalho

Devoluções

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

Uma promessa que retorna um dicionário de valores de campo de item de trabalho (refName para pares de valores).

getId()

Obtém a id do item de trabalho ativo.

function getId(): Promise<number>

Devoluções

Promise<number>

Uma promessa que retorna a id do item de trabalho ativo.

getIdentityFieldValue(string, WorkItemOptions)

Obtém o valor do campo de identidade do item de trabalho ativo.

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

Parâmetros

fieldReferenceName

string

Nome de referência do campo

options

WorkItemOptions

Opções de item de trabalho

Devoluções

Promise<IdentityRef>

Uma promessa que retorna o valor do campo de item de trabalho.

getInvalidFields()

Obtém campos que estão em um estado inválido de acordo com as regras de item de trabalho. Esses campos precisam ser alterados antes que o item de trabalho possa ser salvo.

function getInvalidFields(): Promise<WorkItemField[]>

Devoluções

Promise<WorkItemField[]>

Uma promessa que retorna uma matriz de campos de item de trabalho inválidos.

getRevision()

Obtém a última revisão do item de trabalho ativo.

function getRevision(): Promise<number>

Devoluções

Promise<number>

Uma promessa que retorna a id de revisão mais recente do item de trabalho ativo.

getWorkItemRelations()

Retorna uma matriz de links de item de trabalho para outros itens de trabalho ou artefatos (por exemplo, confirmações, hiperlinks). No momento, o anexo não é suportado por esta função.

function getWorkItemRelations(): Promise<WorkItemRelation[]>

Devoluções

Promise<WorkItemRelation[]>

Uma promessa que retorna uma matriz de relações de item de trabalho de item de trabalho ativo.

getWorkItemRelationTypes()

Retorna uma matriz de tipos de relação de item de trabalho.

function getWorkItemRelationTypes(): Promise<WorkItemRelationType[]>

Devoluções

Promise<WorkItemRelationType[]>

Uma promessa que retorna uma matriz de tipos de relação de item de trabalho.

getWorkItemResourceUrl(number)

Retorna a URL da API REST do recurso de item de trabalho especificado.

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

Parâmetros

workItemId

number

Id do item de trabalho para o qual a URL do recurso é solicitada.

Devoluções

Promise<string>

Uma promessa que retorna a URL do recurso solicitado do item de trabalho.

hasActiveWorkItem()

Retorna true se o item de trabalho ativo estiver disponível.

function hasActiveWorkItem(): Promise<boolean>

Devoluções

Promise<boolean>

Uma promessa que retorna um valor booleano indica se o item de trabalho ativo está disponível.

isDirty()

Retorna true se o item de trabalho ativo estiver sujo.

function isDirty(): Promise<boolean>

Devoluções

Promise<boolean>

Uma promessa que retorna um valor booleano indica se o item de trabalho ativo está sujo.

isNew()

Retorna true se o item de trabalho ativo for novo.

function isNew(): Promise<boolean>

Devoluções

Promise<boolean>

Uma promessa que retorna um valor booleano indica se o item de trabalho ativo é novo.

isValid()

Retorna true se os campos de item de trabalho ativos forem todos válidos.

function isValid(): Promise<boolean>

Devoluções

Promise<boolean>

Uma promessa que retorna um valor booleano indica se todos os valores de campo são válidos.

refresh()

Atualiza o item de trabalho ativo. Avisará o usuário se o item de trabalho estiver sujo.

function refresh(): Promise<void>

Devoluções

Promise<void>

removeWorkItemRelations(WorkItemRelation[])

Remove links para outros itens de trabalho ou artefatos (por exemplo, confirmações, hiperlinks) do item de trabalho. No momento, o anexo não é suportado por esta função.

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

Parâmetros

workItemRelations

WorkItemRelation[]

Links de item de trabalho para remover.

Devoluções

Promise<void>

Uma promessa vazia.

reset()

Redefina todas as alterações no item de trabalho ativo. Solicitará que o usuário confirme.

function reset(): Promise<void>

Devoluções

Promise<void>

save()

Salva o item de trabalho ativo.

function save(): Promise<void>

Devoluções

Promise<void>

Uma promessa que é resolvida se o item de trabalho for salvo com êxito e rejeitado se falhar.

setError(string)

Marca o item de trabalho como inválido e desabilita o salvamento no formulário.

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

Parâmetros

errorMessage

string

Uma mensagem de erro personalizada que seria mostrada na parte superior do formulário de item de trabalho.

Devoluções

Promise<void>

setFieldValue(string, Object)

Define o valor do campo do item de trabalho ativo.

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

Parâmetros

fieldReferenceName

string

Nome de referência do campo

value

Object

Valor do campo

Devoluções

Promise<boolean>

Uma promessa que retorna um valor booleano indica se a função foi concluída com êxito.

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

Define valores de campo do item de trabalho ativo.

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

Parâmetros

fields

{[fieldName: string]: Object}

Um dicionário de campo refName/values

Devoluções

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

Uma promessa que retorna um dicionário de resultados de atualização de valor de campo (refName para pares de resultados).