RESOURCE CENTER / Makaleler

SAP Pazarlama Entegrasyonlarınızı Nasıl Genişletebilirsiniz?

SAP Pazarlama Entegrasyonlarınızı SAP Cloud Platform Entegrasyonunda Çıkış Sonrası ile Nasıl Genişletebilirsiniz? (Bölüm-2)

Bu blog, bu blogunBu yüzden, özellikle bu blogda kullandığımız notasyonların (Mesaj A, Mesaj B, vb.) anlamlarını bilmiyorsanız, buna devam etmeden önce okumanızı şiddetle tavsiye ederim. Önceki blog hepsini açıklıyor.

Bu bölüm yalnızca yapılandırma etkinliklerine odaklanacaktır.

Yapılandırma Faaliyetleri

1. “SAP Pazarlama ile Müşteri Entegrasyonu için SAP Cloud” Entegrasyon Paketinin Hazırlanması

Kimlik bilgilerinizle SAP Cloud Platform Integration (CPI)’da oturum açmanız gerekir. “Keşfet” sayfasına gitmeniz ve “SAP Pazarlama ile Müşteri Entegrasyonu için SAP Cloud” entegrasyon paketini bulmanız gerekir.

Kopyaladıktan sonra, kopyanız CPI alanınızın “Tasarım” sekmesinde mevcut olacaktır. Bu faaliyetler zaten standart entegrasyon paketinin belgelerinde burada açıklanmıştır. Dağıtımınıza bağlı olarak “CPI aracılığıyla SAP Pazarlama ile Entegrasyon” veya “CPI aracılığıyla SAP Marketing Cloud ile Entegrasyon” belgelerini okumanız gerekir.

Kopyalanan paketi “Tasarım” sekmesinde kontrol ettiğinizde, “Eserler” sekmesi listesinde “İş Ortağını SAP Pazarlamaya Çoğalt” entegrasyon akışımızı görebilirsiniz (Şekil 1.5)

Replicate Business Partners to SAP Marketing integration flow

Şekil 1.5: İş Ortaklarını SAP Pazarlama entegrasyon akışına çoğaltma

Standart entegrasyon paketinin belgelerindeki talimatları izleyerek entegrasyon akışını yapılandırmanız gerekir.

Entegrasyon akışının konfigürasyonu sırasında konumuzla ilgili iki noktaya dikkat etmeniz gerekir:

– Entegrasyon akışı yapılandırmasında “Extension Implemented” öğesini “true” olarak ayarlamanız gerekir. (Şekil 1.6)

Bunu yapmak için, “Diğer” sekmesine gidin ve “Uzantı Uygulandı” adlı parametre için “true” (tümü küçük harf) yazın. Bu, bir uzatma senaryomuz olduğunu ve standart entegrasyon akışının oluşturacağımız çıkış sonrası akışımızı çağırması gerektiğini gösterir..

–Şekil 1.6: “Uzantı Uygulandı” parametresi

– Çıkış sonrası akışımızın adresini not etmeniz gerekir çünkü çıkış sonrası akışımızın tasarımı sırasında gerçekten önemli olacaktır.

Çıkış Sonrası referans adresini bulmak için, “Alıcı” sekmesine gitmeniz ve “Alıcı” parametresi için açılır listeden “Muhatap Çoğaltma Sonrası Çıkış” ı seçmeniz gerekir. Adres, Şekil 1.7’deki gibi görünmelidir.

Şekil 1.7: Çıkış Sonrası Akışın Adresi

“İş Ortağını SAP Pazarlamaya Çoğalt” için diğer yapılandırmaları tamamladıktan sonra, yalnızca ayarlarınızı kaydetmeniz gerekir.

Şu andan itibaren standart entegrasyon akışı konusunda yapmamız gereken hiçbir şey yok. Şimdi Çıkış Sonrası akışımızı tasarlamaya başlıyoruz.

2. Çıkış Sonrası Akışı Tasarlama

