Ρύθμιση του Παράγοντα εισαγωγής αρχείου

Ο Παράγοντας εισαγωγής αρχείου είναι μια εφαρμογή γραμμής εντολών που εκτελείται σε οποιονδήποτε υπολογιστή και εξυπηρετεί ως προέλευση για την εισαγωγή περιεχομένου από μια θέση συστήματος αρχείων που παρακολουθείται, όπως ένας φάκελος ή μια μονάδα δικτύου. Παρακολουθεί και αποτυπώνει το περιεχόμενο σε αυτήν τη θέση και το τροφοδοτεί στο πρόγραμμα επεξεργασίας εισαγωγής για περαιτέρω επεξεργασία και δρομολόγηση σύμφωνα με τους κανόνες που ορίζονται στη διαδικασία.

Πρέπει να εγκαταστήσετε και να εκτελέσετε τον Παράγοντα εισαγωγής αρχείου στον τοπικό υπολογιστή σας μόνο αν η προέλευσή σας είναι ένας φάκελος που παρακολουθείται (όχι λογαριασμός ηλ. ταχυδρομείου που παρακολουθείται). Το βοηθητικό πρόγραμα γραμμής εντολών αποτύπωσης είναι διαθέσιμο για να σας βοηθήσει να εγγράψετε server, να διαμορφώσετε εργασίες εισαγωγής και να τις παραθέσετε.

Λήψη και εγκατάσταση του Παράγοντα εισαγωγής αρχείων

Για να μπορείτε να εισάγετε αρχεία από έναν φάκελο υπό παρακολούθηση, πρέπει να εγκαταστήσετε τον Παράγοντα εισαγωγής αρχείων στον τοπικό υπολογιστή σας.

Απαιτήσεις συστήματος

Ο Παράγοντας εισαγωγής αρχείων είναι μια εφαρμογή Java που απαιτεί το Oracle JDK έκδοση 8u251 ή την πιο πρόσφατη έκδοση που είναι διαθέσιμη κατά την χρονική στιγμή που πρόκειται να εγκαταστήσετε αυτήν την εφαρμογή. Ο Παράγοντας εισαγωγής αρχείων είναι συμβατός με Windows, Linux και Mac (δείτε Διαμορφώσεις συστήματος με πιστοποίηση Oracle JDK 8 και JRE 8).

Για να πραγματοποιήσετε λήψη και εγκατάσταση του Παράγοντα εισαγωγής αρχείων:
  1. Συνδεθείτε στο περιβάλλον εργασίας ιστού του Oracle Content Management και επιλέξτε Αποτύπωση στο αριστερό μενού πλοήγησης (κάτω από τη Διαχείριση). Αν δεν εμφανίζεται αυτή η επιλογή, δεν διαθέτετε τα απαιτούμενα προνόμια πρόσβασης.
  2. Στη σελίδα "Διαδικασίες" του Content Capture, κάτω από τα "Στοιχεία λήψης", επιλέξτε Παράγοντας εισαγωγής αρχείων του Oracle Content Capture" για να κάνετε λήψη του αρχείου capture-agent.zip στον τοπικό υπολογιστή σας.
  3. Κάντε εξαγωγή του αρχείου ZIP.
  4. Πρέπει να προσθέσετε τη διαδρομή <agent directory>\bin στη μεταβλητή PATH. Ο κατάλογος του παράγοντα είναι ο φάκελος όπου έχει εξαχθεί το αρχείο capture-agent.zip. Μπορείτε επίσης να ορίσετε τη μεταβλητή περιβάλλοντος CAPTURE_HOME στον εξαχθέντα κατάλογο και να προσθέσετε $CAPTURE_HOME\bin στη μεταβλητή PATH.
    Σε Mac:
    sudo ln -s <agent directory>/bin/capture /usr/local/bin/capture

    Σε Windows:

    Εκτελέστε το αρχείο SystemPropertiesAdvanced.exe, έπειτα επεξεργαστείτε τις Μεταβλητές περιβάλλοντος και, τέλος, προσθέστε τη διαδρομή <agent directory>\bin στη μεταβλητή PATH.

  5. Ορίστε τη μεταβλητή CAPTURE_JAVA_HOME σε μια έγκυρη θέση του JDK είτε ως μεταβλητή περιβάλλοντος ή στο αρχείο <agent directory>/conf/agent.properties.

