メインコンテンツまでスキップ

📦ガル助ver.2 製品概要

Garoon、Microsoftのカレンダーの予定を双方向で即時に同期するGaroonの機能拡張サービスです。

📅同期対象について​

予定範囲​

現在時刻より未来分の予定かつ、予定の参加者にガル助連携ユーザーが含まれている予定が対象となります。 繰り返し予定については、現在時刻～未来1年以内の予定が同期の対象です。

予定種別​

予定の種類対応備考
通常予定○
期間予定○Microsoft→Garoon同期時は通常予定として作成
繰り返し予定（毎日）○
繰り返し予定（毎週平日）○
繰り返し予定（毎週x曜日）○
繰り返し予定（2or3週間ごとにx曜日）○
繰り返し予定（毎月第1～4x曜日）○
繰り返し予定（毎月最終x曜日）○
繰り返し予定（毎月n日）×
更新予定（繰り返し予定内の特定日予定以降をすべて更新）○
更新予定（繰り返し予定内の特定日予定のみ更新）×
削除予定（繰り返し予定内の特定日予定のみ削除）×
1年以上先の繰り返し予定△1年以内の予定のみ同期対象（1年以内となったタイミングで自動で同期します）
繰り返し予定に関する注意事項

■Microsoftでは作成できてGaroonでは作成できない繰り返し条件の予定は同期の対象外となります。

  • 複数曜日指定
  • 年単位の繰り返し
  • 2日おきや2か月おきといった2以上の繰り返し間隔の繰り返し予定
    • ただし、2週間毎 および 3週間毎 の繰り返し予定は同期対象となります。

■Garoon施設を含む繰り返し予定作成時に「次の予定で施設が重複しています」と表示された場合

「次の予定で施設が重複しています」と表示され「はい」で登録した繰り返し予定は、ガル助の同期対象外となります。
この操作で登録された繰り返し予定は「特定日が削除された予定」となり、これはガル助の同期対象外の操作に該当します。

繰り返し予定の特定日のみを変更・削除した場合の挙動（参考）​

繰り返し予定の特定日のみを変更・削除する操作は、ガル助の同期対象外です。
この操作をしたあとの繰り返し予定の扱いが、GaroonとMicrosoftで異なるためです。
GaroonとOutlook/Teamsのどちらで操作しても、特定日の変更・削除は同期先に反映されません。

この操作をおこなうと、予定は以下のように扱われます。
以下では、特定日のみを変更した予定を「単独予定」と呼びます。

  • 単独予定：特定日のみを変更した予定です。サービスによって扱いが異なります。
    • Garoonでは、繰り返し予定から外れ、1件の予定として扱われます。
    • Outlook/Teamsでは、元の繰り返し予定の一部として扱われます。繰り返し予定の全体で、曜日や時刻などの繰り返しの条件を変更すると、特定日の変更は取り消されます。
  • 特定日が欠けた繰り返し予定：元の繰り返し予定です。Garoonでは、変更・削除した日の予定が含まれない状態になります。

例えば、4月から翌年3月まで毎月第1月曜日の繰り返し予定を登録し、10月分のみを変更した場合は以下のとおりです。

  • 10月分：単独予定
  • 4月～9月、11月～翌年3月：特定日が欠けた繰り返し予定

この操作のあとに、これらの予定を変更した場合の挙動は以下のとおりです。

操作Garoonで変更した場合Outlook/Teamsで変更した場合
単独予定を変更するMicrosoftに新しい予定として同期されます（※1）Garoonに同期されません
特定日が欠けた繰り返し予定の、別の特定日のみを変更する同期されません。保存時にエラーが表示される場合がありますGaroonに同期されません
特定日が欠けた繰り返し予定の全体を変更する（曜日の変更など）保存時にエラーが表示される場合があります（※2）Garoonの繰り返し予定が更新されます。ただし、Garoonに同期されない場合があります（※3）
※1 Microsoftには、元の繰り返し予定の同じ日の予定も残ります。​
※2 エラーが表示されなかった場合は、Microsoftに同期されます。エラーが表示された場合、Garoonの変更は保存されますが、Microsoftの予定は変更前のままになります。​
※3 Garoonに同期されなかった場合、Outlook/Teamsの変更は保存されますが、Garoonの予定は変更前のままになります。また、過去を含む繰り返し予定の場合、過去の分がGaroonに別の予定として登録されます。詳しくはこちらの「過去を含む繰り返し予定を更新した場合、Garoon側で過去の予定が多重登録される場合があります。」をご参照ください。​
注意

