×

[PR]この広告は3ヶ月以上更新がないため表示されています。
ホームページを更新後24時間以内に表示されなくなります。




Sapass

 Simplify SAP R/3 development with Excel VBA/VB RFC  
Home> Bapi>StandardMaterial



Index

StandardMaterial

StandardMaterial


The business object Standard Material is a good that is the
subject of business activity. A standard material is traded, used in manufacture, consumed, or produced.


Structure
For data on a material to be stored at the relevant organizational
level, a material is classified according to the organizational units
plant, storage location, warehouse number and storage type, and distribution chain.


Different user departments in a company or enterprise have different
views on a material (for example, Material Requirements Planning (MRP), Purchasing, or Warehouse Management).


Different parameters define how activities such as materials planning or quality inspection are carried out for a material.


A material can have different units of measure. A conversion factor to the base unit of measure is defined for each such unit.


Depending on the unit of measure, a material can have one or more International Article Numbers (EANs) for identification.


A single piece of a material can be distinguished from others by a serial number.


Materials made up of several parts can be described using bills of material (BOMs).


For requirements planning, materials whose requirements have changed are recorded in the planning file.


The different methods by which a material can be produced are determined in a production version.


Subsets of a material that are manufactured in a particular production
run and whose inventory is managed separately from other subsets of the same material are managed as batches.


Integration
The parameters material type and industry sector are used
to classify a material. They define its possible uses.


Materials with the same attributes can be grouped together in material groups.


Comment
In certain cases, a material can also be a service.


11-Dec-2005


Methods

Available Methods


  • Availability : ATP information [ BAPI_MATERIAL_AVAILABILITY ]
  • Create : Create/extend material [ BAPI_STANDARDMATERIAL_CREATE ]
  • Delete : Flag material for deletion [ BAPI_MATERIAL_DELETE ]
  • Display : Display material [ BAPI_MATERIAL_DISPLAY ]
  • Edit : Change material [ BAPI_MATERIAL_EDIT ]
  • ExistenceCheck : Check existence of object [ BAPI_MATERIAL_EXISTENCECHECK ]
  • GetBatchCertificate : Quality certificate for batch in PDF [ BAPI_MATERIAL_GETBATCHCERT ]
  • GetBatches : Batches for material [ BAPI_MATERIAL_GETBATCHES ]
  • GetDetail : Determine details on material [ BAPI_MATERIAL_GET_DETAIL ]
  • GetInternalNumber : Assign new internal numbers [ BAPI_STDMATERIAL_GETINTNUMBER ]
  • GetList : List with description [ BAPI_MATERIAL_GETLIST ]
  • GetProductHierarchy : Read product hierarchy [ BAPI_MATERIAL_GET_PRODUCTHIER ]
  • SaveData : Create and change material master data [ BAPI_MATERIAL_SAVEDATA ]

11-Dec-2005


Availability

Availability


Using this function module, you can determine the receipt quantitystill available for a particular material in a certain plant according to ATP logic (MRPII).

The availability check is carried out on transferring the materialnumber, the plant and the input table (WMDVSX). The scope of the check,
that is, which stocks, receipts and issues are to be included in thecheck is defined by the combination of checking group (material master)and cheking rule. In the function module, the system uses the checkingrule defined in Sales & Distribution (A). You can overrule this
checking rule by using an interface or a user-exit (exit_saplw61v_001).A similar procedure is also valid for the plant parameters. Thecustomer number in the user-exit means that the plant selection can becontrolled via the customer. If no plant parameters are given via the
interface, the system uses the parameter 'WRK' saved in the user's fixed values.

