Script ve HTTP Aktiviteleri

Üst sayfa: PAW Robot/Stüdyo › Aktiviteler Modül: PAWRobot.Script, PAWRobot (çekirdek) Kapsam: Kod çalıştırma, HTTP istekleri, JSON


Genel Bakış

Script ve HTTP aktiviteleri, PAW Robot/Stüdyo içerisinde özel kodların çalıştırılması, harici servislerle iletişim kurulması ve JSON formatındaki verilerin işlenmesi için kullanılır.

  • Script Aktiviteleri: C#, VB, PowerShell ve Python gibi desteklenen dillerde özel kodların çalıştırılmasını sağlar.

  • HTTP Aktiviteleri: REST API servislerine istek gönderilmesini ve yanıtların alınmasını sağlar.

  • JSON Aktiviteleri: Nesnelerin JSON formatına dönüştürülmesini ve JSON verilerinin nesnelere veya desteklenen veri yapılarına aktarılmasını sağlar.

Bu aktiviteler birlikte kullanılarak harici sistemlerden veri alınabilir, veriler dönüştürülebilir ve otomasyon süreçlerine dahil edilebilir.


Script Aktiviteleri

Aktivite

Açıklama

Kod Çalıştır

C#, VB, PowerShell veya Python dillerinde kod çalıştırır

InvokeCode Kullanımı

InvokeCode aktivitesi, standart aktivitelerle doğrudan gerçekleştirilemeyen özel işlemleri kod yazarak gerçekleştirmek için kullanılır.

  1. InvokeCode aktivitesini iş akışına ekleyin.

  2. Aktivitenin kod editörünü açın.

  3. Desteklenen programlama dilini seçin ve kodunuzu yazın.

  4. Gerekiyorsa aktivitenin argümanlarını tanımlayarak iş akışındaki değişkenleri kod içerisinde kullanın.

  5. Kodun ürettiği sonuçları uygun çıkış argümanları üzerinden iş akışına aktarın.

  6. İş akışını çalıştırarak sonucu ve olası hataları kontrol edin.

Kullanım önerisi: Basit veri işlemlerinde standart aktiviteleri tercih edin. Karmaşık dönüşümler, özel hesaplamalar veya birden fazla kod adımı gerektiren işlemler için InvokeCode kullanın.

💡 İpucu: Karmaşık veri dönüşümleri ve özel mantık için InvokeCode kullanın; basit işlemler için görsel aktiviteleri tercih edin.


HTTP ve Ağ Aktiviteleri

Aktivite

Açıklama

HTTP İsteği Oluştur

HTTP isteği oluşturur (GET, POST, PUT, DELETE vb.)

Tipik kullanım: REST API çağrısı → JSON yanıt → DeserializeJson → DataTable işleme.

HTTP İsteği Oluştur Kullanımı

HTTP İsteği Oluştur aktivitesi, harici servislerle HTTP protokolü üzerinden iletişim kurmak için kullanılır.

İstek yapılandırılırken aşağıdaki bilgiler, aktivitenin desteklediği alanlara göre belirlenir:

  • İstek adresi (URL): Çağrılacak servis adresi.

  • HTTP metodu: Servisin gereksinimine göre GET, POST, PUT veya DELETE gibi bir metot.

  • Başlıklar (Headers): Kimlik doğrulama bilgileri veya içerik türü gibi ek istek bilgileri.

  • İstek gövdesi (Body): POST ve PUT gibi metotlarda servise gönderilecek veri.

  • Yanıt: Servisten dönen durum kodu ve içerik.

İstek tamamlandıktan sonra dönen yanıt kontrol edilmeli; başarılı sonuçlar işlenmeli, hata durumları ise sürecin gereksinimlerine uygun şekilde ele alınmalıdır.

Dikkat: API anahtarları ve erişim belirteçleri gibi hassas bilgiler kod içerisine doğrudan yazılmamalı, uygun güvenli saklama yöntemleri kullanılmalıdır.


JSON Aktiviteleri (Çekirdek)

Aktivite

Açıklama

Nesneyi JSON'a Dönüştür

Nesneyi JSON string'e dönüştürür

JSON'u Nesneye Dönüştür

JSON string'i nesneye veya DataTable'a dönüştürür

JSON Serileştirme ve Seriden Çıkarma

Nesneyi JSON'a Dönüştür: Bir nesneyi JSON metnine dönüştürerek API isteği gibi işlemlerde kullanılmasını sağlar.

JSON'u Nesneye Dönüştür: JSON formatındaki metni, desteklenen nesne veya veri yapısına dönüştürerek işlenebilir hale getirir.

Örnek kullanım akışı:

  1. HTTP İsteği Oluştur aktivitesiyle API'ye istek gönderin.

  2. Dönen JSON yanıtını JSON'u Nesneye Dönüştür aktivitesiyle uygun veri yapısına dönüştürün.

  3. Elde edilen verileri ilgili aktivitelerle işleyin.

  4. Gerekirse işlenen verileri Nesneyi JSON'a Dönüştür aktivitesiyle yeniden JSON formatına dönüştürün.


Örnek Senaryo: Sipariş Verilerinin API Üzerinden Alınması

Bir e-ticaret servisinden sipariş verilerinin alınarak otomasyon sürecinde işlenmesi için aşağıdaki akış uygulanabilir:

  1. HTTP İsteği Oluştur: Sipariş servisine GET isteği gönderilir.

  2. Yanıt kontrolü: İsteğin başarılı olup olmadığı kontrol edilir.

  3. JSON'u Nesneye Dönüştür: Servisten dönen JSON yanıtı uygun veri yapısına dönüştürülür.

  4. Veri işleme: Elde edilen kayıtlar döngü veya veri işleme aktiviteleriyle değerlendirilir.

  5. Hata yönetimi: Bağlantı hataları, başarısız HTTP durum kodları ve beklenmeyen yanıtlar ele alınır.

Not: Kullanılacak JSON dönüşüm biçimi ve veri işleme yöntemi, API yanıtının yapısına ve PAW aktivitelerinin desteklediği veri tiplerine göre belirlenmelidir.