Skip to content

Imroved migrations doc#3296

Draft
mnocon wants to merge 1 commit into
5.0from
inspect-migration-examples
Draft

Imroved migrations doc#3296
mnocon wants to merge 1 commit into
5.0from
inspect-migration-examples

Conversation

@mnocon

@mnocon mnocon commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

Target: 5.0, 6.0

I've asked Fable to cross-check the docs and the implementation living in vendor/ibexa - this is the result.

Status: still WIP

@github-actions

Copy link
Copy Markdown

@github-actions

Copy link
Copy Markdown

code_samples/ change report

Before (on target branch)After (in current PR)

code_samples/data_migration/examples/create_blog_post_ct.yaml


code_samples/data_migration/examples/create_blog_post_ct.yaml

docs/content_management/data_migration/importing_data.md@309:``` yaml
docs/content_management/data_migration/importing_data.md@310:[[= include_file('code_samples/data_migration/examples/create_blog_post_ct.yaml') =]]
docs/content_management/data_migration/importing_data.md@311:```
docs/content_management/data_migration/importing_data.md@337:``` yaml
docs/content_management/data_migration/importing_data.md@338:[[= include_file('code_samples/data_migration/examples/create_blog_post_ct.yaml') =]]
docs/content_management/data_migration/importing_data.md@339:```

001⫶-
002⫶ type: content_type
003⫶ mode: create
004⫶ metadata:
005⫶ identifier: blog_post
006⫶ mainTranslation: eng-GB

001⫶-
002⫶ type: content_type
003⫶ mode: create
004⫶ metadata:
005⫶ identifier: blog_post
006⫶ mainTranslation: eng-GB
007⫶        contentTypeGroups:
008⫶ - Content
009⫶ translations:
010⫶ eng-GB:
011⫶ name: Blog Post
012⫶ fields:
013⫶ - identifier: title
014⫶ type: ibexa_string
015⫶ required: true
016⫶ translations:
017⫶ eng-GB:
018⫶ name: 'Title'
019⫶ - identifier: body
020⫶ type: ibexa_richtext
021⫶ required: false
007⫶        nameSchema: '<title>'
008⫶ urlAliasSchema: '<title>'
009⫶ container: true
010⫶ defaultAlwaysAvailable: true
011⫶ defaultSortField: 2 # Location::SORT_FIELD_PUBLISHED
012⫶ defaultSortOrder: 0 # Location::SORT_ORDER_DESC
013⫶ contentTypeGroups:
014⫶ - Content
015⫶ translations:
016⫶ eng-GB:
017⫶ name: Blog Post
018⫶ fields:
019⫶ - identifier: title
020⫶ type: ibexa_string
021⫶ required: true
022⫶            translations:
023⫶ eng-GB:
022⫶            translations:
023⫶ eng-GB:
024⫶                    name: 'Body'
024⫶                    name: 'Title'
025⫶ - identifier: body
026⫶ type: ibexa_richtext
027⫶ required: false
028⫶ translations:
029⫶ eng-GB:
030⫶ name: 'Body'


code_samples/data_migration/examples/create_content_options.yaml



code_samples/data_migration/examples/create_content_options.yaml

docs/content_management/data_migration/importing_data.md@358:``` yaml
docs/content_management/data_migration/importing_data.md@359:[[= include_file('code_samples/data_migration/examples/create_content_options.yaml') =]]
docs/content_management/data_migration/importing_data.md@360:```

001⫶-
002⫶ type: content
003⫶ mode: create
004⫶ metadata:
005⫶ contentType: folder
006⫶ mainTranslation: eng-GB
007⫶ creatorId: 14
008⫶ modificationDate: '2025-06-01T10:00:00+00:00'
009⫶ publicationDate: '2025-06-01T10:00:00+00:00'
010⫶ remoteId: options_folder
011⫶ alwaysAvailable: true
012⫶ section:
013⫶ identifier: standard
014⫶ location:
015⫶ parentLocationId: 2
016⫶ locationRemoteId: options_folder_location
017⫶ hidden: false
018⫶ priority: 10
019⫶ sortField: 9 # Location::SORT_FIELD_NAME
020⫶ sortOrder: ASC
021⫶ fields:
022⫶ - fieldDefIdentifier: name
023⫶ languageCode: eng-GB
024⫶ value: 'Folder with all options'


code_samples/data_migration/examples/create_product_availability.yaml


code_samples/data_migration/examples/create_product_availability.yaml

docs/content_management/data_migration/importing_data.md@563:``` yaml
docs/content_management/data_migration/importing_data.md@564:[[= include_file('code_samples/data_migration/examples/create_product_availability.yaml') =]]
docs/content_management/data_migration/importing_data.md@565:```

001⫶-
002⫶ type: product_availability
003⫶ mode: create
004⫶ product_code: ergo_desk
005⫶ is_available: true
006⫶ is_infinite: false
007⫶ stock: 100


code_samples/data_migration/examples/service_call_step.yaml


code_samples/data_migration/examples/service_call_step.yaml

docs/content_management/data_migration/importing_data.md@226:```yaml
docs/content_management/data_migration/importing_data.md@227:[[= include_file('code_samples/data_migration/examples/service_call_step.yaml') =]]
docs/content_management/data_migration/importing_data.md@228:```

001⫶-
002⫶ type: service_call
003⫶ mode: execute
004⫶ service: App\Migration\ContentImporter
005⫶ method: import
006⫶ arguments:
007⫶ - content.csv
008⫶ - 42


