Holarch

Gereksinimler

Gereksinimler

Gereksinimleri yazın, denetleyin, onaylayın, temel çizgiye alın ve içe aktarın; açık TBD/TBR öğelerini ve incelenecek bağlantıları izleyin.

Nasıl kullanılır →

Bu sayfada
  1. Genel bakış
  2. Kavramlar
    1. Requirement ve Statement
    2. Gereksinim öznitelikleri
    3. Gereksinim etiketleri
    4. Gereksinim iş akışı
    5. Açık öğeler: TBD, TBR ve TBS
    6. Temel çizgiler
  3. Nasıl kullanılır
    1. Ne zaman ve neden
    2. Bir gereksinim yazın
    3. İfadeyi denetleme
    4. EARS şablonlarıyla yazma
    5. Gereksinimleri onaylayın
    6. Bir belgeyi inceleme için dondurma
    7. Temel çizgiden sonraki bir değişikliği ele alma
    8. TBD ve TBR öğelerini kapatma
    9. Mevcut bir belirtimi içe aktarma
    10. Uygulamalı örnek: CubeSat EO-1 demosu
    11. İpuçları ve iyi uygulamalar
    12. Yaygın hatalar
    13. Diğer özelliklerle nasıl bağlantılıdır
  4. Gereksinimler sayfası
  5. Gereksinim Kalitesi
    1. Sayfa düzeni
    2. Kalite sayfasını filtreleme
    3. Ölçütler ve denetimler
    4. Tek gereksinimde iki gereksinim (R19)
    5. Başka dillerdeki gereksinimler
    6. Elle geçersiz kılmalar
    7. Eski sonuçlar
    8. Bir belgeden Kaliteyi denetle
    9. YZ gereksinim denetimi
    10. Kalite dışa aktarmaları
  6. Onaylar
    1. Onay kutusu
  7. TBD/TBR Kaydı
  8. İncelenecek bağlantılar
    1. Bir bağlantıyı inceleme için ne işaretler
    2. İncelenecek bağlantıların gösterildiği yerler
    3. İncelenecek bağlantılar sayfası
  9. Temel çizgiler ve sürüm karşılaştırması
    1. Belge temel çizgileri
    2. Sürümleri karşılaştırma
    3. Temel çizgiler ve sürümler sayfası
  10. Gereksinimleri içe aktarma
    1. Adım 1: Dosya
    2. Adım 2: Eşleme
    3. Adım 3: İnceleme
    4. Her biçimin nasıl okunduğu
    5. Gereksinimleri bir elektronik tablodan güncelleme
    6. İçe aktarma iletileri
  11. Gereksinim kısayolları
  12. Ayarlar
  13. İletiler
  14. Sınırlar
  15. İlgili

Genel bakış

Gereksinimleri yazmak, denetlemek, onaylamak ve temel çizgiye almak ve hâlâ açık olanları izlemek için gereksinim sayfalarını kullanın. Bir gereksinim, LML sınıfı Requirement olan bir nesnedir: sistemin sahip olması gereken bir yetenek, özellik veya kalite faktörü.

Gereksinimler genellikle bir gereksinim belgesinde bulunur (bkz. Belgeler). Her biri yine de modelde bir nesnedir. Böylece aynı gereksinim Veritabanında, diyagramlarda, İzlenebilirlik Matrisinde ve RVTM'de görünür.

Gezinme çubuğundaki İhtiyaçlar ve gereksinimler grubu her gereksinim sayfasını içerir:

SayfaNe gösterir
BelgelerBelirtimler ve anahatları. Gereksinimler burada yazılır.
GereksinimlerHer gereksinim tek bir tabloda (class:Requirement ile filtrelenmiş Veritabanı).
KaliteGereksinim Kalitesi: gereksinim başına dokuz ölçüt üzerinden bir puan.
TBD/TBRHâlâ belirlenecek veya incelenecek açık değerlerin kaydı.
İncelenecek bağlantılarYukarı akıştaki gereksinimi, bağlantı en son incelendikten sonra değişen bağlantılar.
OnaylarDurumu In Review olan gereksinimler.
İçe ve dışa aktarmaWord, Excel, CSV, ReqIF, düz metin, XMI ve proje dosyaları için tek bir bırakma alanı üzerinden içe aktarma ve model dışa aktarmaları.

Temel çizgiler, incelemeler için dondurulmuş anlık görüntülerdir. Onları bir belgeden veya Denetim ve incelemeler → Temel çizgiler ve sürümler bölümünden oluşturun. İşlevlere, varlıklara ve testlere bağlantılar İzlenebilirlik sayfasında ele alınır.

Kavramlar

Requirement ve Statement

Statement, Requirement sınıfının üst sınıfıdır.

  • Bağlayıcı olmayan metinler için bir Statement kullanın: bölüm başlıkları, varsayımlar, bağlam.
  • Bağlayıcı her “shall” ifadesi için bir Requirement kullanın.

Yalnızca Requirement'lar kalite denetimiyle puanlanır, TBD/TBR kaydında listelenir, değiştiklerinde inceleme için işaretlenir ve RVTM'de sayılır. Statement'lar atlanır.

Bir gereksinim ortak nesne alanları Numara, Ad ve Açıklama alanlarına sahiptir. Açıklama, zengin metin olarak gereksinim ifadesinin kendisidir. Aşağıdaki öznitelikler gerisini ekler.

Gereksinim öznitelikleri

ÖznitelikTür ve değerlerAnlamı
GerekçeUzun metinGereksinimin arkasındaki gerekçe.
DurumDraft, In Review, Approved, RejectedGereksinimin onay iş akışında nerede olduğu.
PriorityHigh, Medium, LowGereksinimin paydaşlar için ne kadar önemli olduğu.
CriticalityHigh, Medium, LowGereksinim karşılanmazsa görev veya güvenlik açısından sonuç.
SahipMetinGereksinimden sorumlu kişi veya ekip.
KaynakMetinGereksinimin geldiği paydaş, belge veya standart.
Verification MethodÇoklu seçim: Analysis, Demonstration, Inspection, TestGereksinimin nasıl doğrulandığı.
Verification LevelComponent, Subsystem, SystemGereksinimin doğrulandığı montaj düzeyi.
Success CriteriaUzun metinGereksinimin karşılandığını gösteren ölçülebilir sonuç.
TBD/TBRNone, TBD, TBRTBD = bir değer hâlâ belirlenecek; TBR = bir değer incelenecek. Kapatıldığında yeniden None yapın.
TBD OwnerMetinTBD/TBR'yi kapatmaktan sorumlu kişi.
TBD Due DateTarih ve saatTBD/TBR'nin kapatılması gereken tarih. İş akışı grubundaki Son tarih aynı tarihi gösterir ve ayarlar (bkz. TBD/TBR Kaydı).
Quality ScoreYüzde, hesaplanırSon Kaliteyi denetle işleminin sonucu.
Appropriate, Complete, Conforming, Correct, Feasible, Necessary, Singular, Unambiguous, VerifiableEvet/Hayır, hesaplanır veya elle ayarlanırDokuz kalite ölçütü.

Özellik paneli bir gereksinimin alanlarını gruplar (bkz. Özellik paneli): Requirement (Number, Name, Description, Labels, Rationale, Source, Success Criteria), İş akışı (Status, Priority, Criticality, Owner, Assignee, Due date, TBD/TBR, TBD Owner, TBD Due Date içeren inceleme şeridi), Doğrulama (Verification Method ve Level, Verified by ve Formal program ile kapanış alanları), Değerler (Budget Quantity, Threshold, Objective ve geçerli Value, Units), Uyumluluk (Formal program) ve Kalite.

Puan ve dokuz ölçüt, başlangıçta katlanmış olan Kalite grubunda bulunur. Başlığında örneğin “%89 · 9 ölçütten 8'i karşılandı” veya “henüz denetlenmedi” yazar. Holarch, grubu açık bırakıp bırakmadığınızı sınıf başına hatırlar.

Projeler kendi gereksinim özniteliklerini ve seçeneklerini ekleyebilir; bkz. Şema uzantıları.

Gereksinim etiketleri

Etiketler, gereksinimleri sınıflarını değiştirmeden sınıflandırır. Yerleşik gereksinim etiketleri şunlardır:

  • Functional Requirement, Performance Requirement, Interface Requirement.
  • Environmental Requirement, Reliability Requirement, Safety Requirement.
  • Verification Requirement.
  • Stakeholder Need: bir paydaşın, sistem gereksinimlerine dönüştürülmeden önce ifade ettiği ihtiyaç.

Verification Method aynı zamanda Analysis, Demonstration, Inspection ve Test etiketlerini içeren bir etiket grubudur. Etiket ve öznitelik aynı geri alma adımında eşit tutulur:

  • Test etiketini eklemek Verification Method değerini Test yapar.
  • Öznitelikte Test seçmek etiketi ekler.

Yalnızca etiketleri taşıyan eski projeler ve içe aktarmalar, proje açıldığında özniteliğe birleştirilir.

Gereksinim iş akışı

Her gereksinim dört durumdan geçer:

  1. Draft: yazılıyor.
  2. In Review: karar bekliyor. Onaylar sayfasında listelenir.
  3. Approved veya Rejected: karar verildi. Her karar, kararı kimin, ne zaman verdiğini ve isteğe bağlı bir nedeni kaydeder.

Onaydan sonra üç mekanizma kaydı dürüst tutar:

  • Düzenlemede yeniden inceleme. Approved bir gereksinimin adını veya açıklamasını düzenlemek onu “Onaydan sonra metin değişti” notuyla yeniden In Review durumuna taşır.
  • Eski kalite. Adı veya açıklamayı düzenlemek kalite sonuçlarını eski olarak işaretler ve elle yapılan kalite geçersiz kılmalarını temizler.
  • İncelenecek bağlantılar. Adı, açıklamayı veya bir anahtar özniteliği düzenlemek, aşağı akıştaki öğelere giden bağlantıları inceleme için işaretler.

Üçü de düzenlemenin parçasıdır; bu nedenle tek bir Geri al (⌘Z / Ctrl+Z) hepsini birlikte geri alır.

Açık öğeler: TBD, TBR ve TBS

Bir açık öğe, henüz kesinleşmemiş bir değerdir. Bir gereksinim şu koşullardan biri doğru olduğunda açık öğedir:

  • TBD/TBR özniteliği TBD veya TBR'dir.
  • Adı veya açıklaması TBD, TBR veya TBS sözcüğünü içerir.

Açık öğeler kapatılana kadar TBD/TBR kaydında görünür.

Temel çizgiler

Temel çizgi salt okunur bir anlık görüntüdür. İki türü vardır:

  • Bir belge temel çizgisi tek bir belgeyi tutar. Belge artifact'ını, öğelerini ve özniteliklerini, onlara dokunan ilişkileri, bir adım uzaktaki nesneleri ve belgenin anahat ayarlarını içerir.
  • Bir proje temel çizgisi projedeki her nesneyi ve ilişkiyi tutar.

Temel çizgiler onay kayıtları (ad, rol, beyan, tarih) taşıyabilir. Kayıtlar kaydedildikten sonra kilitlenir.

Nasıl kullanılır

Ne zaman ve neden

Gereksinim çalışması sistem mühendisliği V'sinin sol tarafını kapsar:

  1. Paydaş ihtiyaçlarını yakalayın.
  2. Sistem gereksinimlerini türetin.
  3. Her ifadenin iyi biçimlendirildiğini denetleyin.
  4. Gereksinimleri onaylatın.
  5. Onları bir incelemede (SRR, PDR, CDR) dondurun.

Temel çizgiden sonra çalışma değişiklik denetimine döner. Her değişiklik yeniden incelenir ve aşağı akış etkisi denetlenir. Açık TBD/TBR değerleri tasarım kesinleştirilmeden önce kapatılır.

Gereksinim sayfaları şu soruları yanıtlar:

SoruSayfa
Her gereksinim iyi yazılmış mı?Kalite
Hangi değerler hâlâ bilinmiyor, bunların sahibi kim ve gecikmişler mi?TBD/TBR
Bir gereksinim değiştiği için neyin yeniden denetlenmesi gerekiyor?İncelenecek bağlantılar
Ne karar bekliyor?Onaylar
İncelemeden bu yana ne değişti?Belgenin Sürüm ▾ → Sürümleri karşılaştır… komutu, Temel çizgiler ve sürümler
Her gereksinim tahsis edilmiş ve doğrulanmış mı?İzlenebilirlik Matrisi ve RVTM

Kalite, İncelenecek bağlantılar, TBD/TBR ve Onaylar sayfaları gezinme çubuğunda İhtiyaçlar ve gereksinimler altında yan yana durur. Dört denetimin hepsini oradan sırayla gözden geçirin.

Bir gereksinim yazın

  1. İhtiyaçlar ve gereksinimler → Belgeler öğesini açın.
  2. Gereksinim belgesini açın.

    Yeni bir belge başlatmak için + Yeni belge düğmesine tıklayın (bkz. Belgeler).

  3. Belgenin altındaki Hızlı ekle çubuğunda öğenin nereye gideceğini seçin, örneğin 3 Electrical Power altına.
  4. Gereksinim ifadesini yazın ve Enter tuşuna basın.

    Holarch, belgenin varsayılan sınıfından (gereksinim belgesinde Requirement) bir öğe ekler. Öğe kardeşlerinden sonra numaralandırılır.

  5. Gereksinim seçiliyken sağdaki özellik panelini açın.
  6. Requirement grubunda Gerekçe, Kaynak ve Başarı ölçütleri; İş akışı grubunda Öncelik, Criticality ve Sahip; Doğrulama grubunda Verification Method ve Doğrulama düzeyi alanlarını doldurun.
  7. Özellik panelinin Requirement grubunda + Etiket ile bir tür etiketi ekleyin, örneğin Performance Requirement. (Etiketler sütunu Görünüm ▾ → Sütunlar ▸ altındadır.)

Gereksinimin durumu Draft'tır ve İhtiyaçlar ve gereksinimler → Gereksinimler sayfasında görünür.

Bir değer henüz bilinmiyorsa:

  1. En iyi tahmininizi ifadeye yazın.
  2. TBD/TBR değerini TBD yapın.
  3. TBD Owner alanını doldurun ve tarihi İş akışı grubundaki Son tarih alanında ayarlayın.

    Gereksinim artık bu son tarihle TBD/TBR kaydında da görünür.

