/sap-btp-job-scheduling

name: sap-btp-job-scheduling
description: |
  This skill provides comprehensive guidance for SAP BTP Job Scheduling Service development, configuration, and operations.
  It should be used when creating, managing, or troubleshooting scheduled jobs on SAP Business Technology Platform.

  The skill covers service setup, REST API usage, schedule types and formats, OAuth 2.0 authentication, multitenancy,
  Cloud Foundry tasks, Kyma runtime integration, and monitoring with SAP Cloud ALM and Alert Notification Service.

  Keywords: SAP BTP, Job Scheduling, jobscheduler, cron, schedule, recurring jobs, one-time jobs, Cloud Foundry tasks,
  CF tasks, Kyma, OAuth 2.0, XSUAA, @sap/jobs-client, REST API, asynchronous jobs, action endpoint, run logs,
  SAP Cloud ALM, Alert Notification Service, multitenancy, tenant-aware, BC-CP-CF-JBS
license: GPL-3.0
metadata:
  maintainer: "Eduard Jiglau"
  maintainer_email: "hello@sap-ai-skills.com"
  website: "https://sap-ai-skills.com"
  version: "2.4.1"
  last_verified: "2025-11-27"

SAP BTP Job Scheduling Service

Related Skills

• **sap-dependency-security**: Use for secure dependency and workflow hardening when your job scheduling microservices maintain npm/CLI dependency stacks

Table of Contents

• [Overview](#overview)
• [When to Use This Skill](#when-to-use-this-skill)
• [Quick Decision Tree](#quick-decision-tree)
• [Core Concepts](#core-concepts)
• [Service Constraints](#service-constraints)
• [Quick Reference Tables](#quick-reference-tables)
• [Schedule Formats](#schedule-formats)
• [Cron Format (7 fields)](#cron-format-7-fields)
• [Schedule Lifecycle States](#schedule-lifecycle-states)
• [HTTP Methods for Jobs](#http-methods-for-jobs)
• [Best Practices](#best-practices)
• [Scheduling Optimization](#scheduling-optimization)
• [Asynchronous Jobs](#asynchronous-jobs)
• [One-Time Schedules](#one-time-schedules)
• [Authentication Quick Start](#authentication-quick-start)
• [Standard Plan (OAuth 2.0)](#standard-plan-oauth-20)
• [xs-security.json Configuration](#xs-securityjson-configuration)
• [Create Job Example](#create-job-example)
• [Node.js Client Library](#nodejs-client-library)
• [Rate Limits](#rate-limits)
• [Service Behavior](#service-behavior)
• [Outage Recovery](#outage-recovery)
• [Auto-Deactivation Triggers](#auto-deactivation-triggers)
• [Bundled Resources](#bundled-resources)
• [Common Pitfalls](#common-pitfalls)
• [External Resources](#external-resources)
• [Updates and Maintenance](#updates-and-maintenance)

Overview

SAP Job Scheduling Service is a runtime-agnostic platform service for defining and managing one-time and recurring jobs or Cloud Foundry tasks on SAP BTP. It operates across multiple hyperscalers (AWS, Azure, GCP) without requiring application modifications.

**Documentation Source**: [https://help.sap.com/docs/job-scheduling](https://help.sap.com/docs/job-scheduling)

**Last Verified**: 2025-11-27

When to Use This Skill

Use this skill when:

• **Setting up Job Scheduling Service** on Cloud Foundry or Kyma runtime
• **Creating and managing jobs** via REST API or dashboard
• **Configuring schedules** using cron, date/time, or human-readable formats
• **Implementing asynchronous job execution** for long-running processes
• **Securing action endpoints** with OAuth 2.0 and XSUAA
• **Integrating with SAP Cloud ALM** or Alert Notification Service
• **Developing multitenant applications** with tenant-aware job scheduling
• **Troubleshooting job execution issues** and schedule failures
• **Using the Node.js client library** (@sap/jobs-client)

Quick Decision Tree

What Task?

Setup & Configuration
├─ Initial setup prerequisites → references/setup-guide.md
├─ Create service instance
│  ├─ BTP Cockpit → references/setup-guide.md#cockpit
│  ├─ CF CLI → references/setup-guide.md#cf-cli
│  └─ Kyma Dashboard → references/setup-guide.md#kyma
└─ Configure XSUAA scopes → references/security.md

Job Management
├─ Create jobs → references/rest-api.md#create-job
├─ Configure schedules → references/rest-api.md#schedules
├─ Run logs & monitoring → references/rest-api.md#run-logs
└─ Dashboard operations → references/operations.md#dashboard

Schedule Configuration
├─ One-time vs recurring → references/concepts.md#schedule-types
├─ Cron format → references/concepts.md#cron-format
├─ Date/time formats → references/concepts.md#date-formats
└─ Human-readable → references/concepts.md#human-readable

Asynchronous Execution
├─ Async mode flow → references/concepts.md#async-mode
├─ Callback implementation → references/rest-api.md#update-run-log
└─ CF tasks → references/concepts.md#cf-tasks

Security & Authentication
├─ OAuth 2.0 setup → references/security.md#oauth
├─ XSUAA configuration → references/security.md#xsuaa
└─ Credential rotation → references/security.md#rotation

Integrations
├─ SAP Cloud ALM → references/integrations.md#cloud-alm
└─ Alert Notification → references/integrations.md#alert-notification

Troubleshooting
├─ Common errors → references/troubleshooting.md#errors
├─ FAQ → references/troubleshooting.md#faq
└─ Support: BC-CP-CF-JBS

Version History & Updates
└─ What's New (2021-2025) → references/changelog.md

Core Concepts

Job

A collection of schedules with an action endpoint. Jobs invoke a configured URL at specified times synchronously (short operations) or asynchronously (long processes).

Schedule

A one-time or recurring entity within a job. Supports multiple formats (cron, date/time, human-readable) and has three lifecycle states: SCHEDULED → RUNNING → COMPLETED.

Action Endpoint

An HTTP/REST endpoint exposed by your application that the service invokes when schedules trigger. Must be OAuth 2.0 protected in production.

Cloud Foundry Task

An app or script that runs independently in its own container. Always executes asynchronously with configurable memory allocation.

Service Constraints

| Constraint | Value | |------------|-------| | Minimum schedule