Dosya İçe Aktarma Aracısını Ayarlama

Dosya İçe Aktarma Aracısı, tüm bilgisayarlarda çalışan ve izlenen bir dosya sistemi konumundan (klasör veya ağ sürücüsü gibi) içerik içe aktarma kaynağı işlevi gören bir komut satırı uygulamasıdır. Bu konumdaki içeriği izleyip yakalar ve prosedürde tanımlı kurallara göre daha fazla işleme ve yönlendirme için içe aktarma işleyiciye besler.

Sadece kaynağınız izlenen bir klasörse (izlenen bir e-posta hesabı değil) Dosya İçe Aktarma Aracısını yerel bilgisayarınızda kurmanız ve çalıştırmanız gerekir. Yakalama komut satırı hizmet programı; sunucuları kaydetmenize, içe aktarma işlerini konfigüre etmenize ve listelemenize yardımcı olmak için kullanılabilir.

Dosya İçe Aktarma Aracısını İndirme ve Kurma

İzlenen bir klasörden dosya içe aktarabilmek için yerel bilgisayarınızda Dosya İçe Aktarma Aracısını kurmanız gerekir.

Sistem Gereksinimleri

Dosya İçe Aktarma Aracısı, bu uygulamayı kurduğunuz sırada Oracle JDK sürüm 8u251 veya daha yeni bir sürüm gerektiren bir Java uygulamasıdır. Dosya İçe Aktarma Aracısı Windows, Linux ve Mac ile uyumludur (bkz. Oracle Java Geliştirme Kiti 8 ve Java Çalıştırma Zamanı Ortamı 8 Sertifikalı Sistem Konfigürasyonları).

Dosya İçe Aktarma Aracısını indirmek ve kurmak için:
  1. Oracle Content Management web arayüzünde oturum açın ve sol gezinme panelinde (Yönetim bölümünde) Yakalama'ya tıklayın. Bu seçeneği görmüyorsanız gerekli erişim yetkileriniz yoktur.
  2. İçerik Yakalama Prosedürleri sayfasındaki İndirmeler bölümünde Oracle İçerik Yakalama Dosya İçe Aktarma Aracısı'na tıklayıp capture-agent.zip dosyasını yerel bilgisayarınıza indirin.
  3. ZIP dosyasını çıkartın.
  4. PATH değişkenine <agent directory>\bin eklemeniz gerekir. Aracı dizini, capture-agent.zip dosyasının çıkartıldığı klasördür. Ayrıca, CAPTURE_HOME ortam değişkenini çıkartılan dizin olarak ayarlayabilir ve PATH değişkenine $CAPTURE_HOME\bin ekleyebilirsiniz.
    Mac'te:
    sudo ln -s <agent directory>/bin/capture /usr/local/bin/capture

    Windows'ta:

    SystemPropertiesAdvanced.exe dosasını çalıştırın, ardından Ortam Değişkenlerini düzenleyin ve PATH değişkenine <agent directory>\bin ekleyin.

  5. CAPTURE_JAVA_HOME değişkenini bir ortam değişkeni olarak veya <agent directory>/conf/agent.properties dosyasında geçerli JDK konumuna ayarlayın.

Dosya İçe Aktarma Aracısı İçin Oracle Kimlik Bulutu Hizmeti Uygulamasını Oluşturma

Dosya İçe Aktarma Aracısı, içe aktarma işi konfigürasyonlarını almak ve dosyaları yüklemek için Oracle Content Management ile etkileşim kurar. Bunu, RESTful web hizmetlerini çağırarak yapar. Uygulama programı arabirimleri OAuth tarafından korunur; bu nedenle Dosya İçe Aktarma Aracısı OAuth belirteçleri gerektirir. Oracle Kimlik Bulutu Hizmeti uygulaması, Dosya İçe Aktarma Aracısının bu belirteçleri oluşturmasına izin verir.

