IRPCExternalLocationsAdmin.ImportFilesFromLinkedLocation
Administration API / specialized admin session
Converts a file source that links files into one that imports them, and starts importing.
| Service | External locations MFiles.IRPCExternalLocationsAdmin |
|---|---|
| gRPC method | /MFiles.IRPCExternalLocationsAdmin/ImportFilesFromLinkedLocation |
| HTTP (mf-http-grpc) | POST /grpc/v1/import-files-from-linked-location |
| Request | ImportFilesFromLinkedLocationRequest |
| Response | ImportFilesFromLinkedLocationResponse |
| Book and level | Administration API, specialized |
| Kind | admin |
| Session | Required: the session ID from LogIn in the mfiles-session-id-bin metadata. |
| Idempotent | no |
| Returns metadata structure version | no |
| Streaming | none (unary) |
Remarks
- Turns off
file_source.link_filesand automatic monitoring, saves the location, and starts the import as a background operation; returns before it finishes. - Only for enabled file sources: a mail source fails with an invalid-argument error.
- Restarts the server's external file monitor: running checks of all locations stop, and automatic checks resume in about two minutes.
- Requires
manage_external_locations.
Request: ImportFilesFromLinkedLocationRequest
Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.
| Field | Type | Description |
|---|---|---|
id | int32 | The ID of the file source. |
Response: ImportFilesFromLinkedLocationResponse
Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page. Fields marked (recursive) refer to a type already on their path.
| Field | Type | Description |
|---|---|---|
json_ext_loc | ExternalLocation | The location as saved, with linking and automatic monitoring off. |
json_ext_loc.id | int32 | External location ID. |
json_ext_loc.description | string | Description. |
json_ext_loc.object_acl | AccessControlList | ACL for new documents. |
json_ext_loc.object_acl.checked_out_to_user | int32 | Specifies the ID of the user who has extended rights because of the checkout operation performed by her. 0 if such user does not exist. |
json_ext_loc.object_acl.is_fully_authoritative | bool | Specifies whether this access control list is set to ignore the secondary permissions that come from the latest checked in version. |
json_ext_loc.object_acl.custom_component | AccessControlListComponent | Accesses the custom component of this ACL. |
json_ext_loc.object_acl.restrictive_components[] | repeated AccessControlListComponentMapEntry | Accesses the restrictive automatic components of this ACL. |
json_ext_loc.object_acl.secondary_access_control_list | AccessControlList (recursive) | Secondary ACL used for latest version ACL. Not used for access check if null. |
json_ext_loc.object_acl.additive_components[] | repeated AccessControlListComponentMapEntry | Accesses the additive automatic components of this ACL. |
json_ext_loc.object_type | int32 | Object type. |
json_ext_loc.object_properties[] | repeated DefaultProperty | The properties. |
json_ext_loc.object_properties[].property_def | int32 | PropertyDef ID. |
json_ext_loc.object_properties[].allow_retaining_previous_value | bool | True if the user is allowed to use/retain previous value |
json_ext_loc.object_properties[].type | DefaultPropertyType | Default property type.Values: DEFAULT_PROPERTY_TYPE_UNDEFINED (0), DEFAULT_PROPERTY_TYPE_FIXED_VALUE (1), DEFAULT_PROPERTY_TYPE_FROM_HP_DSS_XML (2), DEFAULT_PROPERTY_TYPE_FROM_XML (3), DEFAULT_PROPERTY_TYPE_FROM_EMAIL (4), DEFAULT_PROPERTY_TYPE_FROM_EMAIL_HEADER (5), DEFAULT_PROPERTY_TYPE_FROM_OCR (6), DEFAULT_PROPERTY_TYPE_FROM_FILE_PROPERTY (7), DEFAULT_PROPERTY_TYPE_STATE_TRANSITION_TIME (8). |
json_ext_loc.object_properties[].data | DefaultPropertyUnion | The details as a union. |
json_ext_loc.options | EXTLOCFLAGS | Flags. |
json_ext_loc.options.all | bool | Specifies all flags set; Including any future flags. |
json_ext_loc.options.disabled | bool | Present if the external location is disabled. If not present, the external location is enabled. |
json_ext_loc.options.monitor | bool | Present if the server should keep monitoring the external location. |
json_ext_loc.update_interval | uint32 | The delay between automatic monitoring rounds in seconds. |
json_ext_loc.type | ExtLocType | The type of the source.Values: EXT_LOC_TYPE_NONE (0), EXT_LOC_TYPE_FILE_SOURCE (1), EXT_LOC_TYPE_MAIL_SOURCE (2). |
json_ext_loc.data | ExtLocUnion | The type-specific data as a union. |
json_ext_loc.data.file_source | FileSource (oneof data) | File source definition. |
json_ext_loc.data.mail_source | MailSource (oneof data) | Mail source definition. |
json_ext_loc.aliases | string | Semicolon-separated list of semantic aliases. |