Options
All
  • Public
  • Public/Protected
  • All
Menu

This class represents the entity "A_MaterialDocumentHeader" of service "API_MATERIAL_DOCUMENT_SRV". This service is part of the following communication scenarios: Material Document Integration (SAP_COM_0108). See https://api.sap.com/api/API_MATERIAL_DOCUMENT_SRV for more information.

Hierarchy

  • Entity
    • MaterialDocumentHeader

Implements

Index

Constructors

constructor

Properties

Protected _customFields

_customFields: MapType<any>

A mapper representing custom fields in an entity. Custom fields are represented by their field names and the corresponding values. A custom field can be added or updated using setCustomField method.

Protected _versionIdentifier

_versionIdentifier: string

The current ETag version of the entity in the remote system. The ETag identified the version of the in the remote system. It will be automatically set in the "if-match" header of update requests and can be set as a custom header for delete requests. When no ETag is provided by the remote system the value of this variable defaults to "*".

Optional createdByUser

createdByUser: undefined | string

User Name. Maximum length: 12.

nullable

Optional creationDate

creationDate: Moment

Day On Which Accounting Document Was Entered. Specifies the date on which the accounting document is entered. NoteThe posting date can differ from the entry date (date of entry in the system) and the document date.

nullable

Optional creationTime

creationTime: Time

Time of Entry.

nullable

Optional documentDate

documentDate: Moment

Document Date in Document. The document date is the date on which the original document was issued.

nullable

Optional goodsMovementCode

goodsMovementCode: undefined | string

Goods Movement Code. Maximum length: 2.

nullable

Optional inventoryTransactionType

inventoryTransactionType: undefined | string

Transaction/Event Type. Identifier for a certain transaction or event. (Example: GR for "Goods receipt against a purchase order".). Maximum length: 2.

nullable

materialDocument

materialDocument: string

Number of Material Document. Alphanumeric key uniquely identifying the document. Number of the material document with which a goods movement was posted.Together with the material document year, the document number constitutes the key via which a material document is accessed. Maximum length: 10.

Optional materialDocumentHeaderText

materialDocumentHeaderText: undefined | string

Document Header Text. The document header text contains explanations or notes which apply to the document as a whole, that is, not only for certain line items. Maximum length: 25.

nullable

materialDocumentYear

materialDocumentYear: string

Material Document Year. Maximum length: 4.

Optional postingDate

postingDate: Moment

Posting Date in the Document. Date which is used when entering the document in Financial Accounting or Controlling. The fiscal year and the period for which an update of the accounts specified in the document or cost elements is made, are derived from the posting date.When entering documents, the system checks whether the posting date entered is allowed by means of the posting period permitted.The posting date can differ from both the entry date (day of entry into the system) and the document date (day of creation of the original document).

nullable

Optional referenceDocument

referenceDocument: undefined | string

Reference Document Number. The reference document number can contain the document number of the customer/vendor. However it may contain a different value. The reference document number is used as a search criterion when displaying or changing documents. In correspondence, the reference document number is sometimes printed in place of the document number.Enter the number specified by the business partner. If the document was created in-house and you do not know the business partner document number, you can copy the document number into the reference number field by entering "*". Maximum length: 16.

nullable

Protected remoteState

remoteState: object

The remote state of the entity. Remote state refers to the last known state of the entity on the remote system from which it has been retrieved or to which it has been posted. It is stored as map, where the keys are stored in the format of VDM properties.

Type declaration

  • [keys: string]: any

toMaterialDocumentItem

toMaterialDocumentItem: MaterialDocumentItem[]

One-to-many navigation property to the MaterialDocumentItem entity.

versionIdentifier

versionIdentifier: string

ETag version identifier accessor.

returns

The ETag version identifier of the retrieved entity, returns undefined if not retrieved

Static ALL_FIELDS

ALL_FIELDS: AllFields<MaterialDocumentHeader> = new AllFields('*', MaterialDocumentHeader)

All fields selector.

Static CREATED_BY_USER

CREATED_BY_USER: StringField<MaterialDocumentHeader> = new StringField('CreatedByUser', MaterialDocumentHeader, 'Edm.String')

Static representation of the createdByUser property for query construction. Use to reference this property in query operations such as 'select' in the fluent request API.

Static CREATION_DATE

CREATION_DATE: DateField<MaterialDocumentHeader> = new DateField('CreationDate', MaterialDocumentHeader, 'Edm.DateTime')

Static representation of the creationDate property for query construction. Use to reference this property in query operations such as 'select' in the fluent request API.

Static CREATION_TIME

CREATION_TIME: TimeField<MaterialDocumentHeader> = new TimeField('CreationTime', MaterialDocumentHeader, 'Edm.Time')

Static representation of the creationTime property for query construction. Use to reference this property in query operations such as 'select' in the fluent request API.

Static DOCUMENT_DATE

DOCUMENT_DATE: DateField<MaterialDocumentHeader> = new DateField('DocumentDate', MaterialDocumentHeader, 'Edm.DateTime')