code_samples/data_migration/examples/update_content.yaml


code_samples/data_migration/examples/update_content.yaml

docs/content_management/data_migration/importing_data.md@366:``` yaml
docs/content_management/data_migration/importing_data.md@367:[[= include_file('code_samples/data_migration/examples/update_content.yaml') =]]
docs/content_management/data_migration/importing_data.md@368:```

001⫶-
002⫶ type: content
003⫶ mode: update
004⫶ match:
005⫶ field: content_remote_id
006⫶ value: options_folder
007⫶ metadata:
008⫶ mainLanguageCode: eng-GB
009⫶ name: 'Updated folder'
010⫶ ownerId: 14
011⫶ alwaysAvailable: false
012⫶ modificationDate: '2025-06-15T10:00:00+00:00'
013⫶ fields:
014⫶ - fieldDefIdentifier: name
015⫶ languageCode: eng-GB
016⫶ value: 'Updated folder'


code_samples/data_migration/examples/update_language.yaml


code_samples/data_migration/examples/update_language.yaml

docs/content_management/data_migration/importing_data.md@479:``` yaml
docs/content_management/data_migration/importing_data.md@480:[[= include_file('code_samples/data_migration/examples/update_language.yaml') =]]
docs/content_management/data_migration/importing_data.md@481:```

001⫶-
002⫶ type: language
003⫶ mode: update
004⫶ languageCode: fre-FR
005⫶ metadata:
006⫶ name: French
007⫶ enabled: true


code_samples/data_migration/examples/update_user.yaml


code_samples/data_migration/examples/update_user.yaml

docs/content_management/data_migration/importing_data.md@262:```yaml
docs/content_management/data_migration/importing_data.md@263:[[= include_file('code_samples/data_migration/examples/update_user.yaml') =]]
docs/content_management/data_migration/importing_data.md@264:```
docs/content_management/data_migration/importing_data.md@288:```yaml
docs/content_management/data_migration/importing_data.md@289:[[= include_file('code_samples/data_migration/examples/update_user.yaml') =]]
docs/content_management/data_migration/importing_data.md@290:```

001⫶-
002⫶ type: user
003⫶ mode: update
004⫶ match:
005⫶ field: login
006⫶ value: admin
007⫶ metadata:

001⫶-
002⫶ type: user
003⫶ mode: update
004⫶ match:
005⫶ field: login
006⫶ value: admin
007⫶ metadata:
008⫶        password: '###XXX env("ADMIN_PASSWORD") XXX###'

docs/content_management/data_migration/importing_data.md@417:``` yaml
docs/content_management/data_migration/importing_data.md@418:[[= include_file('code_samples/data_migration/examples/update_user.yaml') =]]
docs/content_management/data_migration/importing_data.md@419:```
008⫶        email: admin@example.com
009⫶ enabled: true
010⫶ password: '###XXX env("ADMIN_PASSWORD") XXX###'

docs/content_management/data_migration/importing_data.md@462:``` yaml
docs/content_management/data_migration/importing_data.md@463:[[= include_file('code_samples/data_migration/examples/update_user.yaml') =]]
docs/content_management/data_migration/importing_data.md@464:```

001⫶-
002⫶ type: user
003⫶ mode: update
004⫶ match:
005⫶ field: login
006⫶ value: admin
007⫶ metadata:

001⫶-
002⫶ type: user
003⫶ mode: update
004⫶ match:
005⫶ field: login
006⫶ value: admin
007⫶ metadata:
008⫶        password: '###XXX env("ADMIN_PASSWORD") XXX###'
008⫶        email: admin@example.com
009⫶ enabled: true
010⫶ password: '###XXX env("ADMIN_PASSWORD") XXX###'


Download colorized diff

@github-actions

Copy link
Copy Markdown

Summary

Status Count
🔍 Total 761798
🔗 Unique 15028
✅ Successful 6312
⏳ Timeouts 0
🔀 Redirected 0
👻 Excluded 755371
❓ Unknown 0
🚫 Errors 115
⛔ Unsupported 0

Errors per input

Errors in site/ibexa_cloud/ddev_and_ibexa_cloud/index.html

Errors in site/infrastructure_and_maintenance/cache/http_cache/content_aware_cache/index.html

Errors in site/release_notes/ez_platform_v1.10.0/index.html

Errors in site/release_notes/ez_platform_v1.11.0/index.html

Errors in site/release_notes/ez_platform_v1.13.0_lts/index.html

Errors in site/release_notes/ez_platform_v1.9.0/index.html

Errors in site/release_notes/ez_platform_v3.0/index.html

Errors in site/release_notes/ez_platform_v3.0_deprecations/index.html

Errors in site/release_notes/ez_platform_v3.1/index.html

Errors in site/release_notes/ibexa_dxp_v3.2/index.html

Errors in site/release_notes/ibexa_dxp_v4.0/index.html

Errors in site/release_notes/ibexa_dxp_v4.1/index.html

Errors in site/release_notes/ibexa_dxp_v4.2/index.html

Errors in site/release_notes/ibexa_dxp_v4.3/index.html

Errors in site/release_notes/ibexa_dxp_v4.4/index.html

Errors in site/templating/twig_function_reference/recommendations_twig_functions/index.html

Errors in site/update_and_migration/migrate_to_ibexa_dxp/migrating_from_ez_publish/index.html

Full Github Actions output

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant