# Dosyadan Toplu Ürün Ağacı Bileşen Değiştirme Programı

> Excel veya CSV dosyasındaki satırlarla birçok malzeme ürün ağacında bileşen değiştiren, ekleyen, silen veya miktar güncelleyen custom program. Değişiklik numarasıyla geçerlilik tarihi verilir; test modunda her ürün ağacı için ne değişeceği ve kaç açık üretim siparişinin eski bileşeni kullandığı gösterilir.

- Tür: Program, Custom geliştirme, Toplu yükleme
- Modül: PP
- Tahmini efor: M (5–7 iş günü)
- Son güncelleme: 2026-11-17
- URL: https://nekuhub.com/programlar/toplu-urun-agaci-bilesen-degistirme-yukleme-programi/


## Standart çözüm neden yetmiyor?

CS20 toplu değişiklik bir bileşeni seçilen ürün ağaçlarında değiştirebilir, ancak dosyadan okumaz; her satırda farklı yeni bileşen, miktar ve geçerlilik tarihi vermek için tek tek çalıştırılır. Değişiklikten önce açık üretim siparişlerine etkisini gösteren bir ön izleme yoktur. CS02 ise tek ürün ağacını değiştirir. Sezonluk ürün değişiklikleri veya tedarikçi değişimi gibi yüzlerce satırlık işler için şablonlu ve test modlu bir yükleme gerekir.

### En yakın standart alternatifler

- CS20: Seçilen ürün ağaçlarında bir bileşeni toplu değiştirir; dosyadan okumaz ve açık sipariş etkisini göstermez.
- CS02: Tek bir ürün ağacını değiştirir.

## Kullanılan tablolar

| Tablo | Rolü | Erişim | Bağlantı | Sistem |
|---|---|---|---|---|
| MAST | Üst malzeme – ürün ağacı bağlantısı kontrolü | Okuma | MAST-MATNR = dosya üst malzeme AND MAST-WERKS = dosya üretim yeri | ECC + S/4 |
| STKO | Ürün ağacı başlığı; değişiklik numarasıyla güncellenir | Yazma | STKO-STLNR = MAST-STLNR AND STKO-STLAL = MAST-STLAL | ECC + S/4 |
| STPO | Ürün ağacı kalemleri: bileşen, miktar, kalem numarası | Yazma | STPO-STLNR = STKO-STLNR | ECC + S/4 |
| MARA | Yeni bileşenin varlığı, silme işareti ve malzeme durumu | Okuma | MARA-MATNR = dosya yeni bileşen | ECC + S/4 |
| RESB | Eski bileşeni kullanan açık üretim siparişi ihtiyaçları (etki ön izlemesi) | Okuma | RESB-MATNR = eski bileşen AND RESB-WERKS = MAST-WERKS | ECC + S/4 |

## Kullanılan BAPI ve fonksiyonlar

- CSAP_MAT_BOM_READ: Geçerlilik tarihindeki mevcut kalemleri okur
- CSAP_MAT_BOM_MAINTAIN: Ürün ağacında bileşen ekler, siler, değiştirir veya miktar günceller
- BAPI_TRANSACTION_COMMIT: Başarılı ürün ağaçlarını kalıcı olarak kaydeder
- BAPI_TRANSACTION_ROLLBACK: Test modunda ve hatalı ürün ağaçlarında değişikliği geri alır

## Seçim ekranı parametreleri

| Parametre | Açıklama | Tip | Referans alan | Zorunlu |
|---|---|---|---|---|
| P_FILE | Yükleme dosyası (XLSX veya CSV) | Tekil değer | - | Evet |
| P_AENNR | Varsayılan değişiklik numarası | Tekil değer | STPO-AENNR | Hayır |
| P_TEST | Test modu (kayıt yapmadan kontrol et ve etkiyi göster) | Onay kutusu | - | Hayır |

## Girdi dosyası kolonları

