Get Documents
Properties
- Input
- Project Id
- Type:
int
- Description: The unique identifier of the project from which to retrieve documents. This is a required argument.
- Type:
- Service Id
- Type:
int
- Description: The unique identifier of the service associated with the documents. This is a required argument.
- Type:
- Usage Type
- Type:
UsageType?
- Description: Filter by document usage type (e.g.,
UsageType.Outbox
). This is an optional argument.
- Type:
- Document Statuses
- Type:
List<DocumentStatus>
- Description: Filter by a list of document statuses (e.g.,
DocumentStatus.Processed
). This is an optional argument.
- Type:
- Class Name
- Type:
string
- Description: Filter by document category name. This is an optional argument.
- Type:
- Class Id
- Type:
int?
- Description: Filter by document category identifier. This is an optional argument.
- Type:
- Filename
- Type:
string
- Description: Filter by filename. This is an optional argument.
- Type:
- Filetype
- Type:
string
- Description: Filter by filetype (MIME types accepted). This is an optional argument.
- Type:
- Comment Filter
- Type:
string
- Description: Filter by comment. This is an optional argument.
- Type:
- Result Filter
- Type:
string
- Description: Filter by result. This is an optional argument.
- Type:
- Start Date
- Type:
DateTime?
- Description: Filter from a starting date. Defaults to one year prior to the current date. This is an optional argument.
- Type:
- End Date
- Type:
DateTime?
- Description: Filter up to an end date. Defaults to the current date. This is an optional argument.
- Type:
- Document Id
- Type:
int?
- Description: Filter by the unique identifier of a specific document. This is an optional argument.
- Type:
- Master Id
- Type:
int?
- Description: Filter by the unique identifier of the master/parent document. This is an optional argument.
- Type:
- Definition Categories
- Type:
List<ParameterDefinitionCategory?>
- Description: Filter by documents containing specific parameter definition categories. This is an optional argument.
- Type:
- Page No
- Type:
int?
- Description: Filter by page number (only applicable when Page Size is set). This is an optional argument.
- Type:
- Page Size
- Type:
int?
- Description: The maximum number of results to return per page (use Page No to select which page to return results for). This is an optional argument.
- Type:
- Sort Field
- Type:
SortField?
- Description: Sort results by a specific field (default: Id). This is an optional argument.
- Type:
- Sort Direction
- Type:
SortDirection?
- Description: Sort results in a specific direction (default: descending). This is an optional argument.
- Type:
- Result Id
- Type:
string
- Description: Filter by result identifier. This is an optional argument.
- Type:
- Result Index
- Type:
int?
- Description: Filter by result index. This is an optional argument.
- Type:
- External Id
- Type:
string
- Description: Filter by user-configured unique identifier. This is an optional argument.
- Type:
- Document Guid
- Type:
string
- Description: Filter by document GUID. This is an optional argument.
- Type:
- Project Id
Usage
- Setup Activity:
- Add the "Get Documents" activity to your UiPath workflow.
- Configure the required input arguments:
- Project Id: Specify the project ID to search for documents.
- Service Id: Specify the service ID associated with the documents.
- Optionally, configure any additional filters to refine the document search based on your specific needs.
- Execution:
- The activity executes asynchronously, retrieving a list of documents based on the specified criteria.
- It uses the configured API context to access and filter the documents via the document client.
- Output:
- The activity returns a
List<DocumentViewModel>
, representing the documents that match the specified filters.
- The activity returns a
Considerations
- Data Filtering: Utilize the optional filters effectively to retrieve only the necessary documents, improving performance and reducing processing time.
- Data Integrity: Ensure that the project and service IDs are valid and accessible to avoid errors during the retrieval process.
- Pagination: Use the Page No and Page Size properties to manage large datasets efficiently, retrieving only the required subset of documents.