Oracle Kimlik Bulutu Hizmeti uygulaması oluşturmak için:
  1. Hizmetlerim kumanda tablosunda oturum açın.
  2. Kimlik Bulutu'na tıklayın.
  3. Hizmet Anı URL'sini kopyalayın. Bu URL, Oracle Content Management anınıza erişmenizi sağlar. Yani kurulduktan sonra sunucuyu kaydetmek için URL'yi kullanırsınız.
  4. Kimlik Bulutu Hizmeti konsolunda Gezinme Bölmesi'ni genişletin ve Uygulamalar'a tıklayın.
  5. Ekle'ye tıklayın.
  6. Uygulama Ekle sayfasında Gizli Uygulama'ya tıklayın.
  7. Gizli Uygulama Ekle penceresinin Uygulama Detayları bölmesinde uygulamanız için bir ad girin ve İleri'ye tıklayın.
  8. Şimdi bu uygulamayı istemci olarak konfigüre et'i seçin.
  9. Yetkilendirme bölümünde Kaynak Yöneticisi ve JavaScript Nesne Notasyonu Web Belirteci Onayı'nı seçin.
  10. Belirteç Verme Politikası bölümünde Yetkili Kaynaklar için Tümü'nü seçin ve İleri'ye tıklayın.
  11. Kaynak sekmesinde öndeğerleri kabul edin ve İleri'ye tıklayın.
  12. Web Katmanı Politikası sekmesinde öndeğerleri kabul edin ve İleri'ye tıklayın.
  13. Yetkilendirme sekmesinde öndeğerlere tıklayın ve İleri'ye tıklayın.
  14. Son'a tıklayın.
    İstemci No'yu ve İstemci Şifresi'ni kopyalayın. Sunucunuzu Yakalama komut satırı hizmet programına kaydederken bunlara ihtiyacınız olacak.
  15. Konfigürasyon sekmesinde İstemci Konfigürasyonu'nu genişletin.
  16. Belirteç Verme Politikası bölümüne gidin ve Kapsam Ekle'ye tıklayın.
  17. Kapsam Seç iletişim kutusunda Oracle Content Management anınızı bulun ve tıklayın: >.
  18. /urn:opc:... içeren URL'ye sahip kapsamı bulun ve Ekle'ye tıklayın.
  19. Kapsam URL'sini kopyalayın. Sunucunuzu Yakalama komut satırı hizmet programına kaydederken buna ihtiyacınız olacak.
  20. Kaydet'e ve ardından Etkinleştir'e tıklayın.

Oracle Kimlik Bulutu Hizmeti uygulamanız oluşturuldu. Şimdi sunucunuzu Yakalama komut satırı hizmet programına kaydedebilirsiniz.

Dosya İçe Aktarma Aracısı ile Oracle Content Management kayıt edin

Yakalama komut satırı hizmet programının hangi içe aktarma işlerinin Oracle Content Management anı ile konfigüre edildiğini bilmesi ve bu ana dosya yükleyebilmesi için Oracle Content Management anınız hizmet programına kaydedilmelidir.

Kaydolmak için Oracle Content Management:
  1. Bilgisayarınızda kurulu değilse Dosya İçe Aktarma Aracısını indirin ve kurun.
  2. Windows, Linux veya Mac işletim sisteminizde şu komutu çalıştırın:
    $ capture register-server <NAME> --endpoint https://<oracle content management instance name>.oraclecloud.com -u username -p 'password' --idcsurl https://<server name>.identity.oraclecloud.com/oauth2/v1/token --clientid sampleid --clientsecret sample-secret --scope https://<server name>:<port number>/urn:opc:cec:all
    
  3. İçe aktarma işlerini listeleme komutunu çalıştırarak bağlantınızı test edin:
    $ capture list-import-jobs
    

    Belirtilen Oracle Content Management anındaki içerik yakalama prosedürlerinde konfigüre edilmiş tüm klasör ve dosya listesi içe aktarma işlerinin bir listesi görüntülenir.

Oracle Content Management için kaydolduktan ve içe aktarma işlerini konfigüre ettikten sonra, klasörden dosya içe aktarmayı konfigüre edin veya liste dosyası içe aktarmayı konfigüre edin.

Yakalama Komut Satırı Hizmet Programını Kullanma

capture komut satırı hizmet programı, Dosya İçe Aktarma Aracısının dokümanları Oracle Content Management veri havuzuna içe aktarabilmesi için aracıyı konfigüre etmenizi sağlar. Dosya İçe Aktarma Aracısını kullanmaya ve yönetmeye yönelik komutlar sağlar.

