SAP ECM Kurulum

SAP sistemlerine yükleme  

ECM Paketini ve örnek uyarlamaları içeren request dosyaları tarafımızdan paylaşılacaktır. Aşağıdaki adımlar sırası ile takip edilmelidir. Bu kısımda anlatılan detaylar basis danışmanlarının uzmanlık alanıdır. Detaylara girilmeden requestlerin sisteme yüklenmesi de talep edilebilir.       

• Kurulum yapılacak sistemde AL11 tcodu ile DIR_TRANS klasörünün dizini tespit edilir.  

• İki request dosyası sisteme CG3Z tcodu ile sırasıyla yüklenir. K ile başlayan dosya DIR_TRANS/cofiles klasörüne, R ile başlayan dosya DIR/TRANS/data klasörüne yüklenmelidir. Buradaki örnek için yüklenecek dizinler /usr/sap/trans/cofiles ve /usr/sap/trans/data şeklinde olacaktır. 

• STMS tcodu çalıştırılır. Extras-->Other Requests-->Add adımı ve sonrasında request numarası girilerek ilerlenir. Request numarası cofiles dosya adının, uzantısı başa gelecek şekilde yazılmış halidir.

Örnek Request Numarası : KHDK13788

• STMS Ekranı yenilendiğinde request kuyruğa düşecektir. 

• Request satırı seçilerek import request () butonu ile ilerlenir. Target Client seçimi yapılmalı ve options sekmesindeki tüm seçenekler işaretlenmelidir. Taşıma tamamlandığında ürün sisteme yüklenmiş olacaktır.

Paperwork Bağlantı Uyarlamalarının Yapılması

ZPW tcodeu ile PaperWork alan menüsü açılır. Bağlantı uyarlamalarına bu menü altında, Uyarlamalar-->Sistem uyarlamalarından ulaşılacaktır. 

PaperWork Sistem Parametreleri : ZPW --> Uyarlamalar --> Sistem Uyarlamaları --> PaperWork Sistem Parametreleri adımı ile erişilebilir. ZPWC01 tcodu ile de ulaşılabilir. 

Bu uyarlamada her bir SAP sisteminin hangi PaperWork sistemine bağlanacağı ve bağlanılacak PaperWork kurulumuna özel parametreler tanımlanır. 

• SAP sistem Tanıtıcısı : Buraya uyarlamanın çalışması istenen SAP kurulumunun sistem tanıtıcısı(SID) bilgisi yazılmalıdır. Bu bilgi SAP ekranının sağ alt köşesinden kontrol edilebilir. .
• System ID : Bu alana tarafımızdan aksi belirtilmedikçe 0001 yazılmalıdır.
• PW Version : Bağlanılacak PaperWork kurulumunun versiyonu seçilmelidir. 
• UI Viewer URL : PaperWork ECM UI için kullanılan HTML5 Viewer adresi belirlenir. 
• WF Viewer URL : BPM tarafında kullanılan HTML5 Viewer adresidir. ECM için uyarlanmasına gerek bulunmamaktadır. 
• Yetki Seti ID : Doküman yüklemelerinde sistem yeni bir klasör yaratır ise ve ürün user exitleri içerisinde aksi belirtilmemişse oluşturulacak klasörlerin yetki seti bu tanımlamadan alınır. 
• Tarayıcı Exe Dizini :  Tarayıcı uygulamasının SAP Sunucusu içerisinde hangi dizinde bulunduğunun uyarlandığı alandır. Tarayıcıdan doküman yüklemele işleminde, tarafımızdan geliştirilmiş bir windows uygulaması çalışmaktadır. Bu uygulamanın çalışabilmesi için kullanıcının lokal bilgisayarına uygulama kurulmuş olmalıdır. Eğer kullanıcının lokalinde bu uygulama kurulu değil ise doküman tarama işlemi sırasında otomatik olarak ECM ürünü tarafından kurulum yapılmaktadır. Bunun için kurulum dosyaları SAP sunucusu içerisinde bu adımde belirlenen dizine bırakılmış olmalıdır.
• Tarayıcı Exe Adı : “Tarayıcı exe dizini” adımında belirlenen klasör içinde bulunan “tarayıcı Exe “dosyasının(Tarama Uygulamasının) adını belirtir.
• Tarayıcı Exe Versiyonu : Tarama Uygulamasının versiyonunu belirtir. 
• Tarayıcı Sonuç Dosyası : Tarama uygulamasının sonucunda oluşan log dosyasının adını belirtir. 

