HcmWorker Table

The HcmWorker table contains the records for the employees and contractors that are used with the HRM and payroll tables.

Methods

	Method	Description
	addLocations	Add locations to a party.
	aosValidateDelete	Validates on the server that the specified record can be deleted from a table. (Inherited from xRecord.)
	aosValidateInsert	Validates on the server that the specified record can be inserted. (Inherited from xRecord.)
	aosValidateRead	Validates on the server that the specified record can be read. (Inherited from xRecord.)
	aosValidateUpdate	Validates on the server that the specified record can be updated. (Inherited from xRecord.)
	buf2con	Packs the table buffers of an xRecord instance into an X++ container. (Inherited from xRecord.)
	cancelTimeOut	Cancels a previous method call to the setTimeOut method. (Inherited from Object.)
	canSubmitToWorkflow	Indicates whether submission to workflow is possible. (Inherited from xRecord.)
	caption	Gets and sets the caption property of a table. (Inherited from xRecord.)
	checkInvalidFieldAccess	Gets and sets invalid field access. (Inherited from xRecord.)
	checkRecord	Gets and sets the property that indicates whether to check mandatory fields. (Inherited from xRecord.)
	checkRestrictedDeleteActions	Gets and sets the property that indicates whether a record can be deleted. (Inherited from xRecord.)
	clear	Removes all rows from the table buffer. (Inherited from xRecord.)
	company	Gets and sets the property that indicates a legal entity for the record. (Inherited from xRecord.)
	completedCourses	Gets the number of completed courses for the worker.
	con2buf	Unpacks a container into the table buffers. (Inherited from xRecord.)
	concurrencyModel	Gets and sets the default concurrency model to use to update records. (Inherited from xRecord.)
	context	Gets and sets the context property. (Inherited from xRecord.)
	data	Retrieves a row from the table. (Inherited from xRecord.)
	dataSource	Retrieves the data source of the table. (Inherited from xRecord.)
	defaultField	Populates default values in a field in the table. (Inherited from xRecord.)
	defaultRow	Populates default values in fields in the table in the non-interactive case. (Inherited from xRecord.)
	delete	Deletes the current record from the database.
	DirPerson	Looks up the related DirPerson table.
	disableCache	Gets and sets the property that indicates whether caching is disabled. (Inherited from xRecord.)
	dispose	Releases resources that are used by the xRecord object. (Inherited from xRecord.)
	doClear	Removes all rows from the table buffer and bypasses any additional logic in the clear method of the table. (Inherited from xRecord.)
	doDelete	Deletes the current record from the table and bypasses any additional logic in the delete method of the table. (Inherited from xRecord.)
	doInsert	Inserts the record into the table and bypasses any additional logic in the insert method of the table. (Inherited from xRecord.)
	doUpdate	Updates the current record and bypasses any additional logic in the update method of the table. (Inherited from xRecord.)
	doValidateDelete	Performs the action to validate that a record can be deleted. (Inherited from xRecord.)
	email	Gets the primary email address of the worker.
	equal	Determines whether the specified object is equal to the current one. (Inherited from xRecord.)
	fieldAccessRight	Returns the field access right. (Inherited from xRecord.)
	fieldBufferAccessRight	Returns the field access right for the current record. (Inherited from xRecord.)
	fieldState	Sets or returns the state of a field in the table buffer. (Inherited from xRecord.)
	getAllowRedefault	Returns the list of fields that are allowed to re-default. (Inherited from xRecord.)
	getDefaultDimension	Gets the default dimension that is associated with the current worker, according to their oldest, active employment or the supplied parameters.
	getDefaultingDependencies	Returns the container that holds defaulting dependencies. (Inherited from xRecord.)
	getExtension	Returns the table extension. (Inherited from xRecord.)
	getFieldValue	Gets the value of the specified field from a table buffer. (Inherited from xRecord.)
	getFIO_RU	Returns Surname, Name and Middle Name
	getFirstPendingEmployment	Finds the earliest future dated employment record for the current worker.
	getInstanceRelationType	Returns the table name that corresponds to the InstanceRelationType ID. (Inherited from xRecord.)
	getPhysicalTableName	Return the physical table name, which, in the case of the SQL Temp DB table, is the table instance name. (Inherited from xRecord.)
	getPresenceFieldData	Retrieves the PresenceInfo value from the specified field. (Inherited from xRecord.)
	getSQLStatement	Gets the SQL statement that is used to return records from the database. (Inherited from xRecord.)
	getTableInInstanceHierarchy	(Inherited from xRecord.)
	getTableType	Indicates the type of the table. (Inherited from xRecord.)
	getTimeOutTimerHandle	Returns the timer handle for the object. (Inherited from Object.)
	handle	Retrieves the handle of the class of the object. (Inherited from Object.)
	hasRelatedTable	Indicates whether a foreign key constraint buffer is linked with the table. (Inherited from xRecord.)
	helpField	Retrieves a string that contains the Help text for the specified field. (Inherited from xRecord.)
	initValue	Initializes a field to the default value. (Inherited from xRecord.)
	inputStatus	Sets or returns the current input status of the table buffer. (Inherited from xRecord.)
	insert	Inserts the current record into the database.
	interactiveContext	Sets or returns the current interactive context of the table buffer. (Inherited from xRecord.)
	isContractor	Determines whether the worker has an active employment of type contractor for a given time range.
	isEmployedInPeriod	Determines whether the worker is affiliated with the same legal entity for the whole duration of a period.
	isEmployee	Determines whether the worker has an active employment of type employee for a given time range.
	isFieldDataRetrieved	Checks whether the data of the given field has been retrieved. (Inherited from xRecord.)
	isFieldSet	Checks whether a field has a Set or Defaulted state. (Inherited from xRecord.)
	isFormDataSource	Indicates whether the data source is a form. (Inherited from xRecord.)
	isNewRecord	Returns true if the record is a new record that hasn't been persisted yet. (Inherited from xRecord.)
	isPartOfUOWSaveChanges	(Inherited from xRecord.)
	isTempDb	Indicates whether the type of the table is SQL TempDB. (Inherited from xRecord.)
	isTmp	Indicates whether this is a temporary table. (Inherited from xRecord.)
	joinChild	Finds the join child of the current record. (Inherited from xRecord.)
	joinParent	Finds the join parent of the current record. (Inherited from xRecord.)
	linkPhysicalTableInstance	Checks whether there is a link for the physical table instance for the record. (Inherited from xRecord.)
	merge	Merges the current table with the specified table. (Inherited from xRecord.)
	modifiedField	Modifies the specified field to the original. (Inherited from xRecord.)
	modifiedFieldValue	Modifies the specified field to the original value. (Inherited from xRecord.)
	name	Gets the name of the worker.
	new	Initializes a new instance of the Object class. (Inherited from Object.)
	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.)
	officeLocation	Gets the office location of a worker.
	officeLocationAddress	Gets the office location address of a worker.
	orig	Retrieves the original values of the current record. (Inherited from xRecord.)
	overwriteSystemfields	Gets and sets the property that indicates whether system fields can be overwritten. (Inherited from xRecord.)
	owner	Returns the instance that owns the object. (Inherited from Object.)
	personCertificates	Gets the number of resume certificates that was created by this worker.
	personCourses	Gets the number of resume courses that was created by this worker.
	personEducation	Gets the number of resume education records that were created by this worker.
	personLoans	Gets the number of loaned equipment records that were created by this worker.
	personProfessionalExperiences	Gets the number of resume professional experience records that were created by this worker.
	personProjectExperiences	Gets the number of resume project experience records that were created by this worker.
	personSkills	Gets the number of resume skill records that were created by this worker.
	personTrustedPositions	Gets the number of resume trusted position records that were created by this worker.
	phone	Gets the primary telephone number of the worker if one exists.
	phoneLocal	Gets the primary telephone extension of the worker if one exists.
	postCacheLoad	Is a member method of the Microsoft Dynamics AX record and is called automatically whenever a record is read from the database cache.
	postLoad	Is run whenever a record is read from the database.
	preRemoting	Is executed before a cross-tier call is about to be executed for the table that would pack its state to the other tier. (Inherited from xRecord.)
	primaryAddress	Gets the primary address of the worker.
	primaryDepartmentName	Gets the name of the primary department of the worker if one exists.
	primaryPositionId	Gets the position ID of the primary position of the worker if one exists.
	queryTimedOut	Indicates whether the query exceeded the time limit for execution. (Inherited from xRecord.)
	queryTimeout	Gets and sets the property that indicates the time limit for the execution of a query. (Inherited from xRecord.)
	readCommittedLock	(Inherited from xRecord.)
	readPast	Gets and sets the property that indicates whether to skip rows that are locked by other processes when a record is read. (Inherited from xRecord.)
	recordLevelSecurity	Gets and sets the property that indicates whether to apply security on a record level. (Inherited from xRecord.)
	registeredCourses	Gets the number of registered courses for the worker.
	relatedTable	Sets or returns the related buffer of a link of a table buffer. (Inherited from xRecord.)
	renamePrimaryKey	Renames the foreign keys in other tables according to the change of the corresponding primary key value in this table. (Inherited from xRecord.)
	reread	Rereads the record from the table. (Inherited from xRecord.)
	RowCount	Retrieves the number of rows in the table. (Inherited from xRecord.)
	searchName	Gets the search name of the worker.
	selectForUpdate	Gets and sets the property that indicates whether to select records for update when they are read. (Inherited from xRecord.)
	selectLocked	Indicates whether to select locked records. (Inherited from xRecord.)
	selectRefRecord	Selects the record by referenced field ID. (Inherited from xRecord.)
	selectWithRepeatableRead	Gets and sets the property that indicates whether repeatable read is enabled. (Inherited from xRecord.)
	seniorityDate	Gets the worker seniority date.
	setConnection	Sets the user connection for this table. (Inherited from xRecord.)
	setCrossPartition	Sets or resets cross-partitioning for the table. (Inherited from xRecord.)
	setFieldValue	Sets the field value in the record buffer. (Inherited from xRecord.)
	setSQLTracing	Enables or disables SQL tracing mode. (Inherited from xRecord.)
	setTimeOut	Sets up the scheduled execution of a specified method. (Inherited from Object.)
	setTmp	Sets the table so that it is not persisted to the database. (Inherited from xRecord.)
	setTmpData	Sets the contents of the temporary table to the specified data. (Inherited from xRecord.)
	setXDSContext	Sets new XDS context. (Inherited from xRecord.)
	showPartyMatchIcon	Gets the address book for the worker.
	skipAosValidation	Gets and sets the property that indicates whether to skip validation of Microsoft Dynamics AX Application Object Server (AOS). (Inherited from xRecord.)
	skipDatabaseLog	Gets and sets the property that indicates whether to skip database log requests. (Inherited from xRecord.)
	skipDataMethods	Gets and sets the property that indicates whether to discard overloaded methods. (Inherited from xRecord.)
	skipDeleteActions	Gets and sets the property that indicates whether to skip delete actions on the table. (Inherited from xRecord.)
	skipDeleteMethod	Gets and sets the property that indicates whether to discard overloaded methods. (Inherited from xRecord.)
	skipEvents	Provides an option to turn off calling the Application.event* methods for the lifetime of an xRecord object. (Inherited from xRecord.)
	skipPostLoad	Gets and sets the property that indicates whether to skip executing the xRecord.postLoad method on the table. (Inherited from xRecord.)
	skipTTSCheck	Gets and sets the property that indicates whether to skip the check to determine whether the record is selected for update. (Inherited from xRecord.)
	suppressWarnings	Gets and sets the property that indicates whether to suppress warnings for this pointer. (Inherited from xRecord.)
	syncWrkCtrTable	Finds the syncWrkCtrTable record that represents the current resource.
	tableAccessRight	Returns the table access right. (Inherited from xRecord.)
	tableBufferAccessRight	Returns the table access right for the current record. (Inherited from xRecord.)
	takeOwnershipOfTempDBTable	(Inherited from xRecord.)
	title	Gets the title ID of the worker.
	toolTipField	Retrieves the HelpText value for the specified field. (Inherited from xRecord.)
	toolTipRecord	Retrieves the ToolTip value for the current record. (Inherited from xRecord.)
	toString	Returns a string that represents the current object. (Inherited from Object.)
	ttsabort	Aborts a transaction that was started by a call to the ttsbegin method. (Inherited from xRecord.)
	ttsbegin	Starts a transaction that can be either committed by the ttscommit method or aborted by the ttsabort method. (Inherited from xRecord.)
	ttscommit	Commits a transaction that was started by a call to the ttsbegin method. (Inherited from xRecord.)
	update	Updates the current record in the database.
	usageCount	Retrieves the current number of references (the value of the reference counter) that the object has. (Inherited from xRecord.)
	useExistingTempDBTable	(Inherited from xRecord.)
	validateDelete	Determines whether the current record is valid and ready to be deleted from the database. (Inherited from xRecord.)
	validateField	Determines whether the specified field is valid. (Inherited from xRecord.)
	validateFieldValue	(Inherited from xRecord.)
	validateWrite	Determines whether the current record is valid and ready to be written. (Inherited from xRecord.)
	validTimeStateUpdateMode	Sets a valid time state update mode on the cursor. (Inherited from xRecord.)
	wait	Pauses a process. (Inherited from Object.)
	wasCached	Specifies the location from which the data was retrieved. (Inherited from xRecord.)
	workerBenefits	Gets the number of benefit records created by this worker.
	workerDiscussions	Gets the number of discussion records that was created by this worker.
	workerPerformanceGoals	Gets the number of performance goal records created by this worker.
	workerRelationType	Gets the worker relation type across all time.
	workerStatus	Gets the worker status as of now.
	workerStatusForReports	Gets the current worker status.
	write	Updates a record if it exists; otherwise, inserts a record. (Inherited from xRecord.)
	xml	Retrieves an XML string that represents the current object. (Inherited from xRecord.)
	::checkExist	Validates that the specified record is in the HcmWorker table; if not, an error message is displayed.
	::emailServer	Gets the primary email address of the worker.
	::exist	Indicates whether the specified record in the HcmWorker table exists.
	::find	Finds the specified record in the HcmWorker table.
	::findByPerson	Finds the specified record in the HcmWorker table.
	::findByPersonnelNumber	Finds the specified record in the HcmWorker table by using the specified value of the PersonnelNumber field.
	::getDepartmentRecIds	Gets the record IDs of all the OMOperatingUnit records for the given HcmWorker record.
	::getDepartmentRecIdsCacheClear	Clears the global object cache that is used by this method to cache the results.
	::getDepartments	Gets all the OMOperatingUnit records of type OMDepartment for an HcmWorker object, if they exist.
	::getDirPersonNameByTimeState	Finds a DirPersonName record which corresponds to HcmPersonRecId value and active as of a supplied utcDateTime value.
	::getLegalEntities	Gets any CompanyInfo records for an HcmWorker record.
	::getLegalEntity	Retrieves the oldest CompanyInfo record for an HcmWorker object, if it exists.
	::getLegalEntityRecIds	Gets the record IDs of all the CompanyInfo records for the given HcmWorker record.
	::getMaxEmploymentEndDate	Retrieves the maximum ValidTo value for the active employments that are associated with an HcmWorker object.
	::getMinEmploymentStartDate	Returns the minimum ValidFrom value for the active employments that are associated with an HcmWorker object.
	::getPrimaryDepartment	Gets the OMOperatingUnit record that represents the department for an HcmWorker object, if one exists.
	::getPrimaryDepartmentRecId	Gets the OMDepartmentRecId value that represents the primary department for an HcmWorker record.
	::getPrimaryPosition	Retrieves the HcmPositionRecId value from the HcmPositionWorkerAssignment table using the provided HcmWorkerRecId value.
	::getPrimaryPositionAssignment	Retrieves the HcmPositionWorkerAssignmentRecId from the HcmPositionWorkerAssignment table for the provided HcmWorkerRecId value.
	::isPaidByLegalEntity	Indicates whether there is a Legal Entity specified on any of the worker's positions that is used to pay the position.
	::jumpRef	Adds the View Details option to RecId field of the HcmWorker table.
	::numberActiveAndFutureEmployments	Gets the count of current and pending employments for an HcmWorker record.
	::phoneLocalServer	Gets the primary telephone extension of the worker if one exists.
	::phoneServer	Gets the primary telephone number of the worker if one exists.
	::primaryAddressServer	Gets the primary address of the worker.
	::txtNotExist	Gets the message to use when a specific record in the HcmWorker table does not exist.
	::userId2Worker	Finds a record in the HcmWorker table that is associated with a specified user ID.
	::worker2Name	Retrieves the name for the specified HcmWorker record.
	::worker2ProfessionalTitle	Retrieves the professional title for a worker.
	::workerStatusServer	Gets the worker status as of now.

