Erkan SEZER

Kurumun uzun süredir yapmak istediği ama bazı problemlerden dolayı gerçekleştiremediği FileNet Upgrade Projemiz Nisan ayı içinde başarılı şekilde gerçekleştirildi. Uzun süredir çok yoğun şekilde bunun üzerinde çalışıyorduk ve Türkiye`de de ilk bizim gerçekleştirmiş olmamız bizim içinde büyük bir moral kaynağı oldu.

Öncelikle neler yaptık? Content tarafı için tüm kodlarımızı değiştirdik, COM API yerine FileNet`in 4.X ile kodlamalar için uygulamaya aldıpı FileNet.API `yı kullandık. Tabi bu süreç biraz zor oldu, en baştan kodları yazmak ve tümden yeni İnterfaceleri öğrenmek bayağı zamanımızı aldı. Geçiş sonrası düşünemediğimiz tek konu sanırım bize geri dönen hata mesajlarının değişmiş olduğuydu ama yine de çok güzel bir geçiş gerçekleştirdik, iş kesen bir durum oluşmadı.

Process tarafında ise işimiz biraz daha zordu, konfigurasyonların düzeltilmesi süreçlerin yeni proda atılması, yeni serverlardaki konfigürasyonlar gibi sorunlar bizi çok da yordu fakat tüm bunlara rağmen geçiş çok güzeldi ve benim açımdan çokda zevkliydi.

Gelelim teşekkürlere :)

Yöneticim Yavuz Selim Keresteci , çalışma arkadaşlarımız Esra Şenol ve Mehmet Salih Avınç`a, IBM`den Ömer Sever`e , eski yöneticim ve FileNet Trainer`imiz Muhammet Ali Hançer`e katkılarından , yardımlarından ve problemlerimizin çözümündeki aşırı çalışmalarından dolayı teşekkür ederiz.

FileNet ile ilgili bir kaynakta okuduğum bir bilgiyi paylaşmak istiyorum , IBM P8 Platformunun content bazılı ürünleri aşağıda liste halinde bulabilirsiniz. Aslında bu kadar geniş bir ürün yelpazesi olduğunu düşünmüyordum , bunu okuyunca öğrenecek daha çok fazla şey olduğunu gördüm :)

FileNet 3.5.X versiyonunda dokümanı locale kopyalarken öncelike dokumanı set eder ve daha sonra ne yaptığını bvilmediğimiz ve sadece isimlendirmeden yola aıkacağımız bir metod kullanırdık. Doc.CopyContent olarak kullandığımız bu metod ile aslında tam olarak ne yaptığımızı bilmiyorduk , kopyalıyor ama nasıl kopyalıyorduk ne kullanıyorduk hiçbir fikrimiz yoktu.

Ayrıca bunu COM API ile yapıyor ve VB 6.0 ile .NET için kullanmış olduğumuz dokümanı set etmek daha farklıydı ve önce VB 6.0 ve daha sonrada bunu C# da yapmak isteyenler için tam bir eziyet haline geliyordu.

.NET API 4.X versiyonunda sonra geldi ve birçok işlemi standart hale getirdi , işte burda da dokümanı FileNet`den daha doğrusu File Store`dan alıp locale kopyalama işi de standart hale getirilmiş oldu. Bu işlem içi stream sınıflarını kullanıyoruz , tabiki mantıklısı da bu , C# ile her türlü dosya okuma , yazma , XML okuma , yazma gibi işlemleri Stream`lerle yaparken bir dokümanı FileNet`den neden değişik standart olmayan bir metod ile kopyalıyoruz , bunu zaten anlamamıştım , FileNet 4.X ve benim bu derdime çare bulmuş :) aslında çok güze ve şık olmuş..

FileNet 4.5.1 versiyonu IBM`in son çıkardığı versiyondur ve burda 3.5.X versiyonuna göre 4.X ve 4.5.X versiyonunda büyük major farklılıklar göze çarpmaktadır.

Öncelikle FileNet`e nasıl connect olacağımızla ilgili değişikliğe bakacağız? Daha önce biz COM API kullanıyorduk ve bununla birlikte Java API desteğı ve Web service desteği sunuluyordu. Microsoft kullanıcılarını sevindiren bir haber : FileNet artık size .NET API desteği de sunmaktadır.

Eğer Java API kullanmışsanız nerdeyse bire bir aynı gibidir. Bu bizi COM API kullanmanın zorluğundan kurtardığı gibi , FileNet için bir standart oluşturma , performans , daha kolay kodlama (eğer Java API  ve object oriented biliyorsaniz) vb birçok özellik sağlamaktadır.

Öncelikle .NET API kullanacaksanız ve bununla FileNet`e connect olacaksanız bir müjde artık client kuruluma ihtiyacınıoz olmayacak. WSE 3.0 kullanarak Kerbores Token ile user name ve password`a ihtiyaç duymadan FileNet`e bağlanabileceksiniz.Tabiki isterseniz Username Token ile de username ve password ile de FileNet`e connect olabilirsiniz. Çok güzel dediğiniz duyar gibiyim :)

Ayrıca 4.X versiyonu ile birlikte gelen .NET API`si hep interfancelerden türemekte ve buda bize eğer object oriented mantığınız oluşmuşsa büyük kolaylıklar sağlamaktadir.

Uzun suredir Filenet hakkinda biseyler yazmadigimi farkettim, simdi document securitysi hakkinda biseyler yazacagim.

Olusturdugumuz dokumanlara FEM den Document Class ekleyerek istedigimiz security leri olusturuyoruz. Peki bunu kodla nasil olustururduk , devamli Default Instance Security tabinda islemler mi yapacagiz? Tabiki bizim gibi yazilimcilar icin bu biraz kolaylik saglasa da cok da iyi bisey degil. Bundan dolayi asagida kodla nasil Default Instance Security de yaptigimiz islemi dokuman bazinda yapari bunu anlatacagim.

Oncelikle dokumanlar icin AccessPermission i kullanmamiz gerekecek. Burda AccessPermission tipinde bir Instance aliyoruz (CreateInstance) Bu islem Filenet 4.5 de Interfaceler araciligi ile daha da standart hale getirildi.

Daha sonra aldigimizin bu Instance in bazi degerlerini set etmemiz gherekecek. AccessMask degerini IdmAccessLevel enumi ile , AccessMask  degerini IdmAccessType ile ve GranteeName degerini de Active Directory de bulunan herhangi bir grup adi ile set ederek Document in permission metodu ile dokumana olusturulan security eklenir ve son olarak da dokuman Save edilir.

Simdi gidip document in Security sine bakarsak Active Directory de bulunan ve bizimde GranteeName e set ettigimiz kullaniciyi veya kullanici grubunu goruruz.

Process Engine , Application Engine ve Content Engine Filenet P8 platformunun Core componentleridir. Bunları kısaca açıklayacak olursak;

Process Engine:Workflow olarak adlandıracağımız Business Process leri oluşturmamızı , yönetmemizi , simule etmemizi ve modellemizi sağlayan core componentteir. Kendi içinde bulunan componentlarla anlatılanları sağlamaktadır.

Content Engine:Genellikle Administrator`ların kullandığı Workflow ve Custom objeleri kolayca yönetmemizi sağlar. Adminler content engine vasıtası ile her türlü objeyi, property`i , class`ı , storage vb objeleri kolay ve zahmetsiz şekilde oluşturur , yönetirler.

Application Engine: En basit açıklamayla process ve content kısmını host etmemizi sağlar. Yani Workplace , Java Appletleri ve develop edeceğimiz uygulama için bizlere gerekli olan web service ve dll leri sağlar. Yani process engine ile content engine`i için bize presentation layer vazifesi görür.

Filenet ile şimdiye kadar Dokuman Ekleme , silme , versiyonlama , folderlama gibi işlemler yaptık. Bunları COM API ile gerçekleştirdik Her zaman Filenet`in çok komplike ve mükemlle bir sitem olduğudan bahsediyoruz. Şimdi güzel bir konudan daha bahsedeceğim.

COM API ile yaptığımız bütün işlemleri , Dokuman Ekleme , silme , versiyonlama bu versiyonlama major de minor de olabilir , folder oluşturma , property set etme ve buna benzer bir çok özelliği hiçbir şekilde bilgisayarınıza dll yüklemeden de yapabiliriz. Tabiki bunun yolu web service.

Filenet FEM`den , COM API ile veya da CEWS dediğimiz Content Engine Web Service ile bunları yapabilmeye olanak sağlamaktadır. CEWS filenetin kendi web service`idir ve Filenet kurduğumuz makinada bu bulunmaktadır.

Web service`i call ederek content ile ilgili  işlemleri yapabilmek bizim için çok büyük kolaylık.

Filenetde doküman versiyonlarken yapılan en büyük yanlışlardan biri; dokümana content eklediğimizde veya content eklemeden de versiyonlama yaparken ,  dokümanın rezerve edildiğini unutarak bu işlemin yeni doküman eklerken uygulanan işlemin uygulanmasıdır. Tabiki bu da hata alacak ve dokümanı versiyonlayamayacağız. Bunun için yapmamız gereken;

Doc.Checkin degil , Doc.Reservation.Checkin işlemi olmalıdır.

Aynı şekilde dokümana content eklerken de Doc.ContentElements.Add değil , Doc.Reservation.ContentElements.Add işlemi olmalıdır. Bu şekilde işlemimiz başarılı şekilde gerçekleştirilecektir.