Paperwork Kullanıcı Doğrulaması 

 Aşağıdaki menü adımından ya da ZPWC02 üzerinden erişilebilir.

 PW bağlantısında session oluşturacak admin PaperWork kullanıcısının bilgileri bu uyarlamaya yazılır. 

Paperwork Logical Port Uyarlaması

Aşağıdaki menü adımından ya da ZPWC10 üzerinden erişilebilir.

Her bir SAP sisteminin hangi PaperWork kurulumu ile bağlantıda olacağı bu uyarlamadaki logical portlar ile belirlenir. Standart kurulumda dev, qa ve canlı için logical portlar hazır gelmektedir. İlgili logical portlar bu uyarlamaya yazılmalı ve ayrıca LPCONFIG ekranından her bir logical portun bağlanacağı sistem için uç nokta aşağıdaki örnekteki gibi belirlenmelidir. 

Bu örnekte https://demo.g-gsoft.com:8099/soap?LoginService adresi endpoint olarak belirlenmiştir. Bağlanılacak domain kırmızı renkli kısma yazılarak aşağıda belirtilen logical portların endpointleri düzenlenmelidir.
Tanımlı tüm servisler aşağıdaki gibidir. BPM servislerini ECM kurulumnda aktif etmek gerekli değildir.

Görseller

Aşağıdaki menü adımından ya da ZPWC06 üzerinden erişilebilir.

Dosya uzantılarının ECM UI içerisinde hangi SAP iconları ile temsil edileceğinin belirlendiği uyarlamadır. Kurulum requesti içerisinde bu uyarlama yapılmış şekilde gelmektedir.

Tarihçe İşlem Tipleri 

Aşağıdaki menü adımından ya da ZPWC07 üzerinden erişilebilir.

PaperWork tarafında tanımlı işlem tiplerinin ECM UI üzerinde hangi tanımla gösterileceğinin uyarlamasıdır. Bu uyarlama da kurulum requesti ile birlikte dolu gelecektir.

GOS Menü Uyarlaması 

Aşağıdaki menü adımından ya da ZPWC11 üzerinden erişilebilir.

Standart SAP ekranlarında bulunanan GOS(Generic Object Service) menüsüne PaperWork adımlarının eklenmesi için kullanılan uyarlamadır. 

Bu uyarlama standart bir SAP uyarlaması olup, tüm standart ekranlardaki GOS menüsünü etkileyecektir. Öncelikle Uyarlamaya aşağıda seçili iki satır eklenmelidir. İlk satırdaki bilginin de “Sonraki Hizmet” kısmı aşağıdaki gibi güncellenmelidir. Bu uyarlamada “VIWE_ATTA” olarak belirtilen adım  “PERS_NOTE” ile belirtilen adım da  adımıdır.

Bu şekilde uyarlanarak PaperWork menü adımları bu iki standart adımın arasına yerleştirilmiş olur. Bu düzen farklı şekillerde de kurgulanabilir. Uyarlama yapılmadan önce GOS menüsünün mevcut düzenine bakılmalı ona göre uyarlamanın nasıl yapılacağı planlanmalıdır.

Paperwork WF Aktivite Tipleri, Akış Durumları : 

Aşağıdaki iki menü adımı BPM ürünü için kullanılmaktadır. ECM UI için uyarlanmayacaktır.

Süreç Uyarlama ve Geliştirmeleri

Arşivleme yapılacak tüm süreçler için PaperWork ekranlarında yapılacak tanımlamalara paralel olarak SAP içerisinde de Uyarlama ve geliştirme adımları mevcuttur.

Aşağıda örnek olarak “SATINALMA SİPARİŞLERİ” süreci kurgulanmıştır. 

Doküman Tipleri Uyarlaması

Aşağıdaki menü adımından ya da ZPWC08 üzerinden erişilebilir. 

Bu uyarlama süreçlerin genel tanımlarının yapıldığı uyarlamadır. Her bir tanımlama bir süreci ifade eder. 

Object Type : EKKO – 10 haneye kadar bir kod verilir. Bu kod süreci belirten tekil bir koddur ve uyarlamayı yapan kişi tarafından belirlenir.   

Object Type Text : SAP Satınalma Siparişleri – Sürecin tanımıdır.

Kabinet Name : Sap Satınalma Siparişleri – Arşivlenecek dokümanların PaperWork arayüzünde hangi kabinet altında gözükeceğini belirler. 

PaperWork Document Type: PaperWork arayüzünde yapılan tanımlada bu süreç için oluşturulan tipin adı yazılır. Bu bilgi PaperWork tanımlamalarını yapan danışmandan alınmalıdır. 

