Sap Gui Grid View Operation
Bu aktivite, SAP GUI arayüzünde bir Grid View bileşeni üzerinde çeşitli işlemleri gerçekleştirmek için kullanılır.
Özellikler
Display Name:Aktivitenin süreç içinde ayırt edilmesi için verilen isimdir. Varsayılan olarak "Sap Guı Grid View Operation" olarak ayarlanır.
Description : Aktivitenin işlevini açıklayan isteğe bağlı bir not alanıdır. Sürecin bakımını kolaylaştırmak için kullanılır.
Delay Before : Aktivite başlamadan önce geçen bekleme süresini (saniye cinsinden) belirtir.
Varsayılan Değer: 0 (Bekleme olmadan çalışır).
Örnek Kullanım: Aktivitenin çalıştırılmasından önce belirli bir süre beklemek gerekiyorsa, bu süre burada belirtilir. Örneğin, 2 yazılırsa aktivite başlamadan önce 2 saniye bekler.
Delay After: Aktivite tamamlandıktan sonra geçen bekleme süresini (saniye cinsinden) belirtir.
Varsayılan Değer: 0 (Bekleme olmadan bir sonraki aktiviteye geçer).
Örnek Kullanım: İşlem tamamlandıktan sonra sistemde gecikmeler yaşanıyorsa ya da sonraki adımın başlaması için bir süre verilmesi gerekiyorsa, bu alanda belirtilir.
Continue On Error: Aktivite sırasında bir hata oluştuğunda sürecin devam edip etmeyeceğini kontrol eden özelliktir.
True: Aktivite hata aldığında bile süreç çalışmaya devam eder.
False: Aktivite hata alırsa süreç durur.
Varsayılan Değer: False (Varsayılan olarak süreç hata alırsa durur).
Örnek Kullanım: Kritik olmayan işlemlerde hata olsa bile sürecin devam etmesi isteniyorsa bu seçenek True olarak ayarlanır. Örneğin, bir dosyanın varlığını kontrol eden bir aktivitede hata alınırsa ve süreç bu hataya rağmen devam etmeliyse bu seçenek aktif edilir.
Inputs
Sap By Type
Veri Tipi: Text
Açıklama: SAP Grid View bileşeninin belirlenme yöntemini belirtir. Aşağıdaki değerlerden biri seçilmelidir:
Name: Grid View bileşenini adıyla bulur.
Id: Grid View bileşenini benzersiz kimliğiyle bulur.
NameEx: Genişletilmiş ad ile Grid View bileşenini bulur.
Name
Veri Tipi: Text
Açıklama: İşlem yapılacak SAP Grid View bileşeninin adını belirtir (Sap By Type = Name veya NameEx seçildiğinde kullanılır).
Type
Veri Tipi: Text
Açıklama: SAP Grid View bileşeninin türünü belirtir (örn. "GuiGridView").
Id
Veri Tipi: Text
Açıklama: SAP Grid View bileşeninin benzersiz kimliğini belirtir (Sap By Type = Id seçildiğinde kullanılır).
Sap Gui Grid Op Method
Veri Tipi: Text
Açıklama: Gerçekleştirilecek işlemi belirtir. Aşağıdaki değerlerden biri seçilmelidir:
ClearSelection: Seçili hücreleri temizler.
Click: Belirtilen hücreye tek tıklar. Özellikle mavi renkli, altı çizili linklere (Hotspot) tıklamak için kullanılır.
ClickCurrentCell: Geçerli hücreyi tıklar.
ClickWithCellValue: Belirtilen sütundaki tüm hücreleri baştan aşağı tarar; içeriği sizin aradığınız değere eşleştiği an o satırı seçer (SelectedRows) ve odağı o hücreye taşır.
ContextMenu: : SAP Grid üzerinde sağ tıklama (Context Menu) işlemini tetikler. Bu metot menüyü görsel olarak ekrana çizmez, işlemleri hızlandırmak için hafızada sanal olarak açar.
CurrentCellMoved: Geçerli hücreyi taşır.
SelectedRows:Belirtilen satır veya satırları tabloda seçili hale getirir (Sol taraftaki satır seçme kutucuklarını işaretler). Mevcut seçili satırları okumaz, satır seçimi yapar.
DeleteRows: Seçili satırları siler.
DeselectColumn: Belirtilen sütunun seçim işaretini kaldırır.
DoubleClick: Belirtilen satır ve sütunun kesiştiği hücreye çift tıklar. Hücrenin içine girmek veya bir detayı açmak için kullanılır.
DoubleClickCurrentCell: Geçerli hücreye çift tıklar.
DuplicateRows: Seçili satırları çoğaltır.
GetCellCheckBoxChecked: Belirtilen hücredeki checkbox’ın işaretli olup olmadığını kontrol eder.
InsertRows: Belirtilen satır numarasına yeni satır ekler.
MoveRows: Seçili satırları taşır.
PressButton: Tablonun üstündeki araç çubuğunda (Toolbar) yer alan düğmelere DEĞİL, doğrudan bir hücrenin içine yerleştirilmiş olan gerçek bir butona (Pushbutton) basar.
PressButtonCurrentCell: Geçerli hücredeki butona basar.
PressColumnHeader: Belirtilen sütun başlığını tıklar.
PressEnter: : Tablo seçiliyken klavyeden "Enter" tuşuna basma eylemini simüle eder.
SelectAll: Tüm hücreleri seçer.
SelectColumn: Belirtilen sütunu seçer.
SetCurrentCell: Geçerli hücreyi belirler.
VisibleRowCount: Görünür satır sayısını döndürür.
RowCount: Grid View'deki toplam satır sayısını döndürür.
ModifyCell: Tabloda düzenlenebilir (Editable) olarak ayarlanmış bir hücrenin içerisine veri yazar
PressToolbarButton: Tablonun hemen üstünde bulunan araç çubuğundaki (Toolbar) butonlara (Büyüteç, Sil, Yazdır vb.) basar.
SelectContextMenuItem: Görünmez/Sanal olarak açılmış olan sağ tık (Context) menüsünden belirli bir seçeneği (Örn: Kopyala, Bul) tetikler.
PressTotalRowCurrentCell: Toplam satır için geçerli hücrede işlem yapar.
CurrentCellRow: Mevcut aktif satırın indeksini okumaz. Tablodaki odağı doğrudan verdiğiniz satır numarasına taşır.
GetCellValue:Tablodaki belirli bir hücrenin içindeki metni okuyup dışarıya (Result değişkenine) aktarır.
ExtractTable:Tablodaki (Grid) tüm satırları ve sütunları arka planda son hızda tarar ve bütün tabloyu tek bir DataTable değişkenine kopyalar.
PressToolbarContextButton:SAP Grid üzerinde bulunan araç çubuğundaki (Toolbar) belirtilen butonun Context Menu menüsünü açar. İşlem yapılacak buton ilgili butonun teknik adı/ID değeri kullanılarak belirtilir.
Row
Veri Tipi: Number
Açıklama: İşlem yapılacak satırın numarasını belirtir.
Column
Veri Tipi: Text
Açıklama: İşlem yapılacak sütunun adını belirtir.
Rows
Veri Tipi: Text
Açıklama: Birden fazla satırı içeren işlemler için satırları belirtir.
Columns
Veri Tipi: Text
Açıklama: Birden fazla sütunu içeren işlemler için sütunları belirtir.
From Row
Veri Tipi: Number
Açıklama: Kopyalama veya taşıma işlemleri için başlangıç satırını belirtir.
Dest Row
Veri Tipi: Number
Açıklama: Kopyalama veya taşıma işlemleri için hedef satırını belirtir.
To Row
Veri Tipi: Number
Açıklama: Satır taşıma işlemleri için bitiş satırını belirtir.
Value
Veri Tipi: Text
Açıklama: Belirtilen hücreye yazılacak değeri belirtir.
Outputs
Result
Veri Tipi: Collection
Açıklama: SAP Grid View bileşeninden elde edilen veri veya işlem sonucunu içerir.
Altın Kurallar
SAP tablo aktiviteleri kullanılırken aşağıdaki kurallara dikkat edilmelidir:
SAP By Type ve Id Kullanımı
SAP By Type ve buna karşılık gelen Id/Name alanlarının doldurulması zorunludur.
Kullanılan metottan (ContextMenu, Click vb.) bağımsız olarak robotun ekrandaki tabloyu doğru şekilde bulabilmesi için:
SAP By Type alanı (Örn: Id) seçilmelidir.
Seçilen tipe karşılık gelen Id veya Name değeri girilmelidir.
Not: Metot açıklamalarında “Tüm parametreler boş bırakılır.” ifadesi kullanıldığında bu ifade yalnızca Row, Column, Value, Rows gibi operasyonel parametreler için geçerlidir. SAP By Type ve Id/Name alanları her zaman doldurulmalıdır.
Satır (Row) Kullanımı
SAP sisteminde satır indeksleri 0'dan başlar.
Örneğin:
İlk satır için → 0
İkinci satır için → 1
Üçüncü satır için → 2
Bu nedenle Row parametresine işlem yapılacak satırın indeks değeri girilmelidir.
Sütun (Column) Kullanımı
Column parametresine ekranda görünen Türkçe veya İngilizce sütun başlığı (Örn: “Oda”, “Miktar”) girilmemelidir.
Bu alanda sütunun SAP sistemindeki Teknik Alan Adı (Field Name) kullanılmalıdır.
Teknik alan adını bulmak için:
İlgili tablo hücresine tıklanır.
Klavyeden F1 tuşuna basılır.
Açılan pencerede Teknik Bilgi (çekiç ikonlu) butonuna tıklanır.
Field Name alanındaki değer alınır.
Bulunan değer büyük harflerle Column parametresine girilir.
Örnek Field Name değerleri: XHABITACION, MATNR
Örnek Kullanımlar:
CurrentCellRow
Çalışma Şekli:
Rowalanında belirtilen satır tablo üzerinde aktif hale getirilir. İşlem Success döner, veri üretmez (Result boştur).Kullanım:
Sap Gui Grid Op Method alanından
CurrentCellRowseçin.Row alanına hedef satır numarasını (Örn:
0) girin.Column, Value, Rows gibi diğer operasyonel alanları boş bırakın.
Not: SAP tablolarında satır indeksleri
0'dan başlar. İlk satır için0, ikinci satır için1kullanılmalıdır.
GetCellValue
Çalışma Şekli:
RowveColumnparametreleri kullanılarak hedef hücre belirlenir ve hücrenin değeri okunur. İşlem sonucunda okunan veri Result alanında döner.Kullanım:
Sap Gui Grid Op Method alanından
GetCellValueseçin.Row alanına hedef satır numarasını (Örn:
0) girin.Column alanına hedef sütunun teknik adını (Örn:
MATNR) girin.Diğer operasyonel alanları boş bırakın.
Not: Column alanına ekranda görünen sütun başlığı değil, SAP sistemindeki teknik alan adı (Field Name) girilmelidir. Yanlış teknik alan adı kullanılması durumunda işlem hata verebilir.
ExtractTable
Çalışma Şekli: Grid içerisindeki tablo verileri arka planda taranır ve elde edilen tüm veriler Result üzerinden bir DataTable olarak döndürülür.
Kullanım:
Sap Gui Grid Op Method alanından
ExtractTableseçin.Row, Column, Value, Rows gibi operasyonel parametreleri boş bırakın.
Result alanında dönen değeri bir DataTable değişkenine aktarın.
Not: Tablo içerisindeki tüm verilerin tek seferde alınması gerektiği durumlarda kullanılır. Tek bir hücrenin değerini okumak için
GetCellValuetercih edilmelidir.
PressToolbarButton
Çalışma Şekli:
Valuealanında belirtilen butona basma işlemini tetikler. Row bilgisini dikkate almaz. İşlem Success döner, veri üretmez (Result boştur).Kullanım:
Butona basıldığında belirli bir satıra ait işlem gerçekleştirilecekse, öncelikle
SelectedRowsmetodu kullanılarak ilgili satırı seçin.Yeni bir aktivite ekleyerek Sap Gui Grid Op Method alanından
PressToolbarButtonseçin.Row ve Column alanlarını boş bırakın.
Value alanına butonun SAP içerisindeki Function Code değerini (Örn:
&INFO,&DETAIL) girin.
Not:
PressToolbarButtonmetodu Row parametresini kullanmaz. Row alanına bir değer girilse dahi bu değer dikkate alınmaz. Belirli bir satır üzerinde işlem yapılacaksa ilgili satırın öncedenSelectedRowsile seçilmesi gerekir.
Last updated