The example shows you how to:
AbstractFunction
and implements IFunction
.WriteXml
function to generate XML for the API function for the request.credentials.ini
file required by Bootstrap.cs
.test_object
).Open AbstractTestObject.cs
and note how it extends Intacct.SDK.Functions.AbstractFunction
.
AbstractFunction
is a helper class provided mainly to generate random control IDs. AbstractFunction
implements Intacct.SDK.Functions.IFunction
, and any class whose instances will be executed by a client must implement IFunction
. If using ExecuteBatch
, the parameter must be a List<IFunction>
.
Open TestObjectCreate.cs
and note how it extends AbstractTestObject
.
The IFunction
interface requires that the class implement the void WriteXml(ref IaXmlWriter xml)
function. This implementation is where you provide the XML that will be processed at the gateway endpoint.
Back in AbstractTestObject.cs
, replace test_object
with the integration name for your custom object.
protected const string IntegrationName = "test_object";
Run the project, and enter 4
when prompted.
For example, the following runs the project from the command line:
cd Intacct.Examples
"C:\Program Files\dotnet\dotnet.exe" bin/Debug/netcoreapp2.0/Intacct.Examples.dll
Observe the terminal output, which should look similar to this:
Created record ID 10153
Note the record ID, which will be used to delete the object later.
Type 5
to exit the program.
Open the generated Intacct.Examples/bin/Debug/netcoreapp2.0/logs/intacct.log
file in a text editor and review the entries.
The file provides info and debug entries. The SDK provides a debug entry for each HTTP request/response (with the Sage Intacct endpoint).
Note that the log file was created by the logger set in the client config.
Update CustomObjectFunction.cs
to execute a Read
function using the record ID returned by TestObjectCreate
as the key. For example:
using Intacct.SDK.Functions.Common;
...
Read read = new Read()
{
ObjectName = "test_object",
Keys =
{
10054
}
};
Task<OnlineResponse> readTask = client.Execute(read);
readTask.Wait();
OnlineResponse readResponse = readTask.Result;
Result readResult = readResponse.Results[0];
int recordNo = int.Parse(readResult.Data[0].Element("id").Value);
Console.WriteLine("Read record ID " + recordNo.ToString());
Create a TestObjectDelete
class and execute an instance of it that uses the same record ID returned in the TestObjectCreate
result.
If you need help, see the example class.
using Intacct.SDK.Xml;
namespace Intacct.Examples
{
public class TestObjectDelete : AbstractTestObject
{
public TestObjectDelete(int recordId)
{
this.Id = recordId;
}
public override void WriteXml(ref IaXmlWriter xml)
{
xml.WriteStartElement("function");
xml.WriteAttribute("controlid", this.ControlId, true);
xml.WriteStartElement("delete");
xml.WriteElement("object", IntegrationName);
xml.WriteElement("keys", this.Id);
xml.WriteEndElement(); // delete
xml.WriteEndElement(); // function
}
}
}
For more complex examples, you can use the functions in the SDK as models. For example, AbstractBill
extends AbstractFunction
, then BillCreate
and BillDelete
extend AbstractBill
and write the XML for creating or deleting bills.