application-scope

Application Scope Management

Overview

Scoped application development in ServiceNow requires careful management of application context and update set alignment. This skill covers setting the current application scope, understanding scoped vs global considerations, and ensuring update sets are properly aligned with application development.

• What problem does it solve? Prevents records from being created in wrong application scopes and ensures proper update set capture for scoped applications
• Who should use this skill? ServiceNow developers building custom scoped applications
• What are the expected outcomes? Properly scoped application artifacts with correct update set capture and namespace isolation

Prerequisites

• Required ServiceNow roles: admin or application_creator
• An existing scoped application or permission to create one
• Understanding of ServiceNow application scopes and namespaces
• Related skills: admin/update-set-management (must understand update sets first)

Procedure

Step 1: Identify Target Application

First, find the application you want to work in.

Using MCP tools:

Tool: SN-Query-Table
Parameters:
  table_name: sys_app
  query: scope!=global^active=true
  fields: sys_id,name,scope,version,vendor
  limit: 50

Expected Response:

{
  "result": [
    {
      "sys_id": "abc123def456...",
      "name": "My Custom Application",
      "scope": "x_myco_custom_app",
      "version": "1.0.0",
      "vendor": "My Company"
    }
  ]
}

Decision Points:

• If application exists → Proceed to Step 2
• If application not found → Create new application (see Example 3)
• If choosing between multiple apps → Verify scope prefix matches intended namespace

Step 2: Set Current Application Scope

Set the application context for all subsequent operations.

Using MCP tools:

Tool: SN-Set-Current-Application
Parameters:
  app_sys_id: abc123def456...

Important: This is an automated operation using the sys_trigger mechanism. It executes in approximately 1-2 seconds.

Verification:

Tool: SN-Query-Table
Parameters:
  table_name: sys_user_preference
  query: user=javascript:gs.getUserID()^name=apps.current_app
  fields: value

Step 3: Verify or Create Application Update Set

Scoped applications should have their own update sets to maintain clean separation.

Query existing update sets for the application:

Tool: SN-Query-Table
Parameters:
  table_name: sys_update_set
  query: application=abc123def456...^state=in progress
  fields: sys_id,name,state,application
  limit: 10

Decision Points:

• If suitable update set exists → Use existing (Step 4)
• If no update set or all completed → Create new update set

Create application-specific update set:

Tool: SN-Create-Record
Parameters:
  table_name: sys_update_set
  data:
    name: "My Custom App - Feature Development v1.1"
    application: abc123def456...
    state: in progress
    description: "Development update set for new features"

Step 4: Set Current Update Set

Align the update set with the application scope.

Using MCP tools:

Tool: SN-Set-Update-Set
Parameters:
  update_set_sys_id: xyz789ghi012...

Verification:

Tool: SN-Get-Current-Update-Set
Parameters: (none required)

Expected Response:

{
  "name": "My Custom App - Feature Development v1.1",
  "sys_id": "xyz789ghi012...",
  "state": "in progress",
  "application": "abc123def456..."
}

Step 5: Verify Scope and Update Set Alignment

Confirm both scope and update set are properly set before development.

Full verification query:

Tool: SN-Query-Table
Parameters:
  table_name: sys_update_set
  query: sys_id=xyz789ghi012...
  fields: sys_id,name,application.name,application.scope

Alignment Checklist:

• Application scope matches intended app
• Update set application field references correct app
• Update set state is "in progress"
• User has write access to the scope

Tool Usage

MCP Tools (Claude Code/Desktop)

REST API (ChatGPT/Other)

Note: Setting current application via REST API requires background script execution or session manipulation, which is complex. MCP tools handle this automatically.

Native Tools (Claude Code)

Scoped vs Global Considerations

When to Use Scoped Applications

Use Scoped Applications When:

• Building reusable, distributable applications
• Developing features that need namespace isolation
• Creating applications for the ServiceNow Store
• Building tenant-specific customizations in multi-tenant scenarios
• Implementing features that should survive upgrades cleanly

Use Global Scope When:

• Making small, one-off customizations
• Modifying out-of-box ServiceNow features
• Creating integrations that need broad table access
• Prototyping before committing to scoped architecture

Scoped Application Benefits

Scoped Application Restrictions

Cross-Scope Access

To allow a scoped application to access global or other scoped tables:

Tool: SN-Create-Record
Parameters:
  table_name: sys_scope_privilege
  data:
    application: abc123def456...
    table: incident
    operation: read_write
    status: allowed

Best Practices

• Set Scope BEFORE Update Set: Always set application scope first, then set the update set. This ensures the update set is associated with the correct application.
• One Update Set Per Feature: Create separate update sets for distinct features or sprints to enable granular deployments
• Naming Convention: Use consistent naming: {App Name} - {Feature/Sprint} - {Version} (e.g., "My App - User Portal v1.2")
• Verify Before Development: Run the full verification procedure (Steps 1-5) at the start of each development session
• Application-Aligned Update Sets: Always create update sets with the application field set to your scoped app's sys_id
• Scope Prefix Consistency: Maintain consistent scope prefixes across related applications (e.g., x_myco_*)

Troubleshooting

Common Issue 1: Records Created in Wrong Scope

Symptom: New records appear in Global scope instead of intended application Cause: Application scope not set before record creation Solution:

1. Set application scope using SN-Set-Current-Application
2. Verify scope is active by querying sys_user_preference
3. Delete incorrectly scoped records and recreate

Common Issue 2: Update Set Not Capturing Records

Symptom: Changes not appearing in update set Cause: Update set not aligned with application scope or update set not active Solution:

1. Verify update set application field matches current scope
2. Confirm update set state is "in progress"
3. Check that the table being modified is captured in update sets (some tables excluded)

Common Issue 3: Cannot Set Application Scope

Symptom: SN-Set-Current-Application fails or has no effect Cause: Insufficient permissions or application not found Solution:

1. Verify user has admin or application_creator role
2. Confirm app_sys_id is correct and application exists
3. Check application is active (not retired)

Common Issue 4: Cross-Scope Access Denied

Symptom: GlideRecord queries return no results or throw errors Cause: Scoped application lacks permission to access target table Solution:

1. Create sys_scope_privilege record granting access
2. Or modify script include to use GlideRecordSecure with elevated privileges
3. Request cross-scope access in Application Properties

Common Issue 5: Update Set Associated with Wrong Application

Symptom: Update set exists but linked to Global or different app Cause: Update set created before setting application scope Solution:

1. Update the update set's application field:

Tool: SN-Update-Record
Parameters:
  table_name: sys_update_set
  sys_id: xyz789ghi012...
  data:
    application: abc123def456...

2. Move existing records to new application-aligned update set if needed

Examples

Example 1: Standard Development Session Setup

Complete setup for starting a scoped development session:

# Step 1: Find application
Tool: SN-Query-Table
Parameters:
  table_name: sys_app
  query: scope=x_myco_custom_app
  f

---

*Content truncated.*