上記は参考情報です。GaroonやMicrosoftの仕様変更などにより、挙動が変わる場合があります。

備考
  • 過去分に関しては基本同期を行いませんが、予定時間によっては数時間過去であっても同期される場合がございます。
  • Garoonの予定につきましては先頭のユーザー(=予定の主催者)が連携ユーザーである予定のみ対象となります。
  • 期間予定はGaroonにのみ存在する予定の種類になります。日を跨ぐ通常予定として同期されます。

項目​

注意
  • 記載されていない項目は同期対象外です。
  • 対象項目を選択することはできません。以下のすべての項目が同期対象となります。
GaroonOutlook備考
開始/終了日時開始/終了日時
タイトルタイトル
予定メニュー分類予定メニュー、分類に同じ名前のものの事前追加が必要です
参加者出席者
施設会議室連携設定を行った施設のみが同期対象となります。Microsoft側は会議室メールボックスのみ連携でき、備品メールボックスは連携できません。
メモ説明Microsoft側の予定のメモ欄にTeams会議URLが設定されると、ガル助が自動でGaroonの予定のメモ欄に同期します。Outlookでハイパーリンクを追加した場合、Garoon側にはURLを展開した状態で同期します。
公開方法公開/非公開Garoonから非公開予定を追加する場合には共有先に代表アカウントを含める必要があります
Garoon施設（会議室）とOutlook「場所」欄の同期について

ガル助はGaroonの施設を、Outlookの会議室（リソースの出席者）として同期します。Outlookの「場所」欄への書き込みはおこないません。

「場所」欄は、会議室の予約承諾に応じてOutlook（Exchange）側が自動で補完するものであり、ガル助の制御対象外です。

そのため、Garoon側で会議室を変更した場合に、Outlookの「場所」欄に変更前の会議室が残る・累積して表示されることがありますが、これはガル助の仕様（「場所」欄は同期対象外）によるものです。会議室（出席者）としては最新の会議室に正しく更新されています。

操作​

Garoon​

  • 予定の登録
  • ポップアップウィンドウでの予定の登録
  • 予定の変更
    • 通常予定/期間予定の変更
    • 繰り返し予定の変更（操作の詳細）
      • 指定する日付以降の全ての繰り返し予定を変更する場合
      • 全ての繰り返し予定を変更する場合
  • ドラッグアンドドロップで予定の日時を変更する（同期されない予定があります。詳しくはこちら）
  • 予定に参加する（操作の詳細）
    • 通常/期間予定に参加する
    • 繰り返し予定に参加する
      • 指定する日付以降の全ての繰り返し予定を参加する場合
  • 予定から抜ける（操作の詳細）
    • 通常/期間予定から抜ける
    • 繰り返し予定から抜ける
      • 指定する日付以降の全ての繰り返し予定を抜ける場合
  • 予定の削除（操作の詳細）
    • 通常/期間予定の削除
    • 繰り返し予定の削除
      • 指定する日付以降の全ての繰り返し予定を削除する場合
      • 全ての繰り返し予定を削除する場合
以下の操作は同期対象外となります。

その他同期対象操作一覧に記載のないものは基本的に対象外となります。

Outlook/Teams​

  • 同期先のカレンダーに予定が作成された際
  • 同期先のカレンダー内の予定が変更された際
    • 通常予定の変更
    • 繰り返し予定の変更
      • 今回とこれ以降の全てのイベントの変更
      • この定期的なイベントの全ての変更
  • 同期先のカレンダー内の予定が削除された際
    • 通常予定の削除
    • 繰り返し予定の削除
      • 今回とこれ以降の全てのイベントの削除
      • この定期的なイベントの全ての削除

