Cancelar o trabalho

O que faz

Cancela um trabalho (job) iniciado pela sua IA:

• se o trabalho ainda espera a sua vez, não começa;
• se está em andamento, para no próximo avanço do Revit. Uma abertura cancelada com Abrir um modelo não deixa o modelo aberto e o Revit continua utilizável;
• se é uma ação de equipe aguardando a sua aprovação, o pedido é retirado e nada muda;
• se o trabalho já terminou, nada muda.

Responde mesmo enquanto o Revit está ocupado.

Como funciona

1. A sua IA chama a ferramenta com o id do trabalho; sem id, cancela o único trabalho em andamento (se houver mais de um, pede o id).
2. O BIMit registra o pedido de cancelamento e espera, até o tempo indicado (10 segundos por padrão, no máximo 120), que o trabalho termine.
3. A sua IA diz se o trabalho foi cancelado, se já tinha terminado antes de o cancelamento chegar, ou se o pedido foi enviado e o trabalho vai parar no próximo avanço do Revit (ela confirma com Status do trabalho).

Exemplos de pedido

• "Pare a abertura do modelo, está demorando demais."
• "Cancele o pedido de sincronização que você me mandou no Revit."
• "Cancele o trabalho j1-9c1e."

O que muda e como desfazer

A ferramenta não altera o modelo nem os arquivos: só interrompe um trabalho. Uma abertura cancelada não deixa nenhum modelo aberto; se o Revit já tinha terminado de abri-lo, o BIMit o fecha sem salvar (o documento ativo, porém, não pode ser fechado pela API: nesse caso, feche você no Revit). Um pedido de aprovação retirado não muda nada.

Um cancelamento não pode ser revertido: para repetir o trabalho, a sua IA o inicia de novo (por exemplo reabrindo o modelo com Abrir um modelo).

Limites

• Um trabalho em andamento só para no próximo avanço do Revit, não instantaneamente.
• Uma única chamada espera no máximo 120 segundos.

Parâmetros

Ferramentas relacionadas

• Abrir um modelo
• Status do trabalho