Static representation of the documentDate property for query construction. Use to reference this property in query operations such as 'select' in the fluent request API.

Static GOODS_MOVEMENT_CODE

GOODS_MOVEMENT_CODE: StringField<MaterialDocumentHeader> = new StringField('GoodsMovementCode', MaterialDocumentHeader, 'Edm.String')

Static representation of the goodsMovementCode property for query construction. Use to reference this property in query operations such as 'select' in the fluent request API.

Static INVENTORY_TRANSACTION_TYPE

INVENTORY_TRANSACTION_TYPE: StringField<MaterialDocumentHeader> = new StringField('InventoryTransactionType', MaterialDocumentHeader, 'Edm.String')

Static representation of the inventoryTransactionType property for query construction. Use to reference this property in query operations such as 'select' in the fluent request API.

Static MATERIAL_DOCUMENT

MATERIAL_DOCUMENT: StringField<MaterialDocumentHeader> = new StringField('MaterialDocument', MaterialDocumentHeader, 'Edm.String')

Static representation of the materialDocument property for query construction. Use to reference this property in query operations such as 'select' in the fluent request API.

Static MATERIAL_DOCUMENT_HEADER_TEXT

MATERIAL_DOCUMENT_HEADER_TEXT: StringField<MaterialDocumentHeader> = new StringField('MaterialDocumentHeaderText', MaterialDocumentHeader, 'Edm.String')

Static representation of the materialDocumentHeaderText property for query construction. Use to reference this property in query operations such as 'select' in the fluent request API.

Static MATERIAL_DOCUMENT_YEAR

MATERIAL_DOCUMENT_YEAR: StringField<MaterialDocumentHeader> = new StringField('MaterialDocumentYear', MaterialDocumentHeader, 'Edm.String')

Static representation of the materialDocumentYear property for query construction. Use to reference this property in query operations such as 'select' in the fluent request API.

Static POSTING_DATE

POSTING_DATE: DateField<MaterialDocumentHeader> = new DateField('PostingDate', MaterialDocumentHeader, 'Edm.DateTime')

Static representation of the postingDate property for query construction. Use to reference this property in query operations such as 'select' in the fluent request API.

Static REFERENCE_DOCUMENT

REFERENCE_DOCUMENT: StringField<MaterialDocumentHeader> = new StringField('ReferenceDocument', MaterialDocumentHeader, 'Edm.String')

Static representation of the referenceDocument property for query construction. Use to reference this property in query operations such as 'select' in the fluent request API.

Static TO_MATERIAL_DOCUMENT_ITEM

TO_MATERIAL_DOCUMENT_ITEM: Link<MaterialDocumentHeader, MaterialDocumentItem> = new Link('to_MaterialDocumentItem', MaterialDocumentHeader, MaterialDocumentItem)

Static representation of the one-to-many navigation property toMaterialDocumentItem for query construction. Use to reference this property in query operations such as 'select' in the fluent request API.

Static _allFields

_allFields: Array<StringField<MaterialDocumentHeader> | DateField<MaterialDocumentHeader> | TimeField<MaterialDocumentHeader> | Link<MaterialDocumentHeader, MaterialDocumentItem>> = [MaterialDocumentHeader.MATERIAL_DOCUMENT_YEAR,MaterialDocumentHeader.MATERIAL_DOCUMENT,MaterialDocumentHeader.INVENTORY_TRANSACTION_TYPE,MaterialDocumentHeader.DOCUMENT_DATE,MaterialDocumentHeader.POSTING_DATE,MaterialDocumentHeader.CREATION_DATE,MaterialDocumentHeader.CREATION_TIME,MaterialDocumentHeader.CREATED_BY_USER,MaterialDocumentHeader.MATERIAL_DOCUMENT_HEADER_TEXT,MaterialDocumentHeader.REFERENCE_DOCUMENT,MaterialDocumentHeader.GOODS_MOVEMENT_CODE,MaterialDocumentHeader.TO_MATERIAL_DOCUMENT_ITEM]

All fields of the MaterialDocumentHeader entity.

Static _defaultServicePath

_defaultServicePath: string = "/sap/opu/odata/sap/API_MATERIAL_DOCUMENT_SRV"

Default url path for the according service.

Static _entityName

_entityName: string = "A_MaterialDocumentHeader"

Technical entity name for MaterialDocumentHeader.

Static _keyFields

_keyFields: Array<Selectable<MaterialDocumentHeader>> = [MaterialDocumentHeader.MATERIAL_DOCUMENT_YEAR, MaterialDocumentHeader.MATERIAL_DOCUMENT]

All key fields of the MaterialDocumentHeader entity.

Static _keys

_keys: object = MaterialDocumentHeader._keyFields.reduce((acc: { [keys: string]: Selectable<MaterialDocumentHeader> }, field: Selectable<MaterialDocumentHeader>) => {acc[field.fieldName] = field;return acc;}, {})

