← يتطلب: مقدمة في IRIS الأساسيات مبتدئ ⏱ 4 ساعات الدورة 05

بيئة التطوير المتكاملة

Integrated Development Environment

🎯 أهداف التعلم

1تثبيت وإعداد VS Code لتطوير IRIS
2استخدام Management Portal لإدارة النظام
3تعلم تقنيات التصحيح (Debugging)
4فهم أدوات سطر الأوامر
01

إعداد VS Code لتطوير IRIS

يمكنك استخدام Visual Studio Code مع امتداد InterSystems ObjectScript لتطوير تطبيقات IRIS بشكل مريح.

خطوات الإعداد

  • تثبيت VS Code من الموقع الرسمي
  • تثبيت امتداد "InterSystems ObjectScript" من Marketplace
  • تكوين الاتصال بخادم IRIS
// .vscode/settings.json
{
    "objectscript.conn": {
        "active": true,
        "host": "localhost",
        "port": 52773,
        "username": "_SYSTEM",
        "password": "SYS",
        "ns": "USER",
        "https": false
    },
    "objectscript.showExplorer": true,
    "objectscript.compileOnSave": true
}
ℹ️ معلومة

يمكنك أيضاً استخدام امتداد "InterSystems Server Manager" لإدارة多个 خوادم IRIS من داخل VS Code.

02

Management Portal

يُعد Management Portal الأداة الرئيسية لإدارة خادم IRIS. يمكنك الوصول إليه عبر المتصفح.

الميزات الرئيسية

  • System Explorer: استكشاف الفئات والجداول والGlobals
  • System Operations: مراقبة الحالة والأداء
  • Security: إدارة المستخدمين والأذونات
  • Configuration: إعدادات النظام
// الوصول للـ Portal عبر الامر
// http://localhost:52773/csp/sys/UtilHome.csp

// أو عبر ObjectScript
Set url = "http://localhost:52773/csp/sys/UtilHome.csp"
Write "افتح في المتصفح: ", url

// التحقق من حالة النظام
Set status = ##class(%SYS.System).GetSystemInfo(.info)
Write "اسم النظام: ", info("SystemName"), !
Write "إصدار IRIS: ", info("Version"), !
Write "المساحة: ", info("Namespace"), !
03

التصحيح (Debugging)

يوفر VS Code أداة تصحيح متكاملة لتطبيقات IRIS.

// نقاط التوقف (Breakpoints)
// يمكنك إضافة نقطة توقف بالنقر على هامش السطر في VS Code

Class Demo.DebugExample
{
    ClassMethod ProcessData(data As %String) As %String
    {
        Set result = ""
        
        // نقطة توقف هنا
        For i = 1:1:$LENGTH(data) {
            Set char = $EXTRACT(data, i)
            
            If char = " " {
                Set result = result _ "_"
            } Else {
                Set result = result _ char
            }
        }
        
        Quit result
    }
}

// استخدام أمر BREAK للتصحيح
ClassMethod TestBreak()
{
    Set x = 10
    BREAK  // يتوقف هنا في وضع التصحيح
    Set y = x * 2
    Write y
}

// استخدام WRITE لتصحيح سريع
ClassMethod DebugOutput()
{
    Set arr(1) = "أ"
    Set arr(2) = "ب"
    Set arr(3) = "ج"
    
    ZWRITE arr  // طباعة كل المتغيرات
    ZZDUMP arr  // عرض بصيغة hex
}
04

أدوات سطر الأوامر

يمكنك استخدام أداة iris session للتفاعل مع IRIS عبر سطر الأوامر.

# الاتصال بجلسة IRIS
iris session IRIS

# أو عبر terminal
iris terminal IRIS

# أوامر مفيدة في الطرفية
# عرض المساحة الحالية
WRITE $NAMESPACE

# تغيير المساحة
SET $NAMESPACE = "USER"

# تشغيل فئة
DO ##class(MyApp.Main).Run()

# تنظيف الذاكرة
DO $SYSTEM.OBJ.CompileAll()

# عرض حالة النظام
DO $SYSTEM.SQL.Shell()
⚠️ تنبيه

كن حذراً عند استخدام سطر الأوامر في بيئة الإنتاج. الأوامر مثل KILL ^GLOBAL قد تحذف بيانات permanently.

📝 اختبار التحقق

1 ما هو الامتداد المستخدم في VS Code لتطوير IRIS؟
A IRIS Toolkit
B InterSystems ObjectScript
C Cache Studio
D ObjectScript Pro
💡 الشرح

امتداد "InterSystems ObjectScript" هو الأداة الرسمية لتطوير IRIS في VS Code.

2 ما هو عنوان URL الافتراضي للـ Management Portal؟
A localhost:8080
B localhost:52773/csp/sys
C localhost:3000
D localhost:57772
💡 الشرح

المنفذ الافتراضي للـ Management Portal هو 52773.

أي أداة تُستخدم لتصحيح أخطاء الكود في IRIS؟
💡 الشرح

IRIS يوفر Debugger مدمج في Studio وVS Code لتصحيح الأخطاء

💡 النقاط الرئيسية

  • VS Code مع امتداد InterSystems هو بيئة التطوير الموصى بها
  • Management Portal أداة شاملة لإدارة النظام
  • يمكنك استخدام نقاط التوقف في VS Code للتصحيح
  • أدوات سطر الأوامر متوفرة عبر iris session