組織が参加者に含まれる予定の同期について​

Garoonの予定の参加者に「組織」が含まれている場合、同期の方向によって以下のように処理されます。

Garoon → Outlook 同期時​

  • 組織に所属するユーザーのうち、ガル助の連携ユーザーのみがOutlookの参加者として個別に追加されます
  • Outlookには「組織」という概念がないため、組織そのものは同期されず、所属するユーザーに展開されます

一度同期された後のOutlook → Garoon 変更同期時​

  • Garoon側の予定に設定されている組織の参加者はそのまま維持されます
  • Outlook側で参加者が変更された場合：
    • 変更された参加者が組織のメンバーである場合：元のGaroon予定にその方が個別の参加者としても登録されていた場合のみ、個別の参加者として追加されます。組織経由のみで参加していた方は個別追加されません（組織の参加者として既に含まれているため）
    • 変更された参加者が組織のメンバーでない場合：通常通り個別の参加者として追加されます

Garoonでの予定登録・変更時の注意事項​

  • 組織だけではなく、組織に所属しているユーザーから1名を参加者に設定してください
  • 参加者に組織のみが設定されており、連携ユーザーが含まれていない場合、同期は行われません

Outlookでメーリングリストを参加者に追加した場合の挙動​

Outlookからメーリングリストを参加者に追加した場合、各参加者が承諾するまでは、その参加者はOutlookの予定の出席者に含まれません。
そのため、承諾していない参加者はガル助によりGaroonへ同期されません。

注意
  • メーリングリストに含まれる予定の主催者が承諾した時点ではじめて、Garoonへの同期がおこなわれます。
  • 主催者以外の参加者が先に承諾しても、その時点ではGaroonには同期されません。
  • 主催者が承諾してGaroonへ同期された際、それまでに承諾していた他の参加者もあわせてGaroonに同期されます。

🧩その他機能​

ガル助非連携ユーザーからの招待同期​

外部Microsoftテナントユーザーなどのガル助非連携ユーザーからの招待も同期することが可能です。

注意

ゲストとして招待された予定は、ガル助が変更や削除する権限がないため、Garoonからの変更・削除を反映することができません。 そのた非連携ユーザーから招待されて同期されたGaroon予定を変更・削除しようとした場合には以下エラーが発生し、変更・削除を行うことができません。

GRN_CMMN0_3021

社内のガル助利用ユーザーが作成した会議でも、Teamsのチーム（チャネル）で作成した会議は主催者がチームとなるため、同様にGaroonから変更・削除できません。詳しくはこちらをご参照ください。

外部サービスからの招待予定に対する辞退・削除時の挙動​

外部Microsoftテナントや外部Googleカレンダーから招待された予定に対して、削除・辞退（キャンセル）・参加者からの削除をおこなった場合、同期先のGaroon予定は以下のように変化します。

操作外部サービス(例: Googleカレンダー)Outlook
主催者が予定を削除件名の頭に「予定のキャンセル: 」が付与される（不可）
　└ その後参加者の予定から削除削除ー
参加者が予定を削除削除削除
主催者が予定を辞退（キャンセル）変化なし件名の頭に「キャンセル済み」が付与される
　└ その後参加者の予定から削除ー削除
参加者が予定を辞退（キャンセル）件名の頭に「予定のキャンセル: 」が付与される削除
主催者が参加者を予定から削除削除件名の頭に「キャンセル済み」が付与される
　└ その後参加者の予定から削除ー削除
注意

Outlookの自動承諾・自動辞退の設定などにより挙動が異なる場合がございます。

Teams会議URL発行 & 外部ユーザー招待機能​

Garoonの予定画面からTeams会議URLの発行、外部ユーザーの招待をおこなうことができます。

Microsoft側の予定のメモ欄にTeams会議URLが設定されると、ガル助が自動でGaroonの予定のメモ欄に同期します。

Teams会議URL発行機能

Garoonクラウド版の「Web会議連携」との違い

Garoonクラウド版にも予定にWeb会議（Teams会議）のURLを付与するWeb会議連携機能が搭載されていますが、以下の違いがあります。