İfadeyi denetleme

  1. İhtiyaçlar ve gereksinimler → Kalite'yi açın.

    Bir belgeden bunun yerine Denetle ▾ → Kaliteyi denetle seçeneğini seçin.

  2. Kapsam çubuğunda Tüm gereksinimler veya Belge: <name> seçin.
  3. Sayfa başlığında Kaliteyi denetle düğmesine tıklayın.

    Bildirimde “32 gereksinim denetlendi” (veya sizin sayınız) yazar. Her gereksinim %0 ile %100 arasında bir puan ve ölçüt başına bir ✔ veya ✘ alır.

    2.000'den fazla gereksinimde denetim arka planda çalışır: ilerleme kartı “Gereksinimler denetleniyor” iletisini, sayıyı ve kalan süreyi gösterir; çalışmaya devam edebilirsiniz. Durdurmak için karttaki İptal düğmesine tıklayın; hiçbir şey değişmez. Ardından kartta kaydedilen sayıyla birlikte “Kalite sonuçları kaydediliyor” yazar; kaydederken diğer düzenlemeler “Kalite sonuçları kaydediliyor. Bitince yeniden deneyin.” iletisiyle reddedilir. Yalnızca sonuçları değişen gereksinimler kaydedilir; bu nedenle değişiklik olmadan yeniden denetlemek hiçbir şey kaydetmez. Denetimin tamamı tek bir adımdır: tek bir ⌘Z / Ctrl+Z onu kaldırır.

  4. Kutucukları okuyun: Gereksinimler, Ortalama puan, İyi (≥ %67), Yeniden çalışma gerekli (< %67) ve varsa Eski (metin değişti).
  5. %67'nin altındaki her gereksinim için Öneriler sütununu okuyun.

    Veya o ölçütün iletilerini görmek için bir ✘ üzerine gelin.

  6. Açmak için gereksinimin adına tıklayın ve metni düzeltin.
  7. Denetimi yeniden çalıştırın.

Correct ve Feasible her zaman bir kişinin değerlendirmesini gerektirir. Diğer denetimler ne bulursa bulsun, denetim bunları asla karşılandı olarak işaretlemez. Bu nedenle otomatik denetim en fazla 9 ölçütten 7'sine (%78) ulaşır. Doğrulayan bir testi veya gereksinimi olmayan bir gereksinim 9 ölçütten 6'sına (%67) ulaşır. Her gereksinim için bunlara kendiniz karar verin:

  • Gereksinimi inceledikten sonra ölçütü Evet olarak işaretlemek için ✘ simgesine tıklayın.
  • İlk görüş için ✦ YZ ▾ → YZ ile denetle (N gereksinim)… (YZ gereksinim denetimi) komutunu kullanın.

Not: Önceki sürümlerin kaydettiği puanlar, başka bir denetim başarısız olduğunda Correct veya Feasible ölçütünü karşılandı sayabiliyordu. Bunları güncellemek için denetimi yeniden çalıştırın.

EARS şablonlarıyla yazma

EARS (Easy Approach to Requirements Syntax, gereksinim sözdizimine kolay yaklaşım) her gereksinimi tek bir cümle olarak yazar: isteğe bağlı bir koşul, ardından “the [system] shall [response]”. Koşulun ilk sözcüğü deseni belirler.

DesenŞablonÖrnek
UbiquitousThe [system] shall [response].The pump controller shall record every start command with its time.
Event-drivenWhen [trigger], the [system] shall [response].When the tank level falls below 20 %, the pump controller shall start the backup pump.
State-drivenWhile [state], the [system] shall [response].While the vehicle is charging, the battery manager shall keep each cell below 45 °C.
Unwanted behaviorIf [unwanted condition], then the [system] shall [response].If the supply voltage drops below 10 V, then the flight computer shall switch to the reserve battery.
Optional featureWhere [feature is included], the [system] shall [response].Where a heated windshield is fitted, the climate controller shall clear frost within 5 minutes.
ComplexWhile [state], when [trigger], the [system] shall [response].While the drill is in standby, when the operator presses Start, the drill controller shall reach full speed within 3 s.
  1. Bir gereksinimi özellik panelinde veya Öğe görünümünde açın.
  2. Açıklama yanındaki EARS ▾ düğmesine tıklayın.

    İlk satır ifadenin desenini (✓ Event-driven) veya neyin düzeltileceğini (EARS deseni yok: düzeltilecek 1 şey) gösterir.

  3. Bir desen seçin.

    Şablonu açıklama olur. Gereksinimin zaten bir açıklaması varsa Değiştir ile onaylayın; eski ifade öğenin geçmişinde kalır. Tek bir ⌘Z / Ctrl+Z bunu geri alır.

  4. Köşeli parantez içindeki sözcükleri değiştirin.

Her gereksinimi denetlemek için Model denetimleri → Ayarlar bölümünde Requirement.11 kuralını Uyarı veya Hata olarak ayarlayın. Varsayılan olarak kapalıdır.

Bir SysML v2 projesinde EARS ▾, özellik panelinde bir gereksinimin Belgeler alanının altında durur ve doc yorumunu yazar.

Gereksinimleri onaylayın

  1. Bir gereksinim hazır olduğunda Durum değerini In Review yapın.

    Bunu özellik panelinde (İş akışı grubunun inceleme şeridindeki Durum), Veritabanında veya bir belge sütununda yapın.

  2. İnceleyen İhtiyaçlar ve gereksinimler → Onaylar sayfasını açar.

    Sayfa, Durumu In Review olan her gereksinimi listeler.

  3. Bir satıra tıklayın.

    Özellik panelinin İş akışı grubu inceleme şeridini gösterir: Durum, onu kimin ve ne zaman ayarladığı (“J. Rivera tarafından · 9 Mar 2026, 09:58”) ve düğmeler.

  4. Onayla düğmesine tıklayın.

    Veya Reddet… düğmesine tıklayıp isteğe bağlı bir neden girin.

    Bildirimde “Onaylandı” veya “Reddedildi” yazar. Karar adınız ve saatle kaydedilir ve gereksinim Onaylar listesinden çıkar.

    Gereksinim bir temel çizgideyse ve doğrulama öğeleri veya belgeler ona izleniyorsa, Onayla önce bunları Yeniden inceleme gerekiyor altında listeleyen bir iletişim kutusu açar (Etki). Bakmak için bir satıra tıklayın, ardından onaylamak için Onayla düğmesine tıklayın.

Karar verilmiş bir gereksinimi incelemeye geri göndermek için Yeniden aç düğmesine tıklayın. Bildirimde “In Review durumuna taşındı” yazar.

Projede gereksinim Durum özniteliği için bir iş akışı varsa (Şema → İş akışı), inceleme şeridi Onayla, Reddet… ve Yeniden aç yerine o iş akışının geçişlerini gösterir. Onay gerektiren bir geçiş … ile biter ve Onay talep et iletişim kutusunu açar: bkz. Bir durum değişikliği için onay talep etme. Temel çizgiye alınmış bir gereksinim için Onay talep et ve değişiklik talebinin Onayla… iletişim kutusu aynı Yeniden inceleme gerekiyor listesini gösterir.

Bir belgeyi inceleme için dondurma

  1. Belgenin antetinde Sürüm ▾ düğmesine tıklayın.
  2. Temel çizgiyi kaydet… seçeneğini seçin.

    Veya Teslim ▾ → Sürüm ▸ Temel çizgiyi kaydet… seçeneğini seçin.

  3. Ad alanını koruyun veya değiştirin. Varsayılan “<document> Baseline <n>” olur.
  4. Onaylar altında her onaylayan için bir satır doldurun: Ad, Rol ve Beyan (varsayılan “Yayım için onaylandı.”).

    + Onaylayan ekle bir satır ekler; × bir satırı kaldırır.

  5. Oluştur'a tıklayın.

    Bildirimde “Temel çizgi kaydedildi” yazar. Sürüm ▾ düğmesinde “Geçerli · son temel çizgi <name>” yazar.

Bundan sonra her satır, en son temel çizgiden farklı olduğunda bir değişiklik çubuğu alır.

Temel çizgiden sonraki bir değişikliği ele alma

  1. Gereksinim metnini belgede düzenleyin.

    Bir bildirim ne olduğunu özetler, örneğin “Onaylanmış 1 gereksinim In Review durumuna taşındı; 6 bağlantı inceleme için işaretlendi.” Düzenlemenizin parçası olarak (tek bir Geri al ile hepsi geri alınır):

    • Approved bir gereksinim In Review durumuna geçer.
    • Kalite sonuçları eskir (“Kalite: eski — yeniden çalıştır”).
    • Aşağı akış bağlantıları inceleme için işaretlenir.
  2. İhtiyaçlar ve gereksinimler → İncelenecek bağlantılar öğesini açın.
  3. Her satırda metin değişikliğini görmek için Fark düğmesine tıklayın ve bağlı öğeyi inceleyin.
  4. Bağlı bir öğe hâlâ geçerliyse satırındaki İncelendi olarak işaretle… düğmesine tıklayın.

    Birkaçını aynı anda işaretlemek için satırlarını seçin ve Seçilenleri incelendi olarak işaretle… düğmesine tıklayın.

  5. Neyi denetlediğinizi yazın ve İncelendi olarak işaretle düğmesine tıklayın.
  6. Kaliteyi denetle işlemini yeniden çalıştırın.
  7. Gereksinimi yeniden onaydan geçirin.
  8. Sürüm ▾ → Sürümleri karşılaştır… komutuna tıklayın, Başlangıç (eski) altında temel çizgiyi ve Hedef (yeni) altında Geçerli sürüm seçin.

    Rapor, temel çizgiden bu yana her değişikliği listeler.

  9. Değişiklik kurulu için Değişiklikler (Excel) düğmesine tıklayın.

TBD ve TBR öğelerini kapatma

  1. İhtiyaçlar ve gereksinimler → TBD/TBR öğesini açın.
  2. Kutucukları okuyun: Açık TBD/TBR, Gecikmiş, Sahip yok ve belge başına sayı.
  3. Önce gecikmiş satırları ele alın. Renklendirilmişlerdir ve son tarihin altında “Gecikmiş” yazar.
  4. Sahibin “—” gösterdiği yerlerde bir TBD Owner atayın.
  5. Bir değer kesinleştiğinde gereksinim metnini son değere göre düzenleyin.
  6. Satırdaki Kapat düğmesine tıklayın.

    Kapat, TBD/TBR değerini None yapar ve satır kayıttan çıkar.

Kaydı sahiplere göndermek için XLSX olarak dışa aktar düğmesine tıklayın.

Mevcut bir belirtimi içe aktarma

  1. İhtiyaçlar ve gereksinimler → İçe ve dışa aktarma öğesini açın.
  2. Dosyayı bırakma alanına bırakın veya dosyayı seçmek için alana tıklayın: Word (.docx), Excel veya CSV, ReqIF ya da düz metin.

    Durum satırında örneğin “‘SRS.docx’ çözümlendi: 48 satır, 5 sütun.” yazar. Biçim algılanan biçimi gösterir.

  3. Devam düğmesine tıklayın.
  4. Her sütunun neyle eşlendiğini denetleyin ve Sınıfı olmayan satırlar için sınıf değerini Requirement yapın.
  5. Devam düğmesine tıklayın.
  6. Bu N gereksinimden bir gereksinim belgesi oluştur seçeneğini işaretli bırakın, belge türünü ve adını denetleyin ve yeni ve güncellenen öğeleri ve uyarıları gözden geçirin.
  7. N öğeyi içe aktar düğmesine tıklayın.

    Uyarı yoksa Holarch yeni belgeyi açar. Uyarı varsa İçe aktarma tamamlandı kartı bunları listeler.

İçe aktarma tamamlandı kartında belgeyi, Veritabanını, bir Spider veya Ağaç diyagramını ya da Kaliteyi denetle'yi açan düğmeler vardır. Tek bir ⌘Z / Ctrl+Z içe aktarmanın tamamını kaldırır.

Uygulamalı örnek: CubeSat EO-1 demosu

CubeSat EO-1 — Earth Observation Demo demo projesini Projeleri yönet bölümünden oluşturun. Projede SRR temel çizgisi ve sonrasında yapılmış değişikliklerle 32 gereksinimlik bir belirtim, SRS-001 EO-1 System Requirements Specification bulunur.

Kalite.

  1. İhtiyaçlar ve gereksinimler → Kalite öğesini açın ve Kaliteyi denetle düğmesine tıklayın.

    Kutucuklar 32 gereksinim, %92 ortalama, 29 İyi ve 3 Yeniden çalışma gerekli gösterir.

Üç zayıf gereksinim bilerek böyle yazılmıştır. Her biri %44 puan alır:

  • 2.5 Safe Mode Recovery: “The spacecraft should recover from safe mode quickly and resume imaging as appropriate”. Öneriler şunları içerir:
    • “R34 - Ölçülemeyen başarım terimleri: [quickly]”
    • “R8 - Kaçış tümceleri gereksinimi zayıflatıyor: [as appropriate]”
    • “R19 - İki gereksinimi birleştiriyor; ayrı gereksinimlere bölün: [and]”
    • “İfadeyi nokta ile bitirin.”
    • “Onu doğrulayan bir Test Case veya Requirement bağlayın.”
  • 3.5 Battery Thermal Control: “…keep the battery warm enough (TBD).” Öneriler “R21 - Parantez içeriyor; parantez içindeki metni Rationale alanına taşıyın.” ve “TBD/TBR yer tutucularını değiştirin.” olur.
  • 6.4 Operator Interface: “…shall be user friendly and/or easy to use.” Öneriler “R34 - Ölçülemeyen başarım terimleri: [user friendly, easy to use]” ve “R19 - ‘and/or’ belirsizdir; ikisinin mi yoksa birinin mi kastedildiğini belirtin: [and/or]” olur.

2.5'i düzeltmek için:

  1. Onu “The spacecraft shall resume imaging within 6 hours of a safe mode entry.” olarak yeniden yazın.
  2. verified by ile bir test senaryosu bağlayın.
  3. Denetimi yeniden çalıştırın.

    Bağlaç, kaçış tümcesi ve belirsiz terim iletileri kaybolur.

TBD/TBR. TBD/TBR sayfasını açın. Üç açık öğe gösterir:

  • 3.5 Battery Thermal Control: sahibi Thermal Engineer olan bir TBD. Gecikmiştir.
  • 2.4 Target Slew (ADCS Lead) ve 5.3 Downlink Link Margin (Comms Lead): son tarihi daha sonra olan TBR'ler.

