Birlikte çalışması gereken farklı uygulamalar hayal edin, ancak bunlar birbirine uyması gereken yapboz parçaları gibidir. İşte veri eşleme burada devreye giriyor. Yüzeyin altında farklı ‘diller’ konuşsalar da bu uygulamaların birbirlerini anlamalarını sağlayan akıllı bir tercüman gibidir. Bu yazı sizi veri haritalama dünyasında bir keşif yolculuğuna çıkarıyor. Tam olarak ne olduğuna, geliştiricilerin bunu nasıl kullandığına ve APIcenter’ın nasıl yardımcı olduğuna bakacağız. Ayrıca APIcenter’ın ne tür uygulamaların birlikte çalışmasını sağlayabileceğine ve veri eşlemeyi projenizin özel ihtiyaçlarına göre nasıl özelleştirebileceğinize de bakacağız. Kısacası, uygulamaları birbirine bağlamaya perde arkasından bir bakış!
Uygulama Bağlantılarında Veri Eşleme
Veri eşleme, uygulamalar arasındaki bağlantılarda yaygın olarak kullanılır. Bunun nedeni iki farklı uygulamanın iki farklı geliştirici tarafından yazılmış olmasıdır. Sonuç olarak, iki uygulama aynı görünebilir, ancak su altında tamamen farklı yazılmış olabilirler. Bu durum, bu uygulamaları birbirine bağlamaya çalışırken büyük bir boşluk yaratır. Bu sorunun üstesinden gelmek için, entegrasyonu oluşturan bir geliştiricinin iki uygulamanın bilgileri arasında ilişkiler oluşturması gerekir. Bu o kadar da zor değildir, ancak bunu 60’tan fazla uygulama için yapmanız gerektiğinde, imkansız bir görev haline gelir. Bu yazıda, veri eşlemenin ne olduğunu, nasıl kullanıldığını, APIcenter’ın bunu nasıl ele aldığını, hangi APIcenter türlerini desteklediğini ve iş sürecinize daha iyi uyması için veri eşlemeyi nasıl özelleştirebileceğinizi açıklayacağız.
Kaynak ve Hedef Eşleme
APIcenter’da bir veri akışı (flow) tasarlarken her zaman kendi bakış açımızı esas alırız. Bu da sürekli olarak iki tarafa baktığımız anlamına gelir. Bir tarafta, bilginin alındığı ‘alma’ tarafımız (GET) var. Diğer tarafta ise bilginin alındığı ‘gönderme’ tarafı (SEND) vardır. Bu kavramı açıklığa kavuşturmak için, örnek olarak alıcı tarafta bir web mağazasını ve gönderen tarafta bir muhasebe uygulamasını ele alalım. Bu yazıdaki örnekler, kaynak ve hedef eşleme ilkelerini göstermek için bu iki tarafı kullanmaktadır.
Nokta gösterimi
Nokta gösterimi, programlama dillerinde verileri açık ve erişilebilir hale getiren bir tekniktir. Kullanıcıların derinlemesine programlama bilgisi olmadan karmaşık veri yapılarında gezinmelerini sağlar. APIcenter’da, hem kaynak uygulamanın hem de hedef uygulamanın veri yapılarını anlaşılır hale getirmek için nokta gösterimini kullanırız. [Naam van het object][Naam van het attribuut] Standart bir nokta gösterim formatı şu şekilde yapılandırılmıştır: . . Örneğin, bir müşterinin (customer) adını (name) almak istiyorsak, bunu şu şekilde not ederiz: customer.name. Bu yöntem aynı zamanda birkaç katman derinliğe inmemizi sağlar. Örneğin, bir müşterinin cadde (sokak) içeren bir adresi (adres) varsa, bu şu şekilde not edilir: customer.address.street. Ayrıca, bilgiler birden fazla nesne içerebilir. Açıklayıcı bir örnek, bir müşterinin iki nokta üst üste (:) ile temsil edilen birden fazla irtibat kişisine (kişiler) sahip olmasıdır. Örneğin: customer.contacts:name. İki nokta üst üste, ‘name’ özniteliğinin 0, 1 veya birden fazla kez görünebileceğini gösterir.
APIcenter’da Veri Eşleme türleri
APIcenter üç tür veri eşleme kullanır: ‘ doğrudan‘, ‘ eklemeli‘, ‘ dönüştürücü‘ Aşağıdaki örneklerde, bilgiler bir web mağazasından alınır ve bilgiler bir muhasebe sistemine gönderilir.
D oğrudan Bu veri eşleme türünde, veriler birbirleriyle doğrudan ilişkilidir. Örnek olarak, burada adı olan bir ürünümüz var:
| Web mağazası alanı | Muhasebe alanı |
| ÜrünAdı | Ürün Başlığı |
EkBilgiler, bu türde, muhasebe uygulamasına ek bilgi sağlamak için diğer alanlara kopyalanır. Örnek olarak, müşteride sevkiyat adresi eksik olduğunda:
| Web mağazası alanı | Muhasebe alanı |
| BillingStreet | BillingStreet |
| BillingPostalCode | BillingPostalCode |
| BillingCountry | BillingCountry |
| ShippingStreet | |
| NakliyePostaKodu | |
| ShippingCountry |
Bu, gönderimi yapan tarafa mümkün olduğunca fazla bilgi vermek için yapılır. Bu bilgi nihai olarak kullanılmasa bile.
DönüştürücüBu, bilginin eklendiği, çıkarıldığı veya genel olarak değiştirildiği yerdir. Örneğin, bir siparişteki fiyatlar eşleşmediğinde (vergi dahil veya hariç):
| Web mağazası alanı | Muhasebe alanı |
| Vergi Dahil Toplam Fiyat | |
| Vergi Hariç Toplam Fiyat | |
| Toplam Vergi |
Yukarıdaki veri eşlemesinde, alanların doğrudan bitişik olmadığı açıktır; bu da web mağazası bilgilerini doğrudan muhasebeye aktarırken zorluklara yol açabilir. Ancak APIcenter, hem kapsayıcı vergi fiyatını hem de vergi tutarını kullanarak özel vergi fiyatını hesaplayarak bunun üstesinden gelir. Bu, web mağazasında belirli veriler hazır olmasa bile muhasebe için değerli bilgilerin oluşturulmasına olanak tanır. Bu yaklaşım, entegrasyonun muhasebede sorunlara neden olmadan sorunsuz bir şekilde çalışmasını sağlar.
APIcenter’da veri eşleme: Benzersiz bir yaklaşım
APIcenter’da veri eşleme konusunda farklı bir yaklaşım benimsiyoruz. APIcenter, uygulamaları tek tek eşlemek yerine, tüm uygulama alanlarını kendi veri modeliyle ilişkilendirir. (Veri modeli, ürün veya müşteri gibi bir varlığın yapılandırılmış bir temsilidir). Bilgilerin geldiği web mağazası söz konusu olduğunda, veri eşlemesi şu şekilde görünür. APIcenter, veri modelimize mümkün olduğunca çok alan bağlamak için çaba göstermektedir. Bu yaklaşım, kapsamlı bir bilgi setinin diğer uygulama (bu durumda muhasebe) için kullanılabilir olmasını sağlar. Bu metodolojiyi takip ederek APIcenter, diğer uygulamalarla sorunsuz entegrasyon için çok sayıda ilgili verinin mevcut olmasını sağlar.
| Webmağaza alanı | APIcenter alanı |
| ÜrünAdı | İsim |
| Vergi Dahil Toplam Fiyat | Toplam Dahil Fiyat |
| ToplamExclFiyat | |
| Toplam Vergi | ToplamVergiTutarı |
Bilgilerin gönderildiği muhasebe için veri eşlemesi şu şekilde görünebilir. Burada sadece ihtiyaç duyulan bilgiler seçilir.
| APIcenter alanı | Muhasebe alanı |
| İsim | Ürün Başlığı |
| Toplam Dahil Fiyat | |
| ToplamExclFiyat | Vergi Hariç Toplam Fiyat |
| ToplamVergiTutarı |
Müşteri (veya iş ortağı) hangi 2 uygulamayı istediğini seçtikten sonra, 3 veri modeli birleştirilir. Bu daha sonra APIcenter tarafından bilgi almak ve iletmek için kullanılabilir. Bu daha sonra şöyle görünür:
| Web mağazası alanı | APIcenter alanı | Muhasebe alanı |
| ÜrünAdı | İsim | Ürün Başlığı |
| Vergi Dahil Toplam Fiyat | Toplam Dahil Fiyat | |
| ToplamExclFiyat | Vergi Hariç Toplam Fiyat | |
| Toplam Vergi | ToplamVergiTutarı |
APIcenter’da Veri Eşleme Ayarlamaları: İş Süreciniz için Esneklik
Bir APIcenter kullanıcısı olarak, akışınızın veri eşlemesinde ayarlamalar yapma olanağına sahipsiniz. APIcenter bağlantının her iki tarafını da mümkün olan en iyi şekilde doldurmak için her türlü çabayı gösterse de, bazı alanlar standartlaştırılmış veri modelimize sorunsuz bir şekilde uymayabilir. Ayrıca, müşteri ortamında APIcenter’ın tanımlayamadığı özel alanlar oluşturulmuş olabilir. Bu gibi durumlarda, birleştirilmiş veri eşlemelerini akış bazında değiştirme seçeneği sunuyoruz. Bunun somut bir örneği, bir müşterinin bir ürünün başlığının ‘Ad’ yerine ‘ProductDescription’ alanıyla ilişkilendirilmesini tercih etmesidir. Veri eşlemesinde olası bir değişiklik aşağıdaki gibi görünecektir:
| Web mağazası alanı | APIcenter alanı | Muhasebe alanı |
| ÜrünAdı | İsim | ÜrünAçıklaması |
Özelleştirme sürecini kolaylaştırmak için, bildiğimiz veya bulabildiğimiz tüm olası (varsayılan) alan adlarını ekledik. Giriş kutusuna yazmaya başladığınızda, APIcenter otomatik olarak ilgili olabilecek olası alanları arar.
Özel Uygulama Alanları
Müşterinin uygulamasında ayarlanabilecek özel alanlar için, bunların varlığını otomatik olarak bilmiyoruz. Ancak, böyle bir özel alanın programlama adı sizin tarafınızdan biliniyorsa (muhtemelen uygulamada görülebilir), bunu veri eşlemesine kolayca ekleyebilirsiniz.
Özel/serbest alanlar
APIcenter’ın varsayılan modelinde yeri olmayan alanlar için‘özel alanlar‘ (custom fields) sunuyoruz. Bu bölümde, her iki tarafa da rastgele alanlar ekleyebilirsiniz. Bu şu şekilde görünebilir:
| Web mağazası alanı | APIcenter alanı | Muhasebe alanı |
| CustomField1 | CustomFields.freeStringField0 | CustomField2 |
| CustomFields.freeStringField9 | ||
| CustomFields.freeValueField0 | ||
| CustomFields.freeValueField9 |
İki tür serbest alan sunduğumuzu unutmayın: metin içeren alanlar için ‘string’ ve sayısal alanlar için ‘value’. Bu size veri eşlemesini özelleştirme ve özel ihtiyaçlarınıza uygun sorunsuz bir entegrasyon elde etme özgürlüğü verir.
Sonuç
APIcenter için veri eşleme, genel sürecin çok önemli bir parçasıdır. Veri eşleme süreci, birden fazla uygulamanın birbiriyle sorunsuz bir şekilde iletişim kurmasını sağlar. Alanlar birbirine bağlı olduğundan, bir kurulumdan sonra her zaman aynı sonuca sahip olacaktır. Bu da istikrar yaratır, hataları azaltır ve daha önemli görevler için zaman kazandırır.