BotreamDokümanlar Web sitesi English v0.1.1

Tarayıcı eklentisini kurun

Botream Element Capture eklentisi, seçicisini doldurmak için Chrome veya Edge'de bir elemente tıklamanızı sağlar ve tarayıcıda yaptıklarınızı kaydeder; normalde ajan kurulum paketi tarafından sizin için kurulur.

Eklenti ne yapar

  • Element yakalama: Düzenleyicide bir Selector alanının yanındaki Capture düğmesi, elemente tarayıcınızda tıklamanızı sağlar. Eklenti elementi nasıl bulacağını belirler ve seçiciyi düzenleyiciye geri gönderir. Bkz. Elementleri bulma.
  • Kayıt: Düzenleyici araç çubuğundaki Record, tıklamalarınızı, yazdıklarınızı, seçimlerinizi, tuşları ve açtığınız sayfaları not eder (parolalar hariç tutulur) ve bunları göreve komut olarak ekler. Bkz. Kayıt.

Eklenti yalnızca görev oluşturmak içindir. Görevleri çalıştırmak için gerekmez: ajan tarayıcıyı Playwright aracılığıyla kendisi yönetir.

Nasıl bağlanır

Eklenti yalnızca aynı bilgisayardaki Botream Agent ile iletişim kurar:

Editor (web app) ──▶ Botream Server ──▶ Botream Agent (tray app) ──▶ extension
                                        ws://127.0.0.1:17311
  • Ajan, 127.0.0.1 geri döngü adresinde, 17311 portunda dinler. Ağdan hiçbir şey ona ulaşamaz ve yalnızca tarayıcı eklentilerini kabul eder, web sayfalarını kabul etmez.
  • Yakalama yaptığınız bilgisayarda Botream Agent tepsi uygulaması çalışıyor olmalıdır. Kimsenin oturum açmadığı bir makinede yakalama yapılamaz.
  • Bu nedenle yakalamayı hem tarayıcının hem de bir ajanın bulunduğu bir bilgisayarda yaparsınız — genellikle kendi iş istasyonunuzda.

Otomatik kurulum (ajan kurulum paketi)

Ajan kurulum paketinde Install the Botream extension in Chrome and Edge işaretliyse (varsayılan), kurulum eklentiyi Chrome ve Edge'in zorunlu kurulum ilkesine (ExtensionInstallForcelist) ekler. Tarayıcılar ardından eklentiyi Botream sunucunuzdan (<server>/extension/update.xml) kurar ve oradan güncel tutar. Kullanıcılar eklentiyi kaldıramaz.

Not: Tarayıcılar, Chrome Web Mağazası dışından gelen eklentileri yalnızca yönetilen makinelerde kabul eder: bir Active Directory etki alanına katılmış veya Chrome Browser Cloud Management ya da Intune gibi bir tarayıcı yönetim hizmetine kaydedilmiş makineler. Yönetilmeyen bir makinede ilke yok sayılır ve eklentiyi elle kurarsınız (aşağıya bakın).

İlkeyi atlamak için sihirbazdaki onay kutusunu temizleyin veya sessiz kurulumda EXTENSION=0 değerini geçirin (Ajanları kurun). Ajanı kaldırmak ilkeyi de kaldırır.

Kuruluşunuz eklentiyi bunun yerine Chrome Web Mağazası üzerinden dağıtıyorsa ajan kurulum paketi, aynı ilkeyi mağazaya yönlendirecek şekilde derlenir. Edge, Chrome Web Mağazası eklentilerini aynı ilke üzerinden kurar.

İlkeyi kontrol edin

chrome://policy (veya edge://policy) adresini açın ve ExtensionInstallForcelist öğesini arayın. Ardından chrome://extensions (veya edge://extensions) adresini açın: Botream Element Capture listelenmiş ve etkin olmalıdır.

Elle kurulum (geliştirici modu)

