ColdFusion セミナー

新ColdFusion Builder
拡張機能 for Visual Studio Codeのご紹介0最初に 資料内での略語

 「Adobe ColdFusion Builder Extension for Microsoft Visual Code」→ 新 ColdFusion Builder
 従来の「Adobe ColdFusion Builder」→ 旧 ColdFusion Builder 「Microsoft Visual Code」→ VS Code 補足

 この資料は 2022年10月現在の下記のバージョンでの解説
 VS Code 1.72.2

 新ColdFusion Builder: v1.0.443 (2022.8)
 一部の機能やオンラインマニュアル等がまだ日本語化されていない※VS Code 、新ColdFusion Builderともに新しいビルドが出ることで、画面や動作が変わる場合があります。
1アジェンダ
1. 新ColdFusion Builder について（概要）2. 新ColdFusion Builderのセットアップの流れ
3. 基本機能4. エディター機能
5. その他

2

新ColdFusion Builderについて（概要）3

新・旧 ColdFusion Builder の比較
ベース対応バージョン

新 ColdFusion Builder

旧 ColdFusion Builder

VS CodeEclipse

CF2021、CF2018

CF2018以前

RDS・ビューワー

〇

〇

デバッガ

〇

〇

コードアシスト
Enterprise専用
Security CodeAnalyzer

PMTコードプロ
ファイラレポート
統合
対応OS

インストーラー
価格

〇
〇

〇
〇

〇

〇

Windows10, 11
Mac OS11, 12

Win10, 2016/2012svr RH7.x
Ubuntu18.x Mac10.13

無償

有償（無償の機能制限版あり）

×（拡張機能の提供）〇4

新ColdFusion Builderの仕組み
Language
Client
拡張機能

VS CodeColdFusion
Builder

Language
Server(Javaベース)

Java SE
1.8以降

 ColdFusion Builder 拡張機能Language ServerJavaベース
ドキュメントやワークスペースに関連する機能、コードアシストやリファクタリングなどの処理

Language ClientTypeScript+Nodeベース
各種Builderの機能やColdFusionサーバーとの連携
5

新ColdFusionBuilderに必要なもの
 VS Code 1.68以降（セットアップ方法は次に紹介）

 Java 1.8以降が事前にPCにインストールされていること


開発元推奨Java 11。ただし用途に注意

Java 11と2019年4月以降のJava 8のバージョンは、個人的な使用や開発目的などの私用の利用には無償で利用できますが、商用利用の際には有償となります。ですので、ダウンロードしたJavaを 商 用 目 的 で 使 用 す る 場 合 は 、 そ れ 以 前 の Oracle Java ラ イ セ ン ス の 下 で 認 可 さ れ る
Java1.8.0_202以下、またはJava 17以降を使用するか、Oracle社の定めるJava SEサブスクリプシ
ョンを購入してJava1.8.0_203以降またはJava11を使用するかのどちらが必要となります。

※ Java1.8.0_203以降またはJava11をダウンロードする際は、License Agreementへの同意とオラクルのアカウント（プロファイル作成）が必要となりますので上記に注意の上、バージョンを選択してください
参考：Oracle Java SEライセンスに関するFAQ
https://www.oracle.com/jp/java/technologies/javase/jdk-faqs.html
6

新ColdFusion Builderのセットアップの流れ

7

インストール手順 以下の流れでインストール・セットアップ※Java 1.8以降がインストール済みであること
1. VS Codeをインストール
2. VS Codeを日本語化
3. 新ColdFusion Builderをインストール

82. VS Codeを日本語化

9

3. 新ColdFusion Builderをインストール

10

基本画面

11

基本機能

12

ColdFusionサーバーとの連携
ColdFusion
2021 / 2018

RDSRDS
RDS
拡張機能

Windows 10 /11
またはMac OS 10.12-13

VS CodeColdFusion
Builder

Language
ClientLanguage
Server(Javaベース)

 ColdFusionサーバーとの連携（ローカル/リモート）Java SE
1.8以降

開発プロファイルでインストール
RDSを有効にすることによるファイルビュー・クエリビュー・デー
タソース機能プログラムの実行、ラインデバッガ機能
13

