Fonction SAP BAPI_CUST_SAREAS_MATERIALS_GET - Create List of Materials for the Sales Areas of a Customer

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
CUSTOMERNO BAPIKNVVKY-CUSTOMER C 10 Customer Number
MATERIAL_GROUP BAPIQCI-MATL_GROUP C 9 X Material Group
SPECIFIC_DISTR_CHANNEL BAPIKNVVKY-DISTRCHN C 2 X Specific Distribution Channel
SPECIFIC_SALESORGANISATION BAPIKNVVKY-SALESORG C 4 X Specific Sales Organization
TEXTLANGUAGE BAPIMAKT-LANGU C 1 SY-LANGU X Language for Material Short Text
TEXTSTRING BAPIMAKT-MATL_DESC C 40 '*' X Search String for Material Short Text

Paramètre Reférence Type Long. Description
NOTALLOWED BAPIQCI-NOTALLOWED C 1 Access Not allowed
RETURN BAPIRETURN u 452 Return Parameter

Paramètre Reférence Long. Facultatif Description
MATERIALS BAPIMAKT 99 Materials Table
MESSAGETABLE BAPIQCLINE 132 X Log Table

Functionality
This function module provides a list of materials for a customer.
The list contains all sales materials in the sales area, in which thecustomer master record is defined. You can limit the list with theselection criteria that you enter when you call the function module.

Notes
The parameter RETURN
displays notifications.
You can find the return codes and their meanings in this parameterdocumentation.
Caution:

  • If you make an entry for both optional parameters SPECIFICSALESORG
    • (specific sales organization)and SPECIFICDISTRCHANNEL (specificdistribution channel), this method no longer checks if thecustomer is created for this sales organization and distributionchannel. Therefore,you should check these parameters before youcall this method.
    • With exit QCWA0001 you can considerably limit or change the list of
      • materials, i.e., you can make it more customer-specific.
      You can find additional information in thedocumentation for this enhancement.
      • If you do not enter a material group and a text string, the selection
        • may take quite some time.

        Further information
        Enhancement QCWA0001 with the following components:

        • EXIT_SAPLQC07_003

        • EXIT_SAPLQC07_004

        • EXIT_SAPLQC07_005

          • Description
          The output parameter NOTALLOWED displays whether access to materialsis allowed for entry combinations.

          Value range
          ' ',,Access allowed.
          'X',,Access denied.

          Description
          The return parameter confirms whether the R/3 system can find materialsfor the specified entry parameters.
          You can find further details in the output table:MESSAGETABLE

          Value range
          TYPE = "S" CODE = " ": Success message.
          TYPE = "E" CODE = "QC159": No materials were found.

          Description
          Customer number in the R/3 system.

          Value range
          The function module does not check the existence of the customer numberin the system.

          Description
          Goods group in the R/3 system.
          You can use the goods group to limit the selection of materials.

          Value range
          The function module does not check the existence of the goods group inthe system.

          Description
          You can use the parameter SPECIFICDISTRCHANNEL, together with parameterSPECIFICSALESORG to limit the selection of materials to a specificdistribution channel and a specific sales organization.

          Value range
          The function module does not check the existence of the distributionchannel in the R/3 system.

          Description
          You can use the parameter SPECIFICSALESORG, together with parameterSPECIFICDISTRCHANNEL to limit the selection of materials to aspecific sales organization and a specific distribution channel.

          Value range
          The function module does not check the existence of the salesorganization in the R/3 system.

          Description
          The system interprets the entry parameterTEXTSTRINGin the language of the material short text. The fieldsTLANGUAGE, SHORTTEXT andUSHORTTEXT in the output tableMATERIALS also appearin this language.

          Default
          The logon language of the SAP-user,(system language),is preallocated tothe parameter.

          Description
          The search string is a section from the material short text. It is usedto limit the selection and is valid for languageTEXTLANGUAGE.
          The search is carried out in upper case letters, i.e. any lower caseletters entered are translated into upper case.

          Value range
          An * asterisk stands for a user-defined character string. An+ plus symbol stands for a single character.

          Examples

          • If you enter Test* you can find the following short texts:

            • "Test material"
            "Test documentation"
            If you enter Test* "Material to be tested" is not found.
            • If you enter *test "Material for testing" is found.

              • If you enter *test the following texts are not found:
              "Test material"
              "Material to be tested"
              • If you enter *te+t* you can find all previously mentioned
                • examples and in addition the example "tentacles".
                If you enter *te+t* you cannot find the word "Terpentin".

                Default
                The parameter has * preallocated to it.

                Description
                Output table for materials.
                The table consists of the following fields:

                • MATERIAL ,,Material number

                • LANGU ,,Language key

                • MATL_DESC ,,Material short text

                • USHORTTEXT,,Material short text in upper case letters

                  • Description
                  This table holds explanatory information.
                  It contains the field LINE, (line of text)