Denys Vuika ea2c0ce229
[PRODENG-211] integrate JS-API with monorepo (part 1) (#9081)
* integrate JS-API with monorepo

* [ci:force] fix token issue

[ci:force] migrate docs folder

[ci:force] clean personal tokens

* [ci:force] gha workflow support

* [ci:force] npm publish target

* fix js-api test linting

* [ci:force] fix test linting, mocks, https scheme

* [ci:force] fix https scheme

* [ci:force] typescript mappings

* [ci:force] update scripts

* lint fixes

* linting fixes

* fix linting

* [ci:force] linting fixes

* linting fixes

* [ci:force] remove js-api upstream and corresponding scripts

* [ci:force] jsdoc fixes

* fix jsdoc linting

* [ci:force] jsdoc fixes

* [ci:force] jsdoc fixes

* jsdoc fixes

* jsdoc fixes

* jsdoc fixes

* [ci:force] fix jsdoc

* [ci:force] reduce code duplication

* replace 'chai' expect with node.js assert

* replace 'chai' expect with node.js assert

* [ci:force] remove chai and chai-spies for js-api testing

* [ci:force] cleanup and fix imports

* [ci:force] fix linting

* [ci:force] fix unit test

* [ci:force] fix sonar linting findings

* [ci:force] switch activiti api models to interfaces (-2.5% reduction of bundle)

* [ci:force] switch activiti api models to interfaces

* [ci:force] switch AGS api models to interfaces

* [ci:force] switch AGS api models to interfaces

* [ci:force] switch search api models to interfaces

* [ci:force] switch content api models to interfaces where applicable
2023-11-21 05:27:51 -05:00

87 lines
6.3 KiB
Markdown

# Activities Api
All URIs are relative to *https://localhost/alfresco/api/-default-/public/alfresco/versions/1*
| Method | HTTP request | Description |
|-----------------------------------------------------|---------------------------------------|-----------------|
| [listActivitiesForPerson](#listActivitiesForPerson) | **GET** /people/{personId}/activities | List activities |
## listActivitiesForPerson
List activities
You can use the `-me-` string in place of `<personId>` to specify the currently authenticated user.
**Parameters**
| Name | Type | Description | Notes |
|----------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------|
| **personId** | string | The identifier of a person. | |
| opts.skipCount | number | The number of entities that exist in the collection before those included in this list. If not supplied then the default value is 0. | [default to 0] |
| opts.maxItems | number | The maximum number of items to return in the list. If not supplied then the default value is 100. | [default to 100] |
| opts.who | string | A filter to include the user's activities only me, other user's activities only others' | |
| opts.siteId | string | Include only activity feed entries relating to this site. | |
| opts.fields | string[] | A list of field names. You can use this parameter to restrict the fields returned within a response if, for example, you want to save on overall bandwidth. The list applies to a returned individual entity or entries within a collection. If the API method also supports the **include** parameter, then the fields specified in the **include** parameter are returned in addition to those specified in the **fields** parameter. | |
**Return type**: [ActivityPaging](#ActivityPaging)
**Example**x
```javascript
import { AlfrescoApi, ActivitiesApi} from '@alfresco/js-api';
const alfrescoApi = new AlfrescoApi(/*...*/);
const activitiesApi = new ActivitiesApi(alfrescoApi);
const personId = '<personId>';
const opts = {};
activitiesApi.listActivitiesForPerson(personId, opts).then((data) => {
console.log('API called successfully. Returned data: ' + data);
});
```
# Models
## ActivityPaging
**Properties**
| Name | Type |
|------|-------------------------------------------|
| list | [ActivityPagingList](#ActivityPagingList) |
## ActivityPagingList
**Properties**
| Name | Type |
|------------|-----------------------------------|
| pagination | [Pagination](Pagination.md) |
| entries | [ActivityEntry[]](#ActivityEntry) |
## ActivityEntry
**Properties**
| Name | Type |
|-------|-----------------------|
| entry | [Activity](#Activity) |
## Activity
**Properties**
| Name | Type | Description |
|------------------|---------------------|---------------------------------------------------------------|
| **postPersonId** | string | The id of the person who performed the activity |
| **id** | number | The unique id of the activity |
| siteId | string | The unique id of the site on which the activity was performed |
| postedAt | Date | The date time at which the activity was performed |
| **feedPersonId** | string | The feed on which this activity was posted |
| activitySummary | Map<string, string> | An object summarizing the activity |
| **activityType** | string | The type of the activity posted |