我只使用 NetSuite 和 SuiteTalk 不到一年。我找到了利用已保存搜索的基本搜索和高级搜索的示例,但我很难找到如何使用结果集中的条件和选定列从头开始执行高级搜索的示例。所以我在问例子。
3 回答
我查看了可从 NetSuite 下载的 NSClientERP 项目中提供的示例。这是一个简化的例子。
service.searchPreferences = new SearchPreferences();
service.searchPreferences.bodyFieldsOnly = true;
service.searchPreferences.returnSearchColumns = true;
TransactionSearchAdvanced customSearch = new TransactionSearchAdvanced()
{
columns = new TransactionSearchRow()
{
basic = new TransactionSearchRowBasic()
{
dateCreated = new SearchColumnDateField[] { new SearchColumnDateField() }
, tranDate = new SearchColumnDateField[] { new SearchColumnDateField() }
, type = new SearchColumnEnumSelectField[] { new SearchColumnEnumSelectField() }
, tranId = new SearchColumnStringField[] { new SearchColumnStringField() }
, internalId = new SearchColumnSelectField[] { new SearchColumnSelectField() }
, entity = new SearchColumnSelectField[] { new SearchColumnSelectField() }
, item = new SearchColumnSelectField[] { new SearchColumnSelectField() }
, lastModifiedDate = new SearchColumnDateField[] { new SearchColumnDateField() }
}
, itemJoin = new ItemSearchRowBasic()
{
itemId = new SearchColumnStringField[] { new SearchColumnStringField() }
}
}
,
criteria = new TransactionSearch()
{
basic = new TransactionSearchBasic()
{
type = new SearchEnumMultiSelectField()
{
@operator = SearchEnumMultiSelectFieldOperator.anyOf
, operatorSpecified = true
, searchValue = new string[] {
"_salesOrder"
}
}
, lastModifiedDate = new SearchDateField()
{
@operator = SearchDateFieldOperator.onOrAfter
, operatorSpecified = true
, searchValue = DateTime.Now.AddDays(-3)
, searchValueSpecified = true
}
}
}
};
Console.WriteLine("Querying NetSuite");
SearchResult searchResult = service.search(customSearch);
Console.WriteLine("Query Results: " + searchResult.totalRecords.ToString());
int total = searchResult.totalRecords;
int updated = 0;
bool searchMore = false;
Console.WriteLine("\nThe search() operation for transaction was run successfully.");
Console.WriteLine("\n Total Records = " + searchResult.totalRecords);
Console.WriteLine(" Total Pages = " + searchResult.totalPages);
Console.WriteLine(" Page Size = " + searchResult.pageSize);
Console.WriteLine(" Current Page Index = " + searchResult.pageIndex);
Console.WriteLine("\n\nHit Enter to list results");
Console.ReadLine();
SearchRow[] records = searchResult.searchRowList;
if (records != null)
{
for (int i = 0, j = (searchResult.pageIndex - 1) * searchResult.pageSize; i < records.Length; i++, j++)
{
TransactionSearchRow transactionRow = (TransactionSearchRow) records[i];
TransactionSearchRowBasic transactionRowBasic = transactionRow.basic;
ItemSearchRowBasic itemRowBasic = transactionRow.itemJoin;
Console.WriteLine(
"\n Transaction Return Columns Row[" + j + "]: " +
"\n internalId=" + transactionRowBasic.internalId[0].searchValue.internalId +
"\n tranId=" + transactionRowBasic.tranId[0].searchValue +
"\n type=" + transactionRowBasic.type[0].searchValue +
(transactionRowBasic.entity == null ? "" : ("\n customer internalID=" + transactionRowBasic.entity[0].searchValue.internalId)) +
(transactionRowBasic.item == null ? "" : ("\n item=" + transactionRowBasic.item[0].searchValue.internalId)) +
(itemRowBasic == null ? "" : ("\n item.name=" + itemRowBasic.itemId[0].searchValue)) +
(transactionRowBasic.dateCreated == null ? "" : ("\n createdDate=" + transactionRowBasic.dateCreated[0].searchValue.ToString()) +
(transactionRowBasic.tranDate == null ? "" : ("\n tranDate=" + transactionRowBasic.tranDate[0].searchValue.ToString())) +
(transactionRowBasic.lastModifiedDate == null ? "" : ("\n lastModifiedDate=" + transactionRowBasic.lastModifiedDate[0].searchValue.ToString()))));
}
}
在执行高级搜索之前设置搜索首选项很重要。如果没有将 returnSearchFields 设置为 true,我没有得到任何结果。此外,您必须同时提供条件和列。在 NSClientERP 示例中,以 TransactionSearchAdvanced 开头的每个对象都在单独的代码行中被实例化、配置并链接到子对象。我发现这很难理解。我正在使用一行代码来实例化整个搜索对象。
另一件需要注意的是 itemJoin,它将 Items 表连接到销售订单行项目。您还可以使用其他联接,例如 billingTransactionJoin。利用这些连接,您可以访问关联的表,以获取项目的显示名称、库存信息或项目发货时的跟踪号等信息。
除了填充数据集并在事后进行排序之外,我一直无法找到对结果进行排序的方法。如果有人有更好的方法,请告诉我。
这是一个实际正确执行分页的示例。
service.searchPreferences = new SearchPreferences();
service.searchPreferences.bodyFieldsOnly = true;
service.searchPreferences.returnSearchColumns = true;
TransactionSearchAdvanced customSearch = new TransactionSearchAdvanced()
{
columns = new TransactionSearchRow()
{
basic = new TransactionSearchRowBasic()
{
dateCreated = new SearchColumnDateField[] { new SearchColumnDateField() }
,
tranDate = new SearchColumnDateField[] { new SearchColumnDateField() }
,
type = new SearchColumnEnumSelectField[] { new SearchColumnEnumSelectField() }
,
tranId = new SearchColumnStringField[] { new SearchColumnStringField() }
,
internalId = new SearchColumnSelectField[] { new SearchColumnSelectField() }
,
entity = new SearchColumnSelectField[] { new SearchColumnSelectField() }
,
item = new SearchColumnSelectField[] { new SearchColumnSelectField() }
,
lastModifiedDate = new SearchColumnDateField[] { new SearchColumnDateField() }
}
,
itemJoin = new ItemSearchRowBasic()
{
itemId = new SearchColumnStringField[] { new SearchColumnStringField() }
}
}
,
criteria = new TransactionSearch()
{
basic = new TransactionSearchBasic()
{
type = new SearchEnumMultiSelectField()
{
@operator = SearchEnumMultiSelectFieldOperator.anyOf
,
operatorSpecified = true
,
searchValue = new string[] {
"_salesOrder"
}
}
,
lastModifiedDate = new SearchDateField()
{
@operator = SearchDateFieldOperator.onOrAfter
,
operatorSpecified = true
,
searchValue = DateTime.Now.AddDays(-15)
,
searchValueSpecified = true
}
}
}
};
Console.WriteLine("Querying NetSuite");
SearchResult res = service.search(customSearch);
Console.WriteLine("\nThe advanced search completed.");
Console.WriteLine("\n Total Records = " + res.totalRecords);
Console.WriteLine(" Total Pages = " + res.totalPages);
Console.WriteLine(" Page Size = " + res.pageSize);
Console.WriteLine(" Current Page Index = " + res.pageIndex);
Console.WriteLine("\n\nHit Enter to list results");
Console.ReadLine();
while (res.searchRowList.Length > 0)
{
Console.WriteLine($"\n\nProcessing page: {res.pageIndex}");
Console.WriteLine($"Result count: {res.searchRowList.Length}");
Console.WriteLine($"\nHit enter to list page {res.pageIndex} results");
Console.ReadLine();
foreach (TransactionSearchRow transactionRow in res.searchRowList)
{
TransactionSearchRowBasic transactionRowBasic = transactionRow.basic;
ItemSearchRowBasic itemRowBasic = transactionRow.itemJoin;
Console.WriteLine(
"\n tranId=" + transactionRowBasic.tranId[0].searchValue +
(itemRowBasic == null ? "" : ("\n item.name=" + itemRowBasic.itemId[0].searchValue))
);
}
Console.WriteLine("\nQuerying NetSuite again...");
res = service.searchMore(++res.pageIndex);
}
service.logout();
Console.WriteLine("\n\nHit Enter to close this window.");
Console.ReadLine();
一年后我回到了这段代码。我正在编写另一个高级搜索,并认为可能没有必要在数组定义中添加一个空白元素。那是个错误。这是绝对必要的!如果您省略这些,则搜索工作,但 SearchResult.basic 和 SearchResult.ItemJoin 只返回空值。
TransactionSearchAdvanced advanced = new TransactionSearchAdvanced()
{
columns = new TransactionSearchRow()
{
basic = new TransactionSearchRowBasic()
{
// new SearchColumnSelectField() is required!!!!!!
internalId = new SearchColumnSelectField[] { new SearchColumnSelectField() }
}
,
itemJoin = new ItemSearchRowBasic()
{
// new SearchColumnSelectField() is required!!!!!!
externalId = new SearchColumnSelectField[] { new SearchColumnSelectField() }
}
}
}