MS Project (MPP) ve Primavera (XER) Dosyalarıyla Çalışmak İçin Önde Gelen Açık Kaynak API’leri

Kurumsal proje yönetiminde, iki özel dosya formatı hâkimdir: Microsoft Project (.mpp) ve Oracle Primavera P6 (.xer). İç analiz panosu oluşturuyor, inşaat takvimlerini ERP sistemleriyle senkronize ediyor ya da proje durumu boru hatlarını otomatikleştiriyor olun, bu zamanlama dosyalarını programlı olarak okumak ve manipüle etmek kritik bir gereksinimdir.

Ancak, her iki format da kötü şöhretli mühendislik engelleri oluşturur:

• MPP files ikili, belgelenmemiş OLE Structured Storage veya özel birleşik belge formatlarıdır; şema değişiklikleri neredeyse tüm büyük MS Project sürümlerinde (2000, 2003, 2007, 2010, 2013, 2016, 2019, 2021) gerçekleşir.
• Primavera XER files sekme ile ayrılmış metin dışa aktarımlarıdır; ilişkisel veritabanı tabloları (%T tabloları, %F alanları ve %R kayıtları) şeklinde yapılandırılmış, karmaşık referans bütünlüğü kısıtlamaları, çok takvim kalıtımı ve kritik yol mantığıyla doludur.

Aspose.Tasks gibi ticari SDK’lar mevcuttur, ancak lisans maliyetleri ve satıcı bağımlılığı, sağlam açık kaynak alternatiflerini gerekli kılar. Bu rehberde, MPP ve XER dosyalarını temiz ve verimli bir şekilde işlemek için Java, Python ve C#‘da mevcut olan en iyi açık kaynak API’leri, kütüphaneleri ve ayrıştırıcıları inceleyeceğiz.

Açık Kaynak Araçların Hızlı Karşılaştırması

1. MPXJ (Java’da Microsoft Project eXchange)

Programlama Takvimi Uyumluluğu için Tartışmasız Endüstri Standardı

Açık kaynak zamanlama kütüphanelerinde bir altın standart varsa, o MPXJ‘dir. Jon Iles tarafından yirmi yıldan fazla süredir aktif olarak sürdürülen MPXJ, başlangıçta Microsoft Project MPX dosyalarını işlemek için oluşturulmuş, ancak proje zamanlama formatları için evrensel bir çeviri motoruna dönüşmüştür.

Ana Özellikler

