Save Source

1. Kuika platformuna giriş yapın.
2. Apps ekranından çalışacağınız projeyi açın.
3. UI Design modülündeyken sağ kenarda bulunan Properties panelini açın.

4. +ADD ACTION açılır menüsünden Initial Actions → Searching → Save Source seçimini yapın.
5. Açılan ayarlar panelinde aşağıdaki alanları yapılandırın:

• Source Type: Kaynağın türünü belirtir. Google Drive, AWS S3 veya Manual kaynak türlerinden biri seçilmelidir.
• Name: Kaynağa verilen tanımlayıcı isimdir.
• Update Interval In Hour: Kaynağın ne sıklıkta senkronize edileceğini saat cinsinden belirtir.

6. + ADD OPTIONAL PARAMETER açılır menüsüne tıklayın ve aşağıdaki parametreleri ekleyin:
   
   • Collection Name: Veritabanı veya koleksiyon ismini belirtir. Bu, verilerin saklandığı yapıyı tanımlar.
   • Correlation ID: İşlem veya kullanıcı oturumu ile ilişkilendirilmiş benzersiz bir kimliktir. Örneğin, bir API çağrısının yanıtını takip etmek veya bir hata mesajını belirli bir işlemle ilişkilendirmek için kullanılabilir.
7. SAVE butonuna tıklayarak yapılandırma işlemini tamamlayın.
   

1. + ADD OPTIONAL PARAMETER açılır menüsüne tıklayın. 
2. Açılan menüden aşağıdaki parametreleri yapılandırın: 

• Collection Name: Veritabanı veya bir koleksiyonun ismini belirtir ve verilerin saklandığı yapıyı tanımlar. Örneğin, bir NoSQL veritabanında bu, verilerin gruplandığı koleksiyonun adıdır. 
• Correlation ID: Bir işlem veya kullanıcı oturumu ile ilişkilendirilmiş benzersiz bir kimliktir. İşlemlerin ve olayların izlenmesi ve ilişkilendirilmesi için kullanılır. Örneğin, bir API çağrısının yanıtını takip etmek veya bir hata mesajını belirli bir işlemle ilişkilendirmek için kullanılabilir. 

      3. Ardından SAVE butonuna tıklayarak yapılandırma işlemini tamamlayın.

Google Drive'ın kullanılması için yetkilendirilmiş bir Google Console hesabı gereklidir.

Proje Oluşturma ve Seçme

1. Google Cloud Console sayfasında APIs & Services ekranına erişin.

2. Yeni bir proje oluşturun veya mevcut bir projeyi seçin.

3. Eklenecek kaynak bir organizasyon hesabına aitse, proje bu organizasyondan türetilmelidir.

Google Drive API Aktifleştirme

1. APIs & Services ekranına erişin.
2. Google Drive API'yi etkinleştirin.

Service Account Oluşturma ve Erişim

1. IAM & Admin ekranına erişin.

2. Gerekirse yeni bir Service Account oluşturun.
3. Rol listesinden "Viewer" seçeneğini seçin.

Key Oluşturma

1. Service Account bölümünde Manage Keys seçeneğine gidin.

2. Create New Key butonuna tıklayın ve JSON formatında bir key oluşturun.

3. İndirilen JSON dosyasından aşağıdaki bilgileri alın:
   
   • private_key
   • client_email
   • token_uri

Bu bilgiler üzerinden kaynak eklenebilir. private_key bilgisi, BEGIN ve END PRIVATE KEY alanlarını da içerecek şekilde eklenmelidir.

FileID ve FolderID Alma

1. Google Drive'da dosyanızın paylaşım linkini kopyalayın.
2. Link içinde yer alan fileID ve folderID bilgilerini kaydedin.

Örnek bağlantı:

https://drive.google.com/file/d/1vNG371Q2ZAkC0X7e8AHm2lftTMRSqWO_/view?usp=sharing

Burada 1vNG371Q2ZAkC0X7e8AHm2lftTMRSqWO_ kısmı fileID'dir.

Save Source Tanımlama

• Source Type: Google Drive
• Name: Dosya ismi
• Update Interval in Hour: Kaynağın kaç saatte bir senkronize edileceğini belirler.
• Client Email, Private Key, Token Uri, Folder Id ve File Id gibi bilgiler Google Drive servis hesabına ait JSON dosyasından alınmalıdır.

Amazon S3 kullanımı için S3'e read access sahibi bir hesap gerekmektedir.

IAM User Oluşturma

1. IAM bölümüne gidin ve Add Users butonuna tıklayın.

2. Kullanıcı adını belirleyin ve ilerleyin.

3. "Attach policies directly" seçeneğinden AmazonS3ReadOnlyAccess poliçesini atayın.

4. Kullanıcıyı oluşturduktan sonra Security Credentials ekranından Access Key oluşturun.
5. Access Key ve Secret Access Key bilgilerini bir yere kaydedin.

Bu bilgiler yalnızca bir kez görüntülenir.

Save Source Tanımlama

1. Source Type → AWS
2. Name → Dosya ismi
3. Update Interval in Hour → Senkronizasyon süresi
4. Gerekli bilgileri ekleyin:
   
   • awsAccessKeyId
   • awsSecretAccessKey
   • bucketName
   • S3uri

Manual yükleme işlemi Base64 formatında dosya yüklenmesini sağlar.