Çıkış Sonrası akışımızı tasarlamak için entegrasyon paketimizde bir entegrasyon akışı oluşturmamız gerekiyor. Çıkış Sonrası konseptinin düzgün çalışması için, standart entegrasyon akışınızın Çıkış Sonrası akışınızla aynı CPI kiracısında olması gerekir. Çıkış Sonrası entegrasyon akışımızı standart entegrasyon akışımızla aynı entegrasyon paketinde oluşturacağız, bu nedenle bu ön koşul zaten yerine getirilmiş olacak.

Çıkış Sonrası akışımızı oluşturmak için aşağıdaki ekran görüntülerini takip edebilirsiniz (Şekil 1.8 – 1.10)

Editing standard integration package — Şekil 1.8: Standart entegrasyon paketini düzenleme

Creating Post-Exit Integration Flow — Şekil 1.9: Çıkış Sonrası Entegrasyon Akışı Oluşturma

Normalde orijinal standart entegrasyon akışıyla aynı adı veriyorum ve son olarak “Çıkış Sonrası” ekliyorum. Bu şekilde çıkış sonrası akışımız, entegrasyon paketimizdeki “Yapılar” sekmesindeki orjinal standart entegrasyon akışının hemen ardından listelenir. Bu ad alanı modeline sadık kalırsanız, Çıkış Sonrası akışlarınızı kolayca tespit edebilirsiniz.

Alan	Açıklama	Değer
İsim	Orijinal entegrasyon akışınız ile aynı adı seçebilir ve sonuna “Çıkış Sonrası” ekini sağlayabilirsiniz.	İş Ortağını SAP Pazarlama Sonrası Çıkışa Çoğaltın
ID	Ada göre otomatik olarak doldurulmalıdır.	–
Ürün Profili	Değiştirmeyin.	–
Açıklama	Çıkış Sonrası akışınızın açıklaması. Çıkış Sonrası akış amacınızı açıklamak için buraya istediğiniz herhangi bir şeyi yazabilirsiniz.	SAP Marketing’e İş Ortağı Replikasyonu Sonrasında Çıkış Sonrası

Maintaining information for your Post-Exit Flow — Şekil 1.10: Çıkış Sonrası Akışınız için bilgileri koruma

Son olarak, Çıkış Sonrası entegrasyon akışınızı kaydetmek için “Tamam” ı tıklayın.

2.1. Süreç Adaptörünü ve Mesaj Eşleştirmeyi Tanımlama

Şimdi, önceki blogda Şekil 1.2’de gösterildiği gibi bir entegrasyon akışı tasarlayacağız.

“Process Direct” adaptörüyle başlayalım. Talimatlar için aşağıdaki ekran görüntülerini takip edebilirsiniz (Şekil 1.11 – 1.14).

Sol şerit menüsünden “Bağlayıcılar” ı seçin ve “Gönderen” kutusuna tıklayın sonrasında sürükle ve bırak ile “Başlat” simgesine bir çizgi çizin.

Connect “Sender” to “Start” by drag6drop — Figure 1.11: ”Gönderen” i sürükleyerek “Başlat” a bağlayın

Selecting ProcessDirect as “Adapter Type” — Şekil 1.12: ProcessDirect’i “Adaptör Türü” olarak seçme

Now, here’s something very important. On the “Connection” tab, for the “Address” field, you need to type down the exact address you noted in Figure 1.7

Defining address for Process Direct adapter — Şekil 1.13: Process Direct adaptörü için adres tanımlama

Çıkış Sonrası akışı yapılandırırken bu adresi de koruyabilmeniz için isteğe bağlı olarak bu parametreyi harici hale getirebilirsiniz.

Externalizing address parameter — Şekil 1.14: Adres parametresini haricileştirme

Şimdi kendi haritalamamız için bir mesaj haritası oluşturmamız gerekiyor. Talimatlar için aşağıdaki ekran görüntülerini takip edebilirsiniz. (Şekil 1.15 – 1.19)

Defining mapping – 1 — Şekil 1.15: Eşlemeyi tanımlama – 1

Defining mapping – 2 — Şekil 1.16: Eşlemeyi tanımlama – 2

Defining mapping – 3 — Şekil 1.17: Eşlemeyi tanımlama – 3

Naming your mapping — Şekil 1.18 Eşlemenize ad verme

