واجهة برمجة تطبيقات مجانية لإدارة المشاريع بلغة C# .NET للتعامل مع المشاريع في Redmine
مكتبة C# .NET مفتوحة المصدر للتواصل مع تطبيق إدارة مشاريع Redmine. تقوم بأتمتة المهام، إنشاء تقارير مفيدة، أو تخصيص سير العمل في تطبيقات .NET.
ما هو Redmine-Net-API؟
Redmine معروف في أوساط إدارة المشاريع كأداة قوية ومرنة. يفضله العديد من الفرق بسبب تعدد استخداماته وميزاته القوية. لجعلها أفضل، قام المطورون بإنشاء إضافات ومكتبات مفيدة. أحد الأمثلة هو Redmine-Net-API الموجود على GitHub. هذه المكتبة توسّع وظائف Redmine من خلال توفير واجهة برمجة تطبيقات .NET. باستخدامها، يمكنك بسهولة دمج Redmine مع تطبيقات .NET. توفر المكتبة فرصًا مثيرة للمطورين الذين يرغبون في إضافة ميزات Redmine إلى برامج .NET الخاصة بهم. مع هذه المكتبة، يمكنك الآن تسجيل إدخالات الوقت للمهام بسهولة، مما يساعدك على البقاء منظمًا ومتابعة مهام مشروعك.
Redmine-Net-API هي أداة مفيدة لمطوري .NET الذين يرغبون في العمل مع خوادم Redmine. تم إنشاؤها بواسطة zapadi، تجعل هذه المكتبة التواصل مع خوادم Redmine من تطبيقات .NET أسهل. إنها مُصانة جيدًا وأصبحت مفضلة بين المطورين بفضل ميزاتها السهلة الاستخدام ونطاق وظائفها الواسع. من خلال السماح لك بإنشاء استعلامات وسمات مخصصة، تمنحك هذه المكتبة المرونة لتخصيص Redmine وفقًا لاحتياجاتك. سواء كنت تُعد سير عمل خاصة، أو تُدمج حقولًا مخصصة، أو تُؤتمت عمليات تجارية معقدة. إنها مصدر قيم يعزز ميزات Redmine ويبسط عمليات إدارة المشاريع. بفضل تكاملها السلس، وتصميمها السهل، وميزات واسعة، وواجهة برمجة تطبيقات بديهية، تُعد هذه الأداة إضافة رائعة لتسهيل إدارة المشاريع. إنها تعزز قدرات Redmine، مما يجعل مهام المشروع أبسط بالنسبة لك.
البدء مع Redmine-Net-API
الطريقة الموصى بها لتثبيت Redmine-Net-API هي عبر NuGet. يرجى استخدام الأوامر التالية لتثبيت سلس.
تثبيت Aspose.Tasks لـ .NET عبر NuGet
Install-Package redmine-net-api
يمكنك تنزيله مباشرة من صفحة GitHub
إنشاء مشروع جديد في Redmine باستخدام C#
مكتبة Redmine-Net-API المفتوحة المصدر تجعل من السهل على مطوري البرمجيات إنشاء مشروع جديد داخل Redmine باستخدام واجهة برمجة تطبيقات .NET. أولاً تحتاج إلى تهيئة RedmineManager باستخدام عنوان URL لخادم Redmine وبيانات الاعتماد. ثم يمكنك إنشاء كائن Project جديد بالمعلمات المطلوبة واستخدام طريقة CreateObject لإضافته إلى نسخة Redmine الخاصة بك. المثال التالي يوضح كيفية إنشاء مشروع جديد. بعد تشغيل الكود سيتم إنشاء مشروع جديد في نسخة Redmine الخاصة بك بالتفاصيل المحددة، وسيتم عرض معرف المشروع الجديد في مخرجات وحدة التحكم.
كيفية إنشاء مشروع جديد داخل Redmine باستخدام C# .NET API؟
using Redmine.Net.Api;
using Redmine.Net.Api.Types;
class Program
{
static void Main(string[] args)
{
// Initialize RedmineManager with server URL and API key
var redmineManager = new RedmineManager("https://redmine.example.com", "your_api_key");
// Create a new project object
var newProject = new Project
{
Name = "New Project", // Set the name of the new project
Identifier = "new-project", // Set a unique identifier for the project
Description = "This is a new project.", // Set the description of the project
IsPublic = true, // Set whether the project is public or private
TrackerIds = new List { 1, 2, 3 }, // Set the tracker IDs for the project (e.g., 1 for bug, 2 for feature, 3 for support)
IssueCustomFieldValues = new List // Set custom field values for the project, if any
{
new IssueCustomField { Id = 1, Value = "Custom Value 1" },
new IssueCustomField { Id = 2, Value = "Custom Value 2" }
}
};
try
{
// Create the new project
Project createdProject = redmineManager.CreateObject(newProject);
// Output the ID of the newly created project
Console.WriteLine($"New project created with ID: {createdProject.Id}");
}
catch (RedmineException ex)
{
// Handle any errors that occur during project creation
Console.WriteLine($"Error creating project: {ex.Message}");
}
}
}
استرجاع قائمة مشاريع Redmine الموجودة عبر C#
استرجاع قائمة المشاريع الموجودة من Redmine باستخدام مكتبة Redmine-Net-API المفتوحة المصدر أمر بسيط داخل تطبيقات .NET. تحتاج إلى تهيئة RedmineManager باستخدام عنوان URL لخادم Redmine وبيانات الاعتماد، ثم استخدام طريقة GetObjects لجلب المشاريع. المثال التالي يوضح كيف يمكن للمطورين عرض تفاصيل كل مشروع موجود في نسخة Redmine الخاصة بهم، بما في ذلك المعرف، الاسم، الوصف، وما إذا كان عامًا أو خاصًا.
كيفية استرجاع قائمة مشاريع Redmine الموجودة عبر API C#
using Redmine.Net.Api;
using Redmine.Net.Api.Types;
using System;
class Program
{
static void Main(string[] args)
{
// Initialize RedmineManager with server URL and API key
var redmineManager = new RedmineManager("https://redmine.example.com", "your_api_key");
try
{
// Retrieve a list of projects from Redmine
var projects = redmineManager.GetObjects();
// Output details of each project
foreach (var project in projects)
{
Console.WriteLine($"Project ID: {project.Id}");
Console.WriteLine($"Project Name: {project.Name}");
Console.WriteLine($"Project Description: {project.Description}");
Console.WriteLine($"Is Project Public: {project.IsPublic}");
Console.WriteLine();
}
}
catch (RedmineException ex)
{
// Handle any errors that occur during project retrieval
Console.WriteLine($"Error retrieving projects: {ex.Message}");
}
}
}
التصميم الكائني الأمان
إحدى نقاط القوة في Redmine-Net-API تكمن في تصميمه الكائني التوجه. فهو يج abstracts استدعاءات REST API الأساسية إلى مجموعة من الفئات البديهية وسهلة الاستخدام، مما يجعله أكثر ملاءمة للمطورين ويقلل من تعقيد التفاعل مع Redmine. علاوة على ذلك، تدعم المكتبة طرق مصادقة متعددة، مما يضمن اتصالًا آمنًا بين تطبيق .NET وخادم Redmine. يشمل ذلك مصادقة مفتاح API ومصادقة اسم المستخدم/كلمة المرور، مما يتيح للمطورين اختيار الطريقة التي تناسب متطلبات الأمان الخاصة بهم.