サーバーマネージャー
 ColdFusionサーバー（ローカル/リモート）を登録
 登録したサーバーの起動・停止

 ColdFusionプロジェクトのファイルを実行するために紐づけ14

サーバーマネージャー
 設定内容は、旧ColdFusion Builderと同じ

 サーバー設定は、内部Webサーバー（既定 8500）で行う

 IISやApacheの80ポートで実行したい場合は、サーバーを登録した

後、「仮想ホスト設定」と「URL接頭辞」の登録を行う

15

プロジェクトマネージャー
 旧ColdFusion Builderと同じく、複数のColdFusionプロジェクトを登録・管理することができる
 最初にVS Codeのワークスペースを登録

 登録したColdFusionプロジェクト

単位で、実行するColdFusionサーバーを選択する

 あらかじめ、サーバーマネージャーでColdFusionサーバーを登録しておく

16

ワークスペースの注意点
 Eclipseと同様に VS Codeにもワークスペースの機能があり、ColdFusionのプロジェクトの管理もワークスペースで行う
 プロジェクトマネージャーで最初にColdFusion登録する際に、ワークスペースの作成から始める。が、まだメニューの日本語周りが実装されていないので注意する

VS Codeのワークスペースの機能でもワークスペースが作成できるが、ワークスペースの保存を忘れずに行ってからColdFusionプロジェクトを追加する

17

プロジェクトマネージャー
 メニュー（プロジェック内のフォルダを右クリック）

ファイル関連

PMT関連
セキュリティアナライザ関連
18

RDSデータビュー・クエリビューア
 旧ColdFusion Builderと同じ機能

 ColdFusionサーバーとRDS連携が有効な場合に使用可能

 登録済みデータソース一覧から、テーブル名・カラム名など確認可能
 RDSクエリビューア機能でSQLの動作確認も可能

19

RDSファイルビュー
 旧ColdFusion Builderと同じ機能 RDSで接続したColdFusionサーバーのファイルシステムを閲覧可能
 ファイルアクセス・書き込みも可能
 ここで開いたページからはColdFusionの実行は出来ない ColdFusionプロジェクトに登録して開いたページのみ実行が可能

20

後からColdFusionのRDSを有効にする
 有効化の手順

ColdFusion Administratorの「セキュリティ＞RDS」 で、『RDSサービスを有効にする』を有効にする[cf_root]/{インスタンス(cfusiont等)}/wwwroot/WEB-INF/web.xml
をメモ帳等テキストエディタで開き、2か所のRDS設定のコメン
トアウトを外す

1.
2.



3.



<!-- begin RDS ～RDSServlet 設定～ end RDS -->↓<!-- begin RDS --> ～RDSServlet 設定～ <!-- end RDS -->ColdFusionを再起動する

本番環境では、RDSを有効にしない！！
21

デバッガ

 旧ColdFusion Builderと同じ機能

 VS Codeのデバッガ機能と連動して実行する

 実行の際は、ColdFusion AdministratorでRDS、ラインデバッグ、デバッグ出力が有効であること

22

デバッガ
 ブレークポイントはCFタグに設定

 停止（デバッグ停止・おかしくなったらコレ） ステップアウト（CFCやUDF、インクルードのブロックを終わらせ次のCF処理に移る）
 ステップイン（次のCFの処理に移る）
 ステップオーバー（CFCやUDF、インクルードは飛ばして次のCFの処理に移る）

23

コードリファクタ①
 対象となるファイルがプロジェクト内のどこで使用されているかを確認

日本語を使用していると変換位置がずれるバグあり

24コードリファクタ②
 ファイル名を変更すると対象のファイルも変更

日本語を使用していると変換位置がずれるバグあり
25

コードリファクタ③
 CFCのメソッド、ファンクション、変数などの変更をプロジェクト内のコードに反映する

日本語を使用していると変換位置がずれるバグあり
26

サービスブラウザ サーバー内のCFCを検出、コードの挿入にも対応

27

その他
 エンタープライズ専用セキュリティコードアナライザ
 PMTプロファイルのレポート統合

28

エディター機能29

ショートカットアイコン

30

アウトライン31

