Skip to main content

publicationState 被删除并由 status 替换

¥publicationState is removed and replaced by status

在 Strapi 5 中，草稿和发布功能 已被重新设计，并且内容 API（包括 REST、GraphQL 和文档服务 API）接受新的 status 参数。

¥In Strapi 5, the Draft & Publish feature has been reworked, and the Content API, including REST, GraphQL, and Document Service APIs accept a new status parameter.

此页面是 重大变更数据库 的一部分，提供有关重大更改的信息以及从 Strapi v4 迁移到 Strapi 5 的其他说明。

¥This page is part of the breaking changes database and provides information about the breaking change and additional instructions to migrate from Strapi v4 to Strapi 5.

 Is this breaking change affecting plugins?Yes
 Is this breaking change automatically handled by a codemod?Yes
(see entity-service-document-service )

重大更改描述​

¥Breaking change description

在 Strapi v4 中

¥In Strapi v4

publicationState 被使用并接受以下值：

¥publicationState is used and accepts the following values:

  • live 仅返回已发布的条目，

    ¥live returns only published entries,

  • preview 返回草稿条目和已发布的条目。

    ¥preview returns both draft entries & published entries.

在 Strapi 5 中

¥In Strapi 5

status 被使用并接受以下值：

¥status is used and accepts the following values:

  • draft 返回文档的草稿版本，

    ¥draft returns the draft version of a document,

  • published 返回文档的已发布版本。

    ¥published returns the published version of a document.

迁移​

¥Migration

本节重新组合了有关引入的重大更改的有用说明和程序。

¥This section regroups useful notes and procedures about the introduced breaking change.

注意​

¥Notes

  • 没有后备方案来默认返回已发布的版本，如果未找到已发布的版本，则返回草稿版本。

    ¥There are no fallbacks to return by default the published version, and return the draft version if no published version is found.

  • 有关如何使用新 status 参数的更多信息，请参阅 REST API、GraphQL API 和 文档服务 API 文档。

    ¥Additional information about how to use the new status parameter can be found in the REST API, GraphQL API, and Document Service API documentation.

迁移程序​

¥Migration procedure

  • 从使用 publicationState 的前端（REST API、GraphQL API）发起的 API 调用需要手动更新。

    ¥API calls initiated from the front end (REST API, GraphQL API) that used publicationState need to be manually updated.

  • 如果在 Strapi v4 中的实体服务 API 中自定义后端代码中使用 publicationState，则 codemod 将自动处理 Strapi 5 的更改（有关更多详细信息，请参阅 实体服务到文档服务迁移参考）。

    ¥If publicationState is used in your custom back-end code with the Entity Service API in Strapi v4, a codemod will automatically handle the change for Strapi 5 (see Entity Service to Document Service migration reference for additional details).