---
title: Business Objects & Instances
slug: business-objects-and-instances
createdAt: 2024-05-16T21:07:42.769Z
---

# Business Objects

**Business Objects** allow users to dynamically filter on dataset attributes and apply connections to specific filtered subsets. This is useful for situations where an integration is created for a specific grouping of data elements but not all.&#x20;

:::hint{type="info"}
A common use case is point solution activation for specific employer groups.&#x20;

For example adding *SmithRx PBM* to the employer named "*Dunder Mifflin*". In this case *SmithRx PBM* would only transact data relevant to *Dunder Mifflin* (i.e. eligibility, accumulators, and claims)
:::

When creating a **Business Object**, a user picks the field within a data type that will be sorted for and grouped by uniqueness.

Examples include:

- Employer Groups - Select <u>Eligibility</u> and <u>Claims </u>records with matching `group_id`
- Lines of Business - Select <u>Eligibility</u> and <u>Claims </u>records with matching `group_block_of_business_id`
- Location - Select <u>Eligibility</u> records with specific `group_id` and `state`

![](https://api.archbee.com/api/optimize/ONQv7jXaQDUrPP7qukKE0/4b6CmcPsphGQ7Tc-a_IH1_business-objs-1-1.jpg)

# Business Object Instances

Unique instances of business objects (i.e. data groupings that match within the business object filter criteria) are called **Business Object Instances (BOI).**

<u>Examples:</u>

- “Dunder Mifflin” for all <u>Eligibility</u> and <u>Claim</u> records where `group-id` = 12345
- “Intellicorp” for all <u>Eligibility</u> and <u>Claim</u> records where `group-id` = 23648

![](https://api.archbee.com/api/optimize/ONQv7jXaQDUrPP7qukKE0/B16-3drVCNlIA2xKeNiy1_business-objs-2.jpg "BOI with matching \"group_id\"")

## Applying Connections to BOIs

Once Business Objects are configured, users can assign specific Connections to individual **Business Object Instances (BOIs)&#x20;**&#x61;nd also toggle on/off Relays associated with that BOI to further control which data types are traded.

![](https://api.archbee.com/api/optimize/ONQv7jXaQDUrPP7qukKE0/J9cjlZJ8QKVpt23ek2NID_boi-1-1.jpg)

