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 índiceAções no Mac, iPhone e iPad
| Ação | O que faz |
|---|---|
| Abrir calendário | Escolha um conjunto de calendários, uma das seis disposições e uma data inicial opcional. |
| Obter conjuntos de calendários | Devolve nomes e IDs dos conjuntos de calendários guardados. |
| Escolher intervalos de datas | Selecione e confirme datas para devolver intervalos tipados com início, fim, contagem inclusiva de dias e fuso horário. |
| Obter planos guardados | Devolve planos guardados, os respetivos intervalos e informações de repetição. Filtre por nome ou ID. |
| Criar plano guardado | Guarda um intervalo inclusivo com nome e devolve o ID do plano. |
| Duplicar plano guardado | Duplica um plano guardado com outro nome e devolve o seu ID. |
| Abrir plano guardado | Abre um plano guardado com os intervalos e definições de repetição atuais. |
| Mudar conjunto de calendários ativo | Muda o conjunto ativo mantendo a data e a disposição atuais. |
| Contar dias úteis | Conta os dias úteis usando o horário ativado e os calendários de ausências de dia inteiro. Ambos os extremos contam. |
| Adicionar dias úteis | Avança ou retrocede por dias úteis. O dia inicial não conta. |
| Pausar sinais sonoros | Pausa os sinais sonoros pelo número de minutos indicado, até sete dias. |
| Retomar sinais sonoros | Encerra a pausa preservando a programação e o estado de ativação dos sinais sonoros. |
| Exportar imagem do calendário | Exporta um PNG de até dois anos civis. Inclui apenas os planos solicitados. Círculos de eventos são omitidos, a menos que solicitados. |
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 índiceControlos 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 índiceCrie 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.