Development Management Practices
Development Management Practices
management practices
Key insights
• With strong ServiceNow development management practices, you also have effectively
defined development standards, guidelines for customization and configuration, a
development process flow, and a release management process.
• Start by defining a minimum viable set of policies as part of a starter management approach
rather than trying to deliver a full, mature approach all at once.
ServiceNow development management sets the processes and foundational standards that will
support your teams as they develop and configure high-quality applications on the platform
while they also minimize technical debt. It also gives your development teams the common
frameworks, processes, and tools to use when they develop on and maintain your Now Platform.
Your technical governance board should develop and/or approve your development
management policies and procedures because these are key outcomes of solid ServiceNow
technical governance.
1
© 2021 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks a re trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
2. What concepts and practices do I need to consider when defining
ServiceNow development management?
Development standards
Development standards set basic expectations that developers must uphold when they work on
the Now Platform at your organization. By creating and enforcing these standards, you’ll have
consistent development practices, which ultimately makes the platform easier to manage and
leads to greater overall platform health.
Naming standards
Naming standards set conventions for how to name development objects so all developers can
quickly identify objects and their purpose.
Create meaningful naming conventions that are easy to adhere to. This table shows the
common objects that you need to define naming standards for.
2
© 2021 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks a re trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
Object Considerations
Example: xyz.incident.max_reassignment_count
Example: u_target_date
Development documentation
Many organizations overlook—or decide to avoid—creating development documentation.
Don’t let this happen at your organization! Make sure your teams create clear, consistent
documentation and set the expectation that it’s required. Also define what acceptable
development documentation means for your organization.
To determine what development documentation you’ll need, consider the questions in this
table.
3
© 2021 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks a re trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
Area What needs to be defined
Design • What level of detail is required for solution design documentation (integrations,
documentation table architecture, features, and capabilities)?
• Does your architecture review board need to review these design solutions to
make sure there’s no duplication of effort or reusability across the platform?
Coding Coding documentation are the notes and comments you put directly into the code.
documentation Consider:
• When are code comments required?
Build Build documentation details all code objects developed as part of delivering on a
documentation request or story. Consider:
• What level of detail is required for build documentation?
– Objects created
– Intent of the object
– Developer name
• Who should review build documentation for accuracy?
Equally important to creating this development documentation is ensuring that it’s accessible
and available when needed. Consider defining a documentation repository and enforcing it
with your organization's technical governance policies.
4
© 2021 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks a re trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
Practitioner insight: ServiceNow Knowledge Management makes an excellent
repository for development documentation. It’s readily available within the
platform, and the development teams will already have access to the
application within your instance. If possible, avoid using documents that users
can easily download. Consider these development documents as living
documents and train your teams to come back to them over time to see the
most up-to-date guidance. Managing this information in Knowledge
Management can help with this.
5
© 2021 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks a re trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
Practitioner insight: Avoid confusion by following strict definitions for
customization and configuration. Here’s how ServiceNow defines these terms:
The first thing you should consider when you define your organization’s customization and
configuration guidelines is how you’ll decide when it’s appropriate to customize in the first place.
A ServiceNow demand board should be responsible for making these decisions, but they’ll rely
on the technical policies and guidance you craft to make informed decisions on when to invest
in customizations.
As an example, we recommend developing a template like the one shown here that your
demand board can use to assess the complexity and risk of customizations. This allows them to
effectively compare the risk against the potential value of customization requests.
6
© 2021 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks a re trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
WHAT MINIMUM LEVEL
OF BUSINESS VALUE
SCENARIO COMPLEXITY SCORE SHOULD
CUSTOMIZATION
DELIVER?
Modification to form LOW – This will typically not delay upgrades or new functionality, Low
layout or design although poorly planned layouts may disrupt the user experience.
Add fields and/or UI LOW – This will typically not delay upgrades or new functionality, Low-Medium
policies to forms but over configuration of forms (e.g., adding 50+ fields) risks both the
service experience and usage.
Build a simple custom LOW – Integrations that can use IntegrationHub (see below) will not Low
integration typically delay upgrades or new functionality.
Extend an existing table LOW – This will typically not delay upgrades or new functionality, but Low-Medium
(e.g., cmdb_ci) with new additional fields should be strictly tied to validated business
fields only requirements.
Extend an existing table LOW-MEDIUM – This will typically not delay upgrades or new Medium
(e.g., task) with some functionality, but additional fields should be strictly tied to validated
scripting business requirements. Complexity is dependent on the extent of the
scripting.
Extend an existing table LOW-MEDIUM – This will typically not delay upgrades or new Medium
(e.g., task) as the basis functionality, but additional fields should be strictly tied to validated
for a different business requirements. For new applications, this should be preceded
application by clear process mapping and acceptance testing among
knowledgeable users.
Change the state LOW-MEDIUM – This may affect time to upgrade or new functionality if Medium
choice list (e.g., modify the modification changes underlying business logic, rules, and/or
the incident process) policies.
Build a new scoped MEDIUM – This will typically not delay upgrades or new functionality, Medium
application but scoped applications should be strictly tied to validated business
requirements. The complexity is dependent on the extent of the
scripting.
Build a new global MEDIUM-HIGH – This may affect time to upgrade due to testing or new Critical
application functionality if the application changes underlie business logic, rules,
and/or policies.
Change baseline HIGH – This may affect time to upgrade due to testing or new Critical/Mandatory
business rules (e.g., functionality.
modify the SLA process)
Build complex custom HIGH (DEPENDENT ON COMPLEXITY OF INTEGRATION) – This may affect Critical/Mandatory
integration time to upgrade due to testing or new functionality.
Use the incident table as High – This may prevent use of baseline products in the future. Use of Critical/Mandatory
is for a different use the incident table outside its intended use case (e.g., ITSM) should be
preceded by clear process mapping and acceptance testing
among knowledgeable users.
7
© 2021 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks a re trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
This template may work for your organization but you’ll probably need to tailor it to best suit the
context and preferences of your organization. Consider these questions when you either modify
this template for your own use or when you build your own:
• How comfortable is our organization with risk? This will inform how you label the complexity
and risk of specific demands that the demand board may receive.
• Who would be responsible for implementing approved customizations? Does this change
how we want to evaluate the complexity and risk of demands?
• Are there any customization requests that we never want to fulfill? Are there any that should
always be accepted?
Once you’ve structured how to decide on when customizations and configurations are
appropriate, consider how your organization will manage them once they’re complete.
Consider these questions as you define policies for how to manage the customizations and
configurations that your organization decides to invest in:
• How will you track customizations and configurations made in your platform?
• How will you manage these customizations and configurations so they continue adding
value? How will you compare them against new functionality delivered in ServiceNow
releases?
8
© 2021 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks a re trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
following your development process flow leads to high-quality development that meets
requestors’ expectations.
Begin by defining phases for development-related activities and include testing phases
necessary to validate the work. The next table represents phases that are typical within a
development process flow. Most of the phases listed represent different types of testing that’s
performed during the development process. Though not all phases are required for every
organization, it’s important that you find the right mix of testing to create a quality product that
meets your organization’s existing standards.
Phase Description
Build In the build phase, the teams complete the development or configuration work to
match the acceptance criteria defined.
Unit testing The developer performs unit testing as an initial check to determine if the development
matches the story’s acceptance criteria.
Peer testing A second developer performs peer functional testing on the defined unit tests and
evaluates the results to determine if the development meets the story’s acceptance
criteria. Complete peer testing as a quality check before you pass the functionality to
the business for systems integration testing (SIT) and user acceptance testing (UAT).
Systems You’ll complete SIT when you need to test a complete system or an application along
integration with other systems or applications. Perform the level of SIT and specific tests that were
testing (SIT) defined within the intake/demand process. The SIT level and tests are also an input into
the development process.
User Ask the business members who requested the functionality to perform UAT. You can also
acceptance include testing the end-to-end process of the new functionality within the application
that it supports. Once the functionality passes UAT, you have the final signoff that the
testing (UAT)
functionality developed meets the acceptance criteria defined in the story.
Once you’ve defined each phase that’s necessary for your development process flow, align
each of the phases with the instance that phase should occur in. To do this, you’ll need to know
what your instance structure is, including how many instances there are in your stack and what
those instances are used for. See our ServiceNow environment management document if you
haven’t already defined your instance structure.
9
© 2021 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks a re trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
Update Set(s)
Quality User Up
da
)
t(s Assurance Acceptance t eS
e Se et
d at (s)
Up
Within this example four-instance stack structure, you might align your development phases to
the instances where they should occur according to this table.
Build Development
Note that multiple phases can occur within the same instance.
Once you’ve assigned each phase to the instance where teams will perform the work, define
the phase requirements. These requirements establish what your teams must complete as part of
each phase and defines the conditions they must satisfy before the next phase can begin.
10
© 2021 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks a re trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
Phase Phase requirements
Pre-
• Acceptance criteria is defined for each story.
development
• Application architecture is defined.
• All applicable guiding principles and issues are raised to the architecture review
board or appropriate technical governance when necessary.
Unit testing
• The developer has conducted all unit tests and all of them passed.
• The developer has determined that the functionality created meets the
acceptance criteria defined with the story
Peer testing
• A second developer conducts all unit tests and all of them passed.
• A second developer has determined that the functionality created meets the
acceptance criteria defined with the story.
Systems
• Testers execute all defined SIT test cases and document the results.
integration
testing • All defined SIT test cases pass successfully.
User
• The business users/requesters execute all defined test cases and document the
acceptance
results.
testing
• All defined UAT test cases pass successfully.
11
© 2021 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks a re trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
Practitioner insight: Create a robust testing strategy using tools from
ServiceNow. Automated Testing Framework (ATF) can improve your testing
efficiency because it automates functional testing of ServiceNow applications
so they’ll work as expected when you introduce changes. ATF has over 500
quick start tests to accelerate adoption. To make sure you complete testing
thoroughly and accurately, use these ATF features to cover as much testing as
possible, then use Test Management on the Now Platform to track and
manage the test plans and test cases associated with each of your testing
phases.
Start by defining how your high-level release management model will work. Here’s an example
release model for a release with a two-week cadence that aligns with two-week sprints:
12
© 2021 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks a re trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
Note: Most ServiceNow deployment uses a hybrid project management model with a large
initial release followed by agile methodology. In this case, the diagram above would represent
the release cycle after the initial release.
While developing your release management process, consider defining these areas.
13
© 2021 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks a re trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
Area What needs to be defined
Release model • What steps do we need in our release model to align with how development works at our
organization?
• What review and approval meetings will we need to organize ahead of planned
releases? The example above includes three meetings: a development review meeting, a
test review meeting, and a final approval meeting.
• How will we plan to avoid blackout windows?
• Can we manage multiple release streams? If so, how will we coordinate them?
• Will our normal platform release cycle vary from scoped application releases? Will that
have a different CI/CD release process from the application repository?
Release frequency • How frequently will we schedule releases? How do we sync release schedules with
development sprints?
• How will we bundle releases? ServiceNow recommends that:
- All projects or bundled changes that affect the ServiceNow instance (releases
containing multiple enhancements and/or fixes) go through the release
management process
- All projects and bundled changes have a completed change record with the
appropriate approvals obtained for implementation
- Whenever possible, bundle changes to an existing service, application, or
functionality together and release them on a regular basis using the release
management process.
• Will high-priority changes be released outside of standard our release frequency?
Release ownership • How will we assign ownership for releases? We recommend identifying a single owner for
every release who will be responsible for the successful coordination and execution of the
release, as well as making sure all required documentation related to the release exists.
Release testing • How will we test and verify releases before implementation?
• Will there be testing timelines to meet before each scheduled release?
• Will we use automated testing, like the Automated Test Framework?
Release • How will we document and distribute release notes? The best practice is to distribute
documentation release notes two or three business days before the actual release. This will give people
enough time to get familiar with coming changes.
• What do we need to document for each release? We recommend that you document
all release deliverables and make sure you transfer the knowledge.
Implementation • What process should we follow to make sure that all implementation work on a release is
and validation completed by the planned end dates and times?
• How will we validate that releases have been completed successfully? What post-release
testing is required?
Release scheduling Release to production should happen outside of the peak hours to minimize impact to the
users. To find the best day of the week to release to production, consider these questions:
• How often will a release contain changes that impact many users? How will we prepare
for the change and train them?
• If there’s an issue in production, when will users be able to detect it? Do users work over
weekends or are they more likely to discover as issue the next business day?
• Are the developers available for hotfixes during weekend?
Rollback strategy • What will we do if an update set shows collisions during the preview?
• How will we respond to incidents that result from a recent release?
• When will we fix forward by deploying a new hotfix update set rather than backing out of
an update set?
14
© 2021 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks a re trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
Practitioner insight: A common release management approach is to publish a
new release during the weekend because to avoid regular business hours.
Considering the release scheduling questions above, releases over the
weekend may bring some challenges:
Consider involving these roles when you define your ServiceNow development management if
they’re not already participants on your technical governance board.
15
© 2021 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks a re trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
Role Description
Enterprise The EA creates a single language between people, processes, and technology
architect (EA) that allows your teams to seamlessly share and enrich data across business
functions. You can also consult the EA when you define your development
management policies, but if you don’t, make sure you at least inform them of this
work.
Platform owner The platform owner is typically accountable for managing the creation of all
development management policies.
Platform architect The platform architect is typically responsible for the creation of development
management policies while consulting members of the organization, including EAs,
security administrators, and development leads/SMEs, ServiceNow architects, and
process owners.
Development Consult your development leads/SMEs when you define the development
leads/SMEs management policies because the output of these activities will affect the
development flow and process.
IT operations Consult your operations leads when you define development management
lead(s) policies to identify which management activities are feasible and how they’ll be
done on a recurring basis.
If your organization doesn’t have a ServiceNow technical governance board, see our resource
on getting started with ServiceNow governance.
That’s a lot to get right from the start. We recommend starting with a minimum viable policy that
defines the most important standards and controls for your specific needs first—instead of trying
to define everything all at once.
16
© 2021 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks a re trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
Take these steps to get started:
2. Work with your platform owner to select one to three of the policy components listed in
section 2 (for example, “development standards”) that you think are the most urgent and
important to enact at your organization. In our experience, at least development standards
and development process flow practices are most important to include in a minimum viable
policy.
3. Consult with your technical governance board to approve of the components you selected.
If necessary, invite SMEs to help your technical governance board consider what’s needed
in your initial ServiceNow development management process.
5. Make all stakeholders aware of the new polices, train them on them, and set the
expectation that they must adhere to them.
6. Expand on your minimum viable approach to include standards for the remaining
components in section 3.
While this Success Insight covers what to consider when you define ServiceNow development
management, you’ll need to define the specific policies and standards required at your
organization. Account for any special needs required by:
17
© 2021 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks a re trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
When possible, we recommend working with your partner or with ServiceNow platform
architects to define specific ServiceNow development management practices and policies that
will work for your organization. Reach out to your account manager to connect with ServiceNow
architects to help with this.
Additional resources
• ServiceNow governance resources on the Customer Success Center
If you have any questions on this topic or you would like to be a contributor to future ServiceNow
best practice content, please contact us at [email protected].
18
© 2021 ServiceNow, Inc. All rights reserved. ServiceNow, the ServiceNow logo, Now, Now Platform, and other ServiceNow marks a re trademarks and/or registered
trademarks of ServiceNow, Inc. in the United States and/or other countries. Other company and product names may be trademarks of the respective
companies with which they are associated.
Customer Success Best Practices
ServiceNow’s Best Practice Center of Excellence provides
prescriptive, actionable advice to help you maximize the
value of your ServiceNow investment.
Critical Executive
processes sponsors
Expert
Management insights Technical
Platform owners
and teams
Common
pitfalls and
challenges
Service and
process owners
Tactical