simply007 / kontent-migrations-boilerplate-net

Simple migrations boilerplate.

Kontent Migrations Boilerplate

This is a simplified alternative Kontent CLI migrations examples . It uses Kontent Management Management API SDK to showcase simple migrations using mentioned SDK.

This repo is meant to be used as a boilerplate for more complex setup, that might i.e. record state of alreasy processed migrations, extends migration modules with other context data, or implements more robust retry policy and respects rate limitations.

Get started

• Copy .environments.json.template and name it .environments.json
• Fill the projectId and apiKey

Alternatively, you can install Kontent CLI an run:

kontent environment add --name TARGET --project-id "<YOUR_PROJECT_GUID>" --api-key "<YOUR_MANAGAMENT_API_KEY>"

• build the project by dotnet build
• run sample migrations dotnet run

Sample migrations

Sample migrations create a bunch of blog posts with test field Author. Then transform this text field with full name into a separate content items Author and link these from the blog posts to reuse content. Ultimately removed old Author text field.

kontent-migrations-boilerplate-net's Issues

Showcase content group with elements creation in one call

Add/Adjust migration to showcase creating a content group(s) and add the elements in one API call.

It is possible to enter the content group entity and its reference to all elements in the payload.

Example
You can use Management SDK tests in vNext branch as a showcase - specificaly CreateContentType_CreatesContentType test

Extend the Migration signature with delivery client

Some of the migrations might need to use the delivery client as well.

Add this as another dependency to the migration's Run method signature.

Implement Rate limitations

Currently, there is no rate limitation respected in the boilerplate.

Since the MAPI SDK has rate limitations and the SDK does not yet respect the value of retry-after (kontent-ai/management-sdk-net#39) It might be wise to implement some counting mechanism,

Unable to create a Multiple Choice Element for a Content Type via MultipleChoiceElementMetadataModel

I'm trying to create a Multiple Choice Element on a given Content Type inside of a call to new ContentTYpeAddIntoPatchModel() { ... } and the API doesn't allow me to create more than one Option (via new MultipleChoiceOptionModel()) (there is no enumerable support, only single option support as a value to the Options property of MultipleChoiceElementMetadataModel.

The Management API responds with the following error every time:
Invalid operation, the multiple choice element must specify its options. Provide at least an empty array.

Code snippet:

Error message:

The reason I think it's an issue is that the property MultipleChoiceOptionModel is a single object in the Management SDK.