PaCE policy version states

  • Release version: Washingtondc
  • Updated February 1, 2024
  • 2 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of PaCE Policy Version States

    The PaCE policy version can exist in four states: Draft, Current, Archived, and Ready. Understanding these states is crucial for effective policy management and execution within ServiceNow. Each state influences the versioning and utilization of policies, ensuring that only one version is active at a time while allowing for multiple drafts and archived versions.

    Show full answer Show less

    Key Features

    • Draft: The initial state of a new version. Draft versions can be saved for later or published to become Current. They cannot be executed until published.
    • Current: The active version used for policy execution. When a new version is published, the previous Current version is automatically archived.
    • Archived: Represents previous Current versions. Archived versions can be republished if needed.
    • Ready: Assigned to optional policies from installed application content packs. These cannot be modified directly.

    Key Outcomes

    Each version has three identifiers: Version name, Version number, and Revision number. Draft versions follow a naming convention of Draft-V{Revision number}, while Current and Archived versions use V{Version}. The Version number increments with each published version, starting at 1.0 for the first Current version. Revision numbers increment for each Draft created, starting at 0.1 for the first Draft.

    Understanding these states and numbering conventions helps ServiceNow customers manage their policies effectively, ensuring clarity in version management and execution processes.

    A PaCE policy version can be in one of four states: Draft, Current, Archived, and Now-Content. The policy version state also defines the version numbering.

    Only one policy version in each policy can be Current at any one time. There is no limit to the number of Draft or Archived policy versions.

    Table 1. Policy version states
    State Description
    Draft When a version is created, its initial state is Draft. The new Draft version can be saved as a Draft for later use, or published to become the Current version. The draft versions cannot be used until they are published.
    Current Draft versions can be published to Current, which means the former draft version becomes the default published version used for policy execution.
    Note:
    When publishing the version, if mapping exists, verification is performed to confirm that all required inputs for mapping inputs were provided. If you update the mapping inputs, you must update the inputs in the Mapping screen. If you updated caller inputs, you must update the PaCE API call to ensure that the policy is executed.
    Archived A published Current version becomes Archived when a different version is published. Only Current versions can be Archived. If necessary, you can also republish an Archived version.
    Note:
    When a version is published, it becomes the Current version irrespective of its previous states.
    Ready The Ready state is assigned to optional policies available when an application content pack is installed. These policies cannot be modified. If you want to modify a policy, create a copy and make the required changes.

    Policy version numbering

    There are three identifiers for each version: Version name, Version, and Revision number. These identifiers are shown as three separate columns in the Versions tab.
    Identifier Description
    Version name

    For Draft versions, the version name uses Draft-V{Revision number}.

    For Current (published) or Archived versions, V{Version} is used for the name.
    Version The Version number is assigned only when you publish a version. The number is automatically created according to the existing version number. For the first Current (published) version, the number is 1.0 and for subsequent current versions, the number increases by +1.0. For example, 2.0, 3.0, 4.0, and so on.

    Current versions that have been Archived retain the original version number.

    Draft versions are not assigned a version number.
    Revision number The Revision number is derived from the version that it was created from. If an empty new policy is created, the initial draft version is assigned 0.1. Each subsequent draft version is assigned 0.2, 0.3, 0.4, and so on.

    If the version was created from a published (Current or Archived) version, it inherits the Version number. For example, you can create a draft version from the Current (published) version 2.0. The draft version is assigned the revision number 2.1.

    The following image illustrates the different states and their version numbering.

    Policy version numbering.

    As shown in the preceding image, the first draft policy version created was automatically assigned the Revision number 0.1. Each subsequent draft is assigned V0.2, V0.3, and so on. Draft version 0.2 (as indicated in the Revision number column) was published and became the Current version, with the Version name of V1.0.

    A draft version of this Current version was created, with the Revision number 1.1. That draft was published to become the Current version and was assigned the Revision number 1.1. The previously Current version is now Archived, but retains the Revision number 0.2.