---
title: "GeneXusとは？ナレッジベースからの自動生成とMSBuildでのビルド、移行判断【2026年11月】"
url: "https://www.issoh.co.jp/tech/details/20100/"
published: 2026-11-22
updated: 2026-11-22
categories: ["自動化"]
publisher: "株式会社一創"
---

# GeneXusとは？ナレッジベースからの自動生成とMSBuildでのビルド、移行判断【2026年11月】

GeneXus（ジェネクサス）は、業務のデータ構造とルールを「ナレッジベース（KB）」に定義し、そこからデータベースと.NETやJavaのプログラムを生成する開発ツールです。ウルグアイで生まれた製品で、現在はGlobantグループのGeneXus社が開発しています。この記事では、KBから生成する仕組み、MSBuildタスクでビルドを自動化するスクリプト、2026年11月12日に正式版が出たGeneXus for Agents、そして生成コードを保守し続けるか他の技術へ移すかの判断基準を、公式ドキュメントに沿って説明します。内容は2026年11月時点の情報です。

## まとめ：GeneXusの仕組みと使い続けるか移行するかの判断の要点

- **仕組み**：開発者が書くのはKBの定義で、データベースとプログラムはGeneXusが生成します。同じKBから.NETとJavaのどちらにも生成できるのが、画面を組み立てるタイプのローコードとの違いです。
- **現行版**：GeneXus 18が最新のメジャー版で、2026年11月時点の公式目次ではUpgrade 16とそのHotfixが最新、Upgrade 17がプレビューです。
- **自動化**：KBのオープン、ビルド、XPZへのエクスポートはMSBuildタスクで書けます。夜間ビルドや退避はIDEを開かずに回せます。
- **AI対応**：GeneXus for Agents 1.0でKBをテキストに書き出し、Claude CodeやOpenAI CodexなどのAIエージェントから操作できるようになりました。
- **判断**：KBを読める技術者が社内か取引先に2人以上いて、版上げを続けているなら使い続けてよい状態です。担当者が1人だけ、または版上げが2世代以上止まっているなら、移行の検討を始める時期です。

## GeneXusの開発モデル：ナレッジベースから.NETやJavaのコードを生成する仕組み

GeneXusを理解する近道は、成果物が「ソースコード」ではなく「KB」だと捉えることです。プログラムはKBから毎回生成される派生物として扱われます。

### ナレッジベース（KB）に業務の定義を置き、データベースとプログラムを生成する流れ

