Professional Documents
Culture Documents
Architecture Instances Integrations Data Flow Plan
Architecture Instances Integrations Data Flow Plan
For the purpose of this document, “architecture” includes your Now Platform instance configuration and management, data architecture and configuration management, and integration
strategy, design, and management.
Understand the Now Platform infrastructure Understand the Now Platform’s core features and functionality
Learn about Now Platform’s cloud infrastructure. Ensure your teams: Ensure your teams develop an understanding of the following features and functionality of the Now
Review the overview of the ServiceNow ® Platform:
Advanced High Availability (AHA) architecture. Capabilities – For example, Service Portal, Configuration Management Database (CMDB), Compliance,
Build a deep understanding of the ServiceNow infrastructure, including etc.
its capabilities to scale horizontally, load balance, and failover when Products – For example, IT Service Management, IT Operations Management, Security Operations,
necessary. Customer Service Management, HR Service Delivery, etc.
Certified applications – Explore the ServiceNow Store.
Learn how data is stored and managed in your ServiceNow instance.
ServiceNow Store integration hub apps – For example, preconfigured integrations with Box and Splunk,
Refer to product documentation (of your instance release version) for and Okta.
an overview of how applications use tables and records to manage data
and processes on the Now Platform. Ensure your teams are familiar with the Now Platform user interface including:
Forms – Display information from one record in a data table.
Lists – Display a set of records from a table.
Available options to configure lists and forms.
Practitioner insight: The best way your team can build up its expertise on the Ensure your teams know how business processes are triggered and completed on the Now Platform,
Now Platform’s core features and functionality is to start by taking the including:
ServiceNow Foundations eLearning course and then review Business rules – Server-side scripts that runs when a record is displayed, inserted, updated, or deleted, or
ServiceNow Training and Certification courses for training and certification when a table is queried
opportunities. Flow Designer – A Now Platform feature for automating processes, including integrations, in a single
design environment without coding
1. Develop a clear understanding 2. Define your instance and data 3. Define your integration 4. Manage your ServiceNow 5. Plan for expansion and
Steps
of architectural needs architecture architecture architecture development on the Now Platform
Identify the enterprise IT teams you’ll need to partner with to support the Now Provide an overview of Now Platform architecture and functionality to your
Platform enterprise IT partners, to find questions and requirements that may affect your
Enterprise architecture (EA) – EA performs the analysis of business structure architectural decisions
and processes. EA may have been involved in evaluating the Now Platform and You may conduct this as a planning workshop—be sure to include your
will help determine how it fits into your business and systems architecture. implementation partners. (Note: This may already be planned or conducted as part of
Data architecture and technical integration – These teams define how different your onboarding process with ServiceNow.)
data entities and IT systems will store, consume, integrate, and manage data. In addition to finding potential questions and requirements, you can use this workshop
They'll be an important resource as you integrate the Now Platform with other to identify points-of-contact within the teams listed previously, who can collectively
enterprise systems. act as your “extended” ServiceNow team. This should provide the basis for a RACI
Security – Security is responsible for defining security requirements and protocols chart that defines “ownership” for key decisions and responsibilities between the core
ServiceNow team and enterprise IT functions.
for your environment.
Network administration – This resource will help enable Now Platform access to
users (e.g., opening a network port for access, single sign-on, etc.) and help to
ensure appropriate network support. Practitioner insight: Technical planning needs to be coordinated with the development of
governance (e.g., for the establishment of documented technical standards). Work with the
IT support – This resource supports the platform on a daily basis. IT support also ServiceNow governance lead and/or executive sponsor to coordinate governance policy
coordinates and supports patches, upgrades, defects, and enhancements. development with your ServiceNow architecture design process.
Practitioner insight: Your extended ServiceNow team may also include non-technical teams within your organization such as vendor management, legal, and procurement to assist with business-
related processes (e.g., purchasing instances, terms and conditions related to software licensing, etc.) involving the Now Platform.
1. Develop a clear understanding 2. Define your instance and data 3. Define your integration 4. Manage your ServiceNow 5. Plan for expansion and
Steps
of architectural needs architecture architecture architecture development on the Now Platform
Assess the potential impact your business objectives/strategy will have on Now Platform architecture requirements
Document business objectives and strategy considerations (both for ServiceNow and outside the scope of your ServiceNow implementation) that may impact your architecture
for the coming year (Note: You can do this as part of the planning workshop recommended in 1b). Ensure you review this with your executive sponsor to validate your
assumptions.
For each objective/consideration, define potential implications or decisions that you may need to raise with enterprise architecture and other stakeholders. For example, a
corporate merger and acquisition strategy should prompt you to ask stakeholders whether your architecture will need to accommodate rapid integration of new user populations,
or whether the intent is to onboard new populations gradually.
Validate these implications and decisions with your enterprise architecture team and strategic governance function for ServiceNow. Make sure that you make decisions on a
defined timeline so you’re able to advance the development of the requirements in your architecture planning.
Practitioner insight: Choosing an architecture is an important decision that sets the foundation for your implementation’s success. Refer to the Success Insight
A comparison of four complex ServiceNow architectural models for guidance.
1. Develop a clear understanding 2. Define your instance and data 3. Define your integration 4. Manage your ServiceNow 5. Plan for expansion and
Steps
of architectural needs architecture architecture architecture development on the Now Platform
Work with your enterprise IT team (see step 1) to address the following questions:
Will data sovereignty considerations influence your use of ServiceNow’s cloud infrastructure?
What additional data security constraints will influence your use of ServiceNow’s cloud infrastructure?
What regulatory guidelines do you have to follow that affect data storage and access?
Do you need to provide one virtual view that shows tasks that reside in multiple instances?
Identify specific requirements and constraints for cloud hosting with your ServiceNow implementation partner, based on the questions above
Identify whether you will require any on-premises server infrastructure to run your ServiceNow instance(s). Note: We highly recommend using cloud infrastructure as your
preferred option, as maintaining on-premises infrastructure can be costly and does NOT include advanced features that ServiceNow has implemented to manage cloud
infrastructure.
Practitioner insight: You can choose to have a multi-instance strategy for your dev and test environment as well. Work with your technology development teams to understand their
development and testing processes to design a sub-production instance architecture.
*Refer to our Plan your platform architecture page on the Customer Success Center for more resources .
1. Develop a clear understanding of 2. Define your instance and data 3. Define your integration 4. Manage your ServiceNow 5. Plan for expansion and
Steps
architectural needs architecture architecture architecture development on the Now Platform
Your architecture and instance strategy will be strongly influenced by requirements for process and data separation. Identify requirements to separate data, administrative tasks,
processes, or reporting across different entities, customers, or sub-organizations within your organization. Work with your executive sponsor, enterprise IT, legal/compliance
functions, and key business stakeholders to answer the following questions:
Do you need to enforce data separation between different entities within your organization due to regulation, data protection policies, or other business requirements?
Do you need to preserve business process and user interface differentiation across business entities/
Do you need to define policies to govern instance configuration and management (e.g., policies that govern how upgrades are done, how to right-size environments, replicate instances
correctly, develop a security access control model, and ensure proper maintenance)? If so, do the same policies apply to all instances? Or are separate policies needed for separate
instances?
Do you anticipate variation in speed of process change/evolution across different functions or entities in your organization?
Do you need a single virtual view that consolidates tasks from multiples instances in one view?
Based on the answers to the above questions, work with your ServiceNow implementation partner to determine whether requirements should drive:
Domain separation – This allows you to separate data, processes, and administrative tasks into logical groupings called domains. You can then control several aspects of this separation,
including which users can see and access data.
A multi- vs. single-instance architecture – A separate instance provides complete and total separation of all system properties. Consider separate instances only if you don’t require global
reporting or global processes along with total separation of all system properties.
Application scoping – Application scopes keep data separate, allowing for additional access controls and security. In addition, it offers delegated development.
Access control list rules (ACL), business rules, or configurations – These let you vary your processes and preferences without separating data from the overall governance or
administrative tasks. Examples are custom views and form layout.
Global queue – Using this queue helps you create a single virtual view of the tasks in multiple instances. This is also known as a mesh architecture.
1. Develop a clear understanding of 2. Define your instance and data 3. Define your integration 4. Manage your ServiceNow 5. Plan for expansion and
Steps
architectural needs architecture architecture architecture development on the Now Platform
*Refer to the Instance Hardening Guide for more information and guidance on making your
instance more secure and resistant to malicious intrusion.
1. Develop a clear understanding of 2. Define your instance and data 3. Define your integration 4. Manage your ServiceNow 5. Plan for expansion and
Steps
architectural needs architecture architecture architecture development on the Now Platform
Identify a list of CMDB use cases that directly impact your organization’s key strategic initiatives. These use cases will help you make the case for effective configuration
management and get required funding and support for implementation. Below are examples of questions you could use to identify CMDB use cases:
What level of understanding do we need of our infrastructure configuration to assess the impact of an incident on business services*?
What level of understanding do we need of our infrastructure configuration to assess the potential risk of a component-level change?
What level of detail of cloud services is needed to monitor the performance of our business services?
What level of understanding do we need of our infrastructure assets for better financial tracking and management?
Define clear configuration management goals, objectives, and outcomes. Document: Practitioner insight: Build your
What you want to accomplish with configuration management, per the use cases outlined above. configuration management team and
data model early, to set the foundation
How you will approach your implementation, as well as your assumptions and constraints. for configuration to support other
What business outcomes this will support. applications long term. See
How will you know if you’re doing it right, i.e., the measures of success you’re going to use. ServiceNow’s Success Playbook for
more information on
planning a successful CMDB deploymen
t
*Consider using CSDM (ServiceNow’s Common Services Data Model) to map your IT services. Following this model ensures that the .
data for your application maps correctly to the appropriate tables
1. Develop a clear understanding of 2. Define your instance and data 3. Define your integration 4. Manage your ServiceNow 5. Plan for expansion and
Steps
architectural needs architecture architecture architecture development on the Now Platform
Practitioner insight: Just like any other new IT implementation, a successful configuration management
implementation requires cultural change. Consider creating a comprehensive communication plan for your CMDB
implementation, highlighting CMDB needs and value, in term of “what’s in it for me,” progress against key
milestones, and success stories. Coordinate this communication with any ongoing and/or
planned organizational change management efforts.
1. Develop a clear understanding of 2. Define your instance and data 3. Define your integration 4. Manage your ServiceNow 5. Plan for expansion and
Steps
architectural needs architecture architecture architecture development on the Now Platform
Create a configuration management plan that accounts for the following activities to ensure proper controls are established.
Define the process and procedures for creating new, modifying and retiring CIs. They should be retired rather than deleted to preserve any relationships that the CI has to other records in
the CMDB.
Establish integration with the change management process.
Define the process and procedures for Discovery reconciliation if used.
Define the process and procedures for CMDB verification and audit.
Identify the configuration management and CMDB key performance indicators (KPIs), and establish measurement procedures and a reporting schedule.
Use the CMDB health dashboard to monitor and maintain your CMDB health.
Create a roadmap for continual CMDB expansion and configuration management process improvement.
Practitioner insight: Your ability to deliver on many critical capabilities, such as incident management or change management, depends on having a robust single system of record. Instead of
delaying your CMDB implementation, aim for a minimum viable product that includes the “right” amount of configuration management. Avoid a big bang approach to configuration
management. Most organizations that try that approach get bogged down and may not ever manage to implement a CMDB.
1. Develop a clear understanding of 2. Define your instance and data 3. Define your integration 4. Manage your ServiceNow 5. Plan for expansion and
Steps
architectural needs architecture architecture architecture development on the Now Platform
Consult with your enterprise architecture and security teams to define integration requirements
Document current integrations, integration tools, and organization standards.
Coordinate integration and architecture requirements—tables, fields, and data relationships.
1. Develop a clear understanding of 2. Define your instance and data 3. Define your integration 4. Manage your ServiceNow 5. Plan for expansion and
Steps
architectural needs architecture architecture architecture development on the Now Platform
Identify foundational data from external systems that needs to be in place, both Capture remote system capabilities to understand integration design constraints
initially and ongoing. What is the target system?
Determine what data needs to be transferred to and from ServiceNow, and whether What data is available? In what format? Can fields be mapped easily?
translation is required at either end. Can you show a sample?
Identify the system of truth for each data element. What is the data quality like?
What protocols are available?
Identify the process events that will trigger an exchange of data between systems
Who is the owner? And who makes the decisions?
This could be events—such as creating an incident or assigning it to a particular
group—when certain fields such as Priority are changed, when a work note is
added, etc.
1. Develop a clear understanding of 2. Define your instance and data 3. Define your integration 4. Manage your ServiceNow 5. Plan for expansion and
Steps
architectural needs architecture architecture architecture development on the Now Platform
Select the best ServiceNow integration from the options below, listed in order from the most supportable to those that provide the most flexibility/choice
ServiceNow Store integrations – These integrations are built by ServiceNow or a partner that’s an expert in the external system. The seller of the integration will generally provide
implementation and ongoing support. There may be cost associated with the integration.
IntegrationHub – IntegrationHub lets you integrate third-party APIs as part of a flow when a specific event happens in ServiceNow. These integrations, referred to as spokes, are
easy to configure with Flow Designer and help you quickly add powerful actions without writing a script. There may be a cost associated with the spokes and/or licensing of Flow
Designer in order to enable IntegrationHub.
Note: Not all integrations on the ServiceNow Store will be spokes compatible with IntegrationHub. Use the IntegrationHub filter when in the ServiceNow Store to filter
integrations specifically designed for use with IntegrationHub.
Custom – Custom integrations (REST, SOAP, IoT devices, file import and export abilities via CSV or XML, Flow Designer with IntegrationHub) meet a specific customer use
case, are designed from scratch, and are owned and maintained by the customer long term.
Message structures, response formats, and exception actions (e.g., validation fails, message timeouts)
Rules around ownership of records and what updates can be made by the non-owning party (Note: Allowing both sides of an integration to update any field at any point can cause
issues, so we normally advise that non-owners should only add journal fields, such as comments and work notes.)
1. Develop a clear understanding of 2. Define your instance and data 3. Define your integration 4. Manage your ServiceNow 5. Plan for expansion and
Steps
architectural needs architecture architecture architecture development on the Now Platform
Execute large integration loads after hours or during a non-peak time of day to
minimize performance impact to your systems.
Practitioner insight: Customers engaged in enterprise services transformation will see more
Use out-of-the-box features and functions as the baseline, especially the demands for cross-platform integration, but this doesn’t necessarily have to lead to complex,
ServiceNow API. customized integration. ServiceNow’s IntegrationHub reduces the need for complex,
custom-coded integrations because you can execute third-party REST APIs as part of a
Use IntegrationHub (requires a separate subscription) for designing custom workflow when a specific event occurs in ServiceNow. IntegrationHub supports three use
integrations. IntegrationHub extends the ServiceNow Flow Designer to incorporate cases, reducing the need for custom code:
integrations into automated processes. • Third-party REST API integrations – Customers can post messages and ServiceNow
incident, problem, and change record details to collaboration channels like HipChat,
Work with a certified partner when you build custom integrations unless you have Slack, or Microsoft Teams.
strong, ServiceNow-specific integration expertise within your organization. The right • Integrations between ServiceNow instances – IntegrationHub provides an easy-to-
expertise can dramatically simplify work and even reduce total investment (by configure spoke allowing data synchronization across multiple ServiceNow instances.
reducing the need for rework). • Creating REST actions – IntegrationHub supports developing custom REST web service
actions to support API development for web-based applications.
Consider our internal, customer, and partner learnings when you design your
integration.
1. Develop a clear understanding of 2. Define your instance and data 3. Define your integration 4. Manage your ServiceNow 5. Plan for expansion and
Steps
architectural needs architecture architecture architecture development on the Now Platform
Use CMDB Identification and Reconciliation-enabled integration methods when creating CIs in the CMDB
Create the integration in a scoped application. Identification engine APIs are accessible in scoped apps. Activate the Configuration Management for Scoped Apps (CMDB)
plugin.
When inserting CIs with JavaScript code, use the internal ServiceNow function IdentificationEngineScriptableApi.createOrUpdateCI. This will confirm that any inserts or
updates use the Identification and Reconciliation Engine.
1. Develop a clear understanding of 2. Define your instance and data 3. Define your integration 4. Manage your ServiceNow 5. Plan for expansion and
Steps
architectural needs architecture architecture architecture development on the Now Platform
As you implement (and upgrade) your Now Platform, ensure that configurations and data are migrated and promoted through your ServiceNow environments via our recommended
steps. During the development phase, keep a runbook to document the steps that need to be taken when migrating the data and promoting update sets. A runbook is a set of defined
procedures developed by the administrator for various tasks such as migration plans, daily procedures, and handling exceptional incidents or tasks.
1. Develop a clear understanding of 2. Define your instance and data 3. Define your integration 4. Manage your ServiceNow 5. Plan for expansion and
Steps
architectural needs architecture architecture architecture development on the Now Platform
Set a cadence for reviewing system logs. Reviewing system logs on a frequent basis is a proactive way to catch any performance issues.
Set a cadence to test your instance. A system administrator should go through core system functionality to verify system usability and performance. Navigating through forms and
lists to check page load times, form rendering, field data entry, etc. will let you know if there are any potential issues with system configuration, internal network, or browser
performance. Consider engaging ServiceNow for a HealthScan to better understand the health of your instance.
Ensure timely review of release notes. ServiceNow may release patches to address issues. It’s critical to review release notes for these regularly, as well as for planned upgrades.
Ensure timely review of ServiceNow-scheduled maintenance notifications. There are periodic maintenance activities that ServiceNow executes on its systems (databases,
application infrastructure). Notifications are sent with all the details you need, including support details. It is important to review notifications and understand the support process
if any issues arise.
1. Develop a clear understanding of 2. Define your instance and data 3. Define your integration 4. Manage your ServiceNow 5. Plan for expansion and
Steps
architectural needs architecture architecture architecture development on the Now Platform
Gather relevant information about upcoming ServiceNow releases Gather relevant information about your ServiceNow environment
Build awareness about new features and develop an understanding of how to Confirm your instance hosting model, the instances in scope for upgrade, and the
incorporate these features into your environment. upgrade features you plan to enable or disable.
Review updated product documentation which includes the new release notes by Identify a core team of testers, power users, and key stakeholders to validate
version. functionality before and after you upgrade.
Attend the new release broadcast (ask your account manager for details). Create a comprehensive test plan, including test cases for all core instance
functionality and integrations, your testing scope and approach, your method for
Attend ServiceNow Knowledge or Now at Work user conferences which provide tracking defects, and the availability and restrictions of the systems required for
release learning opportunities and insights into the product roadmap. integration testing.
Join the ServiceNow Developer Program which provides resources to learn, build, Develop a high-level implementation plan covering sequence and timing to
and deploy applications on the Now Platform and offers resources (e.g., technical upgrade production and non-production instances (including any change freeze
library, online training, developer community, etc.) to ensure a successful windows which may affect timing), instances to be cloned, and the instance to be
application-building experience. used for integration testing.
Become a Now Creator and explore Now Learning to continue your education. Define and document a process to review and update supporting documentation,
including training material and knowledge base articles.
1. Develop a clear understanding of 2. Define your instance and data 3. Define your integration 4. Manage your ServiceNow 5. Plan for expansion and
Steps
architectural needs architecture architecture architecture development on the Now Platform
After a release cycle is complete, consider cloning your instances using your production environment. This ensures that the instances remain in sync from a data and functionality
perspective. We also strongly recommend that you never clone a production instance from a sub-production instance. If a circumstance arises where this is a consideration, contact
ServiceNow support for assistance.
Determining when you clone and how often can be challenging simply because there may be overlapping activities occurring in your other instances. Typically, clones occur
after releases, however, if you are in a pre-go-live scenario you may not need to clone this often.
Setup target – Configure the target instance to accept clones. You will need to use an administrator account for the process.
Data – Determine what data, if any, needs to be preserved on the target instance. For more details, visit this page on data preservers.
Instance activities – Ensure that any activities occurring in that instance are completed, data is backed up or exported, and update sets are complete if any development is
ongoing. Consider creating a shared folder that users can save their exported items to.
Integrations – Ensure that any integrations on the target instance are turned off or paused during the clone.
Notifications – Notify all users of the instance and any stakeholders that a clone is taking place. After the clone has completed, send out another notification advising that users
are able to continue their work in the instance.
1. Develop a clear understanding of 2. Define your instance and data 3. Define your integration 4. Manage your ServiceNow 5. Plan for expansion and
Steps
architectural needs architecture architecture architecture development on the Now Platform
Define the process and requirements for developing on the Now Platform in accordance with your defined architecture and technical requirements
Define a detailed plan describing the process developers should take to develop, maintain, and enhance capabilities on ServiceNow.
Define an end-to-end software development lifecycle (SDLC) specific to ServiceNow (or adapt an SDLC currently in place in your organization to work for ServiceNow).
Define how demand for new ServiceNow applications and functionality will be managed.
Define requirements that specifically address what needs to happen during updates and release management involving the Now Platform.
Define how to use application scoping, including when and where to use private scoped apps (referred to as scoped apps, where access to the apps’ data and code is restricted) vs. global
scoped apps (with shared resources that any developer can access and modify).
o Establish private scoped apps as the default for new applications whenever possible. This makes it easier to manage a larger number of apps on the platform without hindering
upgrades.
Define the requirements for the development teams working on ServiceNow, including:
o Requirements for developers to make sure that set architecture, instance, integration, and data flow requirements are upheld
o Requirements to make sure that new development does not negatively impact the ability to upgrade
Define requirements for testing processes, user acceptance testing (UAT), and managing ongoing changes for ServiceNow.
Work with your executive sponsor to ensure that appropriate staff and resources are available to oversee development operations adherence.
Practitioner insight: Coordinate with your ServiceNow governance group and/or executive sponsor as you define development operations. Technical and/or portfolio governance policies may
already define some of the requirements you need to establish. If they do, take the opportunity to review set policies and suggested changes/additions to them as needed.
Practitioner insight: Make sure the developers working on ServiceNow attend training for
new releases and/or get early access to upcoming versions so they can better understand
requirements for developing on the Now Platform.
To do so, you need to plan for how to include delegated developers (users outside of IT and defined ServiceNow teams who can create new applications or functionalities within
applications) to enhance ServiceNow, including how you ensure that they adhere to your architecture by following consistent development guidelines.
Define and clearly communicate the organizational goals and priorities for ServiceNow deployment so that delegated developers are not pursuing contradictory strategies
Work with the ServiceNow platform support team to define development goals that align with your ServiceNow vision.
Define the technical functionality needed and requirements involved for planned projects so developers can understand what development is already in progress and/or planned for the
future.
Define what development requirements should be applied to delegated developers who are developing on the Now Platform.
Define the specific responsibilities/accountabilities that delegated developers need to fulfill or follow to be able to reliably contribute to Now Platform development.
Write a document (can be formatted as a policy, announcement email, or even a newsletter) to clearly communicate these goals/priorities and responsibilities to delegated
developers.
Capture the defined development goals in a document that can be shared with delegated developers across the organization.
Include the delegated developer responsibilities/accountabilities defined above.
Include a brief description of the development guidelines that delegated developers must follow (e.g., the defined ServiceNow SDLC).
Invite delegated developers who read the document to connect with the ServiceNow platform support team to coordinate development.
Work with the executive sponsor to spread the word—they can share the documented goals with leaders in other departments who can then share with the delegated developers
in their departments.
Practitioner insight: Consider providing a separate environment for delegated developers to test and safely implement code on ServiceNow. Since they are less likely to strictly follow your
development operations and requirements, this can help make sure that their contributions can’t directly disrupt your core environment.
Strategic
Best practice insights
from customers, partners,
Critical and ServiceNow teams
processes
Practical Actionable
Expert
Management insights Technical Based on thousands of
successful implementations
Common across the globe
pitfalls and
challenges