------------------------
capture
------------------------
usage : capture <command> [options]
Run capture <command> -h' to get the detailed help for the command.
Commands:  
capture create-encryption-key <file>     Create an encryption key to encrypt/decrypt password for servers.                       [alias:   cek]  
capture register-server <name>           Registers a CEC server                                                                  [alias:   rs]  
capture list-servers                     Lists registered servers                                                                [alias:   ls]  
capture list-import-jobs                 Lists all Import Jobs from server                                                       [alias:  lij]  
capture configure-import-job             Configures import job. Set Import Folder path. Enable or disable.                       [alias:  cij] 
capture trigger-import-job               Forces import job processing.                                                           [alias:  tij]
capture refresh-config                   Refresh configuration from server.                                                      [alias:   rc]
capture list-procedures                  Displays capture procedures.                                                            [alias:   lp]  
capture register-database <name>         Registers external database.                                                            [alias:   rd]  
capture deregister-database              Deregister previously registered database.                                              [alias:   dd]  
capture list-databases                   Displays registered databases and tables.                                               [alias:   ld]  
capture register-table                   Registers tables in a database.                                                         [alias:   rt]  
capture deregister-table                 Deregister previously registered table.                                                 [alias:   dt]
capture list-table-sync-jobs             Lists all Asset Sync Jobs from server.                                                  [alias: ltsj]
capture trigger-table-sync               Force table / asset synchronization.                                                    [alias:  tts]
capture start                            Starts import agent                                                                     [alias:    s]  
capture stop                             Stops import agent                                                                      [alias:    x]  
capture status                           Shows import agent status                                                               [alias:   st]  
capture help                             Shows this message                                                                      [alias:    h]

