# Excel'den Toplu Ana Kontrol Karakteristiği Yükleme Programı

> Excel veya CSV dosyasındaki satırlardan nicel ve nitel ana kontrol karakteristiklerini metin, ölçü birimi, ondalık basamak, hedef değer, tolerans sınırları ve kod grubuyla toplu olarak oluşturan veya yeni sürümünü açan custom program. Önce test modunda kontrol eder, sonra her satırın sonucunu listeler.

- Tür: Program, Custom geliştirme, Toplu yükleme
- Modül: QM
- Tahmini efor: M (4–6 iş günü)
- Son güncelleme: 2026-11-17
- URL: https://nekuhub.com/programlar/excelden-toplu-ana-kontrol-karakteristigi-yukleme-programi/


## Standart çözüm neden yetmiyor?

QS21 ana kontrol karakteristiklerini tek tek oluşturur, QS23 tek tek yeni sürüm açar; dosyadan yükleme yoktur. Kontrol göstergeleri açılır pencerelerle girildiği için ekran kaydı (recording) tabanlı yüklemeler kırılgandır. Yeni bir üretim yeri veya ürün ailesi için yüzlerce karakteristik gerektiğinde ekipler günlerce elle giriş yapar. Custom program karakteristik listesini standart BAPI ile dosyadan yükler.

### En yakın standart alternatifler

- QS21: Ana kontrol karakteristiğini tek tek oluşturur; dosyadan yükleme yoktur.
- QS23: Karakteristik için tek tek yeni sürüm açar.

## Kullanılan tablolar

| Tablo | Rolü | Erişim | Bağlantı | Sistem |
|---|---|---|---|---|
| QPMK | Ana kontrol karakteristiği başlığı: sürüm, geçerlilik, kontrol göstergeleri, hedef ve tolerans | Okuma / yazma | - | ECC + S/4 |
| QPMT | Karakteristik kısa metni (dile göre) | Yazma | - | ECC + S/4 |
| T006 | Ölçü birimi kontrolü | Okuma | T006-MSEHI = QPMK-MASSEINHSW | ECC + S/4 |
| QPGR | Nitel karakteristikler için kod grubu kontrolü | Okuma | - | ECC + S/4 |

## Kullanılan BAPI ve fonksiyonlar

- BAPI_QPMK_SAVEREPLICA: Her satır için ana kontrol karakteristiğini veya yeni sürümünü oluşturur
- BAPI_TRANSACTION_COMMIT: Başarılı satırları kalıcı olarak kaydeder
- BAPI_TRANSACTION_ROLLBACK: Test modunda 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_WERKS | Üretim yeri | Tekil değer | QPMK-ZAEHLER | Evet |
| P_RELEA | Serbest bırakılmış durumda oluştur | Onay kutusu | - | Hayır |
| P_TEST | Test modu (kayıt yapmadan kontrol et) | Onay kutusu | - | Hayır |

## Girdi dosyası kolonları

| Kolon | Hedef alan | Zorunlu |
|---|---|---|
| Ana karakteristik | QPMK-MKMNR | Evet |
| Geçerlilik başlangıcı | QPMK-GUELTIGAB | Evet |
| Kısa metin | QPMT-KURZTEXT | Evet |
| Dil | QPMT-SPRACHE | Hayır |
| Tür (N nicel, L nitel) | QPMK-STEUERKZ içindeki nicel/nitel kontrol göstergesine yazılır | Evet |
| Ondalık basamak | QPMK-STELLEN | Hayır |
| Ölçü birimi | QPMK-MASSEINHSW | Hayır |
| Hedef değer | QPMK-SOLLWERT | Hayır |
| Alt tolerans | QPMK-TOLERANZUN | Hayır |
| Üst tolerans | QPMK-TOLERANZOB | Hayır |
| Kod grubu (nitel) | Nitel karakteristikte katalog bağlantısı olarak atanır; QPGR'de bulunmalıdır | Hayır |

## Sonuç listesi kolonları

| Kolon | Kaynak |
|---|---|
| Satır | Hesaplanan: Dosyadaki satır numarası |
| Ana karakteristik | QPMK-MKMNR |
| Sürüm | QPMK-VERSION |
| Durum | Hesaplanan: BAPI dönüş mesajlarına göre: oluşturuldu, yeni sürüm veya hata |
| Mesaj | Hesaplanan: Kontrol mesajı veya BAPI dönüş tablosundaki ilk mesaj |

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

1. Dosya okunur; üretim yeri seçim ekranından gelir (QPMK-ZAEHLER), ilk satır başlık olarak atlanır.
2. Her satır kontrol edilir: karakteristik anahtarı ve geçerlilik başlangıcı zorunlu; nicel karakteristikte ölçü birimi T006'da tanımlı olmalı, ondalık basamak verilmeli, alt sınır ≤ hedef ≤ üst sınır olmalıdır; nitel karakteristikte kod grubu QPGR'de bulunmalıdır.
3. Karakteristik QPMK'da varsa ve yeni geçerlilik tarihi daha ileriyse yeni sürüm açılır; aynı tarihte sürüm varsa satır hata alır.
4. Satır BAPI_QPMK_SAVEREPLICA yapılarına eşlenir: başlık ve kontrol göstergeleri (nicel/nitel, alt ve üst sınır kontrolü, hedef değer kontrolü), dile göre kısa metin (QPMT) ve nitel karakteristikte katalog bağlantısı.
5. Test modunda BAPI çağrılır ve BAPI_TRANSACTION_ROLLBACK ile geri alınır; gerçek çalıştırmada başarılı her satırdan sonra BAPI_TRANSACTION_COMMIT çağrılır. Sonuç ve mesaj satır bazında listelenir, hatalı satırlar ayrı dosyaya indirilebilir.

## Yetki nesneleri

- Q_TCODE: QM işlem kodu yetkisi (QS21 / QS23)

## Sık sorulan sorular

### Mevcut bir karakteristik dosyada yer alırsa ne olur?

Dosyadaki geçerlilik başlangıcı son sürümden ileriyse yeni sürüm açılır ve eski sürüm geçmiş kontrol planları için korunur. Aynı tarihte sürüm varsa satır değiştirilmez ve hata olarak listelenir.

### Kontrol yöntemleri ve örnekleme ayarları da yüklenebilir mi?

Evet. Kontrol yöntemi ataması, örnekleme yöntemi ve ek kontrol göstergeleri dosya şablonuna sütun olarak eklenebilir; her ek alan grubu efor aralığını biraz artırır.

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

Evet. QPMK, QPMT ve BAPI_QPMK_SAVEREPLICA S/4HANA'da da vardır; dosya şablonu ve kontroller değişmez.

---
Bu programı sizin sisteminize göre yazalım: https://nekuhub.com/teklif-al/?report=qm-master-inspection-characteristic-upload
