template-add について
template-addは、1Cプロジェクトで指定形式のテンプレートを作成し、オブジェクトのルートXMLに登録する開発スキルです。複数の形式に対応し、HTMLの言語ページやレポートのメインデータコンポジションスキーマも扱えます。
主な機能
- 01複数形式のテンプレート作成
- 02ルートXMLへのテンプレート登録
- 03HTML言語ページの追加
- 04レポートのメインスキーマ設定
- 05ソースディレクトリと別名の指定
活用シーン
- 01レポート用データコンポジションスキーマの作成
- 02外部データプロセッサーへのテキストまたはバイナリテンプレート追加
- 03HTMLテンプレートへの別言語ページ追加
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ nikolay-shirokov/ cc-1c-skills --skill template-addインストール後、Claude Code で/template-addを入力して読み込まれたか確認します。
同梱ファイルscripts/add-template.ps1scripts/add-template.py
詳細
/template-add — レイアウトの追加
指定した種類のレイアウトを作成し、オブジェクトのルート XML に登録します。
使用方法
/template-add <ObjectName> <TemplateName> <TemplateType>
| パラメーター | 必須 | デフォルト | 説明 |
|---|---|---|---|
| ObjectName | はい | — | オブジェクト名 |
| TemplateName | はい | — | レイアウト名 |
| TemplateType | はい | — | 種類:HTML、Text、SpreadsheetDocument、BinaryData、DataCompositionSchema |
| Synonym | いいえ | = TemplateName | レイアウトの別名 |
| Lang | いいえ | ru | ページの言語コード。HTML タイプのみ。別の言語で再度呼び出すと、既存のレイアウトにページが追加されます |
| SrcDir | いいえ | src | <ObjectName>.xml が格納されているオブジェクト種別フォルダー(Reports、DataProcessors、Catalogs、Documents など)へのパス。外部処理/レポートが隣接しているディレクトリでは、デフォルトの src を使用できます |
| -SetMainSKD | いいえ | — | MainDataCompositionSchema を強制的に設定します |
コマンド
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/add-template.ps1" -ObjectName "<ObjectName>" -TemplateName "<TemplateName>" -TemplateType "<TemplateType>" [-Synonym "<Synonym>"] [-Lang "<Lang>"] [-SrcDir "<SrcDir>"] [-SetMainSKD]
例
拡張機能のレポートにメインの DCS を追加します。
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/add-template.ps1" -ObjectName "ОтчётПродажи" -TemplateName "ОсновнаяСхемаКомпоновкиДанных" -TemplateType "DataCompositionSchema" -SrcDir "src/cfe/МоёРасширение/Reports"
種類のマッピング
ユーザーは自由な形式で種類を指定できます。文脈から適切な種類を判断してください。
| ユーザーの指定 | TemplateType | 拡張子 | 内容 |
|---|---|---|---|
| HTML | HTMLDocument | Template/<lang>.html | 空の HTML ドキュメント |
| Text、テキストドキュメント、テキスト | TextDocument | .txt | 空のファイル |
| SpreadsheetDocument、スプレッドシートドキュメント、MXL | SpreadsheetDocument | .xml | 最小限のスプレッドシート |
| BinaryData、バイナリデータ | BinaryData | .bin | 空のファイル |
| DataCompositionSchema、DCS、コンポジションスキーマ | DataCompositionSchema | .xml | 最小限の DCS スキーマ |
命名規則
印刷フォーム用のレイアウト(SpreadsheetDocument タイプ)には、プレフィックス ПФ_MXL_ を付けます。
| 文脈 | 名前の形式 | 例 |
|---|---|---|
| 印刷フォーム(印刷フォーム形式の追加処理、またはユーザーが明示的に「印刷フォーム」と指定した場合) | ПФ_MXL_<КраткоеИмя> | ПФ_MXL_М11、ПФ_MXL_СчётФактура、ПФ_MXL_КонвертDL |
| その他のレイアウト(データ読み込み、サービス用、設定) | プレフィックスなし | МакетЗагрузки、НастройкиПечати |
ユーザーがプレフィックスなしのレイアウト名を指定し、文脈が印刷フォームの場合は、プレフィックス ПФ_MXL_ を自動的に追加し、その旨を伝えてください。
MainDataCompositionSchema(自動)
ExternalReport または Report に DataCompositionSchema タイプのレイアウトを追加する場合:
MainDataCompositionSchemaが空であれば、レイアウトへの参照が自動的に設定されます- 既存の値を上書きするには
--SetMainSKDを使用します
作成されるもの
<SrcDir>/<ObjectName>/Templates/
├── <TemplateName>.xml # Метаданные макета (1 UUID)
└── <TemplateName>/
└── Ext/
├── Template.<ext> # Содержимое макета
└── Template/<lang>.html # HTML: содержимое (Template.xml — дескриптор)
変更されるもの
<SrcDir>/<ObjectName>.xml—ChildObjectsに<Template>が追加されます- ExternalReport/Report の場合:
MainDataCompositionSchemaが更新されることがあります
コメント
Markdown 対応