Save Source

1. Kuika platformuna giriş yaptıktan sonra “Apps” ekranından çalışacağınız projeyi açın.

2. “UI Design” modülündeyken sağ kenarda bulunan “Properties” panelini açın.
3. “+ADD ACTION” açılır menüsünden “Initial Actions → Searching → Save Source” seçimini yapın. 

4. Ardından aşağıdaki alanları yapılandırın:

• Source Type: Kaynağın türünü belirtir. Google Drive, AWS S3 ve 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.

1. “+ ADD OPTIONAL PARAMETER” (1) 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” (2) butonuna tıklayarak yapılandırma işlemini tamamlayın.

Google Drive'ın kullanılması için kullanıcının yetkilendirilmiş bir hesapla Google Console'ını kullanması gerekir.

1. Proje Oluşturma ve Seçme:
   • Console sayfasında, banner'ın yanında bulunan dropdown menüsünden yeni bir proje oluşturabilir veya mevcut bir projeyi seçebilirsiniz.

• Eklenecek kaynak bir organizasyona ait hesabın drive alanındaysa, proje bu organizasyondan türetilmelidir. Organizasyon ve lokasyon bilgilerini doldurmalısınız.

2. Google Drive API Aktifleştirme:

• Sayfanın üstündeki arama bölümünden “APIs & Services” ekranına erişin ve Google Drive API'yi etkinleştirin.

3. Service Account Oluşturma ve Erişim:
   • “IAM & Admin” ekranına erişin.

• Gerekirse yeni bir Service Account oluşturun.

• Service account bilgilerini doldurun ve rol listesinden “Viewer”'ı seçin.

4. Key Oluşturma:

• Oluşturduğunuz Service Account bölümünün yanında yer alan “Manage Keys” seçeneğine giderek “Create New Key” butonuna tıklayın ve JSON formatında bir key oluşturun.

• İndirilen JSON dosyasından private_key, client_email ve token_uri bilgilerini kayıt altına alın. Bu bilgiler üzerinden kaynak eklenebilir. Private key bilgisi BEGIN ve END PRIVATE KEY alanları da dahil olacak şekilde eklenmelidir.

5. FileID ve FolderID Alma:
   • Google Drive'da dosyanızın paylaşım linkini kopyalayın.
   • Linkte yer alan dosya kimliği (fileID) ve klasör kimliği (folderID) action için kullanılmalıdır.
6. Save Source Tanımlama:
   • Google Drive'dan bir kaynak eklemek için aşağıdaki parametreler doldurulmalıdır: some text
     • Source Type → Google Drive
     • Name → Dosya ismi
     • Update Interval in Hour → Kaç saatte bir senkronizasyon yapılacağını seçmenizi sağlar. 
     • Client Email, Private Key, Token Uri, Folder Id, File Id gibi bilgiler JSON dosyasından alınır.

Amazon S3 kullanımı için S3'e read access sahibi bir hesap gerekmektedir. Bunun için yeni bir IAM User oluşturabilirsiniz.

1. IAM User Oluşturma:

• IAM bölümüne gidin ve “Add Users” butonuna tıklayın.
• Kullanıcı adını belirleyin ve “Next” ile ilerleyin.

• “Attach policies directly” seçeneğinden AmazonS3ReadOnlyAccess poliçesini atayın.

• Kullanıcıyı oluşturduktan sonra Security Credentials ekranından Access Key oluşturun.

2. Access Key Kayıtı:

• Oluşturulan Access Key ve Secret Access Key bilgilerini bir yere kaydedin. 

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

3. Save Source Tanımlama:
   • Amazon S3'ten kaynak eklemek için aşağıdaki parametreler doldurulmalıdır:some text
     • Source Type → AWS
     • Name → Dosya ismi
     • Update Interval in Hour → Kaç saatte bir senkronizasyon yapılacağını seçmenizi sağlar. 

awsAccessKeyId, awsSecretAccessKey, bucketName, S3uri bilgileri gereklidir.

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

