> For the complete documentation index, see [llms.txt](https://docs.antsomi.com/cdp-365-user-guide-en/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.antsomi.com/cdp-365-user-guide-en/data-hub/business-objects/data-objects/collections.md).

# Collections

## Navigate to Collections Menu

1. Hover your mouse over **Data**. Choose **Data Objects**.

<figure><img src="https://826840553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtU4vFUxT5JkWYHePuoX%2Fuploads%2Fcg6vqsH89Sl1Q5mCAFpM%2Fimage.png?alt=media&amp;token=9fd96be4-759f-42bc-8bbc-afb3ed7cd6ae" alt=""><figcaption></figcaption></figure>

2. For this example, choose **Product** Data Object.

<figure><img src="https://826840553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtU4vFUxT5JkWYHePuoX%2Fuploads%2FAbWjR7k7PGmYIAzlKNma%2Fimage.png?alt=media&amp;token=d9ec24fa-568e-4df3-9a6d-446fc7b775ac" alt=""><figcaption></figcaption></figure>

3. Choose **Collections**

<figure><img src="https://826840553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtU4vFUxT5JkWYHePuoX%2Fuploads%2Fd3s4xsnvbi10oYSy4KDk%2Fimage.png?alt=media&amp;token=2735f985-d80a-4b59-af13-60ff4de101ec" alt=""><figcaption></figcaption></figure>

## Create a Collection

You can create a Collection by following the steps:&#x20;

1. Click ![](https://826840553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtU4vFUxT5JkWYHePuoX%2Fuploads%2Fs5AjYLlktQPVEJSSdic9%2Fimage.png?alt=media\&token=6c7598cb-2c52-4793-9ad0-cb020a46f2f3) to create a Collection

<figure><img src="https://826840553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtU4vFUxT5JkWYHePuoX%2Fuploads%2FUjGKsJaXONs6YKik0O38%2Fimage.png?alt=media&amp;token=ea107246-150a-4f32-b2d7-a402e28048c2" alt=""><figcaption></figcaption></figure>

2. [Configure the Collection](#undefined)
3. Click ![](https://826840553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtU4vFUxT5JkWYHePuoX%2Fuploads%2Fqvi5zIt5hEBntV3qIBDb%2Fimage.png?alt=media\&token=1ff257d4-a6ea-4102-ac06-1876dd6075fc)to save and wait for the calculated result by the system&#x20;

<figure><img src="https://826840553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtU4vFUxT5JkWYHePuoX%2Fuploads%2FqIc59uwdLj9HZ98iu3uS%2Fimage.png?alt=media&amp;token=173c4cf2-79da-4b8b-89a9-e8ee90b6107e" alt=""><figcaption></figcaption></figure>

### Configure the Collection

#### Update method

<figure><img src="https://826840553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtU4vFUxT5JkWYHePuoX%2Fuploads%2FfetX6pHiOvPTJMUenzcM%2Fimage.png?alt=media&amp;token=3b2acd8b-e730-4a5c-b0e0-f385c53e1282" alt=""><figcaption></figcaption></figure>

| Update Collection | Description                                                                                                                                                                                                                                                            |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Static            | The final result is computed result after selecting ![](https://826840553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtU4vFUxT5JkWYHePuoX%2Fuploads%2FsQXxRBykqBKvvvorNYuC%2Fimage.png?alt=media\&token=6e2f6506-f17d-411e-a8b8-ba48d5e49497) |
| Dynamic           | The result will be recomputed periodically based on the schedule by date or time                                                                                                                                                                                       |

{% hint style="info" %}
The collection chooses the Dynamic Collection - scheduled update type will contain the Computation Schedule option. See more about the [Computation Schedule](broken://pages/e485ErmJLYjqXpBEEBFU#computation-schedule)
{% endhint %}

#### Include item that

<figure><img src="https://826840553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtU4vFUxT5JkWYHePuoX%2Fuploads%2FT7gBTtAl5I8LT7iGFd6o%2Fimage.png?alt=media&amp;token=7c43af76-ffab-4d58-a082-1ac4ec218df7" alt=""><figcaption></figcaption></figure>

The item will be updated to Collection by selecting the method below:

| Item input method | Description                                                                                                                                                                         |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Add condition     | Collection will be created based on objects that already exist on your CDP 365 system portal. These objects are filtered based on your setting of the ***Have attribute***          |
| Or bulk select    | The element will be imported into the collection by uploading a data file ​with format .csv, .xlsx, .xls. See more the[ Import](broken://pages/e485ErmJLYjqXpBEEBFU#import) utility |

**Forecast**

You can see a sample of users in the audience by clicking **Forecast** on the right hand side of the screen.

<figure><img src="https://826840553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtU4vFUxT5JkWYHePuoX%2Fuploads%2FbxaCh6Ln4hnZ9ueRKyDF%2Fimage.png?alt=media&amp;token=20bccf20-9c42-4d9f-9f18-4a2f1f736f2b" alt=""><figcaption></figcaption></figure>

### Status of a **Collection**

You can change the status of a Collection by switching ![](https://826840553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtU4vFUxT5JkWYHePuoX%2Fuploads%2F0m10VCu1LiSvSKA8rA9t%2Fimage.png?alt=media\&token=f1c48e6b-7c18-46cc-a9a4-64f23a0a1dd0)or ![](https://826840553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtU4vFUxT5JkWYHePuoX%2Fuploads%2Fus97NrKJXRmdbYftpXq1%2Fimage.png?alt=media\&token=ff380e9e-9c74-4d1f-b116-8150a3b039d6)

### Quick editing name of the Collection

You can edit the name of the segment quickly by following the steps:

1. &#x20;Hover the collection name and choose ![](https://826840553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtU4vFUxT5JkWYHePuoX%2Fuploads%2FzRx5PiyFmTu3ykJOcbky%2Fimage.png?alt=media\&token=6923f6c3-6ab3-47be-844d-f043f0c2047b)
2. Edit name in the Collections popup
3. Click ![](https://826840553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtU4vFUxT5JkWYHePuoX%2Fuploads%2FJ3h7luaNiH0VQz54GZa4%2Fimage.png?alt=media\&token=721ab12e-ecaa-4102-afe5-c3161066cd5e)

<figure><img src="https://826840553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtU4vFUxT5JkWYHePuoX%2Fuploads%2FfMAaiyJTnfqkdkhxJYog%2Fimage.png?alt=media&amp;token=25286947-df3e-4018-88ad-04150402028b" alt=""><figcaption></figcaption></figure>

### Action with Collection

There are many actions you could do with one or multiple collections. To do so, click on the check box(es) of the collection(s) you want.

#### EDIT

<figure><img src="https://826840553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtU4vFUxT5JkWYHePuoX%2Fuploads%2FrwUInOZGaD7j4AoYCTap%2Fimage.png?alt=media&amp;token=89dae441-9067-4a11-8659-878111d69813" alt=""><figcaption></figcaption></figure>

#### Enable

When enabling the collection will change the state of the collection to Enabled.

If within a specified time the segment is not used anywhere, the state is changed to disabled

#### Disable

Disabling the collection changes the state of the collection to Disabled. This will then block the input of the collection. Collection cannot be used in any function.&#x20;

If, within a specified time, the collection is not re-enabled, the collection will automatically change its state to archived.

#### Archive&#x20;

When archive collection will block all output and input of collection. Then the collection will not show up in any collection selector list.

If within a specified time period, the collection is not enabled, it will be deleted forever.

#### Recover

Restore archived segment.

During recovery, the segment's state can be changed to enabled or disabled.

**Make a copy**

Create a new collection with the setting of the chosen one. This only applies when choosing one items.&#x20;

#### LABEL

In order to better distinguish between collections having the same characteristics and the others, you could use **Label** feature. This is especially helpful in many cases such as labeling collections by the team who created it, by seasons of the year or by discount rate, etc.

If there exists available labels, choose on the labels you want and click **Apply**.

<figure><img src="https://826840553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtU4vFUxT5JkWYHePuoX%2Fuploads%2Fol2llcx0sVxr3AH22TUh%2Fimage.png?alt=media&amp;token=cd3e5d72-c039-4a0a-a993-82b0a6ca0a25" alt=""><figcaption></figcaption></figure>

To create a new label, click ![](https://826840553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtU4vFUxT5JkWYHePuoX%2Fuploads%2FJPK1Zqw9itcdoVkqLxut%2Fimage.png?alt=media\&token=d72ad2ad-b943-4eee-8188-e7df8982f91a) & input necessary information -> click **Create**

<figure><img src="https://826840553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtU4vFUxT5JkWYHePuoX%2Fuploads%2Fo723hSZj0BvKPcw7cpAd%2Fimage.png?alt=media&amp;token=ec85049c-1e5d-4ce6-acc4-35251b1c297a" alt=""><figcaption></figcaption></figure>

## Computed result of collection

#### Quickly see the results in the collection list

<figure><img src="https://826840553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtU4vFUxT5JkWYHePuoX%2Fuploads%2F1ZUHLH8hbdQsWqkj3JdZ%2Fimage.png?alt=media&amp;token=d95ea7ae-3162-417e-a3d9-3b49de84c6ab" alt=""><figcaption></figcaption></figure>

You can quickly check the status and number of calculated elements in the data table of the Collection

## Collection Computation Histories&#x20;

### View Collection Computation Histories

Click the icon![](https://826840553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtU4vFUxT5JkWYHePuoX%2Fuploads%2FfiD7L490tRVVsfEuOGDI%2Fimage.png?alt=media\&token=404f9add-66f0-4768-bfc5-b7b25e9abb74)on the collection display to view the Collection Computation Histories

<figure><img src="https://826840553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtU4vFUxT5JkWYHePuoX%2Fuploads%2FxPQUq3JbS2dBf1dbhWCJ%2Fimage.png?alt=media&amp;token=2b7ab161-1c97-4810-8c42-00b2135da566" alt=""><figcaption></figcaption></figure>

### Collection Computation Histories Data table

It presents a data table containing information about collection computation

* **Computation ID:** Every time attribute is computed, it will have an ID
* **Name:** name of the attribute
* **Update method:** type of update method (Static/Dynamic)
* **Computation trigger:** Trigger by the user or Scheduled Update
* **Computation status:** Status of the computation (Success, Computing, Unsuccess, Paused, Waiting)
* **Computation started on:** the date and time that the computation starts
* **Computation ended on:** the date and time that the computation ends
* **Computation duration (sec):** The duration of computation (in seconds)
* **Computation output:** Number of outputs that satisfy the condition after finishing the computation
* **Error info:** Error code that caused compute failed

<figure><img src="https://826840553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtU4vFUxT5JkWYHePuoX%2Fuploads%2FmZRrFyeFuL23TyCg2PCm%2Fimage.png?alt=media&amp;token=1642e4d8-1b73-4a64-871b-d4dcc30c8283" alt=""><figcaption></figcaption></figure>

## Copy a Collection

When you want to create a collection that has similar condition settings to an existing collection, you can use the **Make a copy** feature. After creating a collection copy, you can modify the conditions to match the purpose and save it by selecting **Make a copy**.

### Steps to make a collection copy

1. Select the original collection
2. Select **Make a copy** in Action&#x20;

<figure><img src="https://826840553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtU4vFUxT5JkWYHePuoX%2Fuploads%2FLlkbMrylosb3icN9NbXe%2Fimage.png?alt=media&amp;token=360c3e98-8c8f-4d6f-a18d-fec9f7b5d2a7" alt=""><figcaption></figcaption></figure>

3. Enter the name and click **Make a copy**

<figure><img src="https://826840553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtU4vFUxT5JkWYHePuoX%2Fuploads%2FobiXYevXGia5dTJMxlej%2Fimage.png?alt=media&amp;token=61a3edd0-ff70-4d1f-bcd4-5db35715e66a" alt=""><figcaption></figcaption></figure>

4. Customize conditions&#x20;
5. Select **save** and compute

<figure><img src="https://826840553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtU4vFUxT5JkWYHePuoX%2Fuploads%2FkjD4CumGOArDhsyopa5T%2Fimage.png?alt=media&amp;token=83dc5f6e-c4ef-4f19-b33f-8ed5958118bb" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Note: The copy is only Saved and calculated when you click ![](https://826840553-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtU4vFUxT5JkWYHePuoX%2Fuploads%2FKwjGIZcQLjMeaXEwB3uI%2Fimage.png?alt=media\&token=e6aa442a-27a1-4df2-9503-e1fbd563a5f5)
{% endhint %}

## Use cases of Collection

### [How to create a Collection](/cdp-365-user-guide-en/use-cases/data-hub/business-objects/how-to-create-a-collection.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.antsomi.com/cdp-365-user-guide-en/data-hub/business-objects/data-objects/collections.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
