fbpx
< 前に戻る
印刷

BuildVuマイクロサービスにおけるAPIの変更

作成日:2024年7月5日
最終更新日:2024年7月5日

2024.07リリースでは、BuildVuマイクロサービスによって生成されるzipファイルに変更があります。この変更はマイクロサービスのユーザのみに影響します。BuildVu JARファイルを直接使用している場合は影響はありません。

何が変わったのですか？

2024.05およびそれ以前：

  1. ZIPファイルと親ディレクトリの名前は、元のドキュメントの名前と一致していました。
  2. zipファイルの内部には、すべてのコンテンツを保持するトップレベルの親ディレクトリがありました。
例：
				
					MyDocument.zip
└─ MyDocument
    ├─ 1.html
    ├─ 2.html
    └─ etc

2024.07 以降：

  1. zipファイルの名前は変換のuuidと一致します。
  2. zipファイルの内部では、変換されたドキュメントは親ディレクトリを使用せずにトップレベルに格納されます。
例：
				
					a96d569a-ec97-421e-997e-f1f23c169fa2.zip
├─ 1.html
├─ 2.html
└─ etc

なぜ変更するのですか？

マイクロサービスの信頼性と予測可能性を高めるため、マイクロサービスが内部的にファイルを保存する方法を変更しました。これは、マイクロサービスが特定の問題のあるファイル名を拒否したり、長すぎるファイル名を切り詰めたりする必要がなくなったことを意味します。

この改善は zip ファイルの命名規則を変更しなければ不可能でした。親ディレクトリ名を変更するとワークフローに影響を与える可能性があるため、代わりに親ディレクトリを完全に削除することで、親ディレクトリを必要としないワークフローを簡素化することができます。この変更に対応するのは複雑ではないと予想しています。

可能な限り、お客様のワークフローを壊すようなAPIの変更は避けたいと考えています。この場合、変更を導入することなく改善を行うことは不可能であり、潜在的なマイナス要因を上回るメリットがあると考えています。

 

    MENU
    PAGE TOP