Δημιουργία της εφαρμογής Oracle Identity Cloud Service (IDCS) για τον Παράγοντα εισαγωγής αρχείου

Ο Παράγοντας εισαγωγής αρχείου αλληλεπιδρά με το Oracle Content Management ια την ανάκτηση διαμορφώσεων εργασιών εισαγωγής και την αποστολή αρχείων. Αυτό γίνεται καλώντας τις υπηρεσίες ιστού REST. Τα API προστατεύονται από το OAuth, οπότε ο Παράγοντας εισαγωγής αρχείου απαιτεί διακριτικά OAuth. Η εφαρμογή IDCS επιτρέπει στον Παράγοντα εισαγωγής αρχείου να δημιουργεί αυτά τα διακριτικά.

Για τη δημιουργία μιας εφαρμογής IDCS:
  1. Συνδεθείτε στο dashboard "Οι υπηρεσίες μου".
  2. Επιλέξτε "Identity Cloud".
  3. Αντιγράψτε τη διεύθυνση τοποθεσίας στιγμιότυπου υπηρεσίας. Αυτή η διεύθυνση τοποθεσίας θα σας επιτρέψει την πρόσβαση στο στιγμιότυπό σας Oracle Content Management. Δηλαδή, θα τη χρησιμοποιήσετε για την εγγραφή του server μετά την εγκατάστασή του.
  4. Στην κονσόλα της υπηρεσίας Identity Cloud Service, αναπτύξτε το Συρτάρι πλοήγησης και έπειτα κάντε κλικ στην επιλογή "Εφαρμογές".
  5. Κάντε κλικ στην επιλογή "Προσθήκη".
  6. Στη σελίδα "Προσθήκη εφαρμογής", επιλέξτε "Εμπιστευτική εφαρμογή".
  7. Στο τμήμα παραθύρου "Λεπτομέρειες εφαρμογής" του παραθύρου "Προσθήκη εμπιστευτικής εφαρμογής", εισαγάγετε ένα όνομα για την εφαρμογή σας και πατήστε "Επόμενο".
  8. Επιλέξτε "Διαμόρφωση αυτής της εφαρμογής ως client τώρα".
  9. Κάτω από την "Εξουσιοδότηση", επιλέξτε "Κάτοχος πόρου" και "Δήλωση JWT".
  10. Κάτω από την επιλογή "Πολιτική έκδοσης διακριτικών", επιλέξτε "Όλοι" για την επιλογή "Εξουσιοδοτημένοι πόροι" και πατήστε "Επόμενο".
  11. Στην καρτέλα "Πόρος", αποδεχθείτε τις προεπιλεγμένες τιμές και πατήστε "Επόμενο".
  12. Στην καρτέλα "Πολιτική επιπέδου ιστού", αποδεχθείτε τις προεπιλεγμένες τιμές και πατήστε "Επόμενο".
  13. Στην καρτέλα "Εξουσιοδότηση", αποδεχθείτε τις προεπιλεγμένες τιμές και πατήστε "Επόμενο".
  14. Κάντε κλικ στην επιλογή "Τέλος".
    Αντιγράψτε το Αναγνωριστικό Client και τον Μυστικό κωδικό Client. Θα τα χρειαστείτε κατά την εγγραφή του server σας με το βοηθητικό πρόγραμμα γραμμής εντολών Capture.
  15. Στην καρτέλα "Διαμόρφωση", αναπτύξτε τη "Διαμόρφωση client".
  16. Κάντε κύλιση στην ενότητα "Πολιτική έκδοσης διακριτικών" και επιλέξτε "Προσθήκη εμβέλειας".
  17. Στο πλαίσιο διαλόγου Επιλογή εμβέλειας, εντοπίστε το στιγμιότυπό σας Oracle Content Management και πατήστε >.
  18. Επιλέξτε την εμβέλεια που έχει διεύθυνση τοποθεσίας με /urn:opc:... και έπειτα πατήστε "Προσθήκη".
  19. Αντιγράψτε τη Διεύθυνση τοποθεσίας εμβέλειας. Θα τη χρειαστείτε κατά την εγγραφή του server σας με το βοηθητικό πρόγραμμα γραμμής εντολών Capture.
  20. Κάντε κλικ στο κουμπί "Αποθήκευση" και, στη συνέχεια, κάντε κλικ στο κουμπί "Ενεργοποίηση".

