Toplu işlem servisi j-Platform sistemi üzerinde toplu işlem çalıştırmak için yazılmıştır. j-Platform'da tanımlı tüm toplu işlemler üzerinde işlem yapmak için bu servis kullanılabilir. Toplu işlem için gerekli olan filtre ve parametre tanımlarına bu servis aracılığı ile erişilir.

Güvenlik

Toplu işlem servisi j-Platform kullanıcısı güvenliğini kullanır. Servise yollanan SOAP mesajlarında UsernameToken tanımlı olmalıdır ve bu token içinde geçerli ve sisteme bağlanabilen (yasaklanmamış, şifresinin süresi dolmamış... vs) bir j-Platform kullanıcısına ait kullanıcı adı ve şifre bilgisi bulunmalıdır. Bu servisi sadece j-Platform kullanıcıları kullanabilir.

Servis Erişim Adresi

Bu servise erişmek için j-Platform sistem adresi şöyledir:

http://<sunucu>:<port>/logo/services/BatchWebService?wsdl

Örnek adres: http://172.16.12.62:9081/logo/services/BatchWebService?wsdl

Servis Metodları

• getFilterList(String batchName, RWSBasicParams basicParams) : j-Platform da tanımlı tüm toplu işlemlere ait filtreleri dönen metoddur.
• getParameters(String batchName, RWSBasicParams basicParams) : j-Platform da tanımlı tüm toplu işlemlere ait parametreleri dönen metoddur.
• executeBatch(BWSParams batchParams, RWSBasicParams basicParams): j-Platform da tanımlı tüm toplu işlemleri çalıştıran metoddur.
• getBatchStatus(int batchID, RWSBasicParams basicParams) : ID si verilen toplu işleminin o anki durumunu dönen metoddur.

Serviste Kullanılan Nesneler

 BWSParams

  BWSParams nesnesi toplu işlem adı, parametreleri ve filtre listesini içerir.

•     batchName: Toplu işlemin adını belirten parametredir.
•     parameters : Toplu işlemin parametrelerini belirten parametredir.
•     filtersValues: Toplu işlemin filtre değerlerini belirten parametredir.

RWSBasicParams

RWSBasicParams nesnesi j-Platform a bağlanılacak firma, period ve dil bilgisini içerir. İçerdiği parametreler:

• firm : Firma bilgisini belirtir. İşlem yapılmadan önce j-Platform bağlantısı (login) sırasında kullanılacak kurumun numarasıdır. Bu değer geçerli bir kuruma ait numara olmalıdır. Eğer geçerli bir kurum numarası değil ise j-Platform bağlantısı (login) sağlanamayacağı için işlem başarısız olur.
• period : Period bilgisini belirtir. İşlem yapılmadan önce j-Platform bağlantısı (login) sırasında kullanılacak dönemin numarasıdır. Bu değer geçerli bir döneme ait numara olmalıdır. Eğer geçerli bir dönem numarası değil ise j-Platform bağlantısı (login) sağlanamayacağı için işlem başarısız olur.
• language : Dil bilgisini belirtir: Varsayılan değeri "ENUS" tur. Örnek değerler : "TRTR", "ENUS".

Metodların Döndüğü XML Yapıları

• getFilterList(String batchName, RWSBasicParams basicParams)

<?xml version="1.0" encoding="UTF-8"?>
<navi-filters>
   <filter type="group-selection" caption="Malzeme (Sınıfı) Türü" id="1" />
   <filter type="group-selection" caption="Malzeme (Sınıfı) Durumu" id="2" />
   <filter type="string" caption="Malzeme (Sınıfı) Kodu" id="3" range="true" />
   <filter type="string" caption="Malzeme (Sınıfı) Açıklaması" id="4" range="true" />
   <filter type="string" caption="Malzeme (Sınıfı) Özel Kodu" id="5" range="true" />
   <filter type="string" caption="Malzeme (Sınıfı) Yetki Kodu" id="8" range="true" />
   <filter type="string" caption="Malzeme (Sınıfı) Grup Kodu" id="10018" range="true" />
   <filter type="string" caption="Üst Malzeme Sınıfı Kodu" id="20" />
   <filter type="group-selection" caption="Konfigüre Edilebilir" id="10" />
   <filter type="string" caption="Birim Seti Kodu" id="22" range="true" />
   <filter type="string" caption="Birim Seti Açıklaması" id="23" range="true" />
   <filter type="group-selection" caption="ızleme Yöntemi" id="24" />
   <filter type="group-selection" caption="Stok Yeri Takibi" id="31" />
   <filter type="numeric" caption="Alış KDV Oranı (%)" id="25" />
   <filter type="numeric" caption="Satış KDV Oranı (%)" id="34" />
   <filter type="numeric" caption="İade KDV Oranı (%)" id="35" />
   <filter type="group-selection" caption="Kullanım Yeri" id="36" />
   <filter type="string" caption="Org. Birimler" id="33" range="true" />
   <filter type="string" caption="OrgBirimGrupKodu" id="9" />
   <filter type="list-selection" caption="Ambar_Bilgisi_Detayları" id="28" />
   <filter type="string" caption="Ambar Kodu" id="29" range="true" />
   <filter type="list-selection" caption="Takım_Bilesenleri" id="30" />
