APIS
Client libraries
Custom Projection IDs
Understanding Projection IDs
By default, all Projections use the Aggregate ID from the feed they are created from as the ID of the Projection (except for aggregated Projections which don't have IDs).
Example
Let's say we have an event for an order:
1
{
2
"eventId": "f2c8bfc1-c702-4f1a-b295-ef113ed7c8be",
3
"eventType": "OrderRegistered",
4
"data": {
5
"orderId": "ABC-123",
6
"amount": 1000,
7
"currency": "SEK"
8
}
9
}
Copied!
The Aggregate ID is not shown in the Projection data but you will see it if you take an entry from the Feed instead:
1
{
2
"sequenceNumber": 12314,
3
"aggregateId": "22c3780f-6dcb-440f-8532-6693be83f21c",
4
"timestamp": 1503386583474,
5
"events": [
6
{
7
"eventId": "f2c8bfc1-c702-4f1a-b295-ef113ed7c8be",
8
"eventType": "OrderRegistered",
9
"data": {
10
"orderId": "ABC-123",
11
"amount": 1000,
12
"currency": "SEK"
13
}
14
}
15
]
16
}
Copied!
If we would create a Projection from this order feed we would get a Projection for the Aggregate ID
22c3780f-6dcb-440f-8532-6693be83f21c. The URL for accessing the Projection data would be:1
https://api.serialized.io/projections/single/orders/22c3780f-6dcb-440f-8532-6693be83f21c
Copied!
Customizing the Projection ID
You can control what ID you want to use for your projections. You can use any existing field from your event as an ID instead of the default Aggregate ID.
To change the ID of your Projections, you use the
idField value in the Projection definition that you use to configure your Projection. If you want different ID:s for different event types, you can put the idField on Handler level instead.Example
To use
orderId from the example above, we could use the following Projection definition:1
{
2
"projectionName": "orders",
3
"feedName": "order",
4
"idField": "orderId",
5
"handlers": [
6
{
7
"eventType": "OrderPlacedEvent",
8
"functions": [
9
{
10
"function": "set",
11
"targetSelector": "$.projection.status",
12
"rawData": "PLACED"
13
},
14
{
15
"function": "set",
16
"targetSelector": "$.projection.orderAmount",
17
"eventSelector": "$.event.orderAmount"
18
}
19
]
20
}
21
]
22
}
Copied!
Or, if you're using a custom projection function:
1
{
2
"projectionName": "orders",
3
"feedName": "order",
4
"idField": "orderId",
5
"handlers": [
6
{
7
"eventType": "OrderPlacedEvent",
8
"functionUri": "https://example.com/generate-orders-projection"
9
}
10
]
11
}
Copied!
This would result in your Projection being available from the following URL instead:
1
https://api.serialized.io/projections/single/orders/ABC-123
Copied!
Last modified 2mo ago