Agent voor bestandsimport instellen

De agent voor bestandsimport is een opdrachtregelapplicatie die op elke computer kan worden uitgevoerd en die als bron fungeert voor het importeren van inhoud uit een bewaakte bestandssysteemlocatie zoals een map of netwerkstation. De inhoud op deze locatie wordt gecontroleerd en vastgelegd door de agent voor bestandsimport en doorgestuurd naar de importprocessor voor verdere verwerking en routering volgens de regels die in de procedure zijn gedefinieerd.

Installeer en gebruik de agent voor bestandsimport alleen op uw lokale computer als uw bron een bewaakte map is (geen bewaakte e-mailaccount). Met behulp van het opdrachtregelprogramma Capture kunt u servers registreren, importtaken configureren en deze weergeven.

Dit zijn de stappen voor het instellen van de agent voor bestandsimport:

De agent voor bestandsimport downloaden en installeren

Voordat u bestanden kunt importeren uit een bewaakte map, moet u de agent voor bestandsimport installeren op uw lokale computer.

Systeemvereisten

De agent voor bestandsimport is een Java-applicatie die Oracle JDK versie 8u251 vereist of de nieuwste versie die beschikbaar is op het moment dat u deze applicatie installeert. De agent voor bestandsimport is compatibel met Windows, Linux en Mac (zie voor meer informatie: Gecertificeerde systeemconfiguraties Oracle JDK 8 en JRE 8).

Ga als volgt te werk om de agent voor bestandsimport te downloaden en te installeren:

Log in bij de Oracle Content Management webinterface en klik op Vastleggen in het linkernavigatievenster (onder Beheer). Als u deze optie niet ziet, beschikt u niet over de juiste toegangsrechten.
Klik op de pagina met procedures voor het vastleggen van inhoud onder Downloads op Agent bestandsimport Oracle Content Capture om het bestand capture-agent.zip te downloaden naar uw lokale computer.
Extraheer het zipbestand.
Voeg <agentdirectory>\bin toe aan PATH. De agentdirectory is de map waarnaar capture-agent.zip is geëxtraheerd. U kunt ook de omgevingsvariabele CAPTURE_HOME instellen op de geëxtraheerde directory en $CAPTURE_HOME\bin toevoegen aan PATH.
Onder Mac:
```
sudo ln -s <agent directory>/bin/capture /usr/local/bin/capture
```
Onder Windows:

Voer het bestand SystemPropertiesAdvanced.exe uit en bewerk Omgevingsvariabelen. Voeg vervolgens <agentdirectory>\bin toe aan de variabele PATH.
Stel de variabele CAPTURE_JAVA_HOME in op een JDK-locatie in een omgevingsvariabele of in het bestand <agentdirectory>/conf/agent.properties.

De Oracle Identity Cloud Service (IDCS) applicatie maken voor de agent voor bestandsimport

De agent voor bestandsimport werkt samen met Oracle Content Management voor het ophalen van configuraties van importtaken en het uploaden van bestanden. Dit gebeurt door het aanroepen van RESTful-webservices. De API's worden beschermd via OAuth en daarom heeft de agent voor bestandsimport OAuth-tokens nodig. De IDCS-applicatie staat de agent voor bestandsimport toe deze tokens te genereren.

Ga als volgt te werk om een IDCS-applicatie te maken:

