Configurarea agentului de import de fişiere

Agentul de import de fişiere este o aplicaţie cu linie de comandă care rulează pe orice computer şi care serveşte drept sursă pentru importul de conţinut dintr-o locaţie de sistem de fişiere monitorizată, precum un folder sau o unitate din reţea. Monitorizează şi captează conţinutul din locaţia respectivă şi îl transmite către procesorul de import pt. procesare ulterioară şi rutare în conformitate cu regulile definite în procedură.

Trebuie să instalaţi şi să rulaţi agentul de import de fişiere pe computerul dvs. local doar dacă sursa dvs. este un folder monitorizat (nu un cont de e-mail monitorizat). Utilitarul în linie de comandă Captare este disponibil pt. a vă ajuta să înregistraţi servere, să configuraţi joburi de import şi să le listaţi.

Descărcaţi şi instalaţi Agentul de import de fişiere

Înainte să puteţi importa fişiere dintr-un folder monitorizat, trebuie să instalaţi pe computerul dvs. local Agentul de import de fişiere.

Cerinţe de sistem

Agentul de import de fişiere este o aplicaţie Java care necesită Oracle JDK versiunea 8u251 sau cea mai recentă versiune disponibilă la momentul instalării aplicaţiei. Agentul de import de fişiere este compatibil cu Windows, Linux şi Mac (consultaţi Configuraţii de sistem certificate Oracle JDK 8 şi JRE 8).

Pt. a descărca şi instala agentul de import de fişiere:
  1. Conectaţi-vă la interfaţa web Oracle Content Management şi faceţi clic pe Captare în panoul de navigaţie din partea stângă (sub Administrare). Dacă nu vedeţi această opţiune, nu aveţi privilegiile de acces necesare.
  2. Pe pagina Proceduri Content Capture, sub Descărcări, faceţi clic pe Agent de import de fişiere Oracle Content Capture pt. a descărca fişierul capture-agent.zip pe computerul dvs. local.
  3. Extrageţi fişierul ZIP.
  4. Trebuie să adăugaţi <director agent>\bin la PATH. Directorul agent este folderul în care se extrage capture-agent.zip. Puteţi de asemenea să setaţi variabila de mediu CAPTURE_HOME la directorul extras şi să adăugaţi $CAPTURE_HOME\bin la PATH.
    Pe Mac:
    sudo ln -s <agent directory>/bin/capture /usr/local/bin/capture

    Pe Windows:

    Rulaţi fişierul SystemPropertiesAdvanced.exe, apoi editaţi Variabile de mediu şi apoi adăugaţi <director agent>\bin la variabila PATH.

  5. Setaţi variabila CAPTURE_JAVA_HOME la o locaţie JDK validă, fie ca variabilă de mediu, fie în fişierul <director agent>/conf/agent.properties.

Crearea aplicaţiei Oracle Identity Cloud Service (IDCS) pentru Agentul de import fişiere

Agentul de import fişiere interacţionează cu Oracle Content Management, pentru a prelua configuraţiile jobului de import şi a încărca fişierele. El face acest lucru prin invocarea serviciilor Web REST complete. Interfeţele API sunt protejate de OAuth, astfel că Agentul de import fişiere necesită tokenuri OAuth. Aplicaţia IDCS permite Agentului de import fişiere să genereze aceste tokenuri.

