オートメーションのドキュメント

Appleショートカット

カレンダーセット、確定した日付範囲、保存済みプラン、稼働日、カレンダー画像を使ったワークフローを作成します。

このガイドはpopCalendar 1.3以降を対象としています。一部のアクションには、以下に記載する新しいシステムバージョンが必要です。

ショートカットでpopCalendarを探す

更新後のアプリを一度開き、Appleショートカットでアクションを追加してpopCalendarを検索します。アクションはmacOS 13以降とiOS 17以降で利用できます。Macの日付選択と候補のAppショートカットにはmacOS 13.3以降が必要です。macOS 12ではCLIとURLインターフェイスを使えます。

popCalendarのセクションには、カレンダーを開く、日付範囲を選択、稼働日を数える、チャイムを一時停止、チャイムを再開のショートカットが用意されています。一時停止の既定値は60分です。ショートカットファイルの読み込みは不要です。

目次に戻る

Mac、iPhone、iPadのアクション

アクション動作
カレンダーを開くカレンダーセット、6種類の表示、任意の開始日を選びます。
カレンダーセットを取得保存済みカレンダーセットの名前とIDを返します。
日付範囲を選択日付を選んで確定し、開始日、終了日、両端を含む日数、タイムゾーンを持つ型付きの範囲を返します。
保存済みプランを取得保存済みプラン、その範囲、繰り返し情報を返します。名前またはIDで絞り込めます。
保存済みプランを作成両端を含む日付範囲を名前付きで保存し、プランIDを返します。
保存済みプランを複製保存済みプランを別の名前で複製し、そのIDを返します。
保存済みプランを開く現在の範囲と繰り返し設定を使って保存済みプランを開きます。
アクティブなカレンダーセットを切り替え現在の日付と表示を維持して、アクティブなカレンダーセットを切り替えます。
稼働日を数える有効な勤務スケジュールと終日の休暇カレンダーを使って稼働日を数えます。両端の日付を含みます。
稼働日を追加稼働日単位で前後に移動します。開始日は数えません。
チャイムを一時停止指定した分数だけチャイムを一時停止します。最長7日間です。
チャイムを再開設定済みのチャイムのスケジュールと有効状態を維持して、一時停止を終了します。
カレンダー画像を書き出す最大2暦年分のPNGを書き出します。指定した保存済みプランだけを含みます。イベントの丸印は指定した場合だけ含みます。
目次に戻る

セットとプラットフォームごとの動作

保存済みセットを名前で一覧表示するには、個人データへのアクセスを有効にします。選択は固定IDを使うため、セット名を変えてもショートカットは動作します。セットを削除すると、別のセットを開かずエラーになります。ネイティブアクションにMacの外部操作権限は不要です。

Macのカレンダーを開くは、フィルタをコピーした独立したウインドウを作ります。既定のセッション名はshortcutsで、再利用すると同じウインドウを更新します。iPhoneとiPadではカレンダータブを開き、選んだモード、日付、アクティブなセットを適用します。ほかのiPadウインドウの日付と表示は維持されます。

目次に戻る

Mac専用の追加操作

カレンダーを操作は、URLインターフェイスと同じオプションで名前付きセッションの表示、切り替え、更新、移動、終了を行います。ウインドウ、ポップアップ、全画面を選べます。カレンダーセッションを取得はIDを一覧表示します。カレンダーコマンド情報を取得は、バージョン、リファレンス、対応機能、診断を返します。

カレンダーの日付を選択は、確定した範囲をJSONまたはテキストで返します。日付範囲を選択は型付きの値を返します。既定のタイムアウトは300秒です。Escapeまたは選択画面を閉じる操作でキャンセルします。ネイティブの停止によるキャンセルはmacOSとiOS 26.4以降に対応しています。それ以前でもキャンセルとタイムアウトが使えます。

目次に戻る

ワークフローを作る

  • 日付範囲を選択し、各範囲について繰り返し、稼働日を数えます。
  • カレンダーセットを取得し、リストから選択し、そのセットでカレンダーを開きます。
  • 保存済みプランを取得し、プランを選び、開くか複製します。作成や複製の再試行には固定のリクエストUUIDを指定します。
  • カレンダー画像を書き出し、ファイルを保存、共有、または写真アルバムに保存を使います。書き出し結果はPNGファイルです。
  • 集中して作業を始める際にアクティブなセットを切り替え、チャイムを一時停止し、終わったら再開します。各デバイスで必要な権限を先に有効にしてください。
目次に戻る