Por favor, note: Este artigo é uma tradução gerada por IA.
O Zoom Nightshift automatiza ações no Zoom usando arquivos de script JSON em combinação com o Agendador de Tarefas do Windows.
Com o Nightshift, você pode automatizar as seguintes ações no BIMcollab:
Abrir modelos / Adicionar ao projeto
Conectar ao projeto
Filtrar issues
Atualizar issues
Executar e compartilhar todas as Listas
Sincronizar projeto
Neste artigo, descrevemos como criar um script para ser executado no Zoom Nightshift.
Para mais informações sobre como configurar uma tarefa no Agendador de Tarefas do Windows, consulte o artigo Configure uma tarefa para o Zoom Nightshift no Agendador de Tarefas do Windows.
📝 Nota: Um script JSON pode ser configurado em qualquer editor de script JSON. Você pode encontrar um script de exemplo como anexo a este artigo para começar.
O script começa com o título do script e, opcionalmente, a versão, seguido pelas ações a serem realizadas no BIMcollab quando o script for executado.
{
"title": "Example_Script",
"version": "0.1",
"actions": [
As diferentes ações que podem ser adicionadas ao script, para o BIMcollab executar durante o Nightshift, são explicadas no restante deste artigo.
Abrir modelos / Adicionar ao projeto
A primeira coisa que você quer fazer no Nightshift é abrir um conjunto de modelos nos quais o restante das ações pode ser realizado. Para isso, existem dois prompts possíveis:
OPEN_MODELS: adiciona e carrega um modelo no Navigator e fecha qualquer modelo carregado anteriormente
ADD_TO_PROJECT: adiciona e carrega um modelo no Navigator sem fechar modelos que já estão presentes no Navigator
📝 Nota: Quando você se conecta a um projeto onde uma Pasta do projeto está ativa, todos os modelos na pasta do projeto serão carregados automaticamente, independentemente do status de carregamento deles no seu projeto. Não é necessário inserir nada adicional no script para abrir esses modelos.
Se você quiser adicionar modelos adicionais ao projeto que não estão localizados na pasta do projeto, use o prompt ADD_TO_PROJECT.
Script
{
"type": "OPEN_MODELS",
"models": [
"C:/Users/userone/Desktop/1.ifc",
"C:/Users/userone/Desktop/2.ifc",
"C:/Users/userone/Desktop/3.bcp"
]
}
Explicação
Substitua "C:/Users/userone/Desktop/1.ifc", etc., pelos caminhos para os modelos que você gostaria de abrir, separados por vírgulas.
⚠️ Atenção: Sempre use barras "/" na definição do caminho, não barras invertidas.
Conectar ao projeto
Para realizar uma atualização de Smart Issues e compartilhar Listas, você precisa estar conectado a um projeto no BIMcollab.
O prompt para isso é CONNECT_TO_PROJECT
Script
{
"type": "CONNECT_TO_PROJECT",
"space_name": "example.bimcollab.com",
"project_name": "Meu projeto BIMcollab"
}
Explicação
Substitua "example.bimcollab.com" pela URL do espaço ao qual você deseja se conectar.
Substitua "Meu projeto BIMcollab" pelo nome do projeto ao qual você deseja se conectar. Preste atenção à grafia correta do nome e da URL.
⚠️ Atenção: É importante notar que o projeto ao qual você deseja se conectar faz parte da lista de projetos recentes no BIMcollab e que suas credenciais estão salvas no BIMcollab. Isso pode ser alcançado marcando a caixa de seleção 'Lembrar de mim' ao se conectar manualmente ao projeto.
Além disso, certifique-se de que o formato do parâmetro "space_name" corresponda exatamente ao formato em que o nome do espaço foi inserido ao se conectar ao projeto.
Se você, por exemplo, inseriu https://example.bimcollab.com/ ou example.bimcollab.com, isso precisa ser exatamente igual no script.
Filtrar issues
Uma vez que você está conectado a um projeto, todos os issues que estão visíveis para você no projeto serão carregados no BIMcollab.
No próximo passo, qualquer Smart Issue que faça parte desta lista pode ser atualizado automaticamente. Para atualizar apenas uma seleção de issues de sua escolha, primeiro configure o filtro de issues.
O prompt é FILTER_ISSUES.
Se este prompt for omitido do script, o último filtro ativo será usado.
Script
{
"type": "FILTER_ISSUES",
"filter_type": "Issue",
"area": "Model",
"milestone": "Fase de design",
"label": "Arquitetura",
"priority": "Normal",
"show_active": true,
"show_resolved": true,
"show_closed": false,
"hide_invisible": false,
"show_to_approve": false,
"assigned_to_user_email": "[email protected]",
"deadline": "01-01-2021",
"created_by_user_email": "[email protected]",
"custom1": "Valor 1",
"custom2": "Valor 2"
}
Explicação
Aqui estão algumas coisas a serem consideradas para esta parte do script:
Quando este prompt é adicionado ao script, o filtro de issue no BIMcollab é primeiro redefinido para o filtro padrão e, em seguida, ajustado de acordo com os valores no script.
O Nightshift assume as configurações padrão de parâmetros sempre que possível, então você só precisa especificar mudanças feitas a partir das configurações padrão. Todas as linhas de parâmetros nesta parte do script, exceto por "type": "FILTER_ISSUES" (definição de ação obrigatória) e "priority", podem ser omitidas do script. Se, por exemplo, o parâmetro "label" for omitido, o Nightshift manterá essa configuração de parâmetro em "All".
Preste atenção à grafia dos valores inseridos. Eles devem ser exatamente os mesmos que estão no projeto.
💡 Dica: Abra a janela de filtro de Issue no BIMcollab ao lado do editor JSON para evitar erros de digitação no script.
Todas as linhas nesta parte do script representam uma das propriedades no filtro de issue:
"filter_type"
Substitua "Issue" pelo tipo que você deseja filtrar. O valor padrão é "All" (ou o valor correspondente no idioma do seu projeto)."area"
Substitua "Model" pela área que você deseja filtrar. O valor padrão é "All" (ou o valor correspondente no idioma do seu projeto)."milestone"
Substitua "Fase de design" pela fase que você deseja filtrar. O valor padrão é "All" (ou o valor correspondente no idioma do seu projeto)."label"
Substitua "Arquitetura" pelo rótulo que você deseja filtrar. O valor padrão é "All" (ou o valor correspondente no idioma do seu projeto)."priority"
Substitua "Normal" pela prioridade que você deseja filtrar. O valor padrão é "All" (ou o valor correspondente no idioma do seu projeto)."show_active"
Este é um checkbox que determina se as issues ativas do projeto devem ser exibidas. Insira 'true' se o checkbox deve ser habilitado ou 'false' se deve ser desabilitado. O valor padrão é true."show_resolved"
Este é um checkbox que determina se as issues resolvidas do projeto devem ser exibidas. Insira 'true' se o checkbox deve ser habilitado ou 'false' se deve ser desabilitado. O valor padrão é true."show_closed"
Este é um checkbox que determina se as issues fechadas do projeto devem ser exibidas. Insira 'true' se o checkbox deve ser habilitado ou 'false' se deve ser desabilitado. O valor padrão é false."hide_invisible"
Este é um checkbox que determina se issues que não são visíveis para todos os membros da equipe devem ser ocultadas. Insira 'true' se o checkbox deve ser habilitado ou 'false' se deve ser desabilitado. O valor padrão é false."show_to_approve"
Este é um checkbox que determina se as issues que você precisa aprovar devem ser exibidas. Insira 'true' se o checkbox deve ser habilitado ou 'false' se deve ser desabilitado. O valor padrão é false."assigned_to_user_email"
Substitua "[email protected]" pelo endereço de email do usuário designado, não apenas pelo nome dele. O valor padrão é "" (issues atribuídas a todos os usuários são exibidas)."deadline"
Substitua "01-01-2021" pelo prazo no qual você deseja filtrar, no formato dd-mm-yyyy. O valor padrão é "" (nenhum prazo é considerado)."created_by_user_email"
Substitua "[email protected]" pelo endereço de email do criador, não apenas pelo nome dele. O valor padrão é "" (issues criadas por todos os usuários são exibidas)."custom1"
Substitua "Valor 1" pelo valor do Campo personalizado 1 que você deseja filtrar. A linha do script deve sempre começar com "custom1", não com o nome real do Campo personalizado. O valor padrão é "" (Todos os valores para este campo personalizado são exibidos)."custom2"
Substitua "Valor 2" pelo valor do Campo personalizado 2 que você deseja filtrar. A linha do script deve sempre começar com "custom2", não com o nome real do Campo personalizado. O valor padrão é "" (Todos os valores para este campo personalizado são exibidos).
⚠️ Atenção: Se uma das entradas do filtro estiver incorreta, o script não será executado.
Atualizar issues
Todos os Smart Issues que estão visíveis na aba Issues do BIMcollab podem ser atualizados automaticamente de acordo com o status dos clashes nos modelos carregados.
O prompt é UPDATE_ISSUES.
Script
{
"type": "UPDATE_ISSUES",
"close_where_clashes_solved": true,
"reopen_previously_closed_issues": false,
"comment": "Atualizado com Nightshift"
}
Explicação
Cada linha nesta parte do script representa uma das opções na janela 'Atualizar Smart Issues'. Note que 'Somente issues selecionadas' não está presente, pois nenhuma issue pode ser selecionada separadamente ao executar o script. A ação será realizada em todas as issues visíveis na aba issues.
"close_where_clashes_solved"
Este é um checkbox que determina se issues onde todos os clashes estão resolvidos podem ser fechadas com a atualização. Insira 'true' se o checkbox deve ser habilitado ou 'false' se deve ser desabilitado"reopen_previously_closed_issues"
Este é um checkbox que determina se issues fechadas que contêm clashes ainda ativos podem ser reabertas com a atualização. Insira 'true' se o checkbox deve ser habilitado ou 'false' se deve ser desabilitado"comment"
Substitua "Atualizado com Nightshift" por qualquer comentário que você gostaria de adicionar às issues atualizadas
Se alguma das opções estiver faltando, um valor padrão será adicionado, conforme mostrado na imagem abaixo.
Executar e compartilhar Listas
Todas as Listas localizadas em 'Compartilhado' na aba Listas podem ser executadas e compartilhadas ao mesmo tempo, para que as informações mais recentes estejam disponíveis para todos os membros da equipe no BIMcollab.
O comando para esta ação é RUN_AND_SHARE_LISTS
Script
{
"type": "RUN_AND_SHARE_LISTS",
"list_set-name" : "List set 3"
}
Explicação
O parâmetro "list_set_name" é opcional. Se você quiser executar um conjunto de listas específico, substitua "List set 3" pelo nome do conjunto de listas que deseja executar. Se o parâmetro não estiver presente, todas as Listas em 'Compartilhado' serão executadas e compartilhadas.
Sincronizar projeto
Uma vez que os Issues são atualizados e as Listas são executadas e compartilhadas, é importante sempre sincronizar o projeto com o BIMcollab, para que as mudanças sejam salvas e visíveis para o restante da equipe.
Sempre adicione este comando ao final do script.
O comando é SYNCHRONIZE_PROJECT.
Script
{
"type": "SYNCHRONIZE_PROJECT"
}
Acompanhar o status da tarefa
Uma vez que a tarefa foi executada, você pode verificar se todas as ações foram realizadas com sucesso no arquivo de log do Nightshift. O arquivo fornece feedback sobre o status de execução de todas as ações nos scripts e códigos de erro se algo deu errado.
Você pode encontrar todos os arquivos de log em C:\Users\\AppData\Roaming\KUBUS\BIMcollab Zoom\Nightshift.
Substitua pelo nome do seu próprio perfil de usuário no Windows.
A pasta AppData é uma pasta oculta por padrão. Exiba as pastas ocultas no Explorador de Arquivos para navegar até o local correto.