Ver1からVer2への具体的な移行手順書

Ver1からVer2への具体的な移行手順書

Q. カスタムエレメントVer1からVer2への具体的な移行手順を教えてください。

A.以下が具体的な手順となります。

概要

カスタムエレメントVer1からVer2への、安全で具体的な移行手順書を記載します。


前提

既にカスタムエレメントVer1を使ってサイト内検索を提供しているお客様が対象となります。

本番環境とは別に、ステージングなどで動作確認する環境が必要です。


詳細
１．ステージング環境にて強制的にVer2を適用

最初に、ステージング環境にて強制的にカスタムエレメントVer2 を読み込ませるようにします。

検索窓画面と検索結果画面のページ内、以下2箇所を修正します。


【1箇所目】次のlinkタグを削除

<link href="https://ce.mf.marsflag.com/latest/css/mf-search.css" rel="stylesheet" type="text/css" media="all" charset="UTF-8">


【1箇所目】次のscriptタグを変更

変更前

<script src="https://ce.mf.marsflag.com/latest/js/mf-search.js" charset="UTF-8"></script>

変更後

<script
src="https://ce.mf.marsflag.com/v2/js/mf-search.js"
async
type="module"
></script>

※ /v2/ というパスを指定することで、強制的に Ver2を読み込ませることができます。



２．ステージング画面の確認と調整

１．を適用した後、検索窓画面と検索結果画面を確認し、必要であればページを修正して調整します。


動作や画面レイアウトを調整する際には、以下のドキュメントを参照してください。


３．本番への反映

２．の作業後、そのままステージングの内容を本番へ反映します。


４．管理画面より、Ver1 から Ver2への切り替えを行います。


５．ステージング環境の強制Ver2適用を解除

１．にて指定していた scriptタグを、以下のように通常状態へ戻します。
現在

<script
src="https://ce.mf.marsflag.com/v2/js/mf-search.js"
async
type="module"
></script>

修正後

<script src="https://ce.mf.marsflag.com/latest/js/mf-search.js" charset="UTF-8"></script>

※ /v2/ を /latest/ というパスに戻すことで、強制的な Ver2読み込みを解除します。

​
６．本番への反映

５．の作業後、そのままステージングの内容を本番へ反映します。


以上





    • Related Articles

    • 1. 検索窓を設置する Ver.1 ( 初期バージョン )

      ステップ1★検索窓を表示したいhtmlファイルにタグを埋め込む 1） 検索窓を表示したいhtmlファイル（例 window.html）の<head>～</head>の中に、 以下のタグを埋め込んでください。　 <!-- ↓CSS --> <link href="https://ce.mf.marsflag.com/latest/css/mf-search.css" rel="stylesheet" type="text/css" media="all" charset="UTF-8"> ...

    • 2. 検索結果を設置する Ver.1 ( 初期バージョン )

      ステップ2★検索結果を表示したいhtmlファイルにタグを埋め込む 1） 検索結果を表示したいhtmlファイル（例 result.html）の<head>～</head>の中に、以下のタグを埋め込んでください。 <!-- ↓CSS --> <link href="https://ce.mf.marsflag.com/latest/css/mf-search.css" rel="stylesheet" type="text/css" media="all" charset="UTF-8"> 2） ...

    • marsfinder_on offタグによる除外

      お客様サイト内へ以下のタグを挿入いただくことで、「タグ内の文字列を検索対象から除外する※」ことができる機能です。 但し、bodyタグ内でのみ有効です。 この機能は、検索DB詳細画面->拡張設定->marsfinderoff～marsfinderonタグ除外を利用する により、有効・無効が設定できます。 設定は、次回検索データベースが作成されると反映されます。 ※タグ内のリンクに関しては、クロール対象のままです。 ■タグ ＝＝＝＝ 開始 <!-- marsfinderoff: index --> ...

    • 0. はじめに Ver.2 ( 推奨 )

      本章は、カスタムエレメントVer.2をご利用のお客様向けのマニュアルとなります。 ご利用のカスタムエレメントのバージョンの確認方法は、こちら に掲載しております。

    • 0. はじめに Ver.1 ( 初期バージョン )

      本章は、カスタムエレメントVer.1をご利用のお客様向けのマニュアルとなります。 ご利用のカスタムエレメントのバージョンの確認方法は、こちら に掲載しております。