JSSコード優先インポート・プロセスの特性

インポート プロセスは、同じアプリケーションから同じSitecoreインスタンスに対して複数回実行できますが、いくつかの制限があります。

マニフェストで明示的に定義されていない項目のフィールドは、そのまま残ります。たとえば、Sitecore開発者がインポートされたフィールドにソースを入力した場合、マニフェストでソースの値も定義されていない限り、次回のインポートではソースはリセットされません。

特別な考慮事項 は、インポートがコンテンツアイテムおよびコンテンツエディターとどのように機能するかを定義します。

インポート形式は、Sitecoreアイテムの完全な忠実性を表しているわけではなく、アイテムを更新する際にすべての状況を処理するわけでもありません。UnicornやTDSなど、Sitecoreアイテムをシリアル化するツールに取って代わるものではありません。

インポート プロセスでは、主に、利用可能なSitecoreインスタンスを持っていないフロントエンド開発者や、バックエンド開発者がSitecoreを設定する前にアプリケーションの作業を開始したいフロントエンド開発者がレンダリング アプリを設計できます。最終的には、開発プロセスでは、インポート プロセスを専用のSitecoreアイテム シリアル化ツールで補完するか、専用の アイテム シリアル化ツールに置き換えることをお勧めします。ただし、急速に開発された単純なキャンペーン スタイルのアプリを除き、JSSアプリの状態を維持することもできます。

Sitecoreアイテムのシリアル化ツールは、JSSインポートによって作成または更新されたアイテムをシリアル化できます。これは、他のSitecoreアイテムと同じです。

インポート プロセスでは、文字列名がGUIDを持つSitecoreアイテムにマッピングされるため、インポート ファイルを簡単に書き込めます。マッピングは、インポートされたアイテムの移動または名前の変更を慎重に行う必要があることを意味します。

マニフェストからテンプレートまたはルートを削除しても、インポート プロセスでは次回のインポート時にSitecoreから削除されません。

明示的に定義されたマニフェスト データのみが、Sitecoreで設定された値を上書きします。

たとえば、アイコンを定義していないテンプレートをインポートし、Sitecore開発者がアイテムにアイコンを設定したとします。この場合、今後のインポートではアイコン値は上書きされません。マニフェストでテンプレートのアイコンが定義されている場合、マニフェストの値によってSitecoreで設定された値が上書きされます。

Sitecoreアイテムには一意のGUID IDがあります。既定では、App Importはマニフェストで定義されているnameを使用して 決定論的なGUIDを派生させ、インポートされたアイテムが常に予測可能なIDを持つようにします。GUIDはnamespacedであるため、名前はJSSアプリ全体ではなく、アプリのセクション内でのみ一意である必要があります。

たとえば、ルートとHomeという名前のテンプレート (または異なるレベルの2つのルート) の両方を持つことは有効ですが、Homeという2つのテンプレートを持つことは無効です。名前空間にはJSSアプリケーション名も含まれているため、複数のJSSアプリケーションで同じ名前の項目を持つことができます。

また、アイテムのマニフェスト定義にidプロパティを追加することで、インポート マニフェスト内のすべてのアイテムのexplicit IDを指定することもできます。

idは、次のいずれかのタイプになります。

サンプル・アプリケーションのStyleguideの例には、content reuseのStyleguideの例に明示的なIDを設定する例があります。