Pentru a crea o aplicaţie IDCS:
  1. Conectaţi-vă la tabloul dashboard Serviciile mele.
  2. Faceţi clic pe Identity Cloud.
  3. Copiaţi adresa URL a instanţei serviciului. Această adresă URL vă va permite să accesaţi instanţa Oracle Content Management pe care o aveţi. Adică, o veţi utiliza pentru a înregistra serverul după ce acesta este instalat.
  4. În consola serviciului Identity Cloud Service, extindeţi Meniu glisant, apoi faceţi clic pe Aplicaţii.
  5. Faceţi clic pe Adăugare.
  6. În pagina Adăugare aplicaţie, faceţi clic pe Aplicaţie confidenţială.
  7. În panoul Detalii aplicaţie din fereastra Adăugare aplicaţie confidenţială, introduceţi un nume pentru aplicaţia dvs. şi faceţi clic pe Înainte.
  8. Alegeţi Configuraţi acum această aplicaţie drept client.
  9. Din Autorizare, selectaţi Deţinător resursă şi Afirmaţie JWT.
  10. Din Politică de emitere tokenuri, alegeţi Toate pentru Resurse autorizate şi faceţi clic pe Înainte.
  11. Pe fila Resursă, acceptaţi valorile prestabilite şi faceţi clic pe Înainte.
  12. Pe fila Politică pt. niveluri Web, acceptaţi valorile prestabilite şi faceţi clic pe Înainte.
  13. Pe fila Autorizare, faceţi clic pe valorile prestabilite şi apoi clic pe Înainte.
  14. Faceţi clic pe Încheiere.
    Copiaţi ID client şi Secret client. Veţi avea nevoie de ele atunci când înregistraţi serverul dvs. cu utilitarul în linia de comandă, Capture.
  15. Pe fila Configuraţie, extindeţi Configuraţie client.
  16. Derulaţi în jos la secţiunea Politică de emitere tokenuri şi faceţi clic pe Adăugare domeniu.
  17. În dialogul Selectare domeniu, găsiţi instanţa Oracle Content Management pe care o aveţi şi faceţi clic pe >.
  18. Selectaţi domeniul care are adresa URL cu /urn:opc:... şi apoi faceţi clic pe Adăugare.
  19. Copiaţi adresa URL domeniu. Veţi avea nevoie de ea atunci când înregistraţi serverul dvs. cu utilitarul în linia de comandă, Capture.
  20. Faceţi clic pe Salvare şi apoi clic pe Activare.

Aplicaţia dvs. IDCS a fost creată. Acum puteţi să mergeţi mai departe şi să înregistraţi serverul dvs. cu utilitarul în linia de comandă, Capture.

Înregistraţi Oracle Content Management în agentul de import de fişiere

Instanţa dvs. Oracle Content Management trebuie să fie înregistrată cu utilitarul Capture pentru linia de comandă, astfel ca utilitarul să ştie ce joburi de import sunt configurate cu instanţa Oracle Content Management şi să poată încărca fişiere în această instanţă.

Pentru înregistrarea Oracle Content Management:
  1. Descărcaţi şi instalaţi Agentul de import fişiere în cazul în care nu îl aveţi deja instalat pe computerul dvs.
  2. Executaţi următoarea comandă pe sistemul de operare Windows, Linux sau Mac pe care îl aveţi:
    $ 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
    
    • URL instanţă Oracle Content Management: <oracle content management instance name>.oraclecloud.com

    • Numele de utilizator şi parola pentru adresa URL de instanţă Oracle Content Management.

      Notă:

      Pentru a diminua o potenţială ameninţare la adresa securităţii, luaţi în considerare crearea unui utilizator specific pentru Agentul de import fişiere, căruia i se asignează doar rolurile sau permisiunile pentru procedurile obligatorii din Content Capture.
    • Adresa URL a instanţei Identity Service: https://<server name>.identity.oraclecloud.com/oauth2/v1/token (Aţi copiat valoarea sa la crearea aplicaţiei IDCS.)

    • ID client: sampleid (Aţi copiat valoarea sa la crearea aplicaţiei IDCS.)

    • Secret client: sample-secret (Aţi copiat valoarea sa la crearea aplicaţiei IDCS.)

    • Adresă URL domeniu de aplicare: https://<server name>:<port number>/urn:opc:cec:all (Aţi copiat valoarea sa la crearea aplicaţiei IDCS.)

  3. Testaţi-vă conexiunea rulând comanda pentru a lista joburile de import:
    $ capture list-import-jobs
    

    Se afişează o listă cu toate joburile de import din folder şi din lista de fişiere configurate în procedurile de captare conţinut pe instanţa Oracle Content Management specificată.

După ce aţi înregistrat Oracle Content Management şi aţi configurat joburi de import, configuraţi importul de fişiere dintr-un folder sau configuraţi importul unui fişier listă.

Folosirea utilitarului în linia de comandă, Capture

Utilitarul pentru linia de comandă, capture, vă permite să configuraţi Agentul de import fişiere, astfel ca agentul să poată importa documente în repository-ul Oracle Content Management. Acesta oferă comenzi pentru utilizarea şi administrarea Agentului de import fişiere.

------------------------
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