キーボードショートカット 次/前のタブブロックに移動：ctrl + shift + E / ctrl + shift + Q
 タグ・コードブロックを選択：ctrl + alt + F 閉じタグにジャンプ：ctrl + alt + V

 UDFやCFCのコードにジャンプ：ctrl + クリック
 ColdFusion関連
 Ctrl+Alt+O
 Ctrl+Alt+; Ctrl+Alt+H

 Shift+Alt+^

選択範囲を<cfoutput>ブロックで囲みます<cfset >ブロックをエディタ画面に配置します
選択範囲を＃で囲みます
選択範囲を"で囲みます ショートカット一覧表示・編集：ctrl+K を押して ctrl+S 例：
次/前の属性に移動：ctrl + ] / ctrl + [ が VS Codeのインデントと被っているので、ctrl + alt + ] / ctrl + alt + [ に変更する
32コードアシスト 入力した文字、状況（##に囲まれている）、ページ内の項目に応じた適切なショートカットを表示
 ショートカット: Ctrl + スペース （従来と同じ）

33

コードフォーマット
 [右クリック] → [ドキュメントのフォーマット]
 cfml, HTML, css, javascriptのフォーマットに対応→34

プロファイル設定
 フォーマットや構文エラーなどに関する設定35

構文エラーの表示例

36

その他

37

ファイルのエンコード
 Eclipseベースの旧ColdFusion Builderと異なり、プロジェクト単位でエンコードの設定はできない。ファイル単位でエンコードを選択する

 VS CodeのEncoding設定を行う手もある https://atmarkit.itmedia.co.jp/ait/articles/1806/01/news051.html

38

旧ColdFusion Builderと違う操作系
 ダブルクリックやドラック＆ドロップは効かない 基本は画面に表示されるメニューからの操作

 RDSデータビューからカラムを選択してコードに反映したい 旧ColdFusion Builder…ダブルクリック、またはドラック＆ドロップ
 新ColdFusion Builder…右クリックしてリフレッシュを選択

39

既知の不具合 現在、英語ページのみ

https://helpx.adobe.com/coldfusion/coldfusion-builderextension-for-visual-studio-code/known-issues.html

 マップされたドライブとUNCパスのサポートは、小規模なプロジェクトのみに制限されています。
 大規模なプロジェクトでは、RAM 使用量が高くなることがあります。
 非常に大きなプロジェクト(100Kファイル>)の場合、プロジェクトの読み込みに時間がかかることがあります。
 複数のCFML拡張機能がインストールされている場合は、競合の可能性があり、いくつかの提案が表示されない可能性があります。
これは、拡張機能がアルファベット順に処理されるVSCodeのデフォルトの動作です。

40

一部はまだ日本語化されていない
 コードヒントやエラーメッセージなどは英語のまま

41

一部の項目は日本語が用意されていない
 https://tracker.adobe.com/#/view/CF-4214811

42

翻訳がおかしい https://tracker.adobe.com/#/view/CF-4214811

43その他不具合系（バグベース登録済）
 一部のメニューが未翻訳・翻訳がおかしい https://tracker.adobe.com/#/view/CF-4214810

 日本語を含む列でコードアシストのダイヤログが出てこない場合がある

 https://tracker.adobe.com/#/view/CF-4215114

 日本語を含む列のコードリファクタの変換位置がずれる
 https://tracker.adobe.com/#/view/CF-4215359

 その他、

 リモートサーバーでのデバッガのステップが正しく動作しない

 仮想ホスト機能で開いたページのコードリファクタが正しく動かない等の制限もある模様

44

最後に
 最新情報はメーカーのコミュニティもチェック 最新情報等は開発元のコミュニティ（ColdFusion Forum）

 メーカーの公式ブログ（ https://coldfusion.adobe.com/blogs/ ） Slack (cfml.slack.com)

 無償の拡張機能のため、メーカーサポートや個別パッチは提供されない

 拡張機能の更新機能で更新される

 不具合等を確認した時は、開発元のバグベースに登録 https://tracker.adobe.com

 エディタの問題は環境に依存している場合も多いため、不具合が生じた際は、その環境で発生することをバグベースに登録してください45