WebI.KzdLib

工程’ｓ (Kouteizu) の WebI.KzTools を使うアプリケーション向けに、WinForms / WPF 起動雛形・親プロセス／ウィンドウ連携・工程’ｓフォルダー解決・画像色 (IMAGE_COLOR.csv) など、アプリ寄りの共通処理を提供するユーティリティライブラリです。

5.0 でパッケージを分割しました。Kouteizu 非依存の汎用ユーティリティは WebI.KzdLib.Foundation、工程データモデルの拡張 (ノード走査・バー判定・カレンダー・KzProjector 等、名前空間 WebI.KzdLib.KzTools) は WebI.KzTools 5.0 へ移り、本パッケージはそれらに依存します。WebI.KzdLib を入れれば両者も自動的に取得されます。

• 対象フレームワーク: .NET Framework 4.7.2 / .NET 8 (Windows) のマルチターゲット (net472;net8.0-windows)
• C# 言語バージョン: latest (ただし net472 で素のまま動作する言語機能に限定)
• 依存パッケージ: WebI.KzTools 5.0、WebI.KzdLib.Foundation 5.0
• 提供元: Web I Laboratories, Inc.

インストール

社内 NuGet サーバー https://nuget.dev.cloud-webi.com/v3/index.json をパッケージソースに追加してから、Visual Studio の NuGet パッケージマネージャー、または以下のコマンドでインストールしてください。依存パッケージ WebI.KzTools は自動的に取得されます。

Install-Package WebI.KzdLib

詳細手順: getting-started.md

クイックスタート

工程’ｓから --transport <path> で渡される kzd ドキュメントを読み込み、ルートノード以下を列挙して保存し直すだけの最小例です。

using Kouteizu.Network;
using WebI.KzdLib;
using WebI.KzdLib.KzTools;

var cmdLineArgs = new KzdCommandLineArgs();
cmdLineArgs.Parse(args);

var cmd = cmdLineArgs.LoadDocumentFromTransportDir();
var doc = cmd.Document;

var root = doc.GetRootNode(TreeId.Tree1);
foreach (var node in root.EnumerateSelfAndDescendants())
{
    Console.WriteLine("{0}: {1}", new string(' ', node.Level * 2), node.S_DES);
}

cmdLineArgs.SaveDocumentToTransportDir(cmd);

WinForms / WPF アプリ向けには KzdAppProgram.KzdAppMain<TForm> / KzdAppMain<TWindow> が例外ハンドリング + 引数パース + Application.Run をまとめて面倒見ます (WebI.KzdLib.WinForms / WebI.KzdLib.Wpf の 2 つの namespace に同じ API を提供)。

ドキュメント

• ユーザーガイド (目次): docs/user-guide/index.md
• Getting Started: getting-started.md
• 4.7.x → 5.0 移行ガイド: migration-from-4.7.md
• Core 版 (dotnet-core) → 5.0 移行ガイド: migration-from-core.md
• WinForms / WPF アプリ雛形: app-skeleton.md
• How-To: ノード走査拡張 / バー・制約拡張 / KZCommand 拡張 / KzProjector (ドキュメント間転写) / Calendar / Foundation 汎用ユーティリティ
• API リファレンス: 公開型・メンバーの XML ドキュメントコメント (IntelliSense / WebI.KzdLib.xml) を正とします。

不具合・要望は社内 GitLab の イシュートラッカー へ。