SAP CPI Adlandırma Standartları: Ekibinizin Uygulayabileceği Bir Kural Paketi

SAP Cloud Integration (SAP CPI) ekiplerinin çoğunun adlandırma standartları vardır. Her iFlow'un uyduğu standartlara sahip olanlar ise daha azdır, çünkü kurallar bir wiki sayfasında durur ve kimse bir transport öncesinde bir Content Modifier'ın adını kontrol etmez.

Bu makale adımlar, kanallar, özellikler ve adresler için bir başlangıç standardı öneriyor, bunu bir aracın kontrol edebileceği kurallar olarak nasıl yazacağınızı ve bir ekibin onu nasıl paylaşıp uygulayabileceğini gösteriyor.

SAP CPI'da adlar neden önemlidir

Bir şey bozulduğunda gördüğünüz şey adımın adıdır. İzleyici başarısız adımı adıyla bildirir, “sipariş ID'sini ayarlayan adım” araması onu ancak ad bunu söylüyorsa bulur ve bir tasarım belgesi ya da devir teslim diyagramın etiketleri gibi okunur. “Content Modifier 3” hiçbir şey söylemez; CM_SetOrderHeaders ne yaptığını söyler.

Tutarlı adlar iki iFlow'u karşılaştırılabilir de kılar: standardı bilen bir inceleyici, ekibin herhangi bir iFlow'unu bir bakışta okuyabilir.

Bir başlangıç standardı

Adım türü için bir önek, ardından PascalCase ile ne yaptığı çoğu ekip için yeterlidir. Bu, Kitegra ile birlikte gelen pakettir; uyarlanacak bir başlangıç noktasıdır, bir SAP standardı değildir:

Standardı kurallar olarak yazın

Bir aracın kontrol edebileceği bir standart, her öğe türü için bir tane olmak üzere kurallardan oluşan bir listedir. Sabit metin tam olarak eşleşmelidir; <Placeholder> herhangi bir metni temsil eder; <PascalCase>, <camelCase>, <UPPER>, <lower> ve <Number> o biçimdeki metni temsil eder. Her türün ilk kuralı uygulanır ve her kuralın bir önem derecesi vardır: Hata, Uyarı veya Bilgi.

Kitegra'da kurallar bir JSON kural paketidir. Bir alıntı:

{
  "rules": [
    {
      "id": "content-modifier",
      "target": "content-modifier",
      "pattern": "CM_<Action>",
      "example": "CM_SetOrderHeaders",
      "notes": "Content Modifier: CM_ and what it sets.",
      "severity": "warning",
      "enabled": true
    },
    {
      "id": "mapping",
      "target": "mapping",
      "pattern": "MM_<Source>_to_<Target>",
      "example": "MM_Order_to_SalesOrder",
      "notes": "Message Mapping: source and target message.",
      "severity": "info",
      "enabled": true
    },
    {
      "id": "property",
      "target": "property",
      "pattern": "<camelCase>",
      "example": "orderId",
      "notes": "Exchange property names in camelCase.",
      "severity": "info",
      "enabled": true
    }
  ]
}

Ekip olarak üzerinde anlaşın

1. Uzantının seçenekler sayfasını açın ve Adlandırma kuralları'nı bulun. Varsayılan paketle başlar.
2. Bir kuralın Desen, Önem veya Notlar alanını değiştirin, “Kural açık” ile bir kuralı kapatın ya da “Kural ekle”yi seçip Denetler alanında neyi denetleyeceğini belirleyin.
3. “JSON dışa aktar”ı seçin ve dosyayı ekibin standartlarını tuttuğu yere, transport yönergelerinin yanına koyun.
4. Her ekip arkadaşı bu dosyayla “JSON içe aktar”ı seçer. Kitegra ile oturum açtıklarında paket onları her bilgisayara takip eder.

Eşitleme, bir kişinin paketini tüm bilgisayarlarında aynı tutar; ekibi aynı kurallarda tutan ise paylaşılan JSON dosyasıdır.

Bir iFlow'u kurallara göre kontrol edin

iFlow'u açın, “Kitegra araçları” düğmesine tıklayın ve Denetçi'yi seçin (veya Alt+Shift+K'ye basın). Adlandırma sekmesi kurallara uymayan her adı, sayısı düğmede görünecek şekilde listeler: gerçek ad, Beklenen, bir Örnek ve adımın içeriği izin verdiğinde adımın yaptığı işten oluşturulan Önerilen ad. Bir bulguya tıklamak adımı diyagramda seçer.

Düzenleme modunda Yeniden adlandır, önerilen adı adımın Name alanına yazar. Asla kaydetmez: panel “Yeniden adlandırıldı. Korumak için iFlow'u kaydedin.” der ve kararı siz verirsiniz.

Aynı bulgular, iFlow inceleme kontrol listesinin gösterdiği gibi iFlow raporunda tasarım kontrollerinin yanında görünür ve iyi adlar oluşturulan bir tasarım belgesinin iyi okunmasını sağlar.

Kitegra nasıl yardımcı olur

Adlandırma, Kitegra uzantısındaki iFlow Inspector'ın bir parçasıdır. Kontrol, iFlow'un modelini tarayıcınızda okur; kural paketiniz oturum açtığınızda Kitegra hesabınızla eşitlenir ve iFlow'un içeriği asla gönderilmez.

Helper, Message Monitor, iFlow Inspector ve iFlow Docs, kullandığınız iFlow'ları her biri ayrı sayar: Kitegra hesabı olmadan modül başına 5, Free planında 50, Starter'da 100 ve Pro'da 300; Business'ta sınır yoktur. Toolbox ve çalışma alanı ekstraları ücretsizdir. Planları karşılaştırın.

Bir sonraki iFlow'unuzda deneyin

Kitegra'ın SAP Integration Suite tasarımcısının çevresine neler eklediğini okuyun veya onu Kitegra'in diğer Chrome uzantılarıyla birlikte görün.

Sık sorulan sorular