EXCEL/CSV テンプレートから接続文字列の置換をアップロードする

接続文字列センター の「接続の検索/置換/更新」タブにある「EXCEL または CSV テンプレートから変更を読み込み」ボタンを使うと、EXCEL スプレッドシート (.xlsx) または CSV (コンマ区切り、.csv) ファイルから接続文字列の置換を読み込めます。

GOFR では、1 つのファイルから複数行の置換データを読み込めます。

データを正しくインポートするために、次の手順に従ってください。

  1. 「変更を CSV にエクスポート」ボタンをクリックして、空のテンプレートを作成します。この手順は、テキストの置換の場合とは少し異なります。インポートする接続プロパティをプログラムに伝える必要があり、最も簡単な方法は、すべての列と行が入力された「空の」エクスポートを作成することだからです。エクスポートには、プログラムが認識しているすべての接続プロパティについて 1 行ずつと、すでに入力済みの操作 1 件につき 1 行が含まれます。
  2. 下の表に従って、テンプレートに必要なデータを追加します。同じ接続プロパティに対して複数の行を作成できます。Element の値を同じにしたまま、Excel で行を複製するだけです。
  3. ファイルを .csv または .xlsx として保存し、「EXCEL または CSV テンプレートから変更を読み込み」をクリックして、そのファイルを選択します。

テンプレートを読み込むと、現在このタブにある検索と置換の操作は置き換えられます。

ルール

  • Text To Find と Text To Replace の「両方」が空白のエントリは、プログラムに無視されます。Text To Find は空白のままにできます。この場合、Text To Replace の値が、文書内で値のない接続プロパティに設定されます。
  • Element がプログラムの認識している接続プロパティと一致しない行は無視されます。
  • Excel から置換を読み込むには、データがブックの最初のシートにある必要があります。
  • データには、最初の行 (1 行目) に適切な見出しが必要です。
  • 列の順序は自由ですが、適切な見出しが必要です。
  • 見出しは、下の表のとおりに正確に記述する必要があります。大文字と小文字は区別されません。
  • 読み取られるのは最大で約 300 行です。
  • 試用版では、.csv ファイルは最初の 2 行、.xlsx ファイルは最初の 5 行のみ読み込まれます。

列

Field Name (Must appear as the header for the column) Description
Element 更新したい接続プロパティを指定します。値が分からない場合は、先に csv にエクスポートしてください。すべての値が出力されます。
Text To Find element で指定した接続プロパティの中から検索したい文字列です。正規表現またはワイルドカード パターンも指定できます (下記の追加設定を参照してください)。
Regex Find 値: True または False。True の場合、検索する文字列は正規表現パターンとして扱われます。詳細は正規表現をご覧ください。True を入力すると、Text To Find が緑色で表示されます。
WildCard Find 値: True または False。True の場合、検索する文字列はワイルドカード式として扱われます。詳細はワイルドカードをご覧ください。
True を入力すると、Text To Find が黄色で表示されます。
Text To Replace element で指定した接続プロパティの中で置換後にしたい文字列です。正規表現またはワイルドカード パターンも指定できます (下記の追加設定を参照してください)。色分けは Text To Find と同じです。
Regex Replace 値: True または False。True の場合、置換後の文字列は正規表現として扱われます。
WildCard Replace 値: True または False。True の場合、置換後の文字列はワイルドカード パターンとして扱われます。
Case Insensitive 値: True または False。True の場合、文書内で検索するテキストの大文字と小文字は区別されません。

True / False の列には、1 または 0 も入力できます。

たとえば、Element に接続文字列プロパティを指定し、Text To Find を Server=myServer;Database=myDb、Text To Replace を Server=myNewServer;Database=myDb にした行では、一致するすべての接続が新しいサーバーを指すようになります。

特記事項

  1. 正規表現またはワイルドカードをオンにすると、大文字小文字の区別なしの値は false に設定され、無効になります。これらは正規表現パターンの検索には適用されません。
  2. 正規表現またはワイルドカードの検索パターンが正しく入力されていない場合、対応するテキスト フィールドがピンク色で表示されます。