Documentação de automação

Atalhos da Apple

Crie fluxos com conjuntos de calendários, intervalos confirmados, planos guardados, dias úteis e imagens do calendário.

Estes guias abrangem o popCalendar 1.3 e versões posteriores. Algumas ações exigem uma versão mais recente do sistema, conforme indicado abaixo.

Encontre popCalendar em Atalhos

Abra a aplicação atualizada uma vez, adicione uma ação em Atalhos da Apple e procure popCalendar. As ações estão disponíveis no macOS 13 ou posterior e iOS 17 ou posterior. Os seletores de datas e os atalhos sugeridos no Mac exigem macOS 13.3 ou posterior. No macOS 12, use CLI ou URL.

A secção popCalendar inclui os atalhos prontos Abrir calendário, Escolher intervalos de datas, Contar dias úteis, Pausar sinais sonoros e Retomar sinais sonoros. A pausa predefinida é de 60 minutos. Não é necessário importar um ficheiro de atalhos.

Voltar ao índice

Ações no Mac, iPhone e iPad

AçãoO que faz
Abrir calendárioEscolha um conjunto de calendários, uma das seis disposições e uma data inicial opcional.
Obter conjuntos de calendáriosDevolve nomes e IDs dos conjuntos de calendários guardados.
Escolher intervalos de datasSelecione e confirme datas para devolver intervalos tipados com início, fim, contagem inclusiva de dias e fuso horário.
Obter planos guardadosDevolve planos guardados, os respetivos intervalos e informações de repetição. Filtre por nome ou ID.
Criar plano guardadoGuarda um intervalo inclusivo com nome e devolve o ID do plano.
Duplicar plano guardadoDuplica um plano guardado com outro nome e devolve o seu ID.
Abrir plano guardadoAbre um plano guardado com os intervalos e definições de repetição atuais.
Mudar conjunto de calendários ativoMuda o conjunto ativo mantendo a data e a disposição atuais.
Contar dias úteisConta os dias úteis usando o horário ativado e os calendários de ausências de dia inteiro. Ambos os extremos contam.
Adicionar dias úteisAvança ou retrocede por dias úteis. O dia inicial não conta.
Pausar sinais sonorosPausa os sinais sonoros pelo número de minutos indicado, até sete dias.
Retomar sinais sonorosEncerra a pausa preservando a programação e o estado de ativação dos sinais sonoros.
Exportar imagem do calendárioExporta um PNG de até dois anos civis. Inclui apenas os planos solicitados. Círculos de eventos são omitidos, a menos que solicitados.
Voltar ao índice

Conjuntos e comportamento por plataforma

Ative o acesso a dados privados para listar conjuntos guardados por nome. As escolhas usam IDs estáveis, pelo que renomear um conjunto não impede o funcionamento de um atalho. Apagar um conjunto gera um erro em vez de abrir outro. As ações nativas não exigem o controlo externo do Mac.

No Mac, Abrir calendário cria uma janela independente com uma cópia do filtro. A sessão predefinida é shortcuts. Reutilizá-la atualiza a mesma janela. No iPhone e iPad, abre o separador Calendário e aplica o modo, a data e o conjunto escolhidos. As outras janelas do iPad mantêm as suas datas e disposições.

Voltar ao índice

Controlos adicionais do Mac

Controlar calendário abre, alterna, atualiza, move ou fecha sessões com nome e as mesmas opções da interface URL. Escolha janela, painel ou ecrã completo. Obter sessões do calendário lista os seus IDs. Obter informações de comandos do calendário devolve a versão, a referência, as capacidades ou o diagnóstico.

Selecionar datas do calendário devolve intervalos confirmados em JSON ou texto. Escolher intervalos de datas devolve valores tipados. O tempo limite predefinido é de 300 segundos. Escape ou fechar o seletor cancela a operação. O cancelamento nativo com Parar é suportado no macOS e iOS 26.4 ou posteriores. As versões anteriores mantêm Cancelar e o tempo limite.

Voltar ao índice

Crie um fluxo de trabalho

  • Escolher intervalos de datas, repetir com cada intervalo e depois Contar dias úteis.
  • Obter conjuntos de calendários, Escolher da Lista e depois Abrir calendário com o conjunto escolhido.
  • Obter planos guardados, escolher um plano e depois Abrir plano guardado ou Duplicar plano guardado. Use um UUID de pedido estável ao repetir uma criação ou duplicação.
  • Exportar imagem do calendário e depois Guardar ficheiro, Partilhar ou Guardar no álbum de fotografias. A exportação devolve um ficheiro PNG.
  • Mudar conjunto de calendários ativo e Pausar sinais sonoros ao iniciar um período de foco. Retomar sinais sonoros depois. Ative primeiro as permissões correspondentes em cada dispositivo.
Voltar ao índice