PaperWork Form Name : SAP_SATINALMA_SIPARISI – Süreç için PaperWork arayüzünde oluşturulmuş formun adıdır. Bu bilgi de PaperWork tanımlamalarını yapan danışmandan alınmalıdır. 

Master Tablo : EKKO , Sürecin anaveri tablosunu ifade eder. Bu alan, PaperWork arayüzünden doküman yüklerken, dokümanı bir SAP kaydı ile eşleştirmede kullanılmaktadır.

FTS : Tam Metin Arama ( Full Text Search ) özelliğinin bu süreçte aktif olup olmayacağını belirler. 

Data Select Function : ZESM_EKKO_DATA_GET – Bir sonraki uyarlama adımında belirlenecek olan index alanların tespiti için yazılması gereken fonksiyondur. ZPW_SAMPLE_INTERFACE_DATA_GET fonksiyonundan referans ile oluşturulabilir.  (Not : Geliştirme yapılırken Ürünün standart paketine (ZFPR_DYS_KOKPIT) kesinlikle müdahale edilmemelidir. Bu geliştirmeler müşteriye özel olduğu için müşteri SAP sisteminde bir paket açılmalı ya da mevcut paketlerden biri kullanılarak ilerlenmelidir.) 

Fonksiyonun export parametreleri süreçte kullanılacak index alanları içeren yapılar olmaldıdır. Z’li de oluşturulabilir. Bu örnekte EKKO ve LFA1 tablolarındaki alanlardan indexlerimizi oluşturacağız. 

Paperwork Doküman İndeksleri

Aşağıdaki menü adımından ya da ZPWC05 üzerinden erişilebilir. 

Bu uyarlama ile her bir sürecin hangi indexler ile çalışacağı belirtilmiş olur. 

Object Type : EKKO - Bir önceki uyarlama adımında belirlediğimiz süreç adı. 

Sıra No : 1 – Sıradan artan numara verilmelidir. 

Alan Adı : EBELN - SAP’de alanın adı. Anlamlı herhangi bir ad kullanılabilir. Referans alanın adı ile aynı şekilde uyarlanması uygundur. Aksi bir ihtiyaç olmadıkça bu şekilde uyarlıyoruz. 

PaperWork Field Name : SATINALMA_BELGE_NO - Index alanın PaperWork arayüzündeki tanımlanmış adıdır. 

Reference Table : EKKO – Bir önceki uyarlama adımında, data select function alanında uyarlanan fonksiyonun dönüş parametrelerinde bu index hangi yapı içerisinde ise o yapının adı verilir. 

Reference Field : EBELN – Referans tablo alanındaki yapının içerisinde bulunan ilgili alan adı kullanılır. 

Aranabilir : Bu alan seçildiğinde, index alanı üzerinden doküman arama yapılabilir. PaperWork arama ekranların yardım sayfasında arama ekranında index aramaları detaylı anlatılmaktadır.

Gos Object – PW Type Eşlemesi 

Aşağıdaki menü adımından ya da ZPWC09 üzerinden erişilebilir. 

SAP Standart ekranlarında GOS menüsü için bir GOS Nesnesi bulunmaktadır. Standart ekranların ECM UI için tasarladığımız süreçlere bağlantısı bu uyarlama ile sağlanır. 

Belge Kaynak Yolu  

Aşağıdaki menü adımından ya da ZPWC04 üzerinden erişilebilir. 

ECM UI Arama Ekranında, belge listesinde ilgili satıra çift tıkladığınızda belgenin anaveri ekranına yönlendirilirsiniz. Bu uyarlama yönlendirmenin nasıl yapılacağını tanımlar. Buradaki örnek için anaveri ekranı ME23N ekranıdır. 

Object Type : EKKO – Doküman Tipleri uyarlamasında belirlenmiş süreç kodu.

İşlem Kodu : ME23N – İlgili anaveri ekranı transaction kodu.

Alan Adı : EBELN – Anaveri ekranına gidebilmek için gerekli index adı. 

Parametre Tanıtıcısı : BES – Anaveri ekranında alan adının (EBELN) parametre tanıtıcısı.

Süreç User Exit/Enhancement Kullanımı

Paperwork Arayüz Uyarlamaları

PaperWork Tip Tanımlama Ekranı

Arşiv tanımının tamamlanması için son adım form tanımı yapılmasıdır. Oluşturulan tip için bir elektronik form oluşturulmalıdır. Form tasarımı istenildiği gibi ayarlanabilir. Kaydın SAP tarafında hangi veriye karşılık geldiği bilgisine ihtiyaç varsa SAP_OBJECT_TYPE ve SAP_OBJECT_ID alanları form üzerinde salt okunur olarak kullanılabilir.