[GeneXusの公式ドキュメント「Knowledge Base」](https://docs.genexus.com/en/wiki?1836,Knowledge+Base)では、KBを「業務の現実についての利用者の見方（Users’ Views）」を蓄える場所という説明です。利用者の見方は、トランザクション（データ構造と画面）やプロシージャ（処理）といった種類のオブジェクトで記述します。GeneXusはその定義から推論して、データベースとアプリケーションのプログラムを、選んだプラットフォーム向けに自動生成します。

[公式FAQ](https://www.genexus.com/en/products/genexus/faq)は、生成が決定的（deterministic）であり、同じモデルからは常に同じコードが出ると明記しています。テーブル構成を変えたときに既存データを新しい構造へ移す「再編成（reorganization）」も、GeneXusが差分から作ります。開発者がSQLのALTER文を書かずに済むのはこのためです。

裏返すと、生成されたC#やJavaのファイルを手で直しても、次の生成で上書きされる前提になります。修正はすべてKB側で行う。この1点が、通常のスクラッチ開発の保守と最も違うところです。同じく設計情報から生成する国産製品でも、Javaの独自処理を再生成で上書きされない専用領域に置けるWagby 11との違いは、[Wagbyとは？Wagby 11の設計情報からJavaを生成する仕組みとカスタマイズ範囲・保守の判断](https://www.issoh.co.jp/tech/details/20102/)で整理しています。

### KBテンプレートの生成先（.NET・.NET Framework・Java）とDBMS

KBを作るときにテンプレートで生成先を選びます。[MSBuildタスクの公式ドキュメント](https://docs.genexus.com/en/wiki?3908,MSBuild+Tasks)のCreateKnowledgeBaseの項には、同梱のテンプレートとして次の3つが載っています。

| テンプレート             | 生成先            | 選ぶ場面                  |
| ------------------ | -------------- | --------------------- |
| CSharp.KBTemplate  | .NET Framework | 既存のWindowsサーバー資産で動かす  |
| NetCore.KBTemplate | .NET           | Linuxやコンテナで動かす        |
| Java.KBTemplate    | Java           | Javaのアプリケーションサーバーに載せる |

生成先とDBMSの組み合わせは「環境（Environment）」として KB の中に持ち、1つのKBに複数の環境を置けます。生成先の異なる環境を同じKBに並べられるため、業務の定義を書き直さずに実行基盤を移せます。新規に始めるなら、Linuxやコンテナでも動かせる.NET（NetCore.KBTemplate）かJavaを選び、.NET Frameworkは既存のWindows資産に合わせる場合に限るのが無難です。

### GeneXus 18の現行版（Upgrade 16）とKB変換が必要になる版上げ

[GeneXus 18の公式目次](https://docs.genexus.com/en/wiki?51066,Table+of+contents%3AGeneXus+18)は2026年11月12日に更新されており、GeneXus 18を最新のメジャー安定版とする記載です。リリースの欄にはUpgrade 1からUpgrade 16までと各Hotfixが並び、Upgrade 17がプレビューとして載っています。同じページに「KB Conversion」の節があり、17から18へ上げるときはKBの変換を伴います。

目次ページの作成日は2022年6月16日で、そこから16回のUpgradeが出ています。年に3〜4回の周期です。版上げを数年止めると、変換と再ビルドの確認がまとめて押し寄せます。少なくとも年に1回は最新のUpgradeへ追随し、変換の前にKBを退避する手順（次の章のXPZエクスポート）を決めておきます。

## MSBuildタスクでGeneXusのKBを開いてビルドを自動化する手順

GeneXusはIDEで操作するのが基本ですが、KBのオープン、仕様化、生成、コンパイルはMSBuildのタスクとしても呼べます。夜間ビルドやテストの自動実行は、この仕組みで組みます。

### OpenKnowledgeBaseとBuildAllで夜間ビルドを組むスクリプト例

[公式ドキュメントの基本スクリプト](https://docs.genexus.com/en/wiki?3908,MSBuild+Tasks)は、GeneXusのインストール先にあるGenexus.Tasks.targetsをImportし、KBを開いてBuildAllを呼ぶ形です。これに環境の指定と、再編成が必要なときに止める設定を足すと次のようになります。

```
<Project DefaultTargets="NightlyBuild" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <Import Project="$(GXInstall)\Genexus.Tasks.targets" />
  <Target Name="NightlyBuild">
    <OpenKnowledgeBase Directory="C:\KBs\SalesKB" />
    <SetActiveEnvironment EnvironmentName="NETSQLServer" />
    <BuildAll ForceRebuild="false" FailIfReorg="true" />
  </Target>
</Project>
```

保存したファイルは、MSBuildに渡して実行します。GXInstallにはGeneXus 18のインストール先フォルダを指定します。

```
msbuild NightlyBuild.msbuild /p:GXInstall="GeneXus18_INSTALL_DIR"
```

[OpenKnowledgeBaseタスク](https://docs.genexus.com/en/wiki?35862,OpenKnowledgeBase+MSBuild+Task)は、Windows統合認証のままならDirectoryだけで開けます。SQL Server認証のKBではDatabaseUserとDatabasePasswordを渡しますが、スクリプトに直接書かず、CIのシークレットから渡すようにします。

BuildAllの既定では、テーブル構成の変更で再編成が発生すると、ビルドの途中で自動的に実行されます。FailIfReorgをtrueにすると、再編成が必要な場合はビルドを失敗させ、再編成プログラムだけを生成して止めます。本番に近いデータベースへ夜間ビルドをつなぐなら、この設定を入れて、再編成は人が確認してから流すほうが安全です。

### XPZへのエクスポートでKBを退避し、移行や版上げに備える方法

KBの中身はExportタスクでXPZファイルに書き出せます。Objectsを省略するとKBの全オブジェクトが対象になります。

```
<Project DefaultTargets="ExportKB" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <Import Project="$(GXInstall)\Genexus.Tasks.targets" />
  <Target Name="ExportKB">
    <OpenKnowledgeBase Directory="C:\KBs\SalesKB" />
    <Export File="C:\Backup\SalesKB_full.xpz" />
  </Target>
</Project>
```

XPZは別のKBへImportタスクで取り込める形式で、版上げ前の退避や、別環境での検証用KBを作成するための形式です。KB全体をバージョン情報ごと残したいときは、同じページにあるBulkCopyKnowledgeBaseタスク（BCP形式）を使います。どちらもGeneXusで開く前提の形式なので、他の言語やツールへ移るときの「仕様の受け渡し」には使えない点に注意が要ります。

## GeneXus for Agents 1.0のKBテキスト化とAIエージェントによる操作

2026年に入って変わったのが、AIエージェントからKBを扱う経路です。[GeneXus for Agents 1.0](https://docs.genexus.com/en/wiki?62286,GeneXus+for+Agents+1.0)は2026年11月12日に正式版になりました。

### KBのテキスト表現（.gxファイル）とgx CLIでAIエージェントがKBを編集する流れ

[KBのテキスト表現の公式ドキュメント](https://docs.genexus.com/en/wiki?62120,GeneXus+for+Agents+-+Knowledge+Base+textual+representation)によると、KBのオブジェクトは「{名前}.gx」というテキストファイルとして、KBフォルダ内のsrcとrefへの書き出し対象です。srcには属性やドメインなどの「#」付きフォルダ、モジュールごとのフォルダとmodule.tomlが並び、refに入るのは読み取り専用の参照モジュールです。エージェントはこのテキストを読み書きし、変更は検証を通ってからKBへ取り込まれます。ビルドと実行は取り込み後のKBに対して行われます。

エージェントとの橋渡しは[gx CLI](https://docs.genexus.com/en/wiki?62117,GeneXus+for+Agents+-+gx+CLI)の役割です。エージェントは端末でgxコマンドを実行するだけで、背後のGeneXus MCP Serverとの接続はgx CLIの管理下です。終了コードは0が成功、1がエラー、130が中断で、結果は最終行のRESULT:または–jsonで受け取れます。[公式FAQ](https://www.genexus.com/en/products/genexus/faq)では、公式にサポートするエージェントをCODA、Claude Code、OpenAI Codexの3つとし、GeneXusの顧客は追加費用なしで使えるとしています。

### 2026年11月時点でGeneXus for Agentsの本番利用を見送る判断条件

正式版が出たばかりで、公式ドキュメントにも既知の制限（Known limitations）のページがあります。対象はGeneXus 18のKBです。次のどれかに当てはまるなら、まず検証用KBで試し、本番KBへの適用は見送るのが妥当です。

- KBがGeneXus 17以前のままで、18への変換が済んでいない
- KBの変更をレビューする手順がなく、エージェントの変更をそのまま取り込むことになる
- テキスト表現をGitで管理する運用と、従来のGeneXus Serverでのチーム開発をどう併用するか決まっていない

逆に、KBの構造を把握している技術者が減っている組織では、エージェントにKBの構成を説明させる使い方だけでも価値があります。オブジェクトの関係を文章で引き出せるため、後述の移行判断で「KBを仕様書として読む」作業の下準備にもなります。

## 生成コードの保守とGeneXusから他技術への移行を判断する基準

GeneXusの評価が分かれるのは、導入時ではなく導入から10年後です。この章では、使い続ける条件と移行を考えるべき場面を言い切ります。

### KBを読める技術者の人数で決まる、GeneXusの保守体制のリスク

GeneXusの保守性はKBの品質と、それを読める人に依存します。生成コードは人が直す前提ではないため、KBが読めなければ、生成されたC#やJavaのソースがあっても実質的に手を入れられません。KBの設計にはGeneXus固有の知識が要るため、JavaやC#の技術者をそのまま保守に充てることはできません。

リスクが表に出るのは、担当者の退職や販売代理店との契約終了のときです。ベンダーや特定の担当者への依存が契約や体制にどう表れるかは、[ベンダーロックインとは？原因と回避策・契約で押さえる条項とリプレイスの判断基準](https://www.issoh.co.jp/column/details/19158/)で整理しています。ローコード全般に共通する弱点は[ローコード開発のデメリット7つ｜スクラッチとの使い分けと導入判断](https://www.issoh.co.jp/column/details/16318/)も参考になります。

### GeneXusを使い続ける条件と、移行の検討を始めるべき4つのサイン

使い続けてよいのは、次の3つが揃っている場合です。KBを読める技術者が社内または委託先に2人以上いる。GeneXus 18の最新Upgradeへ1年以内に追随している。業務ルールの変更がKBに反映され、生成コードを手で直していない。この状態なら、KBから生成先を切り替えられるGeneXusの利点がそのまま生きます。

次のサインが1つでも出たら、移行の検討を始めます。

1. KBを読める人が1人だけで、その人の不在時に改修が止まる
2. GeneXusの版上げが2世代以上止まり、KB変換の見通しが立たない
3. 生成後のソースを手で直した箇所があり、KBから再生成すると壊れる
4. 外部SaaSやAPIとの連携が増え、KBの外に書くコードのほうが多くなっている

1と2は体制の問題なので、まずGeneXusのまま委託先を増やすことも選択肢です。3と4は構造の問題で、GeneXusを使う利点そのものが失われています。この場合は移行を前提に進めるほうが、改修のたびに費用が膨らむ状態を早く抜けられます。

### GeneXusから移行するときの進め方：KBを仕様書として読み直す手順

移行で最初にやるのは、生成されたソースの変換ではなく、KBからの仕様の取り出しです。生成コードには、GeneXusの実行時ライブラリを前提にした構造が多く含まれます。ソースをそのまま別言語へ機械変換しても、読みやすいコードにはなりません。

進め方は、トランザクションからテーブル定義と業務ルールを、プロシージャから処理を一覧にし、使われていないオブジェクトを除いたうえで新しい設計に落とし込む手順です。GeneXus for Agentsのテキスト表現が使える版なら、この棚卸しの手間は減ります。移行方式（リホスト・リライト・リビルド）の違いは[マイグレーションとは？リプレース・リプレイスとの違い、種類・手法と選び方](https://www.issoh.co.jp/column/details/13177/)、段階的に置き換える手法は[モダナイゼーションとは？手法の違いと選び方・進め方をAWS／Azureの定義で解説](https://www.issoh.co.jp/tech/details/13374/)で説明しています。

一創では、GeneXusを含む既存システムの棚卸しから、移行方式の選定、新システムの開発までを[システムマイグレーション・リプレイス](https://www.issoh.co.jp/service/system/migration/)として受けています。KBを読める担当者がいなくなった場合の現状調査から相談できます。

## よくある質問

GeneXusを検討・運用している人からよく出る質問に答えます。

### GeneXusは無料で使えますか？

[GeneXusの公式ドキュメント](https://docs.genexus.com/en/wiki?1756,Category%3AGeneXus)から評価用のGeneXus Trialをダウンロードできます。商用の開発に使うにはライセンスが必要です。料金は利用形態や契約で変わるため、国内では販売・教育を担うジェネクサス・ジャパンに見積もりを取って確認します。公式FAQによると、AIエージェント向けのGeneXus for Agentsは、GeneXusの顧客なら追加費用なしで使えます。

### GeneXusで生成されるコードは何の言語ですか？

サーバー側は、KBを作るときのテンプレートで.NET、.NET Framework、Javaから選ぶ方式です。データベースのテーブル定義と、構造変更時の再編成プログラムも生成対象です。同じKBに複数の環境を持てるため、生成先を後から切り替えることもできます。ただし、外部ライブラリを直接呼んでいる部分は生成先ごとに作り直しが必要になる場合があります。

### GeneXusとOutSystemsの違いは何ですか？

どちらもローコード開発基盤ですが、GeneXusはKBの定義から.NETやJavaのソースコードを生成し、生成先を選べる点が特徴です。比べるときは、生成物を自社の環境で動かせるか、課金が開発者単位か利用者単位か、技術者を確保しやすいかの3点を見ます。OutSystemsの仕組みと料金は[OutSystems（アウトシステムズ）とは？できること・料金の仕組み](https://www.issoh.co.jp/column/details/1837/)、主要製品の課金単位は[ローコード開発ツール比較｜主要12製品の料金・課金単位と用途別の選び方](https://www.issoh.co.jp/column/details/15348/)で比べています。

### GeneXus 17から18へ上げるときの注意点は？

GeneXus 18の公式目次には「KB Conversion」の節があり、版上げにはKBの変換が必要です。変換の前に、ExportタスクでXPZを、またはBulkCopyKnowledgeBaseタスクでKB全体を事前に退避する手順です。変換後は検証用の環境でBuildAllを流し、再編成の内容と画面の動作を確かめてから本番へ反映します。公式のトレーニングサイトには17から18への更新講座もあります。

### GeneXusの技術者が社内にいない場合はどうすればいいですか？

選択肢は、GeneXusを扱える委託先に保守を任せるか、他の技術へ移行するかの2つです。改修の頻度が低く、KBが整理されているなら委託で対応可能です。生成コードを手で直した箇所が多い、外部連携が増えているといった状態なら移行を検討します。どちらの場合も、まずKBの棚卸しで現状を把握するところから始めます。

## 関連記事

- [ローコード開発会社の選び方｜内製と外注の判断基準と発注前の確認項目](https://www.issoh.co.jp/column/details/16323/)：GeneXusの保守を委託先に任せるときの確認項目
- [FileMakerとは？Pro・Server・Cloudの構成と料金、Data APIのcurl実装とODBC連携](https://www.issoh.co.jp/tech/details/20098/)：同じく業務アプリを内製する製品の構成と連携方法
- [ローコード開発ツール比較｜主要12製品の料金・課金単位と用途別の選び方](https://www.issoh.co.jp/column/details/15348/)：GeneXus以外の候補と課金単位の比較
- [マイグレーションとは？リプレース・リプレイスとの違い、種類・手法と選び方](https://www.issoh.co.jp/column/details/13177/)：GeneXusから移るときの方式の選び方

---

出典: [GeneXusとは？ナレッジベースからの自動生成とMSBuildでのビルド、移行判断【2026年11月】](<https://www.issoh.co.jp/tech/details/20100/>)（株式会社一創）