• Doğrudan MPP Çıkarma: Microsoft Project’in neredeyse tüm sürümlerinde (Project 98’den modern Project 2016/2019/2021/365’e) kurulu bir Microsoft Project kopyası gerektirmeden özel ikili MPP dosyalarını ayrıştırır.
• Primavera P6 XER & PMXML Ayrıştırma: Hem metin tabanlı .xer dökümleri hem de modern Primavera XML dosyaları için yerel destek.
• Normalleştirilmiş Veri Modeli: Tek bir nesne modeli (ProjectFile, Task, Resource, ResourceAssignment, Relation, WorkCalendar) sunar. Girişiniz MPP ya da XER olsun, uygulama kodunuz aynı API ile etkileşir.
• Çok Dilli Dağıtım: Java’da yazılmış olmasına rağmen, MPXJ IKVM/CoreCLR aracılığıyla .NET (C#) için yerel derlenmiş NuGet paketleri ve ayrıca bir Python paketi (mpxj PyPI’de) dağıtır.

Hızlı Kod Örneği: Java

import net.sf.mpxj.ProjectFile;
import net.sf.mpxj.Task;
import net.sf.mpxj.reader.UniversalProjectReader;

public class ScheduleReader {
    public static void main(String[] args) throws Exception {
        // UniversalProjectReader automatically detects whether it's MPP, XER, or XML
        UniversalProjectReader reader = new UniversalProjectReader();
        ProjectFile project = reader.read("capital_project_schedule.xer");

        System.out.println("Project Name: " + project.getProjectProperties().getProjectTitle());

        for (Task task : project.getTasks()) {
            if (task.getName() != null) {
                System.out.printf("Task ID: %d | WBS: %s | Name: %s | Early Start: %s%n",
                    task.getID(), task.getWBS(), task.getName(), task.getEarlyStart());
            }
        }
    }
}

MPXJ’nin Üstün Olduğu Alanlar

• Gerçek çapraz format normalizasyonu (MPP’yi XER uyumlu PMXML veya MSPDI’ye dönüştürme).
• Karmaşık takvim mantığı (vardiyalar, istisnalar, çoklu takvim çalışma saatleri).
• Üretim seviyesinde kararlılık ve aktif bir topluluk.

2. xerparser (Python)

Primavera XER için Hafif, Yerel Python Ayrıştırması

MPXJ Python bağlamaları aracılığıyla çağrılabilir, ancak bu, bir JVM arka ucunu (JPype aracılığıyla) çalıştırmayı gerektirir. Java bağımlılıkları olmadan çalışan tamamen yerel bir Python ayrıştırıcıya ihtiyacınız olduğunda, xerparser tercih edilen çözümdür.

XER dosyası temelde bir veritabanı anlık görüntüsünün düz metne dökülmüş halidir. xerparser bu tabloları yapılandırılmış Python nesnelerine çözer ve pandas ile sorunsuz bir şekilde bütünleşir.

Ana Özellikler

• Sıfır Java Bağımlılığı: pip install xerparser ile kurulabilen saf Python 3 kütüphanesi.
• İlişkisel Bütünlük: TASK (Aktiviteler), PROJECT (Proje meta verileri), PROJWBS (WBS hiyerarşileri), TASKRSRC (Atamalar) ve TASKPRED (Mantık bağları) gibi temel Primavera tablolarını eşler.
• Hızlı Çalıştırma: Konteynerleştirilmiş mikro hizmetler, AWS Lambda fonksiyonları ve modern veri orkestrasyon hatları (ör. Apache Airflow, Prefect) için idealdir.

Hızlı Kod Örneği: Python

from xerparser.reader import Reader
import pandas as pd

# Load XER file
xer = Reader("plant_expansion.xer")

# Access projects inside the XER dump
for project in xer.projects:
    print(f"Project Code: {project.short_name}, Description: {project.name}")

# Convert activities into a Pandas DataFrame for downstream analytics
tasks_data = []
for act in xer.activities:
    tasks_data.append({
        "Task_Code": act.task_code,
        "Name": act.task_name,
        "Status": act.status_code,
        "Early_Start": act.early_start_date,
        "Early_Finish": act.early_end_date,
        "Total_Float": act.total_float_hr_cnt
    })

df = pd.DataFrame(tasks_data)
print(df.head())

xerparser’ın Üstün Olduğu Alanlar

• Veri mühendisliği, gecikme-iddia analizleri ve program sağlık kontrolleri (DCMA 14 noktalı değerlendirme betikleri).
• Java çalışma zamanının 50 MB+ paketlenmesinin pratik olmadığı sunucusuz iş yükleri.

3. python-mpxj

Python’u MPXJ’in Tam Gücüyle Birleştirmek

Python’da çalışıyorsanız ancak ikili .mpp dosyalarını işlemek zorundaysanız, xerparser size yardımcı olamaz çünkü yalnızca .xer hedef alır. En güvenilir açık kaynak köprü python-mpxj‘dir.

Ana Özellikler

• jpype1 kullanarak otomatik olarak başsız gömülü bir JVM başlatır.
• Tam MPXJ API’sını doğrudan Python geliştiricilerine sunar.
• Sahipli .mpp dosyalarından .json veya .csv gibi modern açık formatlara doğrudan dönüşüm sağlar.

pip install mpxj

import mpxj

# MPXJ provides high-level helper utilities
from net.sf.mpxj.reader import UniversalProjectReader

reader = UniversalProjectReader()
project = reader.read("commercial_tower.mpp")

for task in project.getTasks():
    if task.getName():
        print(f"{task.getUniqueID()}: {task.getName()} -> {task.getDuration()}")

4. Özel Ayrıştırma Yardımcı Programları ve Veritabanı Alım Betikleri

Ham Primavera XER’i Akış İşleme ile İşlemek

Primavera XER, öngörülebilir bir tablo formatını izlediği için, birçok açık kaynak mühendislik ekibi yüksek seviyeli DOM tarzı program kütüphaneleri yerine (Go, Python veya Rust ile yazılmış) özel tablo akışı çözücüleri kullanır.

Bir XER dosya yapısı şu şekilde biçimlendirilir:

%T  TASK
%F  task_id  proj_id  wbs_id  task_code  task_name  status_code
%R  10182    120      45      A1000      Mobilization TK_Complete
%R  10183    120      45      A1010      Excavation   TK_Active
%E

GitHub’da bulunan çeşitli açık kaynak kodlu betikler (örneğin xer2sqlite ve xer-to-csv) bu yapıyı doğrudan SQLite veya PostgreSQL’e ayrıştırır. Bu yaklaşım aşağıdaki durumlarda en iyisidir:

1. Yalnızca SQL ile tablo ilişkilerini sorgulamanız gerekir.
2. Takvimler, on binlerce görev içeren ve boyutu yüzlerce megabayt olan, nesne yönelimli ağaç yükleyicilerin bellek yetersizliği hatalarına yol açacağı durumlarda.

Teknik Karşılaştırma: Hangisini Seçmelisiniz?

MPXJ’yi Şu Durumda Seçin:

• Sahip olduğunuz tescilli ticari yazılımlara para ödemeden ikili Microsoft Project .mpp dosyalarını okumalısınız.
• Derin takvim zekâsına ihtiyacınız var: çalışma takvimleri, gecikme süresi hesaplamaları, kritik yol hesaplaması ve temel varyans.
• Teknoloji yığını Java, Kotlin, C# (.NET) veya kurumsal Python’dur.

xerparser’ı Şu Durumda Seçin:

• Yalnızca Primavera P6 .xer dosyalarını işlersiniz.
• Veri hattınız yerel Python ile yazılmıştır ve doğrudan pandas, NumPy veya Dash / Streamlit gibi görselleştiricilere beslenir.
• Hafif konteyner ortamlarına veya sunucusuz bulut çalıştırıcılarına dağıtım yapıyorsunuz.

Doğrudan DB / CSV Akışı Alımını Şu Durumda Seçin:

• Büyük çoklu proje kurumsal XER ihracatları için yüksek verimli veritabanı hazırlığına ihtiyacınız var.
• Yalnızca meta verileri, maliyet hesaplarını ve ilerleme eğrilerini SQL analitiğiyle çıkarmanız gerekir.

Özet ve En İyi Uygulamalar

Zaman çizelgesi verileri için açık kaynaklı veri hatları oluştururken:

1. .mpp dosyasını asla manuel olarak ayrıştırmayın: Microsoft ikili spesifikasyonu karmaşık ve belgelenmemiştir. Her zaman MPXJ gibi kanıtlanmış kütüphanelere güvenin.
2. Tarih Zaman Dilimlerine Dikkat Edin: Primavera zaman çizelgeleri genellikle zaman dilimi meta verisi olmadan iş sürelerini kaydeder ve proje takvimlerine dayanır. Veri alma hattınızın 8 saatlik iş günü kaymalarını 24 saatlik takvim günlerine karşı hesaba kattığından emin olun.
3. Referans Bütünlüğünü Doğrulayın: XER dosyalarında, el ile oluşturulan proje ihracatlarında sıkça yetim kayıtlar (ör. silinmiş WBS düğümlerine işaret eden görevler) bulunur. ETL sırasında her zaman dış anahtarları savunmacı bir şekilde doğrulayın.

SSS

**Q1: 1. Açık kaynaklı kütüphaneler yerel ikili .mpp dosyalarını doğrudan yazabilir veya güncelleyebilir mi?

A1: Hayır, Microsoft’un tescilli ikili formatı nedeniyle, açık kaynak kütüphaneler .mpp dosyalarını güvenilir bir şekilde okuyabilir, ancak yazma işlemleri genellikle MSPDI (XML) veya MPX gibi standart formatlara dışa aktarılır.

**Q2: Bu dosyaları ayrıştırmak için sunucuma Microsoft Project veya Primavera P6 kurulu olması gerekiyor mu?

A2: Hayır, MPXJ ve xerparser gibi kütüphaneler, ana yazılım lisansları gerektirmeden dosyaları doğrudan işleyen bağımsız ayrıştırıcılardır.

**Q3: Java bağımlılıkları olmadan Primavera P6 XER dosyalarını ayrıştırmak için en iyi yerel Python kütüphanesi hangisidir?

A3: xerparser, XER dökümlerini doğrudan yerel sözlükler ve pandas DataFrame’lerine ayrıştırmak için en iyi saf-Python seçeneğidir.

**Q4: MPXJ, Microsoft Project MPP dosyalarını Primavera P6 formatlarına dönüştürebilir mi?

A4: Evet, MPXJ bir .mpp dosyasını okuyabilir ve normalleştirilmiş takvimi Primavera uyumlu PMXML formatına dışa aktarabilir.

**Q5: Primavera XER dosyaları, Microsoft Project MPP dosyalarına göre neden daha kolay ayrıştırılır?

A5: XER dosyaları insan tarafından okunabilir, sekme ile ayrılmış ilişkisel veritabanı dökümleridir, oysa MPP dosyaları tescilli, ikili birleşik belge yapılarıdır.

Dosya Formatı Kaynakları

Dosya Formatı Haberleri – Dünya çapında dosya formatlarıyla ilgili tüm haberler için tek durak Dosya Formatı Forumları – Dosya formatı forumlarında sorularınızı göndererek dosya formatı uzmanlarından ve topluluk kullanıcılarından faydalı bilgiler alın Dosya Formatı Wiki – Çeşitli dosya formatları hakkında bilgi edinmek için dosya formatı kategorilerini keşfedin Açık Kaynak API’leri ve Kütüphaneleri Proje Yönetimi için