Defining mapping -4 — Şekil 1.19: Eşlemeyi tanımlama -4

Çıkış Sonrası akışımıza gerekli unsurları ekledik. Şimdi kendi haritalamamızı gerçekleştirmek için mesajlara (Mesaj A, Mesaj B ve Mesaj C) ihtiyacımız var.

2.2. C4C SOAP Hizmetinin Genişletilmiş Meta Verilerini Alma (Mesaj A)

Özel alanın (ZZMKTS4ID) oluşturulması ve SAP C4C’de ilgili web hizmetleri için etkinleştirilmesi bu blogun bir parçası değildir. Bu yönetim faaliyetleri normalde C4C danışmanları tarafından yapılır.

SOAP hizmetinin (özel alanımız dahil) genişletilmiş meta verilerini indirmek için kimlik bilgilerinizle SAP C4C’de oturum açın. Entegrasyon senaryonuz için ilgili iletişim düzenlemesini bulmanız ve buradan WSDL’yi indirmeniz gerekir. Senaryomuz için, iletişim düzenlemesi, pazarlama iletişimi ortağı için “SAP Business Suite’e İş Ortağı Replikasyonu” şeklindedir.

Talimatlar için aşağıdaki ekran görüntülerini takip edebilirsiniz (Şekil 1.20 – 1.22)

Finding relevant communication arrangement – 1 — Şekil 1.20: İlgili iletişim düzenlemesini bulma – 1

Finding relevant communication arrangement – 2 — Şekil 1.21: İlgili iletişim düzenlemesini bulma – 2

Downloading WSDL for the SOAP service — Şekil 1.22: SOAP hizmeti için WSDL’yi indirme

İndirdikten sonra isteğe bağlı olarak WSDL dosyanızı yeniden adlandırabilirsiniz.

2.3. SAP Marketing OData Service’in Standart Meta Verilerini Alma (Mesaj B)

Bu nispeten daha kolaydır çünkü standart entegrasyon akışında zaten mevcuttur. Hangi şemayı indirmeniz gerektiğini belirledikten sonra, “İş Ortağını SAP Pazarlamaya Kopyala” entegrasyon akışının “Kaynaklar” sekmesinden indirebilirsiniz (Şekil 1.23 – 1.26)

Identifying the schema – 1 — Şekil 1.23: Şemayı tanımlama – 1

Identifying the schema – 2 — Şekil 1.24: Şemayı tanımlama – 2

Identifying the schema – 3 — Şekil 1.25: Şemayı tanımlama – 3

Downloading the schema — Şekil 1.26: Şemayı indirme

İleti A’ya benzer şekilde, bu hizmet meta verilerini de yeniden adlandırabilirsiniz.

2.4. SAP Marketing OData Service’in Genişletilmiş Meta Verilerini Alma (Mesaj C)

Bu kısım biraz zor. Neyse ki, SAP Marketing’de özel bir alanın nasıl oluşturulacağını ve gerekli OData hizmetleri için nasıl etkinleştirileceğini açıklayan bir blog dizisi oluşturdum. Ayrıca, OData hizmeti meta verilerinin (özel alanlarımız dahil) en son sürümünü SAP Marketing’den nasıl alabileceğinizi de açıklar. Bununla birlikte, özel alanımızın (ZZ1_S4ID_ENH) ve OData hizmetimizin (CUAN_BUSINESS_PARTNER_IMP_SRV), atıfta bulunulan blogda açıklananlardan farklı olduğunu lütfen unutmayın (Ama elbette zihniyet aynıdır).

Özel alanın nasıl oluşturulacağını ve OData hizmetlerimiz için nasıl etkinleştirileceğini buradan öğrenebilirsiniz.

SAP Marketing’den OData hizmetlerinin en son meta verilerini almak için öncelikle “Son” simgesi ile “Alıcı” kutusu arasında bir bağlantı oluşturmamız ve Çıkış Sonrası Akışımızda Bağdaştırıcı Türü olarak OData’yı seçmemiz gerekir (Şekil 1.27 – 1.31)

Getting the latest metadata of OData service – 1 — Şekil 1.27: OData hizmetinin en son meta verilerini alma – 1