Top

Fields

Field	Type	Configuration key	Description
createdBy	Extended Data Type: CreatedBy Type: String	None
createdDateTime	Extended Data Type: CreatedDateTime Type: UtcDateTime	None
modifiedBy	Extended Data Type: ModifiedBy Type: String	None
modifiedDateTime	Extended Data Type: ModifiedDateTime Type: UtcDateTime	None
Partition	Extended Data Type: Partition Type: Int64	None	(This field applies only to the following version(s): Microsoft Dynamics AX 2012 R3, Microsoft Dynamics AX 2012 R2 (SYS))
Person	Extended Data Type: DirPartyRecId Type: Int64	None	Reference field in a different table
PersonnelNumber	Extended Data Type: HcmPersonnelNumberId Type: String	None	The personnel number for the worker
RecId	Extended Data Type: RecId Type: Int64	None
recVersion	Extended Data Type: RecVersion Type: Integer	None

Top

Field Groups

Field Group	Fields
AutoLookup
AutoReport
CaseMoreInformation
Identification
AutoIdentification
PersonAndPersonnelNumber
Person
PersonnelNumber
PreviewPane

Top

Relations

Relation	Table	Lines
DirAddressBookParty	DirAddressBookPartyAllView
DirPerson_FK	DirPerson
Partition	Partitions

Top

Indexes

Index	AllowDuplicates	Enabled	Fields
HcmWorker_AK1	No	Yes
HcmWorker_AK2	No	Yes
RecId	No	Yes

Top

Inheritance Hierarchy

xRecord Class
  Common Table
    HcmWorker Table

See Also

Table Methods

Tables Overview