日本語

简体中文
English

日本語

简体中文
English

FAQとサポート ​

I. 一般的な質疑応答 ​

  • Q: プラグインがインストールできません。どうすればよいですか？
    A: まず、お使いの IDE のバージョンがプラグインの最低要件（例：VS Code ≥ 1.84）を満たしているかをご確認ください。それでもインストールに失敗する場合は、以下の対応をお試しください：

    • IDE を再起動して再度インストールを試みる
    • .vsix ファイルを手動でダウンロードし、オフラインインストールを行う
    • ネットワークプロキシや企業ファイアウォールの設定を確認する

  • Q: ログインに失敗するのはなぜですか？
    A: 考えられる原因は以下のとおりです：

    • ネットワーク接続異常（認証サービスにアクセスできない）
    • アカウントのパスワードが間違っている、またはアカウントが無効
    • ローカル時刻とサーバー時刻のずれが大きいため（トークン検証に影響）

    ネットワーク、認証情報、システム時刻の正確性を順にご確認ください。

  • Q: プラグインの動作が遅い、またはカクつきます。
    A: 以下の対策をおすすめします：

    • プラグイン設定で AI 応答の同時実行数を減らす
    • 不要なバックグラウンドプラグインを閉じてリソースを解放する 問題が解消しない場合は、ログファイルをご提供いただき、詳細を分析させていただきます。

II. データベース関連の質疑応答 ​

  • Q: データベースページやワークフローページは開けるものの、データが読み込まれません。
    A: 以下の手順でトラブルシューティングを行ってください：

    1. JDK バージョンの確認
      JDK 8 ～ JDK 17 の間のバージョンを使用していることを確認してください（JDK 21 以降の非 LTS 版はサポートされていません）。
    2. 設定ファイルの確認
      vjspai-link.yml 内のデータベース接続情報（URL、ユーザー名、パスワード、ドライバークラス）およびそのフォーマットが正しいかを確認してください。
    3. ファイル配置場所の確認
      vjspai-link.yml は プロジェクトルート直下の .vjsp フォルダ内に配置されている必要があります。そうでないと起動時に読み込まれません。
    4. 起動ログの確認
      コンソールに Connection refused や ClassNotFoundException などのエラーが出ていないかを確認してください。

    設定が正しいにもかかわらずデータが表示されない場合は、バックエンド API が空の結果セットを返していないかを確認するか、テクニカルサポートまでお問い合わせください。

  • Q: 右クリックメニューに「フォームを編集」のオプションがありません。
    A: 以下の点をご確認ください：

    • VJSP プラグインが正しくインストール・有効化されていること
    • 現在選択中のファイルが .html ファイルであること（VJSP フレームワークにおけるフォーム形式のみ対応）

  • Q: 保存後もコードが更新されません。
    A: 考えられる原因：

    • ファイルが他のプログラム（例：Git、ウイルス対策ソフト）によってロックされている
    • ファイルが読み取り専用状態になっている 対処法：ファイルを一度閉じて再び開く、またはエクスプローラーを手動で再読み込みしてください。

  • Q: カスタムコントロールはサポートされていますか？
    A: はい。vjsp.config.js でカスタムコンポーネントテンプレートを登録することで、独自の UI 要素を実装できます。

III. ワークフロー関連の質疑応答 ​

  • Q: 「ワークフロー」をクリックすると空白ページが表示されます。
    A: 以下の点をご確認ください：

    • プロジェクト内に有効なプロセス定義ファイルが存在すること（例：workflow.json、process.yaml、または @Workflow アノテーション付きの Java クラス）
    • データベース接続設定が正しいこと（一部のプロセスはメタデータストレージに依存）
    • 新規プロジェクトの場合、AI で初期プロセステンプレートを生成してみてください

  • Q: ノード情報が完全に表示されません。
    A: 以下の点を確認してください：

    • 関連する設定ファイルまたは Java クラスが保存済みであること
    • 動的プロセス（例：実行時に生成されるもの）の場合、アプリケーション起動後にワークフロービューを手動で更新する必要があります

  • Q: ワークフローをダイアグラム上で直接編集できますか？
    A: 現在のバージョンでは 読み取り専用での表示およびインタラクション のみをサポートしています。ドラッグ＆ドロップによるモデリングや条件編集などの機能は、今後のバージョンで実装予定です。今後のご期待ください。

IV. 自己診断トラブルシューティングガイド ​

上記に該当しない問題が発生した場合は、以下の順序で自己診断を行ってください：

  1. ✅ 互換性の確認

    • プラグインバージョンが IDE バージョンと一致していること
    • OS が最低要件を満たしていること（Windows 10+/macOS 12+）

  2. 🌐 ネットワーク環境の確認

    • VJSP ウェブサイト などの内部サービスに正常にアクセスできること
    • 社内ネットワークが WebSocket や HTTPS リクエストを遮断していないこと

  3. 🔒 セキュリティソフトの干渉排除

    • 一時的にファイアウォールやウイルス対策ソフトを無効化してテスト
    • IDE およびプラグインのディレクトリをホワイトリストに追加

  4. 🧩 プラグイン競合の確認

    • 他の AI/データベース関連プラグインを無効にして再試行

  5. 📄 詳細ログの確認

    • ログは問題特定の鍵となります（以下参照）

ログの確認方法 ​

プラグインのログはデフォルトで以下のパスに保存されます：

OSログパス
Windows%USERPROFILE%\.vjsp\logs\
macOS~/Library/Logs/vjsp/

ログへのアクセス方法：

  • プラグイン設定画面の 「ログディレクトリを開く」 をクリック
  • IDE の出力パネルで 「VJSP」 チャネルを選択し、リアルタイムでログを確認
  • ターミナルコマンドで確認（例：tail -f ~/.vjsp/logs/vjsp.log）

V. お問い合わせ ​

上記の対応でも問題が解決しない場合は、VJSP テクニカルサポートチームまでお気軽にお問い合わせください：

  • 📧 メール：support@vjsp.cn
  • 🕒 サポート時間：平日 9:00～18:00（祝日を除く）
  • 📎 お問い合わせの際には、以下の情報を必ずご提供ください：
    • IDE の種類とバージョン
    • プラグインのバージョン番号
    • 関連するログの抜粋（機密情報をマスキングしたうえで）
    • スクリーンショットまたは再現手順

できる限り迅速に対応いたします！