-----------------------------
capture create-encryption-key
-----------------------------
usage: create-encryption-key <file> [-h]
Create an encryption key to encrypt/decrypt password for servers and save to <file>.
Options: 
-h,--help   Show help
Example:  
capture create-encryption-key ~/.ceckey                      Create encryption key and save to file ~/.ceckey
------------------------
capture register-server
------------------------
usage: capture register-server <name> -e <endpoint> -u <user> -p <password> [-k <key>] [-i <idcsurl>] [-c <clientid>] [-s <clientsecret>] [-o <scope>] [-m <timeout>] [-h]
Registers a CEC server. Specify -e <endpoint> for the server URL. Specify -u <user> and -p <password> for connecting to the server. Optionally specify -k <key> to encrypt the password.
Optionally specify <idcsurl>, <clientid>, <clientsecret> and <scope> for integration with IDCS app.
Options: 
-e,--endpoint <endpoint>           Server endpoint 
-u,--user <user>                   User name 
-p,--password <password>           Password 
-k,--key <key>                     The key file used to encrypt the password 
-i,--idcsurl <idcsurl>             Oracle Identity Cloud Service Instance URL 
-c,--clientid <clientid>           Client ID 
-s,--clientsecret <clientsecret>   Client secret 
-o,--scope <scope>                 Scope -m,--timeout <timeout>             Timeout in millisecond when try to login to the server. Defaults to 30000ms 
-h,--help                          Show help
Examples:  
capture register-server server1 -e http://server1.com -u user1 -p password1 -i                         The server is a tenant on Oracle Public cloud  
http://idcs1.com -c clientid -s clientsecret -o https://primary-audience-and-scope  
capture register-server server1 -e http://server1.com -u user1 -p password1                            The server is a tenant on Oracle Public cloud  
capture register-server server1 -e http://server1.com -u user1 -p password1 -m 60000                   The timeout is set to 60 seconds  
capture register-server server1 -e http://server1.com -u user1 -p password1 -k ~/.mykey                The password will be encrypted
------------------------
capture list-servers
------------------------
usage: capture list-servers [-u <user>] [-f <pattern>] [-h]
Lists registered CEC servers. Optionally specify -u <user> and -f <pattern> to filter results based on user or server name.
Options: -u,--user <user>         User name 
-f,--pattern <pattern>   String to search in server name 
-h,--help                Show help
Examples:  
capture list-servers                                         Lists all registered servers  
capture list-servers -u user1                                Lists all registered servers linked to user 'user1'  
capture list-servers -f demo                                 Lists all registered servers whose name contains 'demo'
------------------------
capture list-import-jobs
------------------------
usage: capture list-import-jobs [-f] [-l] [-h]
Lists all Import Jobs from server. Optionally specify -f and -l to show only folder or list file import jobs.
Options: 
-f,--folder     Display only folder import jobs 
-l,--listfile   Display only list file import jobs 
-h,--help       Show help
Examples:  
capture list-import-jobs                                         Lists all import jobs  
capture list-import-jobs -f                                      Lists all folder import jobs  
capture list-import-jobs -l                                      Lists all list file import jobs
-----------------------------
capture configure-import-job
-----------------------------
usage: capture configure-import-job -s <server> [-i <import>] [-p <path>] [-e] [-E] [-d] [-D] [-h]
Configures the import job.  Specify -s <server> -i <importjobid> to select the server and import job. Optionally specify -p <path> to set the import folder path. 
Optionally specify -d to disable import job and -e to enable import job
Options: 
-s,--server <server>   Set server name associated with import job 
-i,--import <import>   Set Import Job Id 
-p,--path <path>       Set Local Import Folder Path 
-e,--enable            Enables specific import job 
-E,--enable-all        Enables all import jobs 
-d,--disable           Disables specific import job 
-D,--disable-all       Disables all import job 
-h,--help              Show help
Examples:  
capture configure-import-job -s prod -i import_id -p /Users/user1/data/      Sets the import directory  
capture configure-import-job -s prod -i import_id -e                         Enables a specific import job  
capture configure-import-job -s prod -D                                      Disables all import jobs  
capture configure-import-job -s prod -i import_id -d                         Disables a specific import job
------------------------
capture trigger-import-job
------------------------
usage: capture trigger-import-job -s <server> -i <import> [-h] 
Forces import job processing.  
Options: 
-s,--server <server>   Set server name associated with import job 
-i,--import <import>   Set Import Job Id 
-h,--help              Show help 
Examples:  capture trigger-import-job --server production --import xx-job-id-xx           Forces processing of specified import job
------------------------
capture refresh-config
------------------------
usage: capture refresh-config [-s <server>] [-h] Refresh configuration from server. 
Optionally specify -s to only refresh config for selected server. 
Options: 
-s,--server <server>   Specify the server 
-h,--help              Show help 
Examples:  
capture refresh-config                       Force refresh configuration for all servers  
capture refresh-config -s production         Force refresh configuration from specified server                        
------------------------
capture list-procedures
------------------------
usage: capture list-procedures -s <server> [-h] 
Lists capture procedures. Must specify -s <server> to select a server. 
Options: 
-s,--server <server>   Specify the server 
-h,--help              Show help 
Examples:  capture list-procedures -s ocetest                           Lists all capture procedures available for current user
------------------------
capture register-database
------------------------
usage: capture register-database <name> -s <server> -w <procedure> -c <connection> -u <user> -p <password> [-a] [-h] 
Registers on-prem database with Capture. Specify -c <connection> for the connection URL, -u <user> and -p <password> for connecting to the server. 
Options: 
-s,--server <server>           Specify the server 
-w,--procedure <procedure>     Set procedure to be associated with database 
-c,--connection <connection>   Database connection url 
-u,--user <user>               Database User name 
-p,--password <password>       Database Password 
-a,--attach                    Attach existing database 
-h,--help                      Show help 
Examples:  
capture register-database ebsdb -s server1 -w 1 -c jdbc:oracle:thin:@//host:port/service -u user1 -p pass         Register ebsdb with server1
------------------------
capture deregister-database
------------------------
usage: capture deregister-database  -s <server> -w <procedure> -d <database> [-e] [-h] 
Deregister previously registered database. Specify -s <server>, -w <procedure> and -d <database> to select the database. 
Options: 
-s,--server <server>         Specify the server 
-w,--procedure <procedure>   Procedure associated with database 
-d,--database <database>     Database to deregister 
-e,--detach                  Only detach 
-h,--help                    Show help 
Examples:  
capture deregister-database -s server1 -w 1 -d ebsdb                   Deregister VENDORS table from ebsdb database  
capture deregister-database -s server1 -w 1 -d ebsdb --detach          Detaches ebsdb database without deregistering it
------------------------
capture list-databases
------------------------
usage: capture list-databases -s <server> [-h] Lists registered databases and tables. Must specify -s <server> to select a server. 
Options: 
-s,--server <server>   Specify the server 
-h,--help              Show help 
Examples:  
capture list-databases -s ocetest     Lists all registered databased linked to server 'ocetest'  
------------------------
capture register-table
------------------------
usage: capture register-table -s <server> -w <procedure> -d <database> -t <table> [-m <schema>] [-h]
Registers table with Capture. Specify -s <server>, -w <procedure> and -d <database> to select the database. 
Options: 
-s,--server <server>         Specify the server 
-w,--procedure <procedure>   Specify the procedure 
-d,--database <database>     Specify the database 
-t,--table <table>           Table to sync 
-m,--schema <schema>         Override schema qualifier 
-h,--help                    Show help 
Examples:  
capture register-table -s server1 -w 1 -d ebsdb -t VENDORS                  Register VENDORS table from ebsdb database  
capture register-table -s server1 -w 1 -d ebsdb -t VENDORS -m SVR           Register VENDORS table from ebsdb database in SVR schema
------------------------
capture deregister-table
------------------------
usage: capture deregister-table -s <server> -w <procedure> -d <database> -t <table> [-m <schema>] [-h] 
Deregister table. Specify table details. 
Options: 
-s,--server <server>         Specify the server 
-w,--procedure <procedure>   Procedure associated with database 
-d,--database <database>     Specify the database 
-t,--table <table>           Table to sync 
-m,--schema <schema>         Override schema qualifier 
-h,--help                    Show help 
Examples:  capture deregister-table -s server1 -w 1 -d ebsdb -t VENDORS                      Deregister VENDORS table from ebsdb database      
------------------------
capture list-table-sync-jobs
------------------------
usage: capture list-table-sync-jobs [-r] [-h] Lists all Asset Sync Jobs from server. 
Options: 
-r,--refresh   Force refresh asset sync jobs from server 
-h,--help      Show help 
Examples:  
capture list-table-sync-jobs                                         Lists all asset sync jobs  
capture list-table-sync-jobs -r                                      Refresh asset sync jobs from server and list them
------------------------
capture trigger-table-sync
------------------------
usage: capture trigger-table-sync -s <server> -a <asset> [-h] 
Force table / asset synchronization.  
Options: 
-s,--server <server>   Set server name associated with table sync job 
-a,--asset <asset>     Set Asset Sync Job Id 
-h,--help              Show help 
Examples:  
capture trigger-table-sync -s production -i xx-123-sync-id-xx      Forces processing of asset synchronization job
------------------------
capture start
------------------------
usage: capture start [-h]
Starts capture agent. 
Options: 
-h,--help   Show help
Examples:  
capture start                                                Starts capture agent if not running
------------------------
capture stop
------------------------
usage: capture stop [-h]
Stops capture agent. 
Options: 
-h,--help   Show help
Examples:  
capture stop                                                 Stops capture agent if currently running
------------------------
capture status
------------------------
usage: capture status [-s <server>] [-i <import>] [-u <user>] [-m <machine>] [-l <limit>] [-d <duration>] [-c | -p]  [-h] 
Display capture agent status and activity.  
Options: 
-s,--server <server>       Set Server name 
-i,--import <import>       Set Import Job name 
-u,--user <user>           Set user name. Defaults to current user 
-m,--machine <machine>     Set host name. Defaults to current hostname 
-l,--limit <limit>         Set number of results to return. Defaults to 200 
-d,--duration <duration>   Set duration period in hours 
-c,--completed             Display only completed uploads 
-p,--pending               Display only pending uploads 
-h,--help                  Show help 
Examples:  
capture status                             Display capture agent status  
capture status -u user@example.com         Show upload activity for user : user@example.com  
capture status -i Invoices                 Show upload activity for Invoices import job  
capture status -m myhost.example.com       Show upload activity for a specific host / machine  
capture status -p                          Show uploads pending completion  
capture status -c                          Show completed uploads
------------------------
capture version
------------------------
usage: capture version [-h] 
Displays capture version details. 
Options: 
-h,--help    Show help 
Example:  
capture  version                  Display Capture Agent version