Η εφαρμογή σας IDCS έχει δημιουργηθεί. Τώρα μπορείτε να συνεχίσετε και να κάνετε εγγραφή του server σας με το βοηθητικό πρόγραμμα γραμμής εντολών Capture.

Εγγραφή του Oracle Content Management στον παράγοντα εισαγωγής αρχείων

Το στιγμιότυπό σας Oracle Content Management πρέπει να εγγραφεί στο βοηθητικό πρόγραμμα γραμμής εντολών αποτύπωσης, ώστε να βοηθητικό πρόγραμμα να γνωρίζει ποιες εργασίες εισαγωγής έχουν διαμορφωθεί με το στιγμιότυπο Oracle Content Management και να μπορεί να εκτελεί αποστολή αρχείων σε αυτό το στιγμιότυπο.

Για την εγγραφή του Oracle Content Management:
  1. Πραγματοποιήστε λήψη και εγκατάσταση του Παράγοντα εισαγωγής αρχείου Αν δεν τον έχετε εγκαταστήσει ήδη στον υπολογιστή σας.
  2. Εκτελέστε την ακόλουθη εντολή στο λειτουργικό σύστημα Windows, Linux ή Mac που έχετε:
    $ 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
    
    • Διεύθυνση τοποθεσίας στιγμιότυπου Oracle Content Management: <oracle content management instance name>.oraclecloud.com

    • Όνομα χρήστη και κωδικός πρόσβασης για τη διεύθυνση τοποθεσίας του στιγμιότυπου Oracle Content Management.

      Σημείωση:

      Για να εξουδετερώσετε μια πιθανή απειλή ασφάλειας, μπορείτε να δημιουργήσετε έναν συγκεκριμένο χρήστη για τον Παράγοντα εισαγωγής αρχείου στον οποίο έχουν εκχωρηθεί μόνο οι ρόλοι του Content Capture ή δικαιώματα για τις απαιτούμενες διαδικασίες.
    • Διεύθυνση τοποθεσίας στιγμιότυπου υπηρεσίας ταυτοτήτων: https://<server name>.identity.oraclecloud.com/oauth2/v1/token (Αντιγράψατε την τιμή της κατά τη δημιουργία της εφαρμογής IDCS.)

    • Αναγνωριστικό Client: sampleid (Αντιγράψατε την τιμή του κατά τη δημιουργία της εφαρμογής IDCS.)

    • Μυστικός κωδικός Client: sampleid (Αντιγράψατε την τιμή του κατά τη δημιουργία της εφαρμογής IDCS.)

    • Διεύθυνση τοποθεσίας εμβέλειας: https://<server name>:<port number>/urn:opc:cec:all (Αντιγράψατε την τιμή της κατά τη δημιουργία της εφαρμογής IDCS.)

  3. Ελέγξτε τη σύνδεσή σας εκτελώντας την εντολή για την παράθεση των εργασιών εισαγωγής σε λίστα:
    $ capture list-import-jobs
    

    Εμφανίζεται μια λίστα με όλες τις εργασίες εισαγωγής λίστας αρχείων και φακέλων που έχουν διαμορφωθεί στις διαδικασίες αποτύπωσης περιεχομένου στο καθορισμένο στιγμιότυπο Oracle Content Management.

Αφού έχετε εγγράψει το Oracle Content Management και έχετε διαμορφώσει τις εργασίες εισαγωγής, διαμόρφωση εισαγωγής αρχείου από φάκελο ή διαμόρφωση εισαγωγής αρχείου λίστας.

Χρήση του βοηθητικού προγράμματος γραμμής εντολών αποτύπωσης

Το βοηθητικό πρόγραμμα γραμμής εντολών αποτύπωσης σάς επιτρέπει να διαμορφώσετε τον παράγοντα εισαγωγής αρχείου, ώστε ο παράγοντας να μπορεί να εισαγάγει έγγραφα στο αποθετήριο του Oracle Content Management. Παρέχει εντολές για χρήση και διαχείριση του Παράγοντα εισαγωγής αρχείου.

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