Google カレンダー - カレンダー同期

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：5分

    • Google カレンダーとの接続を作成し、ワークプレイス予約管理 アプリケーションを使用して行われた予約を同期します。ワークプレイス予約管理 を使用して行われたすべての予約を Google カレンダーに同期したり、その逆を行ったりすることができます。

    Google カレンダーから ワークプレイス予約管理 への予約の同期は、イベントやオカレンスなどのさまざまなアプローチを使用して実行されます。

    重要:
    アプリケーションは、Google カレンダーの Strict モード構成をサポートしていません。

    ワークプレイス予約管理 から Google カレンダーへの同期

    ワークプレイス予約管理 から Google への同期プロセスは、Google Calendar スポークを使用して実行されます。フローデザイナーを使用して Google との接続を設定できます。

    同期プロセスには次の手順が含まれます。
    1. Google Calendar スポークをインストールします。
    2. Google Calendar スポークを設定します。
    3. Google を使用して ServiceNow を認証します。「カレンダー同期用の Google の認証」を参照してください。
    4. フローデザイナーを使用して Google Calendar Spoke 接続を構成します。「Google の接続および認証情報レコードの作成」を参照してください。
    5. Google カレンダープロバイダーを作成します。「カレンダープロバイダーとしての Google の構成」を参照してください。
    アプリケーションでは、フローデザイナーを使用して作成されたデフォルトのエイリアスを使用する代わりに、独自の接続および資格情報エイリアスを作成することもできます。「独自の Google 接続および資格情報エイリアスの構成」を参照してください。

    Google カレンダーから ワークプレイス予約管理 への同期

    Google カレンダーから予約ポータルへの予約の同期は、スケジュール済みジョブ (WSDRS Sync Calendar items) を使用して Google カレンダーの最新のカレンダー更新をプルすることによって行われます。同期が有効なルームに関連するすべてのイベントは、ワークプレイス予約管理 アプリケーションで読み取られて更新されます。アプリケーションは、[イベント] テーブルに作成、更新、削除、および読み取りイベントを作成します。

    スケジュール済みジョブ (WSDRS Sync Calendar items) は、すべてのアクティブな予約可能な同期構成の最新の変更を取得するためにアプリケーションで提供されます。スケジュール済みジョブはデフォルトで False に設定されており、同期を開始するには有効にする必要があります。デフォルトでは、スケジュール済みジョブは 5 分ごとに実行されるように設定されています。ただし、スケジュール済みジョブの時刻は、必要に応じて設定できます。いつでも手動で実行することもできます。

    デルタ同期と呼ばれるアプローチは、ワークスペースカレンダーの同期 アプリケーションで使用されます。デルタ同期では、同期トークンと呼ばれる参照ポイントを使用して、カレンダーのリソースメール ID に加えられた増分変更のみを取得します。つまり、オンプレミスカレンダープロバイダーにリンクされた各ルーム (各予約可能な同期レコード) について、カレンダーから増分で更新を取得するための参照ポイントである同期トークンを取得します。
    • [ページサイズ]、[同期バッチサイズ]、[同期バッチ間隔]に基づいて、情報は同期トークンによって取得されます。たとえば、(前のフィールドで) 値をそれぞれ 5、 500、60 と指定したとします。これは、60 秒間隔で 500 件の要求を生成できることを意味します。同期により、1 ページで 5 つの変更が行われます。
    • Google カレンダーの下に予約可能な同期設定レコードを作成する場合は、それがアクティブ化されていることを確認する必要があります。
    • 同期レコードがアクティブ化されると、フローがトリガーされ、その予約可能な同期レコードの同期トークンが [デルタ同期] モジュールに作成されます。
    • スケジュール済みジョブ (WSDRS Sync Calendar items) は、すべてのアクティブな予約可能な同期構成の最新の変更を取得するためにアプリケーションで提供されます。スケジュール済みジョブはデフォルトで False に設定されており、同期を開始するには有効にする必要があります。デフォルトでは、スケジュール済みジョブは 5 分ごとに実行されるように設定されています。ただし、スケジュール済みジョブの時刻は、必要に応じて設定できます。いつでも手動で実行することもできます。
    • 予約可能な同期構成に加えられた変更は、[イベント] モジュールでイベントとして作成されます。アプリケーションは、Google カレンダーの作成、更新、削除、読み取りイベントを作成します。
    • 同期レコードごとに、イベントが作成されます。カレンダープロバイダーで指定されたページサイズに応じて、変更が表示されます。保留中の変更がある場合は、次回のスケジュール済みジョブの実行中に表示されます。
    • 同期トークンを取得するために使用される API は、イベントの [応答] フィールドに応答を保存します。API は、単一の予約、複数の予約、および親の繰り返し予約に対して行われた変更を提供します。
    • API によって作成された応答を使用して、ワークプレイス予約管理 アプリケーションで予約が作成されます。
    • スケジュール済みジョブが実行されるたびに、次の同期の参照ポイントとして使用される同期トークンも更新されます。

    過去の予約と同期する

    ワークスペースカレンダーの同期 を使用すると、過去に行われた予約を同期することもできます。[同期開始日時] フィールドと [同期終了日時] フィールドで日時の範囲を指定できます。オンプレミスカレンダーの場合、過去の予約を同期するには、次の条件を満たす必要があります。
    • 構成した Google カレンダープロバイダーであるカレンダープロバイダーは、アクティブである必要があります。
    • [過去の予約と同期する (Synchronize past reservations)] フィールドを選択する必要があります。
    • 過去の予約を同期する予約可能同期構成がアクティブである必要があります。
      注:
      [過去の予約を同期する(Synchronize past reservations)]を有効にした後、各予約可能な同期設定レコードの場所に移動し、[場所を同期 (Sync Location)] を選択する必要があります。

    「要求なし」処理

    要求なしは、カレンダー用に作成されたイベントのペイロードの生成された構文を検証するメカニズムです。ただし、イベントはカレンダープロバイダーに送信されるのではなく、作成されるだけです。アドミニストレーターは、イベント (JSON) のペイロードコンテンツを検証して、が期待どおりに生成されていることを確認できます。 [要求なし] を選択すると、 ワークプレイス予約管理 アプリケーションで予約を作成、更新、またはキャンセルするときに、アプリケーションがカレンダープロバイダーに対して API 呼び出しを行わないようにします。