Sf Omnistudio

# OmniStudio Reference

Deep reference for OmniStudio component metadata, namespace mappings, and operational guidance.

## Namespace Detection Queries

Run these queries sequentially. The first successful result identifies the installed namespace.

```sql
-- Probe 1: Core (Industries Cloud, Spring '22+)
SELECT COUNT() FROM OmniProcess

-- Probe 2: Vlocity CMT (Communications, Media, Energy)
SELECT COUNT() FROM vlocity_cmt__OmniScript__c

-- Probe 3: Vlocity INS (Insurance, Health)
SELECT COUNT() FROM vlocity_ins__OmniScript__c
```

A successful query returns exit code 0 with `totalSize` in JSON output. An `INVALID_TYPE` error means that namespace is absent.

## Complete Namespace Field Mapping

### Primary Objects

| Concept | Core | vlocity_cmt | vlocity_ins |
|---------|------|-------------|-------------|
| OmniScript / IP container | `OmniProcess` | `vlocity_cmt__OmniScript__c` | `vlocity_ins__OmniScript__c` |
| OmniScript / IP elements | `OmniProcessElement` | `vlocity_cmt__Element__c` | `vlocity_ins__Element__c` |
| FlexCard | `OmniUiCard` | `vlocity_cmt__VlocityUITemplate__c` | `vlocity_ins__VlocityUITemplate__c` |
| Data Mapper | `OmniDataTransform` | `vlocity_cmt__DRBundle__c` | `vlocity_ins__DRBundle__c` |
| Data Mapper Item | `OmniDataTransformItem` | `vlocity_cmt__DRMapItem__c` | `vlocity_ins__DRMapItem__c` |

### Key Fields

| Concept | Core Field | vlocity_cmt Field | vlocity_ins Field |
|---------|-----------|-------------------|-------------------|
| Script type | `Type` | `vlocity_cmt__Type__c` | `vlocity_ins__Type__c` |
| Script subtype | `SubType` | `vlocity_cmt__SubType__c` | `vlocity_ins__SubType__c` |
| Language | `Language` | `vlocity_cmt__Language__c` | `vlocity_ins__Language__c` |
| Active flag | `IsActive` | `vlocity_cmt__IsActive__c` | `vlocity_ins__IsActive__c` |
| Version number | `VersionNumber` | `vlocity_cmt__Version__c` | `vlocity_ins__Version__c` |
| Element config | `PropertySetConfig` | `vlocity_cmt__PropertySet__c` | `vlocity_ins__PropertySet__c` |
| Is Integration Procedure | `IsIntegrationProcedure` | `vlocity_cmt__IsIntegrationProcedure__c` | `vlocity_ins__IsIntegrationProcedure__c` |
| FlexCard data sources | `DataSourceConfig` | `vlocity_cmt__Definition__c` | `vlocity_ins__Definition__c` |
| FlexCard layout | `PropertySetConfig` | `PropertySetConfig` | `PropertySetConfig` |
| DM input object | `InputObjectName` (on Item) | `vlocity_cmt__InterfaceObject__c` | `vlocity_ins__InterfaceObject__c` |
| DM output object | `OutputObjectName` (on Item) | `vlocity_cmt__TargetFieldObjectType__c` | `vlocity_ins__TargetFieldObjectType__c` |

## OmniScript / IP Metadata Structure (Core)

OmniProcess fields: `Id`, `Name`, `Type`, `SubType`, `Language`, `VersionNumber`, `IsActive`, `IsIntegrationProcedure` (boolean discriminator), `OmniProcessType` (computed), `PropertySetConfig` (JSON), `LastModifiedDate`.

OmniProcessElement fields: `Id`, `OmniProcessId` (parent lookup), `Name`, `Type` (element type), `Level` (0=Step, 1+=children), `Order` (sequence), `PropertySetConfig` (JSON), `IsActive`.

### PropertySetConfig Structure (Action Elements)

DataRaptor Extract/Load Action:
```json
{
  "bundle": "DR_Extract_Account_Details",
  "inputMap": {
    "AccountId": "%ContextId%"
  },
  "outputMap": {},
  "optionsMap": {},
  "showError": true,
  "errorMessage": "Failed to retrieve account data"
}
```

Integration Procedure Action:
```json
{
  "ipMethod": "AccountOnboarding_Standard",
  "inputMap": {
    "accountId": "%AccountId%",
    "requestType": "new"
  },
  "outputMap": {},
  "optionsMap": {
    "useFuture": false
  },
  "showError": true,
  "errorMessage": "Onboarding procedure failed"
}
```

Remote Action:
```json
{
  "remoteClass": "AccountService",
  "remoteMethod": "validateAddress",
  "inputMap": {
    "street": "%Street%",
    "city": "%City%"
  },
  "outputMap": {}
}
```

## FlexCard Metadata Structure

OmniUiCard fields: `Id`, `Name`, `IsActive`, `VersionNumber`, `OmniUiCardType`, `AuthorName`, `