İlkenin etkili olmadığı bir makinede:

  1. Paketten çıkarılmış eklenti klasörünü Botream yöneticinizden alın (kurulum paketleriyle birlikte gelen eklenti paketi, zip'ten çıkarılmış olarak).
  2. chrome://extensions (veya edge://extensions) adresini açın.
  3. Developer mode seçeneğini açın.
  4. Load unpacked düğmesine tıklayın ve eklenti klasörünü seçin.

Bu şekilde yüklenen bir eklenti otomatik olarak güncellenmez: bir Botream yükseltmesinden sonra yeni sürümü yükleyin.

Çalıştığını kontrol edin

Tarayıcı araç çubuğunda eklentinin simgesine tıklayın (yapboz parçası menüsünün altında gizliyse önce sabitleyin). Açılır pencere bağlantı durumunu gösterir:

Açılır pencere Anlamı
Connected to the Botream Agent Hazır. Düzenleyicide bir seçicinin yanındaki yakalama düğmesini kullanın.
Botream Agent not running Bu bilgisayarda Botream Agent'ı başlatın. Eklenti ona otomatik olarak bağlanır; Try again hemen yeniden dener.
Capturing Bir yakalama sürüyor: sayfada bir elemente tıklayın veya iptal etmek için Esc tuşuna basın.

Eklenti ajana ulaşamadığı sürece simgesinde kırmızı bir ! görünür.

Eklentinin metinleri (açılır pencere, sayfadaki yakalama başlığı ve kayıt çubuğu) tarayıcının dilini izler: Chrome veya Edge Türkçe çalışıyorsa Türkçe, aksi halde İngilizce görünür. Türkçe tarayıcıda yukarıdaki durumlar Botream Ajanına bağlı, Botream Ajanı çalışmıyor (Yeniden dene ile) ve Yakalanıyor olarak gösterilir.

Bir element yakalayın

  1. Otomatikleştirmek istediğiniz sayfayı bir Chrome sekmesinde açın.
  2. Düzenleyicide Selector alanı olan bir komut seçin (örneğin capture) ve yanındaki Capture düğmesine tıklayın.
  3. Tarayıcı doğru sekmeyi gösterir: açıksa komutun --browser sayfasının adresine sahip sekmeyi (aynı adres, yoksa aynı site), aksi halde en son kullandığınız sekmeyi.
  4. Fareyi hareket ettirdikçe elementler vurgulanır. Elemente tıklayın: tıklama sayfaya ulaşmaz ve düzenleyici öne gelir. Esc yakalamanın iptal edilip edilmeyeceğini sorar.
  5. Birden fazla seçici bulunduysa düzenleyicide birini seçin ve Use selected düğmesine tıklayın.

Birden fazla ajan çevrimiçiyse düzenleyici önce bu bilgisayardakini seçmenizi ister.

Bazı sayfalar yakalanamaz: chrome:// gibi tarayıcı sayfaları, Chrome Web Mağazası, yerleşik PDF görüntüleyici ve Botream web uygulamasının kendisi.

Sorun giderme

Yakalama çalışmıyor

Bunları sırayla kontrol edin:

Kontrol Nasıl
Ajan tepsi uygulaması bu bilgisayarda çalışıyor Botream Agent simgesi bildirim alanındadır ve araç ipucunda Connected yazar. Yakalama iletişim kutusunun hata mesajı bu gereksinimi yineler: The Botream Agent must run on this computer and the Botream Element Capture extension must be installed in Chrome.
Eklenti kurulu ve etkin chrome://extensions, Botream Element Capture eklentisini etkin olarak listeler. Eksikse chrome://policy sayfasını ve makinenin yönetilip yönetilmediğini kontrol edin veya eklentiyi elle kurun.
Eklenti ajana ulaşıyor Açılır pencerede Connected to the Botream Agent yazar ve simgede kırmızı ! yoktur. Değilse ajanı başlatın ve Try again düğmesine tıklayın.
Doğru ajan kullanıldı Birden fazla ajan çevrimiçiyken düzenleyici sorduğunda bu bilgisayardakini seçin.
Sayfa yakalanabilir Sayfayı normal bir sekmede açın (chrome://, Web Mağazası veya bir PDF değil) ve Botream web uygulamasının kendi sekmesinde açmayın.
Sayfa açık Capture, elementi bir görev çalıştırmasının açtığı tarayıcıda değil, kendi tarayıcınızda seçer. Önce sayfayı Chrome'da açın.

Eklenti kendiliğinden kurulmuyor

  • Makine yönetilmiyor, bu nedenle Chrome ve Edge ilkeyi yok sayıyor: eklentiyi elle kurun.
  • Ajan EXTENSION=0 ile veya onay kutusu temizlenerek kurulmuş, bu nedenle ilke eklenmemiş: eklentiyi elle kurun.
  • Tarayıcı ilkeyi henüz almamış: tarayıcıyı yeniden başlatın veya chrome://policy adresini açıp Reload policies düğmesine tıklayın.
Botream 0.1.1 · Oluşturulma 2026-10-14