Getting the latest metadata of OData service – 2 — Şekil 1.28: OData hizmetinin en son meta verilerini alma – 2

Getting the latest metadata of OData service – 3 — Şekil 1.29: OData hizmetinin en son meta verilerini alma – 3

Getting the latest metadata of OData service – 4 — Şekil 1.30: OData hizmetinin en son meta verilerini alma – 4

Getting the latest metadata of OData service – 5 — Şekil 1.31: OData hizmetinin en son meta verilerini alma – 5

Bu andan itibaren, adımlar buradan inceleyebilirsiniz. açıklanan adımlarla oldukça benzerdir. Sadece sonunda .XSD uzantılı oluşturulan şemaya ihtiyacımız var. Adımları izler ve OData hizmetinden CUAN_BUSINESS_PARTNER_IMP_SRV’den en son meta verileri alırsanız, Çıkış Sonrası entegrasyon akışınız için “Kaynak” sekmesinde aşağıdaki gibi bir listeye sahip olacaksınız (Şekil 1.32)

The latest metadata of OData service (Message C) — Şekil 1.32: OData hizmetinin en son meta verileri (İleti C)

Message C’yi yerine getirdiğimizden artık ‘Son’ ve ‘Alıcı’ hatta Çıkış sonrası akış tasarımımızda ‘Alıcı’ arasındaki bağlantıyı silebilirsiniz.

Çıkış Sonrası entegrasyon akışı kaynaklarımıza Message A ve Message B‘yi de eklememiz gerekiyor [Bunları “2.2. C4C SOAP Hizmetinin Genişletilmiş Meta Verilerinin Alınması (Mesaj A) ”ve“ 2.3. SAP Marketing OData Hizmetinin Standart Meta Verilerini Alma (Mesaj B) ”sırasıyla]. WSDL dosyalarını indirdiğiniz PC klasörlerinizden seçmelisiniz. (Şekil 1.33)

Adding Message A and Message B to resource list — Şekil 1.33: Kaynak listesine Mesaj A ve Mesaj B’yi ekleme

WSDL dosyalarını bilgisayarınıza indirdikten sonra yeniden adlandırmazsanız aşağıdaki gibi bir kaynak listesi ile karşılaşmalısınız. (Şekil 1.34)

Final list of resources (Message A, B and C) — Şekil 1.34: Nihai kaynak listesi (Mesaj A, B ve C)

2.5. Çıkış Sonrası Haritalama Gerçekleştirme

Hepimiz, ihtiyaç duyduğumuz tüm kaynaklara sahip olduğumuz için haritalama yapabilmemiz için hazırız. Ayrıntılara girmek için eşlemeyi seçtikten sonra, kaynaklarınızı sırayla nasıl seçeceğinizi ve senaryomuza göre eşleştirmemizi nasıl gerçekleştirebileceğinizi gösteren aşağıdaki ekran görüntülerini takip edebilirsiniz. Özel alanımızı C4C’den (ZZMKTS4ID) eşlemeliyiz. Mevcut eşlenmiş standart alanlara ek olarak SAP Marketing’den (ZZ1_S4ID_ENH) özel alanımızla (Şekil 1.35 – 1.44)

Adding source message — Şekil 1.35: Kaynak mesaj ekleme

Picking up Message A — Şekil 1.36: Mesaj A’nın Alınması

Adding second source message – 1 — Şekil 1.37: İkinci kaynak mesajı ekleme – 1

Adding second source message -2 — Şekil 1.38: İkinci kaynak mesajı ekleme -2

Picking up Message B — Şekil 1.39: B Mesajının Alınması

Adding target source (message) — Şekil 1.40: Hedef kaynak (mesaj) ekleme

Picking up Message C — Şekil 1.41: C Mesajının Alınması

Final picture after message assignments — Şekil 1.42: Mesaj atamalarından sonraki son resim

Mapping custom fields & existing standard fields — Şekil 1.43: Özel alanları ve mevcut standart alanları eşleme

Saving changes — Şekil 1.44: Değişiklikleri kaydetme

