> For the complete documentation index, see [llms.txt](https://docs.genrpa.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.genrpa.com/aktiviteler/sap-automation/sap-gui-grid-view-operation.md). # 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: 1. İlgili tablo hücresine tıklanır. 2. Klavyeden F1 tuşuna basılır. 3. Açılan pencerede Teknik Bilgi (çekiç ikonlu) butonuna tıklanır. 4. Field Name alanındaki değer alınır. 5. Bulunan değer büyük harflerle Column parametresine girilir. Örnek Field Name değerleri: XHABITACION, MATNR ### **Örnek Kullanımlar:** **CurrentCellRow** * **Çalışma Şekli:** `Row` alanında belirtilen satır tablo üzerinde aktif hale getirilir. İşlem **Success** döner, veri üretmez (**Result** boştur). * **Kullanım:** 1. **Sap Gui Grid Op Method** alanından `CurrentCellRow` seçin. 2. **Row** alanına hedef satır numarasını (Örn: `0`) girin. 3. **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çin `0`, ikinci satır için `1` kullanılmalıdır. **GetCellValue** * **Çalışma Şekli:** `Row` ve `Column` parametreleri kullanılarak hedef hücre belirlenir ve hücrenin değeri okunur. İşlem sonucunda okunan veri **Result** alanında döner. * **Kullanım:** 1. **Sap Gui Grid Op Method** alanından `GetCellValue` seçin. 2. **Row** alanına hedef satır numarasını (Örn: `0`) girin. 3. **Column** alanına hedef sütunun teknik adını (Örn: `MATNR`) girin. 4. 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:** 1. **Sap Gui Grid Op Method** alanından `ExtractTable` seçin. 2. **Row, Column, Value, Rows** gibi operasyonel parametreleri boş bırakın. 3. **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 `GetCellValue` tercih edilmelidir. **PressToolbarButton** * **Çalışma Şekli:** `Value` alanında belirtilen butona basma işlemini tetikler. **Row** bilgisini dikkate almaz. İşlem **Success** döner, veri üretmez (**Result** boştur). * **Kullanım:** 1. Butona basıldığında belirli bir satıra ait işlem gerçekleştirilecekse, öncelikle `SelectedRows` metodu kullanılarak ilgili satırı seçin. 2. Yeni bir aktivite ekleyerek **Sap Gui Grid Op Method** alanından `PressToolbarButton` seçin. 3. **Row** ve **Column** alanlarını boş bırakın. 4. **Value** alanına butonun SAP içerisindeki **Function Code** değerini (Örn: `&INFO`, `&DETAIL`) girin. * **Not:** `PressToolbarButton` metodu **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 önceden `SelectedRows` ile seçilmesi gerekir.