| Kolon | Hedef alan | Zorunlu |
|---|---|---|
| Üst malzeme | MAST-MATNR | Evet |
| Üretim yeri | MAST-WERKS | Evet |
| Ürün ağacı kullanımı | MAST-STLAN | Evet |
| Alternatif | MAST-STLAL | Hayır |
| İşlem | R = değiştir, A = ekle, D = sil, Q = miktar güncelle | Evet |
| Eski bileşen | STPO-IDNRK | Hayır |
| Yeni bileşen | MARA-MATNR | Hayır |
| Miktar | STPO-MENGE | Hayır |
| Birim | STPO-MEINS | Hayır |
| Kalem numarası | STPO-POSNR | Hayır |
| Geçerlilik başlangıcı | STPO-DATUV | Evet |
| Değişiklik numarası | STPO-AENNR | Hayır |

## Sonuç listesi kolonları

| Kolon | Kaynak |
|---|---|
| Satır | Hesaplanan: Dosyadaki satır numarası |
| Üst malzeme | MAST-MATNR |
| Üretim yeri | MAST-WERKS |
| İşlem | Hesaplanan: Dosyadaki işlem kodu: R, A, D veya Q |
| Eski bileşen | STPO-IDNRK |
| Yeni bileşen | MARA-MATNR |
| Geçerlilik başlangıcı | STPO-DATUV |
| Etkilenen açık sipariş | Hesaplanan: Eski bileşeni RESB'de açık ihtiyaç olarak taşıyan üretim siparişi sayısı |
| Durum | Hesaplanan: Test başarılı, değiştirildi veya hata |
| Mesaj | Hesaplanan: Fonksiyon dönüş mesajı veya kontrol hatası |

## Program nasıl çalışır?

1. Dosya (XLSX veya CSV) kullanıcının bilgisayarından ya da arka plan işinde uygulama sunucusundan okunur; ilk satır başlık olarak atlanır.
2. Her satırda üst malzeme, üretim yeri, kullanım ve alternatif MAST'ta, yeni bileşen MARA'da aranır; silme işaretli (LVORM) veya engellenmiş malzeme durumu (MSTAE) olan bileşenler reddedilir. İşlem türü R (değiştir), A (ekle), D (sil) veya Q (miktar) olmalıdır.
3. CSAP_MAT_BOM_READ ile ürün ağacının geçerlilik tarihindeki kalemleri okunur; değiştirilecek veya silinecek eski bileşen kalem numarası ile birlikte bulunur, bulunamazsa satır hata olur.
4. Aynı ürün ağacına ait satırlar gruplanır ve CSAP_MAT_BOM_MAINTAIN'e değişiklik numarası ve geçerlilik tarihiyle tek çağrıda verilir; değiştir işleminde eski kalem silme işaretiyle, yeni bileşen aynı kalem numarasıyla gönderilir.
5. Test modunda değişiklik geri alınır ve RESB'den eski bileşeni hâlâ ihtiyaç olarak taşıyan açık üretim siparişi sayısı satıra yazılır.
6. Gerçek çalıştırmada başarılı her ürün ağacından sonra BAPI_TRANSACTION_COMMIT çağrılır; sonuç ve mesajlar satır bazında listelenir, hatalı satırlar ayrı dosya olarak indirilebilir.

## Yetki nesneleri

- C_STUE_WRK: Üretim yerine göre ürün ağacı değiştirme
- C_STUE_BER: Ürün ağacı yetki grubuna göre değiştirme

## Sık sorulan sorular

### Açık üretim siparişleri de güncellenir mi?

Hayır. Ürün ağacı değişikliği yalnızca yeni oluşturulan veya yeniden okunan siparişleri etkiler. Program test modunda etkilenen açık siparişleri sayar; bu siparişlerin bileşenlerini değiştirmek ayrı bir toplu sipariş değişikliği adımıdır ve istenirse eklenebilir.

### Değişiklik numarası zorunlu mu?

Zorunlu değildir, ancak önerilir. Değişiklik numarasıyla eski ve yeni bileşen tarih bazında birlikte korunur ve değişikliğin kim tarafından ne zaman yapıldığı izlenir. Numara dosyada satır bazında veya seçim ekranında varsayılan olarak verilebilir.

### S/4HANA'da çalışır mı?

Evet. CSAP fonksiyonları S/4HANA'da da kullanılır. Clean core hedefleniyorsa ürün ağacı için yayınlanmış API'lere geçiş ayrıca değerlendirilebilir.

---
Bu programı sizin sisteminize göre yazalım: https://nekuhub.com/teklif-al/?report=pp-bom-component-mass-change-upload
