Using the <taRequesterTrxDisabler> XML node

The <taRequesterTrxDisabler> XML node gives you the ability to disable core and third-party Transaction Requester document types for individual transactions. All the eConnect transaction type schemas allow you to add one or more <taRequesterTrxDisabler> XML nodes.

Warning: You use <taRequesterTrxDisabler> with the classes in Microsoft.Dynamics.GP.eConnect .NET assembly. You typically use <taRequesterTrxDisabler> when submitting documents through the Create, Update or Delete method of the eConnectMethods class.

You typically use the <taRequesterTrxDisabler> node with core or third-party document types that do not support the use of the RequesterTrx element. If the document you are using has XML nodes that have RequesterTrx elements, use the RequesterTrx elements to specify whether the Transaction Requester publishes your transaction. For information about the RequesterTrx element, see Using the RequesterTrx element.

To disable the Transaction Requester for a single transaction, add a <taRequesterTrxDisabler> XML node to the transaction type schema. To disable multiple Transaction Requester document types, add separate <taRequesterTrxDisabler> nodes to the transaction type schema. To specify the Transaction Requester document type, add a document type name to the DOCTYPE element.

Use the Index elements to identify a specific document. For example, the Transaction Requester requires the Customer document type to include a CUSTNUMBR value. To disable the Transaction Requester for a document that updates a specific customer, you populate the INDEX1 field with the Customer ID.

The following XML example uses two <taRequesterTrxDisabler> nodes to disable the "Customer" and "Sales_Transaction" Transaction Requester document types. Notice how the INDEX values are used to specify the individual transactions.

<?xml version="1.0" encoding="utf-8" ?>
<eConnect xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <SOPTransactionType>
        <taRequesterTrxDisabler_Items>
            <taRequesterTrxDisabler>
                <DOCTYPE>Customer</DOCTYPE>
                <INDEX1>CONTOSOL0001</INDEX1>
            </taRequesterTrxDisabler>
            <taRequesterTrxDisabler>
                <DOCTYPE>Sales_Transaction</DOCTYPE>
                <INDEX1>INV2001</INDEX1>
                <INDEX2>3</INDEX2>
            </taRequesterTrxDisabler>
        </taRequesterTrxDisabler_Items>
        <taSopLineIvcInsert_Items>
            <taSopLineIvcInsert>
                <SOPTYPE>3</SOPTYPE>
                <SOPNUMBE>INV2001</SOPNUMBE>
                <CUSTNMBR>CONTOSOL0001</CUSTNMBR>
                <DOCDATE>02/02/2006</DOCDATE>
                <LOCNCODE>WAREHOUSE</LOCNCODE>
                <ITEMNMBR>ACCS-CRD-12WH</ITEMNMBR>
                <UNITPRCE>10.95</UNITPRCE>
                <XTNDPRCE>21.9</XTNDPRCE>
                <QUANTITY>2</QUANTITY>
                <ITEMDESC>Phone Cord - 12' White</ITEMDESC>
                <DOCID>STDINV</DOCID>
                <ADDRESS1>2345 Main St</ADDRESS1>
                <CITY>Aurora</CITY>
            </taSopLineIvcInsert>
            <taSopLineIvcInsert>
                <SOPTYPE>3</SOPTYPE>
                <SOPNUMBE>INV2001</SOPNUMBE>
                <CUSTNMBR>CONTOSOL0001</CUSTNMBR>
                <DOCDATE>02/02/2006</DOCDATE>
                <LOCNCODE>WAREHOUSE</LOCNCODE>
                <ITEMNMBR>ACCS-CRD-25BK</ITEMNMBR>
                <UNITPRCE>15.95</UNITPRCE>
                <XTNDPRCE>31.9</XTNDPRCE>
                <QUANTITY>2</QUANTITY>
                <ITEMDESC>Phone Cord - 25' Black</ITEMDESC>
                <DOCID>STDINV</DOCID>
                <ADDRESS1>2345 Main St</ADDRESS1>
                <CITY>Aurora</CITY>
            </taSopLineIvcInsert>
        </taSopLineIvcInsert_Items>
        <taSopHdrIvcInsert>
            <SOPTYPE>3</SOPTYPE>
            <DOCID>STDINV</DOCID>
            <SOPNUMBE>INV2001</SOPNUMBE>
            <TAXSCHID>USASTCITY-6*</TAXSCHID>
            <FRTSCHID>USASTCITY-6*</FRTSCHID>
            <MSCSCHID>USASTCITY-6*</MSCSCHID>
            <LOCNCODE>WAREHOUSE</LOCNCODE>
            <DOCDATE>02/02/2006</DOCDATE>
            <CUSTNMBR>CONTOSOL0001</CUSTNMBR>
            <CUSTNAME>Contoso Ltd</CUSTNAME>
            <ShipToName>WAREHOUSE</ShipToName>
            <ADDRESS1>2345 Main St</ADDRESS1>
            <CNTCPRSN>Joe Healy</CNTCPRSN>
            <FAXNUMBR>13215550150</FAXNUMBR>
            <CITY>Aurora</CITY>
            <STATE>IL</STATE>
            <ZIPCODE>60507</ZIPCODE>
            <COUNTRY>USA</COUNTRY>
            <SUBTOTAL>53.8</SUBTOTAL>
            <DOCAMNT>53.8</DOCAMNT>
            <BACHNUMB>eConnect</BACHNUMB>
            <PYMTRMID>Net 30</PYMTRMID>
        </taSopHdrIvcInsert>
    </SOPTransactionType>
</eConnect>