Share via

<taRequesterTrxDisabler>

  • Article

You use the <taRequesterTrxDisabler> XML node to prevent the Transaction Requester from publishing an eConnect XML document to an MSMQ queue. This node enables you to disable the Transaction Requester service for a specified core or third-party document type that is setup in the eConnect_Out_Setup table.

Hint: This XML node is used with the classes in the Microsoft.Dynamics.GP.eConnect .NET assembly. You typically use <taRequesterTrxDisabler> when submitting documents through the Create, Update or Delete methods of the eConnectMethods class.

To disable a Transaction Requester document type, add a <taRequesterTrxDisabler> XML node to the transaction type schema in your eConnect XML document. To disable multiple Transaction Requester document types for a single transaction type, add a separate <taRequesterTrxDisabler> XML node for each document type.

Use the INDEX elements to identify a specific document. To learn which INDEX fields require values and the type of values to use, view the document type you want to disable in the eConnect_Out_Setup table. For example, the eConnect_Out_Setup table shows that the Customer document type includes a single INDEX that requires a CUSTNUMBR value. To disable the Transaction Requester for a specific customer document, populate the INDEX1 field with the Customer ID. .

Element name

Datatype

Length

Required

Default

Description

DOCTYPE

string

50

Y

Not applicable

Document type

Specify the name of a document type found in the DOCTYPE column of the eConnect_Out_Setup table.

INDEX1

string

75

N

<blank>

Index 1

Used for selection criteria. Specify a value that identifies the current document.

INDEX2

string

75

N

<blank>

Index 2

Used for selection criteria. Specify a value that identifies the current document.

INDEX3

string

75

N

<blank>

Index 3

Used for selection criteria. Specify a value that identifies the current document.

INDEX4

string

75

N

<blank>

Index 4

Used for selection criteria. Specify a value that identifies the current document.

INDEX5

string

75

N

<blank>

Index 5

Used for selection criteria. Specify a value that identifies the current document.

INDEX6

string

75

N

<blank>

Index 6

Used for selection criteria. Specify a value that identifies the current document.

INDEX7

string

75

N

<blank>

Index 7

Used for selection criteria. Specify a value that identifies the current document.

INDEX8

string

75

N

<blank>

Index 8

Used for selection criteria. Specify a value that identifies the current document.

INDEX9

string

75

N

<blank>

Index 9

Used for selection criteria. Specify a value that identifies the current document.

INDEX10

string

75

N

<blank>

Index 10

Used for selection criteria. Specify a value that identifies the current document.

INDEX11

string

75

N

<blank>

Index 11

Used for selection criteria. Specify a value that identifies the current document.

INDEX12

string

75

N

<blank>

Index 12

Used for selection criteria. Specify a value that identifies the current document.

INDEX13

string

75

N

<blank>

Index 13

Used for selection criteria. Specify a value that identifies the current document.

INDEX14

string

75

N

<blank>

Index 14

Used for selection criteria. Specify a value that identifies the current document.

INDEX15

string

75

N

<blank>

Index 15

Used for selection criteria. Specify a value that identifies the current document.

Delete

i4

2

N

0

Flag that specifies whether to delete the record from the eConnectOutTemp table

The following XML document example shows how to use the <taRequesterTrxDisabler> XML node. Notice how the DOCTYPE element specifies the Customer document type and the INDEX1 element specifies the customer ID. Also notice that the RequesterTrx element was set to 1.

Hint: Many XML nodes include a RequesterTrx element. This element also allows you to specify whether or not to publish transaction information to the eConnect_Out table. The typical default value of the RequesterTrx element is to not publish transaction information to the eConnect_Out table.

<eConnect xmlns:dt="urn:schemas-microsoft-com:datatypes">
    <RMCustomerMasterType>
        <taRequesterTrxDisabler_Items>
            <taRequesterTrxDisabler>
                <DOCTYPE>Customer</DOCTYPE>
                INDEX1>JEFF0002</INDEX1>
            </taRequesterTrxDisabler>
        </taRequesterTrxDisabler_Items>
        <taUpdateCreateCustomerRcd>
            <CUSTNMBR>JEFF0002</CUSTNMBR>
            <CUSTNAME>JL Lawn Care Service</CUSTNAME>
            <STMTNAME>JL Lawn Care Service, Co.</STMTNAME>
            <SHRTNAME>JL Lawn Care</SHRTNAME>
            <ADRSCODE>PRIMARY</ADRSCODE>
            <ADDRESS1>123 Main Street</ADDRESS1>
            <CITY>Valley City</CITY>
            <STATE>ND</STATE>
            <ZIPCODE>58072</ZIPCODE>
            <COUNTRY>USA</COUNTRY>
            <PHNUMBR1>55532336790000</PHNUMBR1>
            <PHNUMBR2>55551161817181</PHNUMBR2>
            <FAX>55584881000000</FAX>
            <UPSZONE>red</UPSZONE>
            <SHIPMTHD>PICKUP</SHIPMTHD>
            <TAXSCHID>USALLEXMPT-0</TAXSCHID>
            <PRBTADCD>PRIMARY</PRBTADCD>
            <PRSTADCD>PRIMARY</PRSTADCD>
            <STADDRCD>PRIMARY</STADDRCD>
            <SLPRSNID>GREG E.</SLPRSNID>
            <SALSTERR>TERRITORY 6</SALSTERR>
            <COMMENT1>comment1</COMMENT1>
            <COMMENT2>comment2</COMMENT2>
            <PYMTRMID>Net 30</PYMTRMID>
            <CHEKBKID>PAYROLL</CHEKBKID>
            <KPCALHST>0</KPCALHST>
            <UseCustomerClass>0</UseCustomerClass>
            <UpdateIfExists>1</UpdateIfExists>
            <RequesterTrx>1</RequesterTrx>
        </taUpdateCreateCustomerRcd>
    </RMCustomerMasterType>
</eConnect>