Ferramenta

Status do trabalho

Nome técnico: job_stato

Modelo › Abrir modelos

Lê

Diz em que ponto está um trabalho longo iniciado pela sua IA, como a abertura de um modelo ou uma ação de equipe aguardando a sua aprovação, e devolve o resultado.

O que faz

Acompanha um trabalho (job): uma operação longa que a sua IA iniciou sem ficar esperando, como a abertura de um modelo com Abrir um modelo ou uma ação de equipe que aguarda a sua aprovação no Revit.

Para cada trabalho devolve:

  • o estado: na fila, em andamento, concluído, com falha, cancelado;
  • o andamento: a fase e a porcentagem indicadas pelo Revit, a memória disponível, uma janela do Revit esperando a sua resposta;
  • os segundos decorridos;
  • no fim, o resultado, o erro ou o motivo do cancelamento;
  • para as ações de equipe, o estado da aprovação: aguardando, aprovada, executada ou com falha, ou então negada ou cancelada.

Responde na hora mesmo enquanto o Revit está ocupado (por exemplo abrindo um modelo grande). Não altera nada.

Como funciona

  1. A sua IA chama a ferramenta com o id do trabalho, recebido da ferramenta que o iniciou. Sem id, usa o único trabalho em andamento; se não houver exatamente um, lista os últimos trabalhos deste Revit.
  2. O BIMit espera, até o tempo indicado (30 segundos por padrão, no máximo 120), que o trabalho mude de estado ou termine, e responde com o estado atualizado.
  3. A sua IA chama de novo a ferramenta até o trabalho terminar e informa o resultado; se o Revit mostrar uma janela ou aguardar a sua aprovação, ela avisa para que você responda no Revit.

Exemplos de pedido

  • "Em que ponto está a abertura do modelo?"
  • "Espere o modelo terminar de abrir e depois me diga quantos worksets ele tem."
  • "Aprovei a sincronização no Revit: deu certo?"

O que muda e como desfazer

Nada: a ferramenta só lê o estado dos trabalhos, não mexe no modelo nem nos arquivos. Não há nada a desfazer.

Para interromper um trabalho na fila ou em andamento, use Cancelar o trabalho.

Limites

  • Vê só os trabalhos deste Revit: os trabalhos terminados ficam disponíveis por pelo menos uma hora; um trabalho de um Revit fechado não existe mais.
  • Uma única chamada espera no máximo 120 segundos.

Parâmetros

ParâmetroSignificado
idId do trabalho (ex. "j1-9c1e"), dado pela ferramenta que o iniciou. Sem id: o único trabalho em andamento, senão a lista dos últimos trabalhos.
attesa_sSegundos de espera, no máximo, por uma mudança de estado (0-120, padrão 30).

Ferramentas relacionadas

Todas as ferramentas