Autodesk Construction Cloud（ACC）API をお使いの方へお知らせ
オートデスクは、API を通じて ACC 指摘事項アイテムの 3 つのフィールド（title、description、locationDetails）に許容される最大文字数制限を変更する予定です。この変更により、API と Web ユーザー インターフェース（UI） に一貫した最大文字数制限が適用されます。
API で許容される現在の最大文字数と新しい最大文字数を示します。
| フィールド | 最大文字数 | |
| 現在 | 変更後 | |
| title | 4200 | 100 |
| description | 10000 | 1000 |
| locationDetails | 8300 | 250 |
今回の変更は、ACC Issues API の次の 2 つのエンドポイントに適用されます。
注: この変更は、レガシー データへのアクセスを許容する次の ACC Issues API の読み取りエンドポイントのフィールドには適用されません。
バックグラウンド
これらの新しい最大文字数制限は、Web ユーザー インターフェース に適用されています。ただし、API では最大文字数が多くなっていたため、ユーザー エクスペリエンスに不一致が発生してしまいます（例えば、ユーザーは API を使用して長いタイトルを作成できますが、Web UI で完全なタイトルを見ることが出来ないことになってしまいます）。この変更は、ACC Issues API にのみ影響します。BIM 360 Issues API は変更されません。
必要なアクション
ACC Issues API を使用して指摘事項アイテムを作成/更新する場合は、上記のフィールドの文字数が新しい最大文字数制限を超えないようにしてください。コードがより大きな最大文字数制限に合わせて記述されている場合は、2025年5月15日までにアプリケーションを更新して、特定されたフィールドの最大文字数制限を減らす必要があります。この日付以降は、新しい最大文字数制限よりも長い値でこれらのフィールドを更新出来なくなります。
追加情報
以下は、この変更に関して予想されるいくつかの質問に対する回答のリストです。
Q1: 新しい制限よりも長い既存のデータはどうなりますか？日付は切り捨てられますか？
A1: 既存のデータは変更されません。データはそのまま残ります。
Q2: 古い制限付きの長い文字を持つ API によって属性にパッチを適用または変更するとどうなりますか?
A2:新しい制限と互換性のある新しいタイトルにのみ編集できます。
Q3:私たちのワークフローでは、古い制限の属性がまだ必要ですが、提案は何ですか?
A3: 新しい制限よりも長い文字列が必要な場合には、文字列を指摘事項のカスタム属性（現在、段落タイプで 2500 文字）に保存するか、指摘事項のコメントを作成（現在、100000 文字が受け入れられます）を代替としてご検討いただけます。また、長い文字列をテキストファイルに保存し、ファイルを参照または添付することもできます。
Q4: 長いタイトル/説明/場所の詳細に問題があり、別の属性 (担当者など) を編集したいと考えています。長い文字を持つフィールドを変更せずにこれを行うことはできますか?
A4: はい、title/description/locationDetails のみに適用されます。他の属性への影響はありません。
この変更に関するその他の質問をお持ちの場合には、 APS support までお問い合わせください。
※ 本記事は ACC Issues API: Maximum Length Changes | Autodesk Platform Services から転写・意訳・補足したものです。
By Toshiaki Isezaki
Subscribe
コメント