3. Standart entegrasyon akışını ve Çıkış Sonrası akışı dağıtma

Standard integration flow & Post-Exit flow — Şekil 1.45: Standart entegrasyon akışı ve Çıkış Sonrası akış

Standart entegrasyon akışımızı daha önce yapılandırdık ve şimdi Çıkış Sonrası akışımızın yapılandırmasını tamamladık. Onları iş başında görmek için konuşlandırmalıyız. Öncelikle standart entegrasyon akışı olan “İş Ortağını SAP Pazarlamaya Kopyalama” ve ardından Çıkış Sonrası akışımız “İş Ortağını SAP Pazarlama Sonrası Çıkışa Kopyala” (Şekil 1.46).

Deployment of standard integration flow & Post-Exit flow — Şekil 1.46: Standart entegrasyon akışının ve Çıkış Sonrası akışının dağıtımı

4. Standart Entegrasyon Akışını ve Çıkış Sonrası Akışını Test Etme

Standart entegrasyon akışımız ve Çıkış Sonrası akışımız devreye girdiğinde, bunları test etmeye hazırız. Kimlik bilgilerinizle SAP Cloud for Customer sisteminizde oturum açın ve test müşteriniz için küçük bir değişiklik yapın. Bizim durumumuzda özel alanımız S/4HANA numarası ile güncellenmelidir (Şekil 1.47)

Update of test customer in SAP Cloud for Sales — Şekil 1.47: Satış için SAP Cloud’da test müşterisinin güncellenmesi

SAP C4C’deki bu değişikliğin yükünü “Web Hizmeti Mesaj Monitörü” aracılığıyla kontrol edebilir ve ayrıca bu giden mesaj için herhangi bir hata olup olmadığını da kontrol edebilirsiniz. Özel alanımızın (ZZMKTS4ID) ilgili yükte “0020000452” değerini aldığını doğrulayabiliriz. (Şekil 1.48)

Checking outgoing payload in SAP C4C via Web Service Message Monitor — Şekil 1.48: Web Service Message Monitor aracılığıyla SAP C4C’de giden yükü kontrol etme

Standart entegrasyon akışımızın ve Çıkış Sonrası akışımızın CPI’da başarıyla tetiklendiğini görmeliyiz. (Şekil 1.49)

Figure 1.49: Trigger of standard integration flow and post-exit flow

Ve son adım için, SAP Marketing’deki (ZZ1_S4ID_ENH) eşlenmiş özel alanımızın doğru değeri alıp almadığını kontrol edebiliriz. SAP Marketing sistemimizdeki “Data Stewardship” bölümündeki “Inspect Contact” uygulaması aracılığıyla test müşterimizi arayarak yapabiliriz. Test müşterimiz için SAP C4C’nin menşe verilerini kontrol etmemiz gerekiyor. (Şekil 1.50)

Checking incoming SAP C4C origin data via Inspect Contact app — Şekil 1.50: Gelen SAP C4C kaynak verilerini Inspect Contact uygulaması aracılığıyla kontrol etme

Özet

Bu kadar! Özel entegrasyon senaryolarınız için entegrasyon akışlarınızı genişletebilmelisiniz. Bu yeni işlevsellik ile;

Standart entegrasyon akışları her zaman bozulmadan kaldığından dolayısıyla değiştirilmediğinden, standart entegrasyon paketinizin daha sonraki sürümleri için endişelenmenize gerek yoktur.
Önceki noktaya göre, standart entegrasyon içeriğine (standart entegrasyon akışları) SAP tarafından uygulanan herhangi bir güncelleme veya hata düzeltmesi riskine girmezsiniz.
Tüm uzantı etkinlikleriniz ayrı bir özel entegrasyon akışında gerçekleştirilir, bu nedenle daha az kaynak ve daha az CPI öğesiyle çalışmanız gerekir (Aslında yalnızca bir eşleme).
Entegrasyon paketiniz için daha yeni bir sürüme yükselttikten sonra Çıkış Sonrası akışınız her zaman orada olacağından, uzatma etkinliklerinizi defalarca gerçekleştirmeden zamandan tasarruf edersiniz.

Uzantılarınızda iyi şanslar!