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
- 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.
- 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.
- 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âmetro | Significado |
|---|---|
id | Id 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_s | Segundos de espera, no máximo, por uma mudança de estado (0-120, padrão 30). |