Garoon スケジュールのカスタム項目（additionalItems）廃止のスケジュール（2022/10/12）

「cybozu developer network」をご利用いただきましてありがとうございます。

Garoon スケジュールのカスタム項目（additionalItems）の廃止予定について（2021/04/09）で案内していた、
カスタム項目（additionalItems）（以降、additionalItems） 廃止のスケジュールをお知らせします。

Garoon スケジュールのカスタマイズやプラグインで、additionalItems を利用している場合には、
廃止までに下記の「対応方法」を参照して、コードの差し替えやプラグインのアップデートを行って下さい。
廃止後は、additionalItems を利用しているスケジュールのカスタマイズが動かなくなります。

additionalItems 廃止の背景は、Garoon スケジュールのカスタム項目（additionalItems）の廃止予定について（2021/04/09）を参照してください。

additionalItems 廃止のスケジュール

クラウド版とパッケージ版とで、廃止までのスケジュールが異なります。

クラウド版

• 2022年11月13日メンテナンスより 
  additionalItems を使ったプラグインやカスタマイズが動作しなくなります。
  
  • additionalItems へのデータの登録や更新ができなくなります。
    additionalItems にデータを登録、または更新しようとすると、GRN_SCHD_13384 または GRN_SCHD_13385 エラーが返されます。
    システム管理に追加される additionalItems の編集に関する設定を有効にした場合のみ、データの登録や更新ができます。
  • 登録済みの予定の additionalItems の情報は参照できます。
• 2023年5月14日メンテナンスより
  
  • すべての環境において additionalItems へのデータの登録や更新ができなくなります。additionalItems の編集に関する設定が廃止されます。
  • 登録済みの予定の additionalItems の情報は参照できます。
• 2023年8月13日メンテナンスより
  
  • additionalItems に保存されていたデータが削除されます。
  • 登録済みの予定の additionalItems の情報を参照できなくなります。

パッケージ版

• 2023年秋リリース予定 パッケージ版 Garoon 次期バージョンより
  additionalItems を使ったプラグインやカスタマイズが動作しなくなります。
  • additionalItems へのデータの登録や更新ができなくなります。
    additionalItems にデータを登録、または更新しようとすると、GRN_SCHD_13384 または GRN_SCHD_13385 エラーが返されます。
  • 登録済みの予定の additionalItems の情報を参照できなくなります。

対応方法

利用しているカスタマイズやプラグインに応じて、コードの差し替えやプラグインのアップデートを行って下さい。
なお、すでに登録済みの予定については、自動でデータ移行されません。詳細は後述の「注意事項」を確認してください。

cybozu developer network に掲載しているサンプルコードの場合

次の cybozu developer network のサンプルコードを利用している場合は、現在公開しているコードに差し替えてください。

対象記事

• 【Garoon REST API】スケジュールで受付管理業務を実現する
• Garoon x Box 連携（ポータル・スケジュール）
• Garoon スケジュールとOutlook 予定表を使って予定を調整する
• Garoon スケジュール・ポータルのカスタマイズをはじめよう〜会議効率化カスタマイズ〜
• Garoon スケジュールをカスタマイズして、往訪予定を調整しよう

製品サイトで案内しているプラグインの場合

次のプラグインを利用している場合、プラグインをアップデートするの手順に従ってアップデートをしてください。

• アンケートプラグイン（サイボウズ）
• CROSS Link 365 Teams 連携（クロス・ヘッド）

個別開発のカスタマイズやプラグインの場合

その他個別開発のカスタマイズを利用している場合は、additionalItems を利用しているソースコードを、
次の記事を参照して Schedule datastore を利用するように修正してください。

• Garoon REST API
  • 予定のカスタム項目（Schedule datastore）の取得（GET）
  • 予定のカスタム項目（Schedule datastore）の登録（POST）
  • 予定のカスタム項目（Schedule datastore）の更新（PUT）
  • 予定のカスタム項目（Schedule datastore）の削除（DELETE）
• Garoon JavaScript API
  • カスタム項目（Schedule datastore）の値を取得する
  • カスタム項目（Schedule datastore）の値をセットする

個別開発のプラグインを利用している場合は、ソースコードを修正しパッケージングし直したプラグインにアップデートしてください。
詳細は、プラグインの提供元にご確認ください。

注意事項

すでに登録済みの予定については、自動でデータ移行されません。

必要に応じて、予定の additionalItems に保存している情報を、Schedule datastore へ保存するように移行してください。

additionalItems に保存しているデータを Schedule datastore に移行するためのサンプルコードを公開しています。

備考

ご利用環境において、additionalItems を利用しているかのお問い合わせは、サイボウズではお受けしておりません。

カスタマイズの開発パートナーまたはプラグインの提供元にお問い合わせください。

関連情報

• Garoon スケジュールのカスタム項目（additionalItems）の廃止予定について（2021/04/09）
• 2021/05/09 定期のメンテナンスにおける API 更新情報
• スケジュールオブジェクト - additionalItems