1. Base64 Formatına Dönüştürme:
   • Bir çevrim sitesi (örneğin, https://base64.guru/converter/encode/file) kullanarak dosyanızı Base64 formatına dönüştürebilirsiniz.
2. Save Source Tanımlama:
   • Manual yükleme için aşağıdaki parametreler doldurulmalıdır:some text
     • Source Type → Manual
     • Name → Dosya ismi
     • Update Interval in Hour → Kaç saatte bir senkronizasyon yapılacağını seçmenizi sağlar. 
     • Base64 Content → Base64 formatındaki dosya içeriğini belirtir. 

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

1. Google Drive’da Dosya Kimliklerini (ID) Almak
   • Google Drive'da, bir klasörün içine eklenen dosyaya sağ tıklayın ve Paylaş > Paylaş seçeneklerine tıklayın.
   • Açılan ekranda, service account user’ın görüntüleme erişimine sahip olduğundan emin olduktan sonra Bağlantıyı Kopyala butonuna basın.
   • Kopyalanan bağlantıyı bir yere yapıştırın. Kırmızı ile işaretli kısımdan fileId'yi alabilirsiniz. Bu, action içinde kullanacağınız fileId'dir.
2. Örnek bağlantı: https://drive.google.com/file/d/1vNG371Q2ZAkC0X7e8AHm2lftTMRSqWO_/view?usp=sharing
   Buradaki kalın işaretli alan: fileId
   • Aynı şekilde, Drive’daki folderId’yi almak için, klasörün bağlantısını kullanabilirsiniz:https://drive.google.com/drive/folders/18V8ZSYTNE8T_gKum3ZVUK5wHZQM3s2aa
     Buradaki kalın işaretli alan: folderId

Arayüzde Save Source Action’ı Oluşturmak

UI Design modülü sol kenardaki Elements panelinden bir Button elementi ekleyin ve bu butonun onClick aksiyonunda Save Source action’ını tanımlayın.
Parametreler:

• Source Type → Google Drive
• Name → Dosyanın adı (Kullanıcı tarafından belirlenir)
• Update Interval in Hour → 1 (Bu, Quadrant sisteminin dosyayı her 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-----\n ……. \n-----END PRIVATE KEY-----\n (Google Drive ortamını hazırlarken indirilen JSON dosyasındaki private key bilgisi)
• Token Uri → https://oauth2.googleapis.com/token (Google Drive ortamını hazırlarken indirilen JSON dosyasındaki token URI)
• Folder Id → 18V8ZSYTNE8T_gKum3ZVUK5wHZQM3s2aa (Yukarıda gösterilen folderId)
• File Id → 1vNG371Q2ZAkC0X7e8AHm2lftTMRSqWO_ (Yukarıda gösterilen fileId)
• Collection Name (isteğe bağlı) → googledrive1 (Bu, Qdrant sisteminde kullanıcı adıyla başlayan bir koleksiyon ismi belirler. Eğer girilmezse, DefaultCollection olarak alınır.)
• Correlation Id (isteğe bağlı) → correlationId (Bu parametre, kaynağın güncellenmesi gerektiğinde veya privateKey, clientEmail gibi bilgilerin değişmesi durumunda kaydın yeniden eklenmesini sağlar.)

Amazon S3 Save Source Action’ı Oluşturmak
Parametreler

• Source Type → AWS
• Name → Dosyanın adı (Kullanıcı tarafından belirlenir)
• Update Interval in Hour → 1 (Bu, Qdrant sisteminin dosyayı her kaç saatte bir senkronize edeceğini belirtir.)
• awsAccessKeyId → key (AWS ortamında, bu key’i almak için gerekli adımlar gösterilmiştir.)
• awsSecretAccessKey → key (AWS ortamında, bu key’i almak için gerekli adımlar gösterilmiştir.)
• Bucket Name → test-bucket-vector-search (AWS ortamında, bu bucket adını almak için gerekli adımlar gösterilmiştir.)
• S3uri → s3://test-bucket-vector-search/s3Folder/ (AWS ortamında, bu S3 uri’yi almak için gerekli adımlar gösterilmiştir.)
• Collection Name (isteğe bağlı) → googledrive1
• Correlation Id (isteğe bağlı) → correlationId

Manual Save Source Action’ı Oluşturmak
Parametreler

• Source Type → Manual
• Name → Dosyanın adı (Kullanıcı tarafından belirlenir)
• Update Interval in Hour → 1 (Bu, Qdrant sisteminin dosyayı her kaç saatte bir senkronize edeceğ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. Bu içerik, dosyanın mime type'ı ile birlikte belirtilmelidir.)
• Collection Name (isteğe bağlı) → googledrive1
• Correlation Id (isteğe bağlı) → correlationId