|
<< İçindekileri Görüntülemek İçin Tıklayın >> Yer: Teknik Kılavuzlar > Netsim System Agent İstemci Protokolü Referansı > 3. Diğer HTTP uçları (/ClientREST/...) > 3.2 MCP yerleşik araçları ivd__* (I8, 2026-09-16) |
-MCP kipinde tools/list üç yerleşik araç daha verir (ön eksiz; isteğe bağlı database argümanı MASTER'daki
kayıt adıyla veritabanını seçer, verilmezse istemci bağlantısı kurulabilen ilk kayıt). Kaynak aynı IVD$V_* görünümleridir; USING bağlamıyla
koşul çözümü motor tarafındadır (I9).
| Araç | Argümanlar | Sonuç metni (JSON) |
|---|---|---|
ivd__describe_table |
table |
database, table_name[, requested_name], found, table, columns, relations, references_out, references_in, attributes, localization[, storage_table, storage_note, storage_relations, storage_attributes, storage_localization][, notes] — relations yalnız kısıtlar; references_out (COLUMN_NAME, REFERENCED_TABLE, REFERENCED_VIEW: bu tablonun ns.ref_table bildiren kolonları) ve references_in (TABLE_NAME, COLUMN_NAME: hedefi bu tablo olan kolonlar, görünümü olan NS_ tablosu gizli) IVD$V_COLUMNS.NS_REF_TABLE'dan (katalog 29); attributes / localization / references_* görünüm ya da kolon yoksa null + notes |
ivd__search_objects |
text, scope = NAME (öndeğer) | DESCRIPTION | ATTRIBUTES | ALL |
byName / byDescription / byAttribute kümeleri (IVD$OBJECTS, kullanıcı nesneleri) |
ivd__effective_attributes |
object (TABLO ya da TABLO.KOLON) |
attributes (tüm satırlar, FILTER_TEXT NULL = taban) + note[, storage_note] |
Görünüm öncelikli: güvenlikli veritabanında X görünümü uygulamanın ve SQL'in kullandığı addır, arkasındaki
NS_X tablosu depo (güvenlik) katmanıdır. ivd__describe_table X görünümü anlatır; NS_X'in ilişki, öznitelik ve
yerelleştirme satırları storage_* bölümlerinde gelir (kolonlar görünümünkiyle aynı, tekrarlanmaz). NS_X istenirse
de X anlatılır (requested_name: NS_X). ivd__search_objects görünümü olan NS_X'i ve kolonlarını listelemez;
açıklaması ya da özniteliği NS_X'te eşleşen görünüm listelenir. ivd__effective_attributes X (ya da X.KOLON)
iki nesnenin satırlarını birlikte verir. Çift adla bulunur: X görünümü + NS_X tablosu; görünümü olmayan tablo
eskisi gibidir.
Hatalar: geçersiz argüman -32602, veritabanı bağlanamıyor -32603, sorgu hatası (görünüm yok) isError: true
+ metin.
HTTP MCP (conf processor: "MCP", örnek yol /mcp): POST gövdesi tek JSON-RPC
mesajı, yanıt application/json; bildirim 202 + boş gövde; GET 405; initialize listChanged: false ve
araçları anlatan instructions metni (istemci ajanın sistem istemine koyar); oturum yok, uç anonim. tools/list
yalnız ivd__* (kayıt varsa) ve help_* verir; WEBSENDP araçları, doc_* ve reload_tools çağrısı -32601
(MCP araci HTTP uzerinden sunulmuyor). Uygulamanın conf database'i verilirse ivd__* yalnız o MASTER kaydını
görür: database argümansız çağrı onu okur, başka bir ad -32602 (database bulunamadi: <ad>) alır. Gövde 4 MB'ı
aşarsa 413, boş gövde 400.