Base64 Formatına Dönüştürme

1. https://base64.guru/converter/encode/file gibi bir çevrim sitesi kullanarak dosyanızı Base64 formatına dönüştürün.

Save Source Tanımlama

1. Source Type → Manual
2. Name → Dosya ismi
3. Update Interval in Hour → Senkronizasyon süresi
4. Base64 Content → Base64 formatındaki dosya içeriği

Google Drive Save Source Action’da Folder Id ve File Id Parametrelerinin Alınması ve Kullanılması

Google Drive’da Dosya Kimliklerini (ID) Alma

1. Google Drive'da, bir klasörün içine eklenen dosyaya sağ tıklayın ve
   Paylaş → Paylaş seçeneklerine tıklayın.
2. Açılan ekranda, service account kullanıcı hesabının görüntüleme erişimine sahip olduğundan emin olun.
3. Bağlantıyı Kopyala butonuna tıklayın.
4. Kopyalanan bağlantıyı bir yere yapıştırın.
5. Bağlantıda yer alan File ID ve Folder ID’yi alın:
   Örnek bağlantı:

https://drive.google.com/file/d/1vNG371Q2ZAkC0X7e8AHm2lftTMRSqWO_/view?usp=sharing

6. Buradaki alan: 1vNG371Q2ZAkC0X7e8AHm2lftTMRSqWO_ → File ID
   Klasör için bağlantı örneği:
   
   

https://drive.google.com/drive/folders/18V8ZSYTNE8T_gKum3ZVUK5wHZQM3s2aa

7. Buradaki alan: 18V8ZSYTNE8T_gKum3ZVUK5wHZQM3s2aa → Folder ID
   
   

Arayüzde Save Source Action’ı Oluşturma

1. UI Design modülünde, sol kenardaki Elements panelinden bir Button elementi ekleyin.
2. Bu butonun onClick aksiyonunda Save Source action’ını tanımlayın.
3. Aşağıdaki parametreleri yapılandırın:

Google Drive İçin Save Source Parametreleri

• Source Type: Google Drive
• Name: Dosyanın adı (Kullanıcı tarafından belirlenir)
• Update Interval in Hour: 1 (Bu, sistemin dosyayı kaç saatte bir senkronize edeceğini belirtir.)
• Client Email: test-652@vector-search-test-443209.iam.gserviceaccount.com (Google Drive ortamında, görüntüleme yetkisine sahip service account e-posta adresi)
• Private Key:

-----BEGIN PRIVATE KEY-----

…….

-----END PRIVATE KEY-----

(Google Drive JSON dosyasındaki private key bilgisi)

• Token Uri: https://oauth2.googleapis.com/token (Google Drive ortamını hazırlarken JSON dosyasından alınan Token URI)
• Folder Id: 18V8ZSYTNE8T_gKum3ZVUK5wHZQM3s2aa (Google Drive klasör kimliği - Folder ID)
• File Id: 1vNG371Q2ZAkC0X7e8AHm2lftTMRSqWO_ (Google Drive dosya kimliği - File ID)
• Collection Name (opsiyonel): googledrive1 (Qdrant sisteminde belirli bir koleksiyon ismi belirler. Girilmezse, DefaultCollection olarak alınır.)
• Correlation Id (opsiyonel): correlationId (Kaynağın güncellenmesi veya kimlik değişikliklerinde kaydın yeniden eklenmesini sağlar.)

Amazon S3 İçin Save Source Action’ı Oluşturma

1. UI Design modülünde, bir Button ekleyin.
2. Bu butonun onClick aksiyonunda Save Source action’ını tanımlayın.
3. Aşağıdaki parametreleri yapılandırın:

Amazon S3 Save Source Parametreleri

• Source Type: AWS
• Name: Dosyanın adı (Kullanıcı tarafından belirlenir.)
• Update Interval in Hour: 1 (Dosyanın kaç saatte bir senkronize edileceğini belirtir.)
• awsAccessKeyId: key (AWS erişim anahtarı)
• awsSecretAccessKey: key (AWS gizli erişim anahtarı)
• Bucket Name: test-bucket-vector-search (AWS ortamında kullanılan bucket adı)
• S3uri: s3://test-bucket-vector-search/s3Folder/ (AWS ortamında, S3 dosya yolu)
• Collection Name (opsiyonel): googledrive1
• Correlation Id (opsiyonel): correlationId

Manual Save Source Action’ı Oluşturma

1. UI Design modülünde, bir Button ekleyin.
2. Bu butonun onClick aksiyonunda Save Source action’ını tanımlayın.
3. Aşağıdaki parametreleri yapılandırın:

Manual Save Source Parametreleri

• Source Type: Manual
• Name: Dosyanın adı (Kullanıcı tarafından belirlenir.)
• Update Interval in Hour: 1 (Dosyanın kaç saatte bir senkronize edileceğini belirtir.)
• Folder Path: null
• File Path: null
• Base64 Content:

data:<mimetype_of_file>;base64,……

• (Dosyanın Base64 formatında içeriğini almak için bir Base64 dönüştürme sitesi kullanılabilir.)
• Collection Name (opsiyonel): googledrive1
• Correlation Id (opsiyonel): correlationId

Bu adımları takip ederek, Google Drive, AWS S3 veya Manual yöntemleriyle kaynaklarınızı Kuika platformunda başarılı bir şekilde yönetebilirsiniz.