Temel çizgiden sonra değişiklik. Belgenin Sürüm ▾ menüsü SRR Baseline öğesini listeler. Bu temel çizgi J. Rivera (Systems Lead), R. Okafor (Mission Principal Investigator) ve L. Brandt (Program Manager) tarafından onaylanmıştır.

SRR'den sonra 3.1 Orbit Average Power gereksinimi 28 W'tan 30 W'a değişti. 3.1 Approved olduğu için “Metin onaydan sonra değişti” notuyla yeniden In Review durumuna geçti.

İncelenecek bağlantılar, 3.1'den çıkan altı bağlantıyı listeler:

  • 1.3.1 Solar Arrays
  • F3 Generate and Store Power ve F3.1 Convert Sunlight to Power
  • EQ-1.1 Solar Power Generation ve EQ-1.4 Power Margin Check
  • TC-06 Solar Array Power Test

Herhangi bir satırda Fark düğmesine tıklayın: “28 W” üstü çizilmiş, “30 W” eklenmiştir. Ardından öğeleri inceleyin:

  • TC-06 tepe gücün ≥ 72 W olmasını bekler ve 75,1 W ölçmüştür. EQ-1.3 Orbit-Average Array Power üzerinden (tepe × 0,62 güneşli oran × 0,6 güç yolu verimi) 75,1 W, 27,9 W yörünge ortalamasıdır ve yeni 30 W değerinin altındadır. Bu bağlantıyı incelenmemiş bırakın ve “75.1 W peak = 27.9 W orbit average; re-test against about 80.6 W peak” yorumunu ekleyin. Testin yeni bir beklenen sonuca ve yeni bir çalıştırmaya ihtiyacı vardır.
  • 1.3.1'i incelendi olarak işaretlemeden önce güneş paneli boyutlandırmasının hâlâ tuttuğunu denetleyin.

Geçerli sürümle karşılaştır. Sürüm ▾ menüsünde SRR Baseline seçin, ardından başlık şeridindeki Geçerli sürümle karşılaştır düğmesine tıklayın. Rapor şunları listeler:

  • 3.1'in Description, Rationale, Status ve Quality Score değişiklikleri.
  • 2.4 Target Slew'in Status değişikliği (Draft → In Review).
  • İki yeni satisfies bağlantısıyla yeni gereksinim 4.4 Downlink Encryption.

Onaylar. Onaylar sayfasını açın. 3.1, 1.5 Daily Collection Volume ve 5.3 Downlink Link Margin dahil dokuz gereksinim In Review durumundadır.

İpuçları ve iyi uygulamalar

  • Her gereksinim için etken çatıda, bir sayı, bir birim ve bir koşulla tek bir “shall” yazın. Kalite denetimi tam olarak bunu ödüllendirir.
  • Nedeni ifadeye değil Gerekçe alanına yazın. Amaç öbekleri (“so that”, “in order to”) ve parantezler R20 ve R21 olarak işaretlenir.
  • Verification Method alanını yazarken doldurun. Yöntemi olan ama test senaryosu olmayan bir gereksinim böylece RVTM'de Doğrulanmadı yerine Yalnızca planlandı olarak görünür.
  • Metne yalnızca “TBD” yazmak yerine TBD/TBR değerini bir sahip ve son tarihle ayarlayın. Öznitelik, kayda izlenecek bir sahip ve son tarih verir.
  • Her incelemeden önce temel çizgi alın. Değişiklik çubukları ve Geçerli sürümle karşılaştır yalnızca bir temel çizgiye karşı çalışır.
  • Bağlantıları bir yorumla incelendi olarak işaretleyin. Yorum bağlı öğeye eklenir ve bağlantıya kaydedilir; böylece inceleme bir denetim izi bırakır.

Yaygın hatalar

BelirtiNedenDüzeltme
Bir gereksinim puanlanmıyor, kayıtta değil veya RVTM'de değil.Bu bir Requirement değil, Statement.Özellik panelinde sınıfını Requirement olarak değiştirin.
Correct ve Feasible her gereksinimde ✘ gösteriyor.Bir kişinin değerlendirmesini gerektirirler (“İnceleyenin değerlendirmesi gerekir”).Her birini inceleyin ve Evet olarak işaretlemek için ✘ simgesine tıklayın veya YZ gereksinim denetimini çalıştırın.
Puan “Eski — yeniden çalıştır” gösteriyor.Metin son denetimden sonra değişti.Kaliteyi denetle düğmesine tıklayın veya Metin değiştiğinde otomatik olarak yeniden denetle seçeneğini açın.
Elle verilen Evet/Hayır geçersiz kılmaları kayboldu.Metni düzenlemek onları temizler.İncelemeden sonra yeniden ayarlayın; geri alma onları geri yükler ve Geçmiş'te kalırlar.
Bir yazım hatası düzeltmesinden sonra bir gereksinim Approved durumundan çıktı.Ad veya açıklamadaki her düzenleme onaylanmış bir gereksinimi yeniden açar.Onu yeniden onaylayın. Yazım hatalarını onaydan önce düzeltin.
Bir TBD/TBR satırında “Kapat” yok.Açık öğe yalnızca metinden geliyor.TBD, TBR veya TBS'yi kaldırmak için metni düzenleyin.
Bir içe aktarma güncellemek yerine kopyalar oluşturdu.Mevcut nesneleri şuna göre eşleştir eşleşmedi.Kimlik sütunuyla dışa aktarın, düzenleyin ve Mevcut nesneleri şuna göre eşleştir: Genel kimlik ile içe aktarın (bkz. Gereksinimleri bir elektronik tablodan güncelleme).

Diğer özelliklerle nasıl bağlantılıdır

  • Beslendiği kaynaklar: İçe aktar üzerinden paydaş girdileri ve mevcut belirtimler ile Belgeler içinde yazılan belgeler.
  • Beslediği yerler:
  • YZ: belge ve Öğe görünümündeki ✦ YZ ▾ menüsünde Açık yeniden yaz…, Ölçülebilir ölçüt ekle…, Basitleştir…, Bileşik gereksinimi böl…, Gerekçe taslağı oluştur…, Ad öner… ve YZ ile denetle (YZ gereksinim denetimi) bulunur. YZ değişiklikleri uygulanmadan önce önizlenir. Bkz. YZ'ye sor ve YZ araçları.

Gereksinimler sayfası

Her gereksinimi tek bir tabloda görmek ve düzenlemek için Gereksinimler sayfasını kullanın. İhtiyaçlar ve gereksinimler → Gereksinimler, class:Requirement ile filtrelenmiş Veritabanıdır.

Her Veritabanı özelliği burada çalışır:

  • Sütunları sıralayın ve filtreleyin, hücreleri yerinde düzenleyin.
  • Birçok gereksinimde öznitelikleri veya etiketleri aynı anda ayarlamak için toplu işlem çubuğu için satırları seçin.
  • Dışa aktarın ve seçili satırlar için İzlenebilirlik Matrisini açın.

Gereksinimi özellik panelinde göstermek için bir satıra tıklayın. Öğe görünümünü açmak için çift tıklayın. İncelenecek bir bağlantısı olan bir gereksinim, satırında ⚠ İncele rozeti gösterir. Menüsü için bir satıra sağ tıklayın: nedenleriyle birlikte en fazla üç önerilen eylem (örneğin gereksinim Unambiguous ölçütünü karşılamadığında ✦ Ölçülebilir ölçüt ekle…, doğrulanmadığında ✦ Test senaryosu oluştur…), ✦ Daha fazla YZ ▸, ardından Aç, Yeniden adlandır…, Çoğalt, Alt öğe ekle…, Durum ▸, Öncelik ▸, İlişkilendir ▸, Belgeye ekle ▸, Diyagramda göster ▸, Bağlantıyı kopyala, Numarayı kopyala ve Sil… (bkz. Sağ tıklama menüsü).

Tablo, sorgular ve toplu düzenleme için bkz. Model ve veritabanı.

Yararlı sorgular:

SorguGösterdikleri
class:RequirementHer gereksinim.
Requirement:"Status=In Review"Onaylar listesi.
Requirement:"Status=Draft"Henüz incelemeye gönderilmemiş gereksinimler.
class:Requirement AND is:leafYaprak gereksinimler (alt gereksinimi olmayanlar).
class:Requirement AND NOT relationship:"verified by"Doğrulayan öğesi olmayan gereksinimler.

Gereksinim Kalitesi

Kötü ifade edilmiş gereksinimleri bulmak için Kalite sayfasını (başlık “Gereksinim Kalitesi”) kullanın. Sayfa her gereksinimi dokuz ölçüte göre puanlar.

Dokuz ölçüt ve önerilerdeki kural numaraları (R2, R19 vb.) INCOSE Guide to Writing Requirements belgesindeki özellikleri ve kuralları izler. Holarch'ın sözcük listeleri ve desenleri bu kurallara yaklaşır; kılavuzun metni değildir ve bazı kurallar bir inceleyenin değerlendirmesini gerektirir.

  • Puan = 100 × (karşılanan ölçütler) / 9, yuvarlanmış. Denetlenmeyen bir ölçüt (–, bkz. Başka dillerdeki gereksinimler) dışarıda bırakılır: 100 × karşılanan / 8.
  • %67 veya üzeri İyi olarak kabul edilir. %67'nin altı Yeniden çalışma gerekli olur.
  • Çubuk %34'ün altında kırmızı, %34 ile %66 arasında sarı ve %67'den itibaren yeşildir.