Mapping of all key field names to the respective static field property MaterialDocumentHeader.

Type declaration

Static _serviceName

_serviceName: string = "API_MATERIAL_DOCUMENT_SRV"
deprecated

Since v1.0.1 Use _defaultServicePath instead. Technical service name for MaterialDocumentHeader.

Methods

Protected getCurrentMapKeys

  • getCurrentMapKeys(): Entity
  • Returns a map of all defined fields in entity to their current values.

    Returns Entity

    Entity with all defined entity fields

getCustomField

  • getCustomField(fieldName: string): any
  • Custom field value getter.

    Parameters

    • fieldName: string

      The name of the custom field

    Returns any

    The value of the corresponding custom field

getCustomFields

  • getCustomFields(): MapType<any>
  • Returns a map that contains all entity custom fields.

    Returns MapType<any>

    A map of all defined custom fields in the entity

getUpdatedCustomFields

  • getUpdatedCustomFields(): MapType<any>
  • Returns all updated custom field properties compared to the last known remote state.

    Returns MapType<any>

    A map containing all updated custom properties, with their new values

getUpdatedProperties

  • getUpdatedProperties(): Entity
  • Returns all changed properties compared to the last known remote state. The returned properties does not include custom fields. Use getUpdatedCustomFields, if updated custom fields are needed.

    Returns Entity

    Entity with all properties that changed

hasCustomField

  • hasCustomField(fieldName: string): boolean
  • Validates whether a custom field exists in the entity.

    Parameters

    • fieldName: string

      The name of the custom field to update

    Returns boolean

    A boolean value, that indicates whether a custom field is defined in entity

initializeCustomFields

  • initializeCustomFields(customFields: MapType<any>): this
  • Sets all retrieved custom fields in entity.

    Parameters

    • customFields: MapType<any>

      Extracted custom fields from a retrieved entity

    Returns this

    A boolean value, that indicates the existence of the field in entity

Protected isConflictingCustomField

  • isConflictingCustomField(customFieldName: string): boolean
  • Validates whether a field name does not conflict with an original field name and thus can be defined as custom fields.

    Parameters

    • customFieldName: string

      Field name to check

    Returns boolean

    Boolean value that describes whether a field name can be defined as custom field

setCustomField

  • setCustomField(fieldName: string, value: any): this
  • Sets a new custom field in the entity or updates it. Throws an error, if the provided custom field name is already defined by an original field in entity.

    Parameters

    • fieldName: string

      The name of the custom field to update

    • value: any

      The value of the field

    Returns this

    The entity itself, to facilitate method chaining

setOrInitializeRemoteState

  • setOrInitializeRemoteState(state?: MapType<any>): this
  • Initializes or sets the remoteState of the entity. This function is called on all read, create and update requests. This function should be called after initializeCustomFields, if custom fields are defined.

    deprecated

    Since 1.12.0. Will be removed in version 2.0.

    Parameters

    • Optional state: MapType<any>

      State to be set as remote state

    Returns this

    The entity itself, to facilitate method chaining

setVersionIdentifier

  • setVersionIdentifier(etag: string | undefined): this
  • Set the ETag version identifier of the retrieved entity.

    Parameters

    • etag: string | undefined

      The returned ETag version of the entity

    Returns this

    The entity itself, to facilitate method chaining

toJSON

  • toJSON(): object
  • Overwrites the default toJSON method so that all instance variables as well as all custom fields of the entity are returned.

    Returns object

    An object containing all instance variables + custom fields.

    • [key: string]: any

Static builder

Static customField

  • Returns a selectable object that allows the selection of custom field in a get request for the entity MaterialDocumentHeader.

    Parameters

    • fieldName: string

      Name of the custom field to select

    Returns CustomField<MaterialDocumentHeader>

    A builder that constructs instances of entity type MaterialDocumentHeader.

Static Protected customFieldSelector

  • customFieldSelector<EntityT>(fieldName: string, entityConstructor: Constructable<EntityT>): CustomField<EntityT>
  • Type parameters

    • EntityT: Entity

    Parameters

    • fieldName: string
    • entityConstructor: Constructable<EntityT>

    Returns CustomField<EntityT>

Static Protected entityBuilder

  • entityBuilder<EntityT, EntityTypeForceMandatoryT>(entityConstructor: Constructable<EntityT, EntityTypeForceMandatoryT>): EntityBuilderType<EntityT, EntityTypeForceMandatoryT>
  • Type parameters

    • EntityT: Entity

    • EntityTypeForceMandatoryT

    Parameters

    • entityConstructor: Constructable<EntityT, EntityTypeForceMandatoryT>

    Returns EntityBuilderType<EntityT, EntityTypeForceMandatoryT>

Static requestBuilder

  • Returns a request builder to construct requests for operations on the MaterialDocumentHeader entity type.

    Returns MaterialDocumentHeaderRequestBuilder

    A MaterialDocumentHeader request builder.