JmgJobBundle Class [AX 2012]
The JmgJobBundle class should be used to create all the registrations in shop floor control.
| Method | Description | |
|---|---|---|
| addJob | Adds a job to the job bundle. |
| addTermJob | Adds a job to the job bundle. |
| bundleCommitted | Throws an error if the bundle has been committed. |
| bundleSize | Retrieves the number of jobs added to the bundle. |
| bundleType | Retrieves the bundle type. |
| cancelProductionPostings | Removes any production journals that were created during a canceled registration. |
| cancelTimeOut | Cancels a previous method call to the setTimeOut method. (Inherited from Object.) |
| checkEmployeeForgotClockOut | Checks whether an employee have been clocked in for too long. |
| checkPilot | Indicates whether a worker is currently working as a pilot. |
| checkRegistrationTime | Checks the JmgTermReg table for registrations later than the time entered in the job bundle. |
| clearActiveJobs | Removes all active jobs from the bundle. |
| containsJob | Redtrieves whether the job bundle contains the job with the specified job ID. |
| continueBundle | Sets or retrieves the continueBundle parameter. |
| emplClockedIn | Determines whether the worker that is associated to the JmgJobBundle object is currently clocked in. |
| ensureClockInStatus | Creates a clock-in registration for the employee associated with the bundle if the employee is not currently clocked in. |
| equal | Determines whether the specified object is equal to the current one. (Inherited from Object.) |
| feedbackBundleType | Returns the bundle type of the active jobs bundle. |
| getActiveJob | Gets a job from the activeJobs map. This method throws an error if the supplied job ID is not present in the activeJobs map. |
| getActiveJobsIterator | Returns a map iterator of the activeJobs map. |
| getFeedbackParameters | Gets feedback parameters for a specific job. If the specified job ID is not one of the active jobs, an error is thrown. |
| getJobStartedParameters | Retrieves the registration parameters associated to the specified job ID. |
| getNewJobsIterator | Returns a map iterator of the newJobs map. |
| getRealizedStartTime | Gets the realized starting time of the job that is associated with the specified transaction. |
| getStartupParameters | Gets startup parameters for a specific job. If the specified job ID is not one of the new jobs, an error is thrown. |
| getTimeOutTimerHandle | Returns the timer handle for the object. (Inherited from Object.) |
| handle | Retrieves the handle of the class of the object. (Inherited from Object.) |
| jobsAdded | Retrieves whether jobs have been added to the job bundle. |
| loadActiveJobs | Load the jobs that the employee is currently working on. |
| makeChangePilotRegistrations | Provides a change pilot registration. An error is thrown if no new pilot is specified in the JmgRegistrationParameters object. |
| makeClockInRegistration | Provides a clock-in registration for the employee. |
| makeClockOutRegistration | Provides a clock out registration for the employee. If the employee is already clocked out, an error is thrown. |
| makeFeedbackOnActiveJobs | Provides feedback on active jobs without making a stop registration on these jobs. |
| makeRegistrations | Provides registrations on the added jobs. |
| makeRegistrationsAbsence | Creates a registration on an absence job. |
| makeRegistrationsBreak | Creates a registration on a break job ID. |
| makeRegistrationsEventCode | Creates registrations on a switch code, which has been added to the bundle. |
| makeRegistrationsIPC | Creates a registration on an IPC job. |
| makeRegistrationsProd | Creates registrations on production jobs. |
| makeRegistrationsProj | Creates registrations on project jobs. |
| new | Initializes a new instance of the JmgJobBundle class. (Overrides the new Method.) |
| notify | Releases the hold on an object that has called the wait method on this object. (Inherited from Object.) |
| notifyAll | Releases a lock on the object that was issued by the wait method on this object. (Inherited from Object.) |
| objectOnServer | Determines whether the object is on a server. (Inherited from Object.) |
| owner | Returns the instance that owns the object. (Inherited from Object.) |
| parmAutostamp | Gets or sets the Autostamp parameter. |
| parmCallerForm | Gets or sets the CallerForm parameter. |
| parmResourceRegistration | Gets or sets the ResourceRegistration parameter. |
| postProductionJournals | Posts any production journals created during the production process. |
| postTime | Posts time journals for the registrations made on this job bundle. |
| prodMultiReportFinished | Gets the report as finished parameter collection. |
| registerAsWrkCtr | Determines whether the registrations that are made must be associated to a resource. |
| removeAllJobs | Removes all jobs from the bundle. |
| removeJob | Removes a job from the bundle. If this method is invoked by using a job not added to the bundle. |
| requestFeedback | Prompts the user for feedback on already started jobs. |
| requestStartupInfo | Requests startup information from the user depending on the type of added jobs. |
| requireFeedback | Returns whether feedback should be requested from the user. |
| reset | Resets the job bundle. All added jobs are removed and the employee's active jobs are reloaded from the database. |
| resetRegistrationTime | Resets the registration date and time. |
| restartJobs | At clock in, restarts the jobs that were stopped at the previous clock out. |
| restoreTeam | Restores the team that the employee was a member of at the previous clock out. |
| setFeedbackParameters | Sets the feedback parameters associated with an active job. |
| setFeedbackStatusOnActiveJobs | Sets the feedback status for all of the active jobs. |
| setReportFinishedJournalPosting | Sets the journal used for posting report as finished production journals. |
| setStartUpJournalPosting | Sets the journal used for posting start of productions. |
| setStartupParameters | Set the startup parameters associated with an added job. |
| setStatusQtyJournalPosting | Sets the journals that are used for posting status and quantity changes to productions. |
| setTimeOut | Sets up the scheduled execution of a specified method. (Inherited from Object.) |
| setWrkCtrPilot | Sets the WrkCtrIdPilot property on all registration parameters in the bundle. |
| showClockInfo | Shows information about the clock in or clock out to the user. |
| showMessageInfo | Shows information to the user. |
| startNewJobs | Creates a start registration for the employee for each job that is added to the job bundle. |
| stopActiveBreaks | Creates a stop break registration for each break that the employee is currently registered for. |
| stopActiveJobs | Creates a stop registration for each job that the employee is currently working on. |
| toString | Returns a string that represents the current object. (Inherited from Object.) |
| translateModuleType | Translates between job module types to bundle types. |
| usageCount | Returns the current number of references, that is, the value of the reference counter, that the object has. (Inherited from Object.) |
| validateBundle | Validates that the specified job can be added to the bundle. |
| wait | Pauses a process. (Inherited from Object.) |
| worker | Retrieves the worker that is associated with this bundle. |
| wrkCtrIdPilot | Returns the ID of the pilot resource that is currently associated to the JmgJobBundle object. |
| xml | Returns an XML string that represents the current object. (Inherited from Object.) |
| ::iterateFeedback | Iterates feedback and posts production journals. |
| ::showMessage | Shows information to the user. |
In shop floor control, jobs are said to be bundled when an employee is working on several jobs at the same time. This class encapsulates all of the tasks that are associated with the registration process. These tasks include the following:
-
Providing registrations for all of a job bundle at the same time, which includes a check to indicate whether the jobs are a valid bundle.
-
Providing stop registrations for the jobs that the employee is currently working on before start registrations are made on new jobs.
-
Requesting feedback for the jobs that the employee is currently performing.
-
Requesting startup information about jobs to start.
-
Displaying information about the registration process to the user.
-
Providing the employee clock in status to make sure that a clock in registration is made when the employee is making job registrations when they are clocked out, or indicating whether the employee forgot to clock out.
Most of these features can be enabled or disabled when a JmgJobBundle object is created. For more information, see the JmgJobBundle.new method. There are two typical uses for the JmgJobBundle class:
-
Changing jobs. Employees stop working on one set of jobs and start working on a new set of jobs.This is accomplished by instantiating a new object, adding some jobs, and then calling the JmgJobBundle.makeRegistrations method.
-
Providing feedback on active jobs. Employees finish a part of the work order and want to report the results back to shop floor control. This is performed by creating a new object and then starting the JmgJobBundle.makeFeedbackOnActiveJobs method.
The following two examples show how the JmgJobBundle class is used to create registrations and how to provide feedback on active jobs:
-
To create registrations, so that the specified employee changes to the production jobs with IDs 10000987 and 10000999.
-
To provide feedback on the jobs that the specified employee is currently working on.
// Example 1
JmgJobBundle jmgJobBundle;
jmgJobBundle = new JmgJobBundle(jmgWorkerRecId);
jmgJobBundle.addJob(JmgJobTable::find('10000987'));
jmgJobBundle.addJob(JmgJobTable::find('10000999'));
jmgJobBundle.makeRegistrations();
// Example 2:
JmgJobBundle jmgJobBundle;
jmgJobBundle = new JmgJobBundle(jmgWorkerRecId);
jmgJobBundle.makeFeedbackOnActiveJobs();