Sayfa düzeni

  • Sayfa başlığı:
    • Diğer ▾: Elle verilen derecelendirmeleri temizle, gösterilen gereksinimlerin elle verilen her Evet/Hayır değerini sıfırlar ve denetimi yeniden çalıştırır. Gereksinimler'de aç, gösterilen gereksinimleri Gereksinimler tablosunda açar. Belgeyi aç, kapsam bir belge olduğunda görünür.
    • Dışa aktar ▾: gösterilen gereksinimlerin Excel (.xlsx) ve CSV dosyası.
    • Kaliteyi denetle: filtreler ne gösterirse göstersin kapsamdaki her gereksinimi denetler (yineleme kuralı her gereksinimi kapsamdaki diğerleriyle karşılaştırır).
  • ✦ YZ ▾ (üst çubukta): YZ ile denetle (N gereksinim)…, gösterilen gereksinimlerin YZ gereksinim denetimi.
  • Kapsam çubuğu: Kapsam (Tüm gereksinimler veya Belge: <name>) ve Metin değiştiğinde otomatik olarak yeniden denetle onay kutusu. İncelenecek bağlantılar, TBD/TBR ve Onaylar gezinme çubuğunda Kalite öğesinin yanındadır.
  • Sorgu çubuğu: + Filtre, filtre çipleri ve arama metni, Temizle, ? (arama sözdizimi) ve Görünümler ▾: Gereksinimler sayfasındakiyle aynı çubuk (bkz. Kalite sayfasını filtreleme).
  • Kutucuklar: Gereksinimler (filtreler bazılarını gizlediğinde Gösterilen gereksinimler altında “40'tan 12'si”), Ortalama puan, İyi (≥ %67), Yeniden çalışma gerekli (< %67) ve eski olan varsa Eski (metin değişti). Eski puanlar ortalamaya katılmaz.
  • Kutucukların altındaki not: “Otomatik denetimler en fazla 9 öznitelikten 7'sine (%78) ulaşır; Correct ve Feasible insan doğrulaması gerektirir — Evet olarak işaretlemek için bir ✘ simgesine tıklayın. Her tıklama elle Evet, elle Hayır ve yeniden otomatik arasında geçiş yapar.”
  • Tablo: Numara, Ad (altında açıklamayla), Kalite puanı, ölçüt başına bir sütun ve Öneriler. Öneriler her iletiyi ölçütüyle başlayarak listeler. Satırlar numaraya göre sıralanır. Veritabanı satır menüsü için bir satıra sağ tıklayın veya üzerindeyken Shift+F10 tuşlarına basın: nedenleriyle önerilen eylemler (karşılanmayan bir ölçütü düzelten yeniden yazım önce gelir), ✦ Daha fazla YZ ▸, Aç, Yeniden adlandır…, Çoğalt, Alt öğe ekle…, Durum ▸, Öncelik ▸, İlişkilendir ▸, Belgeye ekle ▸, Diyagramda göster ▸, Bağlantıyı kopyala, Numarayı kopyala ve Sil…. Satır seçim olur.
  • Birkaç satır: ⌘ / Ctrl-tıklama (Windows ve Linux'ta Ctrl-tıklama) bir satırı seçer veya seçimini kaldırır, ⇧ / Shift-tıklama son tıklanan satırdan itibaren aralığı seçer, ⌘ / Ctrl+⇧ / Shift-tıklama o aralığı ekler; odaklanmış bir satırda ⌘A / Ctrl+A veya ⇧ / Shift+↑ / ⇧ / Shift+↓ tüm satırları seçer veya seçimi genişletir. Araç çubuğu sayıyı gösterir; Esc onu temizler. Hepsine uygulamak için seçili bir satıra sağ tıklayın: ✦ YZ ile denetle (n gereksinim)…, ✦ Yeniden yaz (n) ▸, ✦ Test senaryoları oluştur (n)…, ✦ Bunlar hakkında YZ'ye sor (n)…, ✦ İz öner (n)… (her biri tek bir önizlemeyle; bkz. Birkaç seçili öğede YZ), n nesneyi çoğalt, Durumu ayarla ▸, Önceliği ayarla ▸, Belgeye ekle ▸ ve n öğeyi sil…; her biri tek bir Geri al ile geri alınır. TBD/TBR Kaydı ve İncelenecek bağlantılar aynı şekilde çalışır; İncelenecek bağlantılar sayfasında seçim, satırları Seçilenleri incelendi olarak işaretle… için de işaretler.

Özel durumlar:

  • Sonucu olmayan bir satır puan sütununda “Çalıştırılmadı” gösterir.
  • Eski bir satır “Eski — yeniden çalıştır” gösterir.
  • Kapsamda gereksinim yoksa sayfa “Gereksinim yok” ve “Yalnızca Requirement sınıfındaki nesneler puanlanır; Statement'lar atlanır.” gösterir.
  • Filtreler veya arama metni her gereksinimi gizlediğinde sayfa “Eşleşen gereksinim yok” ve “Arama veya filtrelerle eşleşen gereksinim yok. Tüm gereksinimleri görmek için bunları temizleyin.” gösterir.

Kalite sayfasını filtreleme

Sorgu çubuğu Gereksinimler sayfasındaki gibi çalışır (bkz. Yazılan filtreler nasıl çip olur): yazılan filtre terimleri Enter tuşuna bastığınızda çip olur, metnin geri kalanı ad, numara ve açıklamayla eşleşir, boş bir aramada Backspace son çipi kaldırır ve Temizle hepsini kaldırır. Kutucuklar, tablo, Dışa aktar ▾ ve ✦ YZ ▾ → YZ ile denetle filtreleri izler.

+ Filtre, kapsamdaki sayılarla şunları listeler:

GrupFiltrelerTerim
Kaliteİyi (≥ %67), Yeniden çalışma gerekli (< %67), Çalıştırılmadı, Eski (metin değişti), Elle verilen derecelendirmeler, YZ bulgusuquality:good, quality:rework, quality:notrun, quality:stale, quality:manual, quality:ai
Bir ölçütü karşılamıyorÖlçüt başına bir tane: Hayır olarak derecelendirilmişquality:Verifiable=no (=yes: Evet olarak derecelendirilmiş)
Kural bulgusuKapsamda bulunan kurallar, örneğin R7 Kesin olmayan ifade veya R30 Çok benziyor (olası yinelemeler)quality:R7
Yapı, Sınıf, Gereksinim öznitelikleri, Etiket, İlişki, DiyagramGereksinimler sayfasındaki gibi; Gereksinim öznitelikleri sınıf çipi olmadan listeleniris:tbd, Requirement:"Status=Draft", label:"…"

Bir grubun filtreleri veya ile birleşir; farklı gruplar ve ile birleşir. Puan aralıkları özniteliği kullanır: Requirement:"Quality Score>=50". quality: terimleri Gereksinimler sayfasında ve Veritabanında da çalışır.

Görünümler ▾ yerleşik bir görünümü (Yeniden çalışma gerekli, Henüz denetlenmedi, Eski sonuçlar, Belirsiz, Doğrulanamaz, Olası yinelemeler, Elle verilen derecelendirmeler) veya kaydettiğiniz görünümlerden birini uygular. Görünümü kaydet…, geçerli filtreleri ve arama metnini bu tarayıcıda her proje için kaydeder; kaydedilmiş bir görünüm kullanımdayken “<name>” görünümünü sil görünür. Tüm gereksinimler filtreleri temizler. quality?q=<query> adresi sayfayı filtrelenmiş olarak açar.

Filtreleme saklanan sonuçları okur ve yeniden denetlemez. 50.000 gereksinimde bir filtre veya arama değişikliği saniyenin onda birinden çok daha kısa sürer.

Ölçütler ve denetimler

Her ölçüt üç işaretten birini gösterir:

  • ✔ (Evet): ileti yok.
  • ✘ (Hayır): en az bir ileti.
  • –: denetlenmedi.

Denetimler büyük/küçük harfi yok sayarak tam sözcükleri ve öbekleri eşleştirir. Yalnızca listelenen biçimler sayılır: “effective” ve “effectively” ikisi de listelidir, “effectiveness” değildir. Tırnak içindeki sözcükler de sayılır. Aşağıdaki iletiler gösterilen metnin aynısıdır. İletinin sonundaki köşeli parantezli liste bulunan sözcükleri adlandırır.

Unambiguous

KuralİletiTetikleyen
R6R6 - Tanınmayan birimler; standart SI, ABD geleneksel veya İngiliz birimlerini kullanın: [...]Ardından bilinen bir birim olmayan bir sözcük gelen bir sayı (örneğin “12 sorties”). Bilinen birimler SI, ABD geleneksel ve İngiliz birimlerini ve kısaltmalarını, %, derece, °C ve °F içerir.
R2R2 - Etken çatı kullanın: [...]Ardından geçmiş zaman ortacı gelen “shall/must/will/should be” (“shall be measured”).
R5R5 - Şunlar yerine belirli ifadeler kullanın (“the”): [...]“a” veya “an”.
R7R7 - Kesin olmayan ifade: [...]some, many, several, few, little, much, various, appropriate(ly), adequate(ly), efficient(ly), effective(ly), sufficient(ly), reasonable, reasonably, suitable, suitably, significant(ly), minimal(ly), maximal(ly), approximately, almost, nearly, generally, usually, typically, normally, robust(ly), flexible, flexibly, easy, easily, etc, similar, relevant, substantial(ly), large, small, good, bad, better, best, worst, proper, properly, acceptable, acceptably, accurate(ly), extreme, high-contrast, high contrast.
R8R8 - Kaçış tümceleri gereksinimi zayıflatıyor: [...]if necessary, where possible, as appropriate, as practicable, as far as possible, if practical, as required, as needed, to the extent possible, if possible.
R10R10 - Gereksiz mastar öbekleri: [...]to be designed to, to be able to, to be capable of, to enable, to allow, be able to, be capable of.
R16R16 - Olumsuzluktan kaçının: [...]not, n't, never.
R17R17 - Eğik çizgi simgesinden (“/”) kaçının.İki sözcük arasındaki eğik çizgi; km/h, m/s, and/or ve bunun Almanca, Fransızca, İspanyolca, İtalyanca ve Felemenkçe karşılıkları hariç.
R24R24 - Açık adlar yerine zamirler: [...]it, its, they, them, their, he, she, him, her, someone, something, anyone, anything, anybody, somebody, this, these, those.
R32R32 - Evrensel niceleyiciler yerine “each” kullanın: [...]all, any, both, every, everything, everyone.
R34R34 - Ölçülemeyen başarım terimleri: [...]fast, quick, quickly, user friendly, user-friendly, high speed(s), high-speed, best practice(s), state of the art, state-of-the-art, seamless(ly), intuitive(ly), easy to use, timely, rapid, rapidly, real-time, real time. “Real-time clock” sayılmaz: bir bileşeni adlandırır.
R35R35 - Belirsiz zaman sözcükleri: [...]as, eventually, before, after, until, meanwhile, simultaneous(ly), soon, later, sometimes, occasionally, often, subsequently, previously.
—TBD/TBR yer tutucularını değiştirin.Açıklamada TBD, TBR veya TBS (büyük harfle).
—YZ: belirsiz — <reason>YZ gereksinim denetiminden kabul edilmiş bir YZ bulgusu.
—Bir üst sınır belirtiyor (“up to”); alt sınır kastediliyorsa “at least” kullanın.Ardından rakamla veya yazıyla bir sayı gelen “up to” (“up to 72 hours”, “up to five tonnes”). “Up to date” sayılmaz.

Complete

KuralİletiTetikleyen
—Açıklama eksik.Boş bir açıklama.
—Ad eksik.Boş bir ad.
R9R9 - Açık uçlu liste ifadeleri: [...]including but not limited to, etc, and so on, and so forth, such as, among others.

Singular

KuralİletiTetikleyen
R18R18 - Tek bir cümle yazın (bulunan: N).Birden fazla cümle (。, ! veya ? ile biten Japonca ve Çince cümleler de).
—İfadeyi nokta ile bitirin.“.” (veya 。) ile bitmeyen bir açıklama.
R19R19 - İki gereksinimi birleştiriyor; ayrı gereksinimlere bölün: [...]İki eylemi veya iki yükümlülüğü birleştiren and, or, but, however veya whereas (“shall log and report each fault”, “… and the operator shall …”), “nor shall”, “;” sonrasında ikinci bir yan cümle; ikinci bir eylemden önce “and/or”. Bkz. Tek gereksinimde iki gereksinim (R19).
R19R19 - “and/or” belirsizdir; ikisinin mi yoksa birinin mi kastedildiğini belirtin: [and/or]Değerler arasında veya bir koşulda “and/or”.
R19R19 - İki değeri birleştiriyor; her biri ayrı doğrulanıyorsa bölün: [...]Tek bir eylemden sonra iki nesneyi veya değeri birleştiren and, or (“measure the temperature and the humidity”). Bir not: Singular Evet kalır.
R20R20 - Amaç öbekleri içeriyor; Rationale alanına taşıyın: [...]purpose of, in order to, so that, for the purpose of, so as to.
R21R21 - Parantez içeriyor; parantez içindeki metni Rationale alanına taşıyın.“(” veya “[” (tam genişlikli parantezler de).

Conforming

İletiTetikleyen
Kip fiili kullanın: [need, shall, will, should, must]Bu sözcüklerin hiçbiri geçmiyor.

Appropriate

KuralİletiTetikleyen
R31R31 - Bir çözümü dayatıyor: [...]using, by means of, utilizing, utilising, implemented in, implemented with, via a, via the, built with, written in.

Necessary

KuralİletiTetikleyen
R30R30 - Çok benziyor: [3.2 Battery Capacity (%81,3 benzer), ...]Kapsamdaki, açıklaması en az %75 benzer (karakter çifti benzerliği) olan başka bir gereksinim. Bulgu en fazla beşini adlandırır ve gerisini sayar (“ve 3 tane daha”). Gereksinimin doğrudan üst öğesi ve alt öğeleri (decomposed by, decomposes) karşılaştırılmaz: bir ayrıntılandırma çoğu zaman üst öğesinin ifadesini yineler. Kardeşler ve ilişkisiz gereksinimler karşılaştırılır.

Verifiable

İletiTetikleyen
Onu doğrulayan bir Test Case veya Requirement bağlayın.Gereksinimin bir Requirement veya Test Case'e verified by bağlantısı yok.
YZ: yazıldığı haliyle doğrulanamaz — <reason>YZ gereksinim denetiminden kabul edilmiş bir YZ bulgusu.

Feasible

KuralİletiTetikleyen
R26R26 - Nadiren ulaşılabilen mutlak terimler: [...]always, never, 100%, 100 percent, all the time, totally, completely, absolutely, zero defects, forever, continuous, continuously, uninterrupted.
—İnceleyenin değerlendirmesi gerekirMutlak terim ve yakın yineleme bulunmadı; bir kişinin karar vermesi gerekir.

Correct

İletiTetikleyen
İnceleyenin değerlendirmesi gerekirHer metin denetimi (Appropriate, Complete, Conforming, Necessary, Singular, Unambiguous) geçti; bir kişinin karar vermesi gerekir.

Correct ve Feasible, biri karar verene kadar “İnceleyenin değerlendirmesi gerekir” ile bittiği için en yüksek otomatik puan 9'da 7'dir (%78).

Tek gereksinimde iki gereksinim (R19)

Bir gereksinim tek bir şey belirtir. R19 her “and”, “or”, “nor”, “but”, “however”, “whereas”, “as well as” ve “and/or” sözcüğüne bakar ve onu şu türlerden birine ayırır:

TürÖrnekSonuç
İki gereksinim“The unit shall log and report each fault.” “The pump shall stop, and the operator shall be alerted.” “… to acknowledge alarms and to silence the horn.” “…; it shall also …”Bir bulgu. Singular Hayır olur.
Belirsiz “and/or”“The log shall record the user ID and/or the badge number.”Bir bulgu: ikisinin mi yoksa birinin mi kastedildiğini belirtin. Singular Hayır olur.
İki değer“The station shall measure the temperature and the humidity.”Bir not: her değer ayrı doğrulanıyorsa bölün. Singular Evet kalır; not gri gösterilir ve puanı düşürmez.
Bulgu yok“between 5 °C and 30 °C”; “When A and B, the unit shall …”; “… when the door is open and the fan is off”; “requirements 2.1 and 2.2”; tırnak içindeki metin; “The command and control unit shall …”; “ASME Boiler and Pressure Vessel Code”; “5 Nm at 3000 rpm and 24 V”; “including batteries and strap”; “either open or closed”Hiçbir şey.

Tek bir niceliğin iki değeri (“at -20 °C and 60 °C”) not alır. “, and” bir koşulu bitirir: “… when the level falls below 10 %, and restart when …” bir bulgudur. Tek bir birim gibi davranan bir özne (“The Owner and the Contractor shall agree …”, “The power and data connector shall …”) not almaz; her biri ayrı davranan iki özne (“The pump and the valve shall close …”) not alır. Karşılaştırıcılar (“12 or more”) işaretlenmez. Eylemden sonra gelen bir ad iki değerden ayırt edilemez; bu nedenle onu Bileşik adlar altında listeleyin.

Bileşik adlar. Kalite sayfasında Diğer ▾ → Bileşik adlar…, projenin “and” veya “or” içeren ama tek bir şeyi adlandıran adlar listesini açar; her satıra bir tane (örneğin “power and data connector”). R19 bunları işaretlemez. Projenin Acronym sözlüğündeki açılımlar (Acronym statement'ları, bkz. Kısaltmaları bulma) da sayılır ve birkaç yaygın ad yerleşiktir (“command and control”, “research and development”, “operations and maintenance”, …). Liste projeyle birlikte kaydedilir ve geri alınabilir. Bir değişikliği uygulamak için Kaliteyi denetle düğmesine yeniden tıklayın.

Başka dillerdeki gereksinimler

Holarch her gereksinimin dilini metninden algılar. Sözcük kuralları (R2–R10, R16, R19, R20, R24, R26, R31–R35, “up to”, kip fiili, birimler) İngilizce gereksinimleri puanlar.

Almanca, Fransızca ve İspanyolca (beta). Bu gereksinimler aynı kuralları kendi dillerinde alır, örneğin Almanca “angemessen” veya “bei Bedarf”, Fransızca “approprié” veya “si possible”, İspanyolca “adecuado” veya “según corresponda”. Bir dilin kuralları betadayken:

  • her bulgu (beta) ile işaretlenmiş bir öneridir. Diğer notlarla birlikte gri gösterilir ve bir ölçütü veya puanı asla düşürmez;
  • “Bu dilin ifade kuralları betada: yalnızca öneri, puanlanmaz. Yapı denetimleri geçerlidir.” notu gösterilir ve ifade YZ ile denetlenene veya elle derecelendirilene kadar Unambiguous – (denetlenmedi) olur;
  • “each” karşılığı sözcükler (jede, chaque, cada) doğru seçimdir ve işaretlenmez; “alle 5 s” veya “tous les 5 s” (her 5 s) de işaretlenmez.

Bir kural bir dil için ancak o dilde yazılmış en az 300 ifade üzerinde ölçüldükten ve anadili o dil olan bir gereksinim mühendisi tarafından incelendikten (bulgularının en az %90'ı doğru) ve inceleyen onu onayladıktan sonra sayılmaya başlar. Bu olduğunda o dilin puanları bir sonraki denetimde değişebilir; sürüm notları bunu belirtir.

Diğer diller (Japonca, İtalyanca, Çince ve diğerleri) şunları alır:

  • “İfade kuralları İngilizceyi kapsar. Yapı denetimleri geçerlidir.” notu ve Unambiguous için – (denetlenmedi): ifade denetlenene veya elle derecelendirilene kadar puana katılmaz. TBD gibi başka bir Unambiguous bulgusu yine de onu başarısız kılar;
  • her dil için geçerli denetimler: R18 (。 de), son nokta (。 de), R17, R21, TBD/TBR, R30, ad, açıklama ve doğrulama bağlantısı.

Beta olsun veya olmasın her dil bu denetimleri de alır. Öneriler, sözcükler yazıldığı gibi tırnak içinde olmak üzere İngilizce saklanır (“R7 - Imprecise wording: [angemessen] (beta)”); böylece quality:R7 filtresi ve dışa aktarmalar her dilde aynı çalışır. Genel API bunları kuralları, sözcükleri ve moduyla döndürür (findings).

İfadeyi YZ ile denetle. Kalite sayfasında ✦ YZ ▾ → İfadeyi YZ ile denetle… (veya tek bir gereksinimde ✦ Daha fazla YZ ▸) aynı kuralları yapılandırılmış YZ aracılığıyla her gereksinimin kendi dilinde uygular. Önizleme bulguları ve o dilde isteğe bağlı bir yeniden yazımı (işaretsiz) listeler. Seçilenleri uygula, bulguları YZ bulguları olarak ekler ve notu kaldırır (beta önerileri not olarak kalır); bu tek bir geri alma adımıdır. Metni düzenlemek onları temizler. YZ içeren bir plan gerektirir.

Elle geçersiz kılmalar

Otomatik sonuca katılmadığınızda veya bir inceleyenin kararını kaydetmek için bir ölçütü geçersiz kılın.

  • Kalite sayfasında: bir ölçüt hücresine tıklayarak değerleri arasında geçiş yapın: ilk tıklama elle Evet (✔), sonraki elle Hayır (✘) ayarlar, üçüncüsü elle verilen değeri temizler ve otomatik denetim yeniden karar verir. Elle ayarlanmış bir hücre bir işaret gösterir; araç ipucunda “(elle ayarlandı)” ve sonraki tıklamanın ne yapacağı yazar.
  • Özellik panelinde veya Öğe görünümünde: her ölçüt Evet ve Hayır içeren bir listedir. Elle ayarlanmış bir ölçüt, onu otomatik sonuca döndüren Otomatik (yeniden denetle) seçeneğini de sunar. Elle ayarlanan değerler “elle” gösterir.

Denetim yeniden çalıştığında elle verilen değer korunur. Başka iletisi olmayan elle verilmiş bir Hayır “Elle Hayır olarak işaretlendi.” gösterir.

Geçersiz kılmalar iki durumda temizlenir:

  • Gereksinimin adı veya açıklaması değişir. Geçersiz kılmalar Geçmiş'te kalır ve geri alma onları geri getirir.
  • Diğer ▾ → Elle verilen derecelendirmeleri temizle seçeneğini seçersiniz. Bu, kabul edilmiş YZ bulgularını da temizler.

Eski sonuçlar

Bir gereksinimin adı veya açıklaması bir denetimden sonra değiştiğinde sonuçları eski olarak işaretlenir:

  • Kalite sayfası “Eski — yeniden çalıştır” ve “Metin son denetimden sonra değişti. Kaliteyi denetle'yi yeniden çalıştırın.” araç ipucunu gösterir.
  • Bir belgenin Kalite puanı sütunu saat simgeli bir Güncel değil etiketi gösterir (nedeni için üzerine gelin).
  • Özellik paneli “Kalite: eski — yeniden çalıştır” gösterir.

Eski sonuçlardan kaçınmak için Metin değiştiğinde otomatik olarak yeniden denetle seçeneğini açın. Holarch bu durumda düzenlenen gereksinimde kural denetimini hemen yeniden çalıştırır. Ayar bu tarayıcıda saklanır.

Bir belgeden Kaliteyi denetle

Bir belgede Denetle ▾ → Kaliteyi denetle seçeneğini seçin. Bir gereksinim seçiliyken öğede Bu gereksinimin kalitesini denetle yazar ve yalnızca onu denetler. Hiçbir gereksinim seçili değilken belgedeki görünür her gereksinimi denetler.

Sonuçlar kutucuklar ve tabloyla birlikte Kaliteyi denetle — <name> iletişim kutusunda açılır. Düğmeleri CSV dışa aktar, XLSX olarak dışa aktar, Kalite'de aç ve Kapat'tır.

Gereksinimi olmayan bir belge “Bu belgede denetlenecek Requirement yok. Statement'lar puanlanmaz.” gösterir.

YZ gereksinim denetimi

Bir kuralın karar veremediği ölçütler hakkında ilk görüş için YZ gereksinim denetimini kullanın: Correct, Feasible ve Necessary. Denetim ayrıca kuralların Unambiguous (örneğin alt sınır kastediliyor gibi görünen yerde “up to 72 hours” veya ölçüsü olmayan “accurately”) ve Verifiable (hiçbir test, analiz, muayene veya gösterimin gereksinimin yazıldığı haliyle karşılandığını gösteremeyeceği durumlar) altında kaçırdığı ifadeleri de arar. YZ kural bulgularını alır ve yalnızca onların kaçırdıklarını bildirir.

  1. ✦ YZ ▾ → YZ ile denetle (N gereksinim)… seçeneğini seçin.

    Tek bir gereksinim için ✦ YZ ▾ menüsünde YZ ile denetle (bu gereksinim)… veya sağ tıklama menüsünde ✦ Daha fazla YZ ▸ → ✦ YZ ile denetle… seçeneğini seçin.

    Claude gereksinimleri inceler. Gereksinimler, yineleme denetimleri için en fazla 300 başka gereksinimle birlikte 20'lik gruplar halinde gönderilir. Dahil YZ'de denetim 100 gereksinim başına bir istek sayar (yukarı yuvarlanır); 100'den fazla gereksinimlik bir denetim çalışmadan önce bir iletişim kutusu kaç istek kullanacağını söyler, örneğin “Bu inceleme, bu ay kalan 52 dahil YZ isteğinizden 3'ünü kullanır (100 gereksinim başına 1 istek).” Kalandan fazla istek gerektiren bir denetim başlamaz.

  2. Her gereksinimi iletişim kutusunda inceleyin.

    Üstteki satır neyin işaretli başladığını söyler: “İşaretli öğeler uygulanır. Yeniden yazımlar önce okumanız için işaretsiz başlar. Kilitli, onaylanmış ve temel çizgiye alınmış gereksinimler işaretsiz başlar.”

  3. Kabul ettiğiniz değişiklikleri ve yeniden yazımları işaretleyin.

    Düğmelerin üstündeki satır Uygula'nın ne yapacağını sayar, örneğin “5 gereksinime 7 değer ve 2 yeniden yazım uygular.” Hiçbir şey işaretli değilken “Hiçbir şey seçilmedi.” yazar ve Seçilenleri uygula soluk görünür.

  4. Seçilenleri uygula düğmesine tıklayın.

    İşaretli öğeler uygulanır ve tek bir Geri al ile hepsi geri alınır. Bildirimde “N YZ değişikliği uygulandı” yazar.

İletişim kutusu her gereksinim için şunları gösterir:

  • Correct, Feasible, Necessary, Unambiguous ve Verifiable için bir Evet/Hayır kararı ve bir gerekçe.
  • Her kararın altında, uygulandığında neyi değiştirdiğiyle etiketlenmiş bir onay kutusu veya saklanan değer zaten eşleşiyorsa onay kutusu olmadan “değişiklik yok”:
    • Correct, Feasible ve Necessary: karar saklanan değerden farklıysa “Hayır → Evet” veya “Evet → Hayır”, saklanan değer yoksa “Evet yap” veya “Hayır yap”.
    • Unambiguous ve Verifiable: YZ bir sorun bulduysa “Bulgu ekler”, daha önceki bir YZ bulgusu artık geçerli değilse “Önceki bulguyu temizler”.
  • İsteğe bağlı bir yorum.
  • YZ bir yeniden yazım önerdiğinde, sözcük farkıyla birlikte bir Yeniden yazımı uygula: onay kutusu.

Neyin işaretli başladığı:

  • Her değer değişikliği işaretli başlar.
  • Yeniden yazımlar önce okumanız için işaretsiz başlar.
  • Onaylanmış, temel çizgiye alınmış ve kilitli gereksinimler işaretsiz başlar ve işaretlenir.

Bir yeniden yazımı işaretlemek, o gereksinimin Unambiguous ve Verifiable kutularını soluklaştırır ve onları “Yeniden yazımdan sonra yeniden denetlendi” olarak etiketler: kural denetimleri yeni metinde yeniden çalışır. Yeniden yazımın işaretini kaldırmak kutuları önceki haline getirir. Correct, Feasible ve Necessary yine de uygulanır.

DüğmeEtki
Tüm değer değişikliklerini seçOnaylanmış, temel çizgiye alınmış ve kilitli gereksinimler dışında her değer değişikliğini işaretler.
Tüm yeniden yazımları seçİşaretlenmiş olanlar dışında her yeniden yazımı işaretler.
Hiçbirini seçmeHer şeyin işaretini kaldırır.

Uygula'nın yaptıkları:

  • Correct, Feasible ve Necessary elle verilmiş Evet/Hayır değerleri olur.
  • Unambiguous veya Verifiable için Hayır bir YZ bulgusu olur: Kalite sayfası onu kural bulgularıyla birlikte “YZ: belirsiz — <reason>” veya “YZ: yazıldığı haliyle doğrulanamaz — <reason>” olarak listeler ve ölçüt ✘ gösterir. Evet daha önceki bir YZ bulgusunu kaldırır.
  • YZ bulguları, gereksinimin adı veya açıklaması değiştiğinde (kabul edilen bir yeniden yazımla da) ve Diğer ▾ → Elle verilen derecelendirmeleri temizle ile temizlenir.

Seçilenleri uygula düğmesinin yaptıkları:

  • Kararlar “YZ: <reason>” iletisiyle elle verilmiş değerler olur. Denetim yeniden çalıştığında korunurlar.
  • Yeniden yazımlar açıklamanın yerini alır ve denetimi yeniden çalıştırır.

Kalite dışa aktarmaları

Dışa aktarmaİçerik
Dışa aktar ▾ → CSV (quality_report.csv)Gereksinim ve ölçüt başına bir satır: Number, Name, Description, Quality Score, Attribute, Message, Result.
Dışa aktar ▾ → Excel (.xlsx) (quality_report.xlsx)Number, Name, Description, Rationale, Quality Score, Attribute, Message, Result; gereksinim hücreleri dokuz satırı boyunca birleştirilmiş, Evet yeşil ve Hayır kırmızı, sonda bir Rapor puanı (Evet yanıtlarının tüm yanıtlara oranı).
Belgede Teslim ▾ → Tüm dışa aktarımlar… → Kalite bulguları (Excel)Tek bir belge için, belgenin görüntüleme sütunlarıyla aynı düzen.

Onaylar

Karar bekleyen her şeyi görmek için İhtiyaçlar ve gereksinimler → Onaylar sayfasını kullanın. Sayfa Veritabanını Requirement:"Status=In Review" sorgusuyla açar.

Her Veritabanı özelliğine sahiptir:

  • Birkaç satır seçin ve Durumu veya etiketleri birlikte ayarlamak için toplu işlem çubuğunu kullanın.
  • Listeyi dışa aktarın.
  • Öğe görünümü ve tam geçmiş için bir satıra çift tıklayın.

Onay kutusu

Onay kutusu her gereksinimin özellik panelinde ve Öğe görünümünde görünür. Şunları gösterir:

  • Renkli bir çip olarak geçerli durum (hiçbiri ayarlanmamışsa Draft).
  • Kaydedilen son karar: “<status>, <name> tarafından · <date and time>”, varsa ardından “— <note>” (örneğin “— Metin onaydan sonra değişti”) veya “Kayıtlı onay yok”.
  • Geçerli duruma uygulanan düğmeler:
DüğmeGösterildiği durumEtki
OnaylaDurum ne Approved ne de RejectedApproved yapar ve sizi ve saati kaydeder. Bildirim: “Onaylandı”.
Reddet…Durum ne Approved ne de RejectedGereksinimi reddet iletişim kutusunda bir Neden (isteğe bağlı) sorar, ardından Rejected yapar. Bildirim: “Reddedildi”.
Yeniden açDurum Approved veya RejectedIn Review yapar. Bildirim: “In Review durumuna taşındı”.

Kaydedilen ad, hesap adınızdır. Bir tabloda veya özellik panelinde Durumu elle ayarlamak da adınız ve saatle bir karar kaydeder. Görüntüleyiciler kutuyu düğmeler olmadan görür.

Bir iş akışı Approved durumuna geçişi bir değişiklik talebi üzerinden gönderdiğinde kutu bunun yerine açık talebi ve sayısını gösterir, örneğin CR-4: 3 onaydan 1'i. Uygulandıktan sonra karar her onaylayanı ve talebi adlandırır: “Ann Lead, Bob Discipline tarafından onaylandı · <date and time> · CR-4”.

Not: Approved bir gereksinimin adını veya açıklamasını düzenlemek onu “Metin onaydan sonra değişti” notuyla In Review yapar. Bildirim “N onaylanmış gereksinim In Review durumuna taşındı.” iletisini verir. Diğer öznitelikleri değiştirmek onu yeniden açmaz.

TBD/TBR Kaydı

Her açık öğeyi kapatılana kadar izlemek için kaydı kullanın. İhtiyaçlar ve gereksinimler → TBD/TBR öğesini açın. Bir belgeden, kaydı o belgeyle sınırlı olarak açmak için Denetle ▾ → TBD/TBR Kaydı seçeneğini seçin.

  • Sayfa başlığı: XLSX olarak dışa aktar (kayıt boşken devre dışı).
  • Kapsam çubuğu: Kapsam (Tüm gereksinimler veya Belge: <name>).
  • Kutucuklar: Açık TBD/TBR, Gecikmiş, Sahip yok ve her belgeyi açan Belge başına çipleri (“<document>: <count>”).
  • Zaman içinde açık öğeler: açık sayısının bir azalma grafiği. Gereksinimlerin geçmişinden, en eski gereksinimden bugüne en fazla 60 noktayla yeniden oluşturulur. Tarihi ve sayısı için bir noktanın üzerine gelin. Geçmiş çok azsa “Azalma grafiği için henüz yeterli geçmiş yok.” gösterir.
  • Tablo sütunları:
    • Numara ve açıklamasıyla birlikte Ad.
    • Belge.
    • Tür: TBD, TBR veya TBS; “öznitelik”, “metinde” veya ikisi birden ile.
    • Sahip: TBD Owner, o yoksa gereksinimin Owner değeri, o da yoksa “—”.
    • Son tarih: gereksinimin tek son tarihi; özellik panelinin İş akışı grubundaki ve Öğe görünümündeki Son tarih ile aynı tarih. TBD Due Date özniteliği bir tarih tutuyorsa odur, aksi halde gereksinimin son tarihidir. Geçmiş bir tarihin altında “Gecikmiş” gösterir. Gecikmiş satırlar renklendirilir.
    • Yaş: öğe açıldığından bu yana geçen gün sayısı.
    • Kapat.

Veritabanındakiyle aynı satır menüsü için bir satıra sağ tıklayın veya üzerindeyken Shift+F10 tuşlarına basın: nedenleriyle önerilen eylemler, ✦ Daha fazla YZ ▸, Aç, Yeniden adlandır…, Çoğalt, Alt öğe ekle…, Durum ▸, Öncelik ▸, İlişkilendir ▸, Belgeye ekle ▸, Diyagramda göster ▸, Bağlantıyı kopyala, Numarayı kopyala ve Sil…. Diğer sağ tıklama menülerinde, açık bir TBD veya TBR'si olan bir gereksinim, bu kaydı gereksinim seçili olarak açan TBD'yi çöz… ile başlar.

Kayıt salt okunurdur. Bir son tarihi değiştirmek için satırı seçin ve özellik panelinde Son tarih alanını ayarlayın. Holarch gereksinimin son tarihini ve TBD Due Date özniteliği bir tarih tutuyorsa (günün saatini koruyarak) o özniteliği de ayarlar; tek bir Geri al ile hepsi geri alınır. Son tarih alanını temizlemek ikisini de temizler.

Kapat yalnızca TBD/TBR özniteliği ayarlıyken görünür. Özniteliği None yapar:

  • Metinde hiçbir şey kalmadıysa bildirimde “Kapatıldı” yazar.
  • Metinde hâlâ TBD, TBR veya TBS varsa bildirimde “Öznitelik kapatıldı; metin hâlâ TBD içeriyor.” yazar.
  • Yalnızca metinden gelen bir öğenin Kapat düğmesi yoktur; kapatmak için metni düzenleyin.

Açık bir şey olmadığında sayfa “Açık TBD/TBR öğesi yok. Burada listelemek için bir gereksinimin TBD/TBR özniteliğini ayarlayın veya metnine TBD, TBR ya da TBS yazın.” gösterir.

XLSX olarak dışa aktar, Number, Name, Document, Type, Source (attribute, text veya both), Owner, Due Date, Opened, Age (days), Overdue (kırmızı Yes) ve Description içeren TBD-TBR Register.xlsx dosyasını yazar.

Bir gereksinim değiştikten sonra neyin yeniden denetlenmesi gerektiğini bulmak için İncelenecek bağlantılar (başka araçlarda şüpheli bağlantılar da denir) sayfasını kullanın. Bir bağlantının diğer ucundaki öğe, bağlantı en son incelendikten sonra değiştiyse bağlantının incelenmesi gerekir: bağlantının hâlâ geçerli olduğunu denetleyin, ardından incelendi olarak işaretleyin. İhtiyaçlar ve gereksinimler → İncelenecek bağlantılar bunları listeler. Bir belgeden Denetle ▾ → İncelenecek bağlantılar komutunu kullanın.

Bir gereksinimdeki şu değişiklikler bağlantılarını inceleme için işaretler:

  • Ad veya Açıklama.
  • Öncelik, Criticality, Verification Method veya Doğrulama düzeyi.
  • Herhangi bir sayısal, yüzde veya süre özniteliği.

Holarch bu durumda gereksinimin şu türlerdeki her bağlantısını işaretler: decomposed by, derived by, refined by, satisfied by, verified by ve traced to.

Değişen bir Verification Method veya Doğrulama düzeyi yalnızca verified by bağlantılarını işaretler. Bir gereksinimin ilk yöntemini veya düzeyini ayarlamak hiçbir şeyi işaretlemez: doğrulamayı planlar ve incelenmiş hiçbir şeyi değiştirmez.

Her bağlantının diğer ucu incelenecek öğedir: alt gereksinim, karşılayan işlev veya varlık, doğrulayan test senaryosu vb. Aynı gereksinimdeki sonraki değişiklikler aynı işaretteki değişen alanlar listesine eklenir.

  • İncelenecek bağlantılar sayfası: incelenecek her bağlantı için bir satır.
  • Belgeler ve Veritabanı: öğenin satırında bir ⚠ İncele rozeti (“Diğer uçtaki öğe, bu bağlantı en son incelendikten sonra değişti. Bağlantının hâlâ geçerli olduğunu denetleyin, ardından incelendi olarak işaretleyin. İncelemek için tıklayın.”).
  • Özellik paneli ve Öğe görünümü: “⚠ İncele: <requirement>, bu bağlantı en son incelendikten sonra değişti. Bağlantının hâlâ geçerli olduğunu denetleyin, ardından incelendi olarak işaretleyin.” başlık şeridi. İncele… düğmesi o öğe için İncelenecek açık bağlantılar ve Kapat içeren İncelenecek bağlantılar — <item> iletişim kutusunu açar.
  • Özellik panelinin İz bölümü: incelenecek her bağlantının yanında, araç ipucunda değişen alanlar ve tarihle bir ⚠.
  • RVTM: herhangi bir ucunda incelenecek bağlantı olan bir gereksinimden sonra bir ⚠ (gereksinim veya yukarı akışındaki öğe değişti); o bağlantıları incelemek için tıklayın. Doğrulayan içindeki bir test senaryosundan sonraki ⚠ o doğrulama bağlantısını işaretler.

Sayfa kuralı en üstte açıklar ve bir tablo gösterir:

Sütunİçerik
(onay kutusu)Seçilenleri incelendi olarak işaretle… için seçer. Başlık onay kutusu tümünü seçer.
DeğiştirildiDeğişen gereksinim.
DeğişiklikDeğişen alanlar, örneğin “Description” veya “Priority, Verification Level”.
Ne zaman / KimDeğişikliğin tarihi ve saati ve onu kimin yaptığı.
İlişkiDeğişen gereksinimden okunan bağlantı türü (örneğin “satisfied by”).
İncelenecek öğeBağlantının diğer ucundaki öğe.
(eylemler)Fark ve İncelendi olarak işaretle….

Veritabanındaki gibi öğenin satır menüsü için bir satıra sağ tıklayın veya üzerindeyken Shift+F10 tuşlarına basın: önerilen eylemler, ✦ Daha fazla YZ ▸, Aç, Yeniden adlandır…, Çoğalt, Alt öğe ekle…, Durum ▸, Öncelik ▸, İlişkilendir ▸, Belgeye ekle ▸, Diyagramda göster ▸, Bağlantıyı kopyala, Numarayı kopyala ve Sil…. Diğer sağ tıklama menülerinde (Veritabanı, belgeler) incelenecek bir bağlantısı olan bir öğe, onun incelemesini açan Bağlantıyı incele… ile başlar.

Fark, adın ve açıklamanın sözcük farkıyla Değişiklik — <requirement> iletişim kutusunu açar. Yalnızca öznitelikler değiştiyse “Yalnızca öznitelikler değişti: <fields>. Ayrıntılar için nesne geçmişini açın.” yazar. Geçmiş… gereksinimin geçmişini açar.

Bağlantıları incelendi olarak işaretlemek için:

  1. Bir satırda İncelendi olarak işaretle…, işaretli satırlar için Seçilenleri incelendi olarak işaretle… veya Tümünü incelendi olarak işaretle (N)… düğmesine tıklayın.

    N bağlantıyı incelendi olarak işaretle açılır: “Bağlı öğelerin değişiklikten sonra hâlâ geçerli olduğunu onaylayın. Her bağlı öğeye bir yorum eklenir.”

  2. İsteğe bağlı bir yorum yazın, örneğin “Alt öğe hâlâ geçerli; değişiklik gerekmiyor.”
  3. İncelendi olarak işaretle düğmesine tıklayın.

    Bildirimde “N bağlantı incelendi olarak işaretlendi.” yazar.

Hiçbir şey seçili değilken Seçilenleri incelendi olarak işaretle… “Önce incelendi olarak işaretlenecek bağlantıları seçin.” gösterir.

Bir bağlantıyı incelendi olarak işaretlemek incelemeyi bağlantıya kaydeder: kim, ne zaman, yorum ve alanlar. Bir yorum yazdıysanız Holarch her öğenin yorumlarına “Bağlantı incelendi (<requirement> değişti: <fields>): <comment>” de ekler. Geri alma bunu tersine çevirir.

İncelenecek bağlantı yoksa sayfa “İncelenecek bağlantı yok. Bir bağlantının diğer ucundaki öğe, bağlantı en son incelendikten sonra değiştiğinde bağlantının incelenmesi gerekir.” gösterir.

Temel çizgiler ve sürüm karşılaştırması

Belge temel çizgileri

Belge temel çizgilerini belgenin antetindeki Sürüm ▾ ile oluşturun ve kullanın. Şunları listeler:

  • Geçerli sürüm: canlı belge.
  • Bu belgenin her temel çizgisi, en yeniden başlayarak, tarihiyle birlikte.
  • Proje temel çizgileri altında her proje temel çizgisi.
  • Temel çizgiyi kaydet… ve Sürümleri karşılaştır… (belgenin bir temel çizgisi olana kadar soluk: “Önce bir temel çizgi kaydedin”).

Temel çizgiyi kaydet…, Temel çizgiyi kaydet iletişim kutusunu açar:

  • Ad * (zorunlu).
  • Onaylar: + Onaylayan ekle ile Ad, Rol ve Beyan satırları. İlk satır adınızla doldurulur. Boşken “Onaylayan yok.” yazar.
  • “Temel çizgi, belgenin bu sürümünü (öğelerini, özniteliklerini ve ilişkilerini) daha sonra görüntülemek, karşılaştırmak ve geri yüklemek için saklar. Onay kayıtları şimdiki tarihle kaydedilir ve sonradan düzenlenemez.” notu.

Görüntülemek için Sürüm ▾ menüsünde bir temel çizgi seçin. Belge, “Temel çizgi ‘<name>’, salt okunur, <date> tarihinde kaydedildi” başlık şeridi ve onaylar listesiyle salt okunur olur. Şu düğmeler görünür:

DüğmeEtki
Geçerli sürüme dönCanlı belgeye döner.
DüzenlemeTemel çizgiyi düzenle: yeniden adlandırın ve onay kayıtları ekleyin. Onaylar (kilitli) değiştirilemeyen mevcut kayıtları listeler; yeni kayıtlar “şimdiki tarihle kaydedilir ve listeye eklenir”. Yalnızca belge temel çizgileri.
Geçerli sürümle karşılaştırBu temel çizgiden Sürümleri karşılaştır iletişim kutusunu açar. Yalnızca belge temel çizgileri.
Temel çizgiyi geri yükleBelge temel çizgisi: “Bu belgenin nesneleri, sırası ve yapısı ‘<name>’ temel çizgisiyle değiştirilsin mi? O zamandan beri eklenen nesneler belgeden çıkarılır (silinmez). Geri alma kullanılabilir.” Proje temel çizgisi: Projeyi temel çizgiyle değiştir, “Projenin tamamı ‘<name>’ proje temel çizgisiyle değiştirilsin mi? Geri alma kullanılabilir.”
Sil“‘<name>’ temel çizgisi silinsin mi?”

Canlı belgede her satır bir değişiklik çubuğu taşır: temel çizgiden bu yana yeni, temel çizgiden bu yana değişmiş veya değişmemiş. En son belge temel çizgisiyle ya da belgenin temel çizgisi yoksa en son proje temel çizgisiyle karşılaştırır.

Sürümleri karşılaştırma

Bir incelemeden bu yana tam olarak neyin değiştiğini görmek için değişiklik raporunu kullanın.

  1. Sürüm ▾ → Sürümleri karşılaştır… veya bir temel çizginin başlık şeridindeki Geçerli sürümle karşılaştır düğmesine tıklayın.

    Sürümleri karşılaştır açılır.

  2. Başlangıç seçin: bir temel çizgi.
  3. Hedef seçin: daha sonraki bir temel çizgi veya Geçerli sürüm.

    Tablo Numara, Ad, Değişiklik türü, Alan ve Değişiklik (değiştirilmiş metin için sözcük farkı) listeler.

Değişiklik türleri:

Değişiklik türüAnlamı
Eklendi / KaldırıldıNesne belgeye katıldı veya belgeden ayrıldı.
DeğiştirildiBir alan değişti: Name, Number, Description, Class, Image veya herhangi bir öznitelik (alan adlandırılır).
Etiket eklendi / Etiket kaldırıldıBir etiket eklendi veya kaldırıldı.
İlişki eklendi / İlişki kaldırıldıBelgeye dokunan bir bağlantı eklendi veya kaldırıldı.
İlişki özniteliğiBir ilişkinin öznitelikleri değişti.

Değişiklikler (Excel), Number, Name, Class, Change Type, Field, Old Value ve New Value içeren “<document> (Changes).xlsx” dosyasını yazar. Değişiklik izli (Word) aynı karşılaştırmayı Word izlenen değişiklikleri olarak yazar.

Belgenin Teslim ▾ → Değişiklikler (Excel)… komutu (Tüm dışa aktarımlar… içinde de) aynı raporu Başlangıç ve Hedef ile dışa aktarır. Temel çizgi yoksa “Bu belgenin temel çizgisi yok. Önce bir tane kaydedin.” iletisiyle başarısız olur.

Belge (Word), Word çıktısının Revision History ve Approvals tablolarını belgenin temel çizgilerinden doldurur.

Temel çizgiler ve sürümler sayfası

Projedeki her temel çizgiyi yönetmek için Denetim ve incelemeler → Temel çizgiler ve sürümler sayfasını kullanın. Proje temel çizgileri her nesneyi tutar; belge temel çizgileri tek bir belgeyi tutar ve belgenin Sürüm ▾ → Temel çizgiyi kaydet… komutuyla oluşturulur. Sayfa başlığında projenin tamamının daha önceki bir otomatik kaydını geri getiren Önceki bir sürümü geri yükle… ve + Temel çizgi kaydet… bulunur.

Bir proje temel çizgisi oluşturmak için:

  1. Sayfa başlığında + Temel çizgi kaydet… düğmesine tıklayın.

    Proje temel çizgisini kaydet iletişim kutusu geçerli nesne ve ilişki sayılarını gösterir. Ad varsayılan olarak “Baseline <n>” olur; yer tutucuda “Ad, örneğin ‘SRR’” yazar.

  2. Bir ad yazın, ardından Enter tuşuna basın veya Temel çizgiyi kaydet düğmesine tıklayın. Boş bir ad reddedilir (“Bir ad girin.”).

    Bildirimde “Temel çizgi kaydedildi” yazar.

Sayfanın kartları:

  • Temel çizgiler kartı: geçerli sayılar (“Geçerli: <n> öğe, <n> ilişki”) ve bir filtre: Tüm temel çizgiler, Proje genelindeki temel çizgiler veya Belge: <name>. Sütunlar:
    • Ad.
    • Belge: belgeyi o temel çizgide görüntüleyen bir bağlantı veya “Proje”.
    • Oluşturulma.
    • Onaylar: “✔” ve onaylayanların adları. Rol, tarih ve beyan için üzerlerine gelin. “<name> tarafından” oluşturanı adlandırır.
    • Nesneler ve İlişkiler.
    • Karşılaştır: bu temel çizgiyi Başlangıç, geçerli çalışma kopyasını Hedef olarak ayarlar.
    • ⋯ (Diğer eylemler):
      • Yeniden adlandır…: Temel çizgiyi yeniden adlandır.
      • Dışa aktar (JSON): “<name>.json” dosyasını indirir (anlık görüntü ve onaylarla birlikte holarch-baseline biçiminde).
      • Temel çizgiyi geri yükle… (proje temel çizgisi): “Tüm geçerli nesneler ve ilişkiler ‘<name>’ temel çizgisiyle değiştirilsin mi? Geri alma kullanılabilir (⌘Z / Ctrl+Z).” Bildirim: “‘<name>’ geri yüklendi”.
      • Belgeyi geri döndür… (belge temel çizgisi): “‘<doc>’ belgesi ‘<name>’ temel çizgisine geri yüklensin mi? Yalnızca o belgenin nesneleri ve yapısı değişir. Geri alma kullanılabilir.” Belge silinmişse devre dışıdır.
      • Sil…. Barındırılan hizmette bir temel çizgiyi yalnızca proje sahipleri yeniden adlandırır veya siler; diğerleri için bu öğeler nedeniyle birlikte gri görünür.
  • Sahipsiz temel çizgiler (gerektiğinde gösterilir): “Silinmiş belgelere ait N temel çizgi”. Her birinde belge artifact'ını ve nesnelerini temel çizgiden yeniden oluşturan Belgeyi geri yükle ve Sil bulunur.
  • Karşılaştır kartı: Başlangıç (eski) ve Hedef (yeni) seçin. Hedef, Geçerli sürüm veya aynı kapsamdaki başka bir temel çizgidir.
    • Kutucuklar: Eklenen nesneler, Kaldırılan nesneler, Değişen nesneler, İlişki değişiklikleri.
    • Tablo Nesne, Değişiklik, Alan ve Fark (sözcük farkı) gösterir. Tarih öznitelikleri uygulamanın tarih biçiminde gösterilir.
    • CSV dışa aktar ve XLSX olarak dışa aktar, “Changes <from> to <to>” yazar.
    • Gösterilecek bir şey yoksa: “‘<from>’ ile ‘<to>’ arasında fark yok.”

Temel çizgi yoksa: “Temel çizgi yok. Projenin geçerli durumunu kaydetmek için bir tane oluşturun.”

Not: Temel çizgiler projede saklanır ve proje dışa aktarmasında projeyle birlikte taşınır. Bir proje temel çizgisi nesneleri ve ilişkileri tutar. Bir belge temel çizgisi belgenin anahat ayarlarını da tutar.

Gereksinimleri içe aktarma

Gereksinimleri dosyalardan almak için İhtiyaçlar ve gereksinimler → İçe ve dışa aktarma sayfasını kullanın. Dört adımda çalışır: Dosya → Eşleme → İnceleme → İçe aktarma.

  • Geri ve Devam adımlar arasında geçiş yapar. İnceleme adımındaki N öğeyi içe aktar içe aktarır ve tek bir Geri al ile hepsi geri alınır.
  • Tek bir bırakma alanı her biçimi kabul eder. Biçim dosyadan (adından ve bu yetmediğinde içeriğinden) algılanır ve değiştirebileceğiniz Biçim altında gösterilir.

Biçimler Word (.docx), Holarch proje dosyaları (.holarch, .json), Excel / CSV (.xlsx, .csv), Düz metin (.txt), UML/SysML (.xmi, .uml, .mdzip) ve ReqIF (.reqif)'tir.

Bu bölüm gereksinim biçimlerini kapsar. Proje dosyaları, XMI ve diğer tüm içe ve dışa aktarmalar için bkz. İçe ve dışa aktarma.

Adım 1: Dosya

Bir dosyayı “Buraya bir dosya bırakın veya seçmek için tıklayın” alanına bırakın ya da kutuya metin yapıştırıp Metni çözümle düğmesine tıklayın (başlık satırlı CSV, ReqIF XML, XMI, JSON veya belge metni).

SeçenekDeğerlerEtki
BiçimYukarıdaki altı biçimAlgılanan biçimi gösterir. Aynı içeriği başka bir şekilde okumak için başka bir biçim seçin.
Metin kodlaması (CSV, metin)Otomatik, UTF-8, ISO-8859-1 / Windows-1252, Shift_JIS, Big5, UTF-16Dosyanın baytlarının nasıl okunduğu. Değiştirmek dosyayı yeniden okur.
Sayfa (çalışma kitapları)“<name> (N satır)”İçe aktarılacak sayfa. Veri içeren ilk sayfa önceden seçilidir.
  • Düz metin: kutu içe aktarılan içeriği düzenlenebilir tutar. Düzenleyin ve Analizi yeniden çalıştır düğmesine tıklayın.
  • Durum satırında “‘<file>’ çözümlendi: N satır, M sütun.” yazar (ayrıca “(‘<name>’ sayfası)” ve Word için “, N tablo”).

Adım 2: Eşleme

Her dosya sütunu bir satırdır: Dosya sütunu (başlık ve konum), Örnek değerler (ilk üç satır) ve Holarch alanı. Bir sütunu dışarıda bırakmak için Atla seçin. Sütun başlığından eşleştirilen alanlar otomatik ile işaretlenir.

Holarch alanıİçerik
Ad, Numara, AçıklamaÖğenin kendi alanları.
Sınıf, EtiketlerSınıf adı; ; , veya | ile ayrılmış etiket adları.
Üst numara, Genel kimlikÜst öğenin numarası; mevcut nesneleri eşleştirmek için kullanılan kimlik.
Bir öznitelikSınıfı olmayan satırlar için sınıfın herhangi bir özniteliği.
Bir ilişkiBirkaç hedefi ; ile ayırın.
Satır kimliği, Üst satır kimliği, Yeni öznitelik (şemaya eklendi)ReqIF ve XMI dosyalarından gelen yapı ve yeni öznitelikler.

✦ YZ ▾ → Eşleme öner her sütun için bir alan önerir. Önerilen eşleme değişiklikleri YZ'nin gerekçesiyle, işaretli olarak listeler; İşaretlileri uygula eşlemeyi değiştirir. Henüz hiçbir şey içe aktarılmaz.

Holarch eşlemeyi başlıktan tahmin eder:

BaşlıkEşlendiği alan
Number, No, Num, #, ID Number, Req Number, Requirement NumberNumara
Name, Title, Short Name, Requirement NameAd
Description, Text, Requirement, Requirement Text, Statement, DescAçıklama
Class, Type, Entity ClassSınıf
Labels, Label, TagsEtiketler (değerleri ; , veya | ile ayırın)
Parent, Parent NumberÜst numara
Global ID, ID, GUID, UUIDGenel kimlik
Bir öznitelik adı (örneğin Priority, Rationale, Status)O öznitelik. “Method” ve “Verification”, Verification Method ile eşlenir.
Bir etiket grubu adı (örneğin böyle bir öznitelik olmadığında Verification Method)Etiketler
Bir ilişki adı (örneğin satisfied by)O ilişki; birkaç hedefi ; ile ayırın
Object Identifier, Origin IDGenel kimlik
Object Number, ReqIF.ChapterName, ReqIF.ForeignIDNumara
Object Heading, ReqIF.Name, Long NameAd
Object Text, ReqIF.Text, ReqIF.DescriptionAçıklama
ReqIF.CategorySınıf
ReqIF ID, XMI ID, Row ID / Parent IDSatır kimliği / Üst satır kimliği

Yeni öznitelik, içe aktarılan her sınıfta sütunun adını taşıyan bir öznitelik oluşturur. Türü değerlere göre belirlenir:

  • Her değer bir sayıysa Sayı.
  • Az sayıda kısa ve farklı değer varsa bir seçenek listesi.
  • 120 karakteri aşan değerler için Uzun metin.
  • Aksi halde Metin.

Kalite ölçütleri, hesaplanan öznitelikler ve dosya öznitelikleri eşlenemez.

Sütunların altında:

SeçenekDeğerlerEtki
Sınıfı olmayan satırlar için sınıfHerhangi bir sınıf; varsayılan RequirementClass sütununda değeri olmayan ve eşleşen sınıf kuralı olmayan satırların sınıfı.
Sınıf kurallarıAçıklama şunu içerir bir sözcük veya öbek → bir sınıf+ Kural bir kural ekler, × onu kaldırır. Class değeri olmayan satırlara eşleşen ilk kural uygulanır.
Mevcut nesneleri şuna göre eşleştirGenel kimlik, Ad, NumaraMevcut bir nesneyle eşleşen satırlar kopya oluşturmak yerine onu günceller. Ad ve Numara eşleşmeleri aynı sınıfı da gerektirir.
İlgili nesneleri şuna göre eşleştirGenel kimlik, Ad, Numaraİlişki sütunlarındaki değerlerin hedeflerini nasıl bulduğu.
Tarih sütunlarının tarih biçimi (CSV)Otomatik, yyyy-MM-dd HH:mm:ss, dd/MM/yyyy, MM/dd/yyyy, yyyyMMdd, Özel…Tarih hücrelerinin nasıl okunduğu. Özel…, yyyy, MM, dd, HH, mm ve ss kullanarak kendi deseniniz için bir alan gösterir (örneğin dd.MM.yyyy HH:mm).
Numaralandırma deseni (Word, metin)Boş (otomatik) veya 1. a) (i) gibi işaretler ya da 1.1 veya 1.1.a gibi yol numaralarıNumaralı paragrafların nasıl anahat olduğu. Metin için desen numaralandırmadan algılanır ve doldurulur. Word başlık stilleri ve liste numaralandırması desen gerektirmez. Bkz. Numaralandırma deseni.
Alt öğeleri üst öğelerinin altında numaralandır (1 → 1.1) (Word, metin)Varsayılan olarak açıkOluşturulan alt öğe numaraları “1”, “2” yerine “3.1”, “3.2” olur.

Hiyerarşi. Anahat numaraları hiyerarşiyi yeniden kurar: “1.2.3”, “1.2” öğesinin alt öğesi olur. Bir Üst numara sütunu veya bir Satır kimliği ve Üst satır kimliği çifti üst öğeyi açıkça ayarlar. Üst öğesi olmayan öğeler belgenin üst düzey öğeleri olur.

Word tabloları. Bir Word dosyası için Word tabloları bölümü her tabloyu listeler. Bölümler boyunca aynı başlıkla yinelenen tablolar tek bir eşlemeyi paylaşır. Bölüm şunu açıklar: “Bir gereksinim tablosunu her satıra bir nesne olacak şekilde nesneler olarak içe aktarın ve sütunlarını eşleyin. Diğer tablolar, izledikleri öğenin açıklamasında tablo olarak kalır.”

  • Her tabloyu Nesneler (her satıra bir tane) veya Açıklamadaki tablo olarak ayarlayın.
  • Sütunlarını Numara, Ad, Açıklama, Sınıf, Etiketler, Öznitelik, Yeni öznitelik veya Atla ile eşleyin.
  • ID, Req ID, Requirement ID, Ref veya Paragraph gibi başlıklar Numara ile eşlenir.
  • Shall, Shall Statement, Requirement Statement, Requirement Text, Statement veya Text, Açıklama ile eşlenir.

Numara veya açıklama sütunu ve “shall” satırları olan bir tablo nesneler olarak başlar.

Şimdiye kadar bulunan uyarılar sütunların altında veya “Uyarı yok.” olarak görünür.

Adım 3: İnceleme

Herhangi bir şey değişmeden önce sonucu denetleyin. İnceleme, değişiklikleri Temel çizgiler ve sürümler sayfasının sürümleri karşılaştırdığı şekilde gösterir (bkz. Temel çizgiler ve sürüm karşılaştırması):

  • İlk satır dosyayı, biçimi ve sınıf başına öğe sayısını adlandırır.
  • Her öğe bir Statement veya Requirement (ya da bir alt sınıfı) olduğunda Bu N gereksinimden bir gereksinim belgesi oluştur işaretli olarak görünür. Diğer dosyalar için işaretsiz Bu N öğeden bir belge oluştur yazar. İşaretliyken Belge türü (varsayılan Requirements Document), Ad (varsayılan: dosya adı) ve İçe aktarmadan sonra tüm belgeyi yeniden numaralandır seçeneklerini belirleyin.
  • Uyarılar ardından gelir.
  • Kutucuklar Yeni öğeler, Güncellenen öğeler, Eşleştirildi, değişmedi öğeleri ve Dosyadaki ilişkiler sayılarını verir.
  • Değişiklik tablosu her yeni öğeyi açıklamasıyla ve güncellenen bir öğenin değişen her alanını eski ve yeni değerin sözcük farkıyla listeler (ilk 500 değişiklik).

N öğeyi içe aktar düğmesine tıklayın. Bildirimde “N yeni, M güncellenen içe aktarıldı” yazar.

  • Uyarı yoksa Holarch yeni gereksinim belgesini (veya Veritabanını) açar.
  • Aksi halde İçe aktarma tamamlandı kartı uyarıları listeler (sorun yoksa “İçe aktarma hiçbir uyarı bildirmedi.”). Düğmeleri Belgeyi aç, Veritabanını aç, Spider Diyagramı, Ağaç Diyagramı, Kaliteyi denetle ve Başka bir içe aktarma başlat'tır.

Yeni belgenin açıklaması içe aktarma uyarılarını listeler.

Her biçimin nasıl okunduğu

Word (.docx):

  • Başlıklar ve Word liste numaralandırması anahat olur ve numaralarını korur.
  • Bir başlık bir Statement olur. Altındaki gövde metni onun açıklaması olur.
  • shall, must, will veya should içeren bir paragraf, kip fiilinden sonraki sözcüklerden adlandırılan bir alt Requirement olur. Numaralı bir liste öğesi de öyle olur; kip fiili yoksa bir Statement olur.
  • Madde işaretli öğeler, resimler ve tablolar, kalın, italik, listeler ve tablolar korunarak izledikleri öğenin açıklamasına katılır.
  • Özgün .docx, dosya başına ek dosya sınırı içindeyse yeni belgeye eklenir.
  • PNG, JPEG, GIF, WebP ve SVG resimleri korunur. Diğer resim biçimleri bir uyarıyla atlanır.

Excel (.xlsx, .xlsm) ve CSV:

  • Nesne başına bir satır, herhangi bir sütun. İlk satır başlıktır.
  • Çok satırlı hücreler satır sonlarını korur.
  • Excel 97-2003 (.xls) dosyaları okunmaz. Önce .xlsx veya .csv olarak kaydedin.

ReqIF (.reqif, .reqifz):

  • Her SPEC-OBJECT, ReqIF ID, Parent ID (belirtim hiyerarşisinden), Type (Class ile eşlenen nesne türü), Long Name ve öznitelik tanımı başına bir sütun içeren bir satır olur.
  • Eşleşmeyen sütunlar varsayılan olarak Yeni öznitelik olur. XHTML öznitelikleri zengin metin öznitelikleri, numaralandırma öznitelikleri seçenek listeleri olur.
  • SPEC-RELATION'lar ada göre ilişki olur. Ad şemanın izin verdiği bir ilişkiyle eşleşmediğinde traced to olur.
  • Bir .reqifz arşivi otomatik olarak açılır.

Düz metin (.txt) veya yapıştırılan metin:

  • Numaralı bir satır (“3.1 Battery”) veya noktasız kısa bir satır bir başlık (Statement) olur.
  • shall, must, will veya should içeren her cümle, geçerli başlığın altında bir Requirement olur.
  • Diğer metinler önceki öğenin açıklamasına katılır.
  • Bir numaralandırma deseniyle (metinden algılanan veya yazılan) düzeyleri desen belirler.

Gereksinimleri bir elektronik tablodan güncelleme

Birçok gereksinimi bir elektronik tabloda aynı anda değiştirmek için bunu kullanın.

  1. Veritabanında (veya Gereksinimler sayfasında) Dışa aktar… düğmesine tıklayın ve Tablo (CSV) seçin.
  2. Düzenlenecek öznitelikleri işaretleyin. Dahil et altında Kimlik seçeneğini işaretleyin, ardından Dışa aktar düğmesine tıklayın.
  3. Değerleri elektronik tabloda düzenleyin. Kimlik sütununu değiştirmeyin.
  4. Dosyayı içe aktarın. Eşle adımında Kimlik sütununun Genel kimlik ile eşlendiğini denetleyin ve Mevcut nesneleri şuna göre eşleştir değerini Genel kimlik yapın.
  5. İnceleme adımında Bir belge oluştur… seçeneğinin işaretini kaldırın.

    Eşleşen satırlar, değişen her alan listelenerek Güncellenen öğeler olarak sayılır.

  6. N öğeyi içe aktar düğmesine tıklayın.

Bu sürümden önce dışa aktarılmış bir dosyadaki I_… değeri eşleşmez; Kimlik sütununu kullanın. Her adım ve seçenek için bkz. İçe ve dışa aktarma.

Bir güncellemenin yazdıkları:

  • Yalnızca eşlenen sütunlar. Eksik bir Description sütunu mevcut her açıklamayı korur.
  • Dosyadaki etiketler mevcut etiketlere eklenir.
  • Class sütunu yoksa Genel kimlik ile eşleşen bir satır nesnesinin sınıfını korur.

İçe aktarma iletileri

İletiAnlamı ve düzeltme
Hiçbir sütun Ad veya Numara ile eşlenmedi. Bunlardan birini eşleyin.En az bir sütunu Ad veya Numara ile eşleyin.
Satır N: bilinmeyen sınıf “X”, <class> kullanılıyor.Class değeri hiçbir sınıfla eşleşmiyor. Değeri düzeltin veya sütunu Atla ile eşleyin.
Satır N: bilinmeyen etiket “X” yok sayıldı.Önce etiketi şemada oluşturun veya değeri düzeltin.
Satır N: “<attribute>”, <class> sınıfına uygulanmıyor.Satırın sınıfında bu öznitelik yok.
Satır N: “<value>”, “<attribute>” için geçerli bir <type> değil.Değer bir sayı, tarih, seçenek vb. olarak okunamıyor. Tarih biçimi seçeneğini denetleyin.
Satır N: Ad 255 karakterden uzun ve kısaltıldı. / Satır N: Numara 255 karakterden uzun ve kısaltıldı.Adlar ve numaralar 255 karakterle sınırlıdır.
Yinelenen numara X (A ve B satırları).İki satır aynı numarayı paylaşıyor; hiyerarşi alt öğeleri ilkine ekleyebilir.
Satır N: X için üst numara P yok; Q altına eklendi. / …; üst düzeyde içe aktarıldı.Doğrudan üst numara dosyada yok.
Satır N: üst numara P bulunamadı. / Satır N: üst öğe P bulunamadı.Parent Number veya Parent Row ID, dosyada olmayan bir satırı gösteriyor.
Satır N: “<relationship>” hedefi “X” bulunamadı.İlişki sütunu var olmayan bir nesneyi adlandırıyor. İlgili nesneleri şuna göre eşleştir ayarını denetleyin.
Satır N: A'dan B'ye “<relationship>” şema tarafından izin verilmiyor (yine de oluşturuldu).Bağlantı, şema onu listelemese de oluşturuldu.
A ile B arasındaki “X” ilişkisine şema izin vermiyor; atlandı.Bir ReqIF veya XMI ilişkisi traced to olarak bile oluşturulamadı.
X resmi: .ext resimler desteklenmiyor ve atlandı. Resmi korumak için Word'de PNG veya JPEG olarak kaydedin.Desteklenmeyen biçimde bir Word resmi.
X resmi (boyut), <limit> ek sınırını aşıyor ve atlandı.Resim dosya başına sınırdan büyük.
Veri satırı bulunamadı.Dosyada veya sayfada yalnızca bir başlık var ya da boş.
Dosya okunamadı: Excel 97-2003 (.xls) dosyaları desteklenmiyor. Excel'de dosyayı .xlsx veya .csv olarak kaydedin, ardından yeniden içe aktarınDosyayı dönüştürün.
Dosya okunamadı: DOCTYPE veya ENTITY bildirimi içeren XML kabul edilmiyor. Dosyayı bildirim olmadan kaydedin ve yeniden içe aktarınBildirimi ReqIF veya XML dosyasından kaldırın.
Dosya okunamadı: geçersiz XMLReqIF dosyası iyi biçimlendirilmiş bir XML değil.
İçe aktarma başarısız: <reason>İçe aktarma durdu; hiçbir şey değiştirilmedi.

Gereksinim kısayolları

TuşlarYerEylem
EnterBelgede hızlı girişYazılan gereksinimi ekler.
⌘ / Ctrl+Enter / ⌥ / Alt+⌘ / Ctrl+EnterBelge, öğe seçiliBir kardeş / bir alt öğe ekler.
Enter veya SpaceKalite, TBD/TBR ve İncelenecek bağlantılar satırlarıSatırın gereksinimini veya incelenecek öğesini özellik panelinde gösterir.
↑ / ↓Aynı satırlar, satıra odaklanılmışÖnceki veya sonraki satıra geçer.
⌘ / Ctrl-tıklama, ⇧ / Shift-tıklama, ⌘ / Ctrl+⇧ / Shift-tıklamaKalite, TBD/TBR ve İncelenecek bağlantılar satırları; Veritabanı satırları; belge öğeleriBir satırı seçer veya seçimini kaldırır, son tıklanan satırdan itibaren aralığı seçer, o aralığı ekler.
⌘A / Ctrl+A, ⇧ / Shift+↑ / ⇧ / Shift+↓Aynı satırlar, satıra odaklanılmışGösterilen her satırı seçer; seçimi odaklanılan satırdan genişletir.
Sağ tıklama, Shift+F10 veya Menü tuşuGereksinimler, Kalite, TBD/TBR ve İncelenecek bağlantılar satırları; belge öğeleri ve Anahat girişleriSatırın menüsünü açar: önce nedenleriyle önerilen eylemler ve ✦ Daha fazla YZ ▸, ardından öğenin komutları.
EscKalite, TBD/TBR, İncelenecek bağlantılar, RVTMSatırın seçimini kaldırır.
EnterTemel çizgiler ve sürümler ad alanıProje temel çizgisini oluşturur.
⌘Z / Ctrl+ZHer yerdeBir içe aktarmanın tamamı, bağlantıları incelendi olarak işaretleme veya bir durum değişikliği dahil son değişikliği geri alır.

Uygulamadaki her kısayol için bkz. Klavye kısayolları.

Ayarlar

AyarYerVarsayılanKapsam
Metin değiştiğinde otomatik olarak yeniden denetleKalite sayfası kapsam çubuğuKapalıBu tarayıcı
Özellik paneli gruplarının katlanmış veya açık olması (Kalite ve diğerleri)Özellik panelinde bir grubun başlığına veya bağlantılarının sonundaki Tümünü daralt / Tümünü genişlet düğmesine tıklayınKalite katlanmış, diğerleri açıkBu tarayıcı, sınıf başına
Onaylarda, kararlarda ve yorumlarda adınızHesap adınız—Hesap
İzleme Durumu (gereksinimlerdeki noktalar)Belgenin Görünüm ▾ menüsüÜzerindeBelge

İletiler

İletiYerAnlamı
N gereksinim denetlendiKaliteDenetim kapsam üzerinde çalıştı.
Bu kapsamda gereksinim yok.KaliteKapsamda gereksinim yok.
Bu belgede denetlenecek Requirement yok. Statement'lar puanlanmaz.Belgede Kaliteyi denetleÖğeleri Requirement olarak değiştirin veya başka bir belgeyi denetleyin.
Eski — yeniden çalıştır / Güncel değil / Kalite: eski — yeniden çalıştırKalite, belgeler, özellik paneliMetin son denetimden sonra değişti.
İnceleyenin değerlendirmesi gerekirKalite (Correct, Feasible)Bir kişinin karar vermesi gerekir; Evet olarak işaretlemek için ✘ simgesine tıklayın.
Elle Hayır olarak işaretlendi.KaliteBir inceleyen ölçütü Hayır olarak ayarladı.
N onaylanmış gereksinim In Review durumuna taşındı; N bağlantı inceleme için işaretlendi.Bir düzenlemeden sonraDüzenleme onayları yeniden açtı ve bağlantıları inceleme için işaretledi.
Onaylandı / Reddedildi / In Review durumuna taşındıOnay kutusuKarar kaydedildi.
N bağlantı incelendi olarak işaretlendi.İncelenecek bağlantılarİncelemeler kaydedildi.
Önce incelendi olarak işaretlenecek bağlantıları seçin.İncelenecek bağlantılarSeçilenleri incelendi olarak işaretle… öncesinde satırları işaretleyin.
Kapatıldı / Öznitelik kapatıldı; metin hâlâ TBD içeriyor.TBD/TBRÖznitelik None yapıldı.
Metin hâlâ TBD içeriyor. Kapatmak için metni düzenleyin.TBD/TBRYalnızca metinden gelen bir öğe kapatılırken gösterilir.
Temel çizgi kaydedildiBelgeler, Temel çizgiler ve sürümlerAnlık görüntü kaydedildi.
Bu belgenin temel çizgisi yok. Önce bir tane kaydedin.Geçerli sürümle karşılaştır, değişiklik raporlarıBelgenin temel çizgisi yok.
“<name>” sürümüne geri döndürüldü / “<name>” geri yüklendiTemel çizgilerBelge veya proje geri alındı; geri alma kullanılabilir.
İncelenecek gereksinim yok. Önce gereksinimleri seçin veya açın.YZ gereksinim denetimiKapsamda gereksinim yok.

Sınırlar

  • Kaliteyi denetle: kapsamdaki her gereksinim yinelemeler için diğerleriyle karşılaştırılır (%75 benzerlik eşiği).
  • YZ gereksinim denetimi: YZ isteği başına 20 gereksinim, bağlam olarak en fazla 300 başka gereksinimle.
  • Bağlantı inceleme farkı eski adın ilk 500 karakterini ve eski açıklamanın ilk 4.000 karakterini tutar.
  • TBD/TBR azalma grafiği: en fazla 60 nokta.
  • İçe aktarma:
    • En fazla 255 karakterlik adlar ve numaralar.
    • Önizleme ilk 500 satırı gösterir. İlk 50 uyarı listelenir (“…ve N tane daha”).
    • Bir numaralandırma deseni en fazla 6 düzey içerir (“Numaralandırma deseninde 6'dan fazla düzey var. En fazla 6 işaret kullanın.”).
    • 100 milyon karaktere ve 3.000.000 öğeye kadar ReqIF/XML dosyaları.
    • 10.000 girişe, giriş başına 300 MB'a ve toplamda 600 MB'a kadar .reqifz ve .docx arşivleri.
    • Resimler ve özgün Word dosyası yalnızca dosya başına ek sınırı içinde saklanır (Free planında 10 MB, Individual'da 25 MB, Team'de 100 MB).