Community研究&データ分析github.com

gybson63/1c-oData-skill

1C oDataスキルは、AIエージェントが1CプラットフォームのoDataサービスと連携するための機能を提供します。

1c-oData-skill とは?

このスキルは、AIエージェント(Claude CodeやCursorなど)が1C:EnterpriseプラットフォームのoData(Open Data Protocol)サービスにアクセスし、データの読み取り・書き込み・クエリを実行できるようにするためのツールです。oDataはRESTfulなAPIプロトコルであり、このスキルを使用することでエージェントは1Cのビジネスデータ(顧客、在庫、販売データなど)に直接アクセス可能になります。主に開発者やビジネスアナリストが、自然言語インターフェースから複雑な1Cデータ操作を自動化するために利用します。スキルが提供するMarkdownドキュメントには、認証方法、エンドポイントの仕様、サンプルリクエスト/レスポンス、一般的なユースケースが記載されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add gybson63/1c-oData-skill

Installed? Explore more 研究&データ分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

1c-oData-skill は何をしますか?

1C oDataスキルは、AIエージェント向けの機能を提供します。

このスキルは、AIエージェントが1C:EnterpriseプラットフォームのoDataサービスと対話するための機能を提供します。oData(Open Data Protocol)を使用することで、エージェントは標準化されたRESTful APIを通じて1Cのビジネスデータにアクセスし、クエリを実行できます。

はじめに

このスキルを使用するには、以下の環境が必要です:

  • 1C:Enterpriseプラットフォーム(バージョン8.3以上)
  • 公開されたoDataサービスエンドポイント
  • 適切な認証情報

認証

oDataサービスにアクセスするには、適切な認証方法を設定する必要があります。一般的な認証方式は以下の通りです:

  • Basic認証
  • NTLM認証
  • トークンベース認証

エンドポイント

oDataサービスの基本的なエンドポイント構造は以下の通りです:

http(s)://<サーバー>/<ベースパス>/odata/standard.odata

主な操作

データの取得(GET)

GET /odata/standard.odata/Catalog_<カタログ名>

データのフィルタリング

GET /odata/standard.odata/Catalog_<カタログ名>?$filter=<条件>

データの作成(POST)

POST /odata/standard.odata/Catalog_<カタログ名>
Content-Type: application/json

{
  "Description": "新しい要素",
  ...
}

サポートされているリソース

このスキルは以下の1Cリソースタイプをサポートしています:

  • カタログ(Catalog_XXX)
  • ドキュメント(Document_XXX)
  • 情報レジスタ(InformationRegister_XXX)
  • 累計レジスタ(AccumulationRegister_XXX)
  • 勘定科目表(ChartOfAccounts_XXX)
  • その他

使用例

顧客カタログからすべての顧客を取得

GET /odata/standard.odata/Catalog_Клиенты

特定の期間の販売ドキュメントを取得

GET /odata/standard.odata/Document_Продажи?$filter=Date ge datetime'2023-01-01T00:00:00'

注意事項

  • 1C oDataサービスの応答時間はデータ量によって異なる場合があります
  • 大量のデータを扱う場合は、ページング($top, $skip)を使用することを推奨します
  • 認証情報は安全に管理してください

参考リンク

関連スキル