The results of the availability check are recorded in the output table(WMDVEX). This table contains dates and available receipt quantities(ATP quantities). The results of the check depends on the following entries:


  • If no date and no quantity is transferred, the system displays the ATPsituation from today's date into the future as the result.
  • If only a date and no quantity is transferred, the system displays the ATP situation from the corresponding date as the result.
  • If both a date and a quantity are transferred, the system calculates the availability situation for the quantity specified.
  • In the last two cases, the parameter 'DIALOGFLAG' is supplied. This can result in the following:

  • ' ' (blank) <=> quantity completely available

  • 'X' <=> only partial quantity available or not available at
    all
  • 'N' <=> Material not included in the availability check
    (Material not relevant to the availability check)

  • The system also displays the end of the replenishment lead time (ENDLEADTME).


    11-Dec-2005


    Create

    Create


    You can use this method to create or extend a material.

    Notes

    You can use internal and external number assignment if this is allowedfor the material type to be chosen. With internal number assignment, leave the parameter NewMaterial blank.


    The number of the material created is returned in the parameter NewMaterial.


    11-Dec-2005


    Delete

    Delete


    You can use this method to flag a material for deletion or to cancel the deletion flag.


    11-Dec-2005


    Display

    Display


    You can use this method to display a material.


    11-Dec-2005


    Edit

    Edit


    You can use this method to change a material.


    11-Dec-2005


    ExistenceCheck

    ExistenceCheck


    This method checks the existence of a material.

    Notes

    Messages are returned in the parameter RETURN. The return codes and their meanings are contained in this parameter documentation.


    11-Dec-2005


    GetBatchCertificate

    GetBatchCertificate


    This method creates a table in MIME format. This table contains aquality certificate for a batch in edited form. Only the format PDF (Adobe Acrobat(TM) Reader) is currently supported.

    Besides the batch ID, you need to enter a customer number since the
    data in the quality certificate comes from a customer-specific view.

    Notes

    Messages are returned in the parameter RETURN. The parameter documentation contains the return values and their meanings.

    If no certificate can be created, you can use the table parameter MESSAGETABLE to obtain detailed information.


    If you do not know the batch you require, you can use the method GetBatches to create a list of batches for a material.


    11-Dec-2005


    GetBatches

    GetBatches


    This method is used to create a list of batches for a material. You can restrict this list by specifying input parameters.

    For example, you can create a list of the batches whose shelf life expiration date is not yet exceeded.

    Notes


    Messages are returned in the RETURN parameter.
    For the return values and their meanings, see the documentation for theRETURN parameter.

    You can combine the parameters EXPIRYDATEFROM and EXPIRYDATETO (or AVAILABLEDATEFROM and AVAILABLEDATETO) as follows:


  • If you enter an earliest and a latest availability date,
    the system selects only the batch records whose availability date is within this interval.
  • If you enter an earliest and a latest shelf life expiration date,
    the system selects only the batch records whose shelf life expiration date is within this interval.


  • 11-Dec-2005


    GetDetail

    GetDetail


    This method provides a selection of client-specific, plant-specific,and valuation-area-specific or valuation-type-specific detail data for a given material.

    The material number is a required parameter. If only the materialnumber is transferred, the method provides only client-specific detail data for the material.


    Plant-specific detail data can optionally be output for the material ifthe method has been provided with a plant (PLANT). The output ofvaluation-area-specific or valuation-type-specific detail data for thematerial requires a valuation area (VALUATIONAREA) to be specified.


    Notes

    For the data to be read successfully, you must be authorized to display material master data.

    Messages are returned in the parameter RETURN. For the return valuesand their meanings, see the documentation for this parameter.



    11-Dec-2005


    GetInternalNumber

    GetInternalNumber


    This method provides a set (to be determined) of new internally assigned numbers for a material type.

    Notes

    To use these functions, you require the authorization for the material type.

    Internal number assignment must be allowed for this material type. This
    requires an internal number range to be assigned to the material type.

    If the method ends with an error message, part of the material numbersrequested may already have been assigned. These material numbers are contained in the output parameter MATERIAL_NUMBER.



    11-Dec-2005


    GetList

    GetList


    For the selection parameters specified, this method supplies a list ofmaterials with material description for the logon language.

    Example

    Selection of ALL given materials in plant 0001, storage location 0001 or storage location 002:


    MATNRSELECTION : 'I', 'CP', '*' , ' '
    PLANTSELECTION : 'I', 'EQ', '0001', ' '
    STORAGELOCATIONSELECT : 'I', 'EQ', '0001', ' '
    'I', 'EQ', '0002', ' '

    Selection of all given materials in plant 0001 and whose description begins with 'XY':


    MATERIALSHORTDESCSEL : 'I', 'CP', 'XY*' , ' '
    PLANTSELECTION : 'I', 'EQ', '0001', ' '

    Notes

    Messages are returned in the parameter RETURN. The return codes and their meanings are contained in this parameter documentation.

    The relationship between the selection parameters follows this schema:


  • A material is selected if it satisfies the selection criteria formaterial number (MATNRSELECTION) OR for the material description (MATERIALSHORTDESCSEL) for the logon language.
  • Additionally, it must comply with the selection criteria for plant (PLANTSELECTION) and
    storage location (STORAGELOCATIONSELECT) if specified
  • or it has the manfacturer part number specified(MANUFACTURERPARTNUMB) - in this case the plant/storage location is ignored.

  • 11-Dec-2005


    GetProductHierarchy

    GetProductHierarchy


    Implementation of class method getProductHierarchy()

    All subordinate nodes and pages are read for a product hierarchy. If the parameter Product hierarchy is not set, all product hierarchies are read.


    11-Dec-2005


    SaveData

    SaveData


    You use this method to create new material master data or to change existing material master data. The data on a material can betransferred for each call.

    When creating material master data, you must transfer the materialnumber, the material type, and the industry sector to the method. You must also enter a material description and its language.


    When changing material master data, you need enter only the material number.

    In the header data, you must select at least one view for which data isto be created. Depending on the view selected, you must maintain otherrequired parameters. If you do not enter values for all of the required parameters, the method is ended with an error message.


    The corresponding fields in the tables (such as CLIENTDATA) must firstbe supplied with data by the calling program. An indicator must also beset for each of these fields so that the data is written to thedatabase by the method. This requires the calling program to supply the
    corresponding field with the indicator in a checkbox table (for example, CLIENTDATAX). Checkbox tables exist for tables that do notcontain any language-dependent texts (MAKT, MLTX), InternationalArticle Numbers (MEAN), or tax classifications (MLAN). Several data records for a material can be created in these tables.


    If a structure contains fields for units of measurement (such asstructure CLIENTDATA, field BASE_UOM), language indicators (such asstructure MATERIALDESCRIPTION, field LANGU), or country indicators(such as structure TAXCLASSIFICATIONS, field DEPCOUNTRY), there is always a field of the same name with the ending _ISO
    . This makes it possible to transfer either the internally used SAP code or astandardized ISO code for the units of measurement, language indicators, or country indicators. ISO codes are converted to an SAPcode internally for further processing. The ISO code is used only if
    the SAP code is not transferred. If you use ISO codes, there must be aunique assignment of the ISO code to the SAP code in the following activities in Customizing for Global Parameters:

  • Check Units of Measurement
  • Define Countries

  • If you want to maintain long texts (basic data texts, internalcomments, purchase order texts, material memos, or sales texts) orcustomer-defined fields for a material, some special conditions have tobe observed. They are described in the documentation for parameters MATERIALLONGTEXT and EXTENSIONIN.


    11-Dec-2005