Log in op het dashboard Mijn services.
Klik op Identity Cloud.
Kopieer de URL voor de service-instance. Via deze URL krijgt u toegang tot uw instance van Oracle Content Management. Dat wil zeggen: u gebruikt deze URL om de server te registreren nadat deze is geïnstalleerd.
Vouw in de Identity Cloud Service console de Navigatielade uit en klik vervolgens op Applicaties.
Klik op Toevoegen.
Klik op de pagina Applicatie toevoegen op Vertrouwelijke applicatie.
Voer in het deelvenster Details app van het venster Vertrouwelijke applicatie toevoegen een naam in voor uw applicatie en klik op Volgende.
Kies Deze applicatie nu als client configureren.
Selecteer de opties Resource-eigenaar en JWT-assertion onder Autorisatie.
Kies bij Tokenuitgiftepolicy de optie Alle voor Geautoriseerde resources en klik op Volgende.
Accepteer de standaardopties op het tabblad Resource en klik op Volgende.
Accepteer de standaardopties op het tabblad Weblaagpolicy en klik op Volgende.
Klik op de standaardopties op het tabblad Autorisatie en klik op Volgende.
Klik op Voltooien.
Kopieer de Client-ID en het Clientgeheim. Deze hebt u nodig wanneer u uw server registreert met behulp van het opdrachtregelprogramma van Capture.
Vouw Clientconfiguratie uit op het tabblad Configuratie.
Schuif omlaag naar de sectie Tokenuitgiftepolicy en klik op Bereik toevoegen.
Zoek in het dialoogvenster Bereik selecteren uw instance van Oracle Content Management op en klik op \.
Selecteer het bereik met de URL die /urn:opc:... bevat en klik vervolgens op Toevoegen.
Kopieer de URL van het bereik. Deze hebt u nodig wanneer u uw server registreert met behulp van het opdrachtregelprogramma van Capture.
Klik op Opslaan en vervolgens op Activeren.

Uw IDCS-applicatie is gemaakt. U kunt nu verder gaan zodat u uw server registreert met behulp van het opdrachtregelprogramma van Capture.

Oracle Content Management registreren bij de agent voor bestandsimport

Uw Oracle Content Management instance moet worden geregistreerd bij het Capture opdrachtregelhulpprogramma, zodat met dit hulpprogramma kan worden bepaald welke importtaken worden geconfigureerd met de Oracle Content Management instance en met het hulpprogramma bestanden naar deze instance kunnen worden geladen.

Ga als volgt te werk om Oracle Content Management te registreren:

Download en installeer de agent voor bestandsimport als deze nog niet op de computer is geïnstalleerd.
Voer de volgende opdracht uit op uw Windows-, Linux- of Mac-besturingssysteem:
```
$ 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 van Oracle Content Management instance: <oracle content management instance name>.oraclecloud.com
- Gebruikersnaam en wachtwoord voor de URL van de Oracle Content Management instance
  
  Opmerking:
  Om potentiële beveiligingsbedreigingen te verminderen kunt u overwegen om specifiek voor de agent voor bestandsimport een gebruiker te maken aan wie alleen de Content Capture rollen of machtigingen voor de vereiste procedures worden toegewezen.
- URL Identity Service instance: https://<servernaam>.identity.oraclecloud.com/oauth2/v1/token (U hebt deze waarde gekopieerd bij het maken van de IDCS-applicatie.)
- Client-ID: sampleid (U hebt deze waarde gekopieerd bij het maken van de IDCS-applicatie.)
- Clientgeheim: sample-secret (U hebt deze waarde gekopieerd bij het maken van de IDCS-applicatie.)
- Bereik-URL: https://<servernaam>:<poortnummer>/urn:opc:cec:all (U hebt deze waarde gekopieerd bij het maken van de IDCS-applicatie.)
Test uw verbinding door de volgende opdracht uit te voeren voor het weergeven van de importtaken:
```
$ capture list-import-jobs
```
Er wordt een lijst weergegeven met alle map- en bestandslijstimporttaken die zijn geconfigureerd in procedures voor het vastleggen van inhoud op de opgegeven Oracle Content Management instance.

Nadat u Oracle Content Management hebt geregistreerd en importtaken hebt geconfigureerd, configureert u de import van bestanden uit een map of configureert u de import van lijstbestanden.

Capture opdrachtregelhulpprogramma gebruiken

Met het Capture opdrachtregelhulpprogramma kunt u de agent voor bestandsimport configureren zodat hiermee documenten kunnen worden geïmporteerd in de Oracle Content Management repository. Het hulpprogramma biedt opdrachten voor het gebruik en beheer van de agent voor bestandsimport.

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