ガル助の「Teams会議URL発行 & 外部ユーザー招待機能」Garoonクラウド版のWeb会議連携機能
【予定の同期】おこなう（Garoonの予定とOutlook（Teams）の予定を同期）おこなわない
【Teams会議URL】同期したTeams側の予定にひもづくURLを付与単発でTeams会議URLを発行し、Garoonの予定にURLを保持するのみ

ガル助はGaroonとOutlook（Teams）の予定そのものを同期したうえでTeams会議を付与するのに対し、Garoonクラウド版のWeb会議連携機能は予定の同期はおこなわず、発行したTeams会議URLをGaroonの予定に保持するだけ、という点が大きく異なります。

🖥️動作環境​

Garoonサーバー​

クラウド版​

バージョン別の制約無くご利用いただけます

パッケージ版5.15以上​

バージョン別の制約無くご利用いただけます

パッケージ版5.9​

予定への参加/不参加機能には非対応
※Garoon JavaScript APIにおいて当該イベント非提供のため

備考

パッケージ版(5.9以上)は通常版およびDB分割構成版でご利用可能です。

注意

パッケージ版 version 5.5以下は動作対象外です。
(Garoon JavaScript APIにおいて、ガル助の動作に必要な予定登録成功・変更成功イベントが非提供のため。)

Garoonクライアント​

Webブラウザ版且つPC表示のみ対応

注意

モバイル表示およびモバイル向けGaroonアプリからの操作には対応していません
(Garoon JavaScript カスタマイズがモバイル対応していないため)

Microsoft365サーバー​

Exchange Online（クラウド版）​

企業向け有償版のみ対応（無償の個人版は利用不可）

Exchange Server（オンプレ版）​

Microsoft365 クライアント​

Microsoftサービス​

  • Outlook
  • Teams

デバイス​

  • Webブラウザ版
  • デスクトップアプリ (最新版)
  • モバイルアプリ (最新版)

🔄同期の仕組みについて​

ガル助はパブリッククラウドに配置されたサーバーより、インターネット経由で各お客様のGaroonおよびMicrosoft環境にアクセスすることにより同期を実現します。
サーバーや利用者端末へのインストールは不要でご利用いただけます。

Garoon/Microsoftにおいて以下それぞれの方法でカレンダー内の予定の変更を検知し、同期を行います。

Garoonスケジュールの操作検知方法​

Garoon Javascript API イベント

  • JavaScriptカスタマイズによりスケジュールに対する各イベントの発生を検知し、ガル助サーバーへのリクエストをおこなうことで同期を行います。
  • JavaScriptカスタマイズはGaroon画面上での操作にのみ適用されるため、REST APIやSOAP APIによる操作は検知することができません。
  • イベントが提供されていない操作については非対応となります。現在非対応のイベントについては、今後イベントが提供されましたら機能追加の検討を行います。

参考) Garoon APIドキュメント > Garoon JavaScript API > スケジュール > イベント
https://cybozu.dev/ja/garoon/docs/js-api/schedule/event/

Microsoftカレンダー(Outlook/Teams)の操作検知方法​

Microsoft Graph API変更通知

  • Garoonとは異なり、画面上の操作ではなくデータの変更を検知する方式となります。そのため、REST APIによる操作も検知することが可能です。

参考) Microsoft Graph API変更通知
https://learn.microsoft.com/ja-jp/graph/api/resources/change-notifications-api-overview?view=graph-rest-1.0

🔐Microsoft Entraアプリケーションが利用するスコープ​

ガル助は設定時にMicrosoft Entra IDへアプリケーションを自動で登録します。このアプリケーションでは以下のスコープを利用します。

  • User.Read
  • Calendars.ReadWrite
  • Channel.ReadBasic.All
  • Mail.ReadWrite
  • Mail.Send
  • Place.Read.All （代表アカウントの認証時のみ必要）

⚠️その他導入にあたっての注意事項​

その他、制約・注意事項についてはこちらをご参照ください。

製品紹介ページ​

製品のご紹介、利用規約の確認、トライアル申し込み等はこちらから
https://novelworks.jp/garsche2