CompuTec AppEngine Jobs

Jobs are tasks that execute within the CompuTec AppEngine environment, designed to automate processes within SAP Business One plugins. They may connect to a company's SAP database, a customer database (via ADO), or operate without a connection. This guide provides an overview of creating, configuring, and executing Jobs within CompuTec AppEngine.

---

Types of Jobs in CompuTec AppEngine

Event-Based Jobs

Event-based jobs react to specific SAP Business One events occurring within the company database. These jobs rely on SAP Business One event data and standard message information:

• ActionType: A, U, C, D
• ContentType: SAP object type
• Key: Key value
• KeyName: Key name
• UseCode: User code
• UserId: User ID
• UseRegex: Boolean inidcator if true then ContentType is RegexExpression eg:^(20|59|60)$'

To create an Event-Based Job, use the EventBusJob attribute: (!) You can use multiple EventBusAttribite on signle implementation

[EventBusJob(JobId = "Job Id", JobName = "Job Name", Description = "Job Description", ActionType = "*", ContentType = "CT_VO_OVMD")]

There are three base classes your job class must implement:

• EventBusDatabaseJob: Executes with no SAP connection, but you can use the IDbConnection DBConnection property for custom logic. Application-scoped services are available via constructor injection.
• EventBusJob: Executes without any connection, relying only on application-scoped services resolved via constructor.
• EventBusSecureJob: Provides a full connection to the database, allowing access to connection-based services via GetService<T>().

One-Time and Recursive Jobs

• One-Time Jobs: Execute on demand via the REST API.
• Recursive Jobs: Execute periodically according to a Cron expression (see Quartz Cron Generator).

Classes for creating these jobs:

• Job: No database connection, can only use application-scoped services resolved via constructor.
• SecureJob: Full connection to the database; connection-based services can be accessed via GetService<T>().

To configure the job as one-time or recursive, add the appropriate attribute:

[BackgroundJob(JobId = "AE_Plugin_ScheduledJob3AsOneTime", JobName = "AE_Plugin_ScheduledJob3AsOneTime")]
[RecurringJob(JobId = "AE_Plugin_ScheduledJob3", JobName = "BackgroundJob3", CronExpression = "0/20 0 0 ? * * *")]

Job Configuration

You can add configuration to Secure and Database type jobs by using the AdditionalJobConfiguration attribute with a specified configuration type. In your job class, access the configuration by using the Configuration property. For more details on configurations, see Configurations

[AdditionalJobConfiguration(Type = typeof(Adv))]
public class ScheduledJob2 : EventBusSecureJob
{
    public void ExecuteJob()
    {
        var config = Configuration; // Access configuration here
        // Job logic
    }
}

---