</navi-filters>

•  getParameters(String batchName, RWSBasicParams basicParams)

<?xml version="1.0" encoding="UTF-8"?>
<batch-parameters>
   <param name="param2" type="Boolean" />
   <param name="param4" type="Integer" />
   <param name="param1" type="String" />
   <param name="param3" type="Double" />
</batch-parameters>

• executeBatch(BWSParams batchParams, RWSBasicParams basicParams)

<?xml version="1.0" encoding="UTF-8"?> 
<batch id="456" />

•    getBatchStatus(int batchID, RWSBasicParams basicParams)

<?xml version="1.0" encoding="UTF-8"?>
 <batch id="361" status="1" />

Parametrelere Verilecek XML Tanımları

  executeBatch(BWSParams batchParams, RWSBasicParams basicParams): "BWSParams" nesnesinin "filterData" parametresi aşağıdaki XML yapısında olmalıdır.

<?xml version=\"1.0\" encoding=\"UTF-8\"?>
 <navi-filters> 
  <filter type="1" id=\"1\" value=\"0|1|\" /> 
  <filter type="2" id=\"4\" value=\"123\" />
  <filter type="6" id=\"7\" value=\"2009-11-24 00:00:00|2009-12-06 23:59:59\" />
  <filter type="9" id=\"9\" value=\"5|9|12|20|\" />
  <filter type="10" id=\"10\" value=\"1\" />
  <filter type="10" id=\"11\" value=\"1|\" /> 
  <filter type="2" id=\"66\" value=\"12\" />
 </navi-filters>

  Buradaki filtre türleri değerleri aşağıdaki gibidir :

1.    STRING_FILTER = 1
2.   STRING_RANGE_FILTER = 2
3.   NUMERIC_FILTER = 3
4.   NUMERIC_RANGE_FILTER = 4
5. DATE_FILTER = 5
6.  DATE_RANGE_FILTER = 6
7.  TIME_FILTER = 7
8.  TIME_RANGE_FILTER = 8     
9.  GROUPSEL_FILTER = 9
10.  LISTSEL_FILTER = 10

"BWSParams" nesnesinin "parameters" parametresi aşağıdaki XML yapısında olmalıdır.

<?xml version=\"1.0\" encoding=\"UTF-8\"?>
  <batch-parameters>
  <param name=\"param2\" type=\"Boolean\" value=\"true\"/> 
  <param name=\"param4\" type=\"Integer\" value=\"12\"/>
  <param name=\"param1\" type=\"String\" value=\"KOD123\"/>
  <param name=\"param3\" type=\"Double\" value=\"156\"/>
 </batch-parameters>

Hata Mesajları

Tüm metodlar için geçerlidir. Herhangi bir parametre geçersiz olduğunda ya da işlem yapılırken beklenmedik bir hata oluştuğunda metodlar aşağıdaki yapıda olan hata mesajları dönerler.

<?xml version="1.0" encoding="UTF-8"?> 
<error message="Batch Name is null" id="1001" />

Hata Mesajları Anlamları

1.   id = 1000 - > UOD den gelen hataları içeren mesajdır.
2.   id = 1001 - > BatchName parametresi belirtilmediğinde oluşur.
3.  id = 1002 - > RWSBasicParams nesnesinin null olduğu zaman oluşur.
4.  id = 1003 - > Firma ya da Period bilgisinin geçerli olmadığı zaman oluşur.
5.  id = 1004 - > Filtre listesi bulunamadığı zaman oluşur.
6.  id = 1005 - > BWSParams nesnesinin null olduğu zaman oluşur.
7.  id = 1006 - > BatchRunTimeData nesnesi bulunamadığı zaman oluşur.