Service Providers Dialog
This dialog is designed to manage the Service Providers that you may receive orders from.
Use the list on the top of the form to switch providers, the Add button to add a new provider, the Update button to save changes to any data you might have modified and Delete to remove the entry from the list.
Info Tab
The Info tab contains the name of the service provider and its contact information such as address, e-mail, phone numbers etc. Make sure you enter the name of the provider correctly, otherwise RegKeeper might fail to parse orders sent from this provider.
Options Tab
The Service fee group defines the amount that the service provider charges for each order and the way that the charge is calculated.
A fixed percentage - the fee is a percent from the price of the product.
A fixed amount - the fee is a fixed amount, regardless of the price of the product.
But not less than - the charge is limited to (cannot be lower than) the amount specified.
The Parser Settings group defines the settings for parser to use when parsing order from this Service Provider.
Clean white spaces - if this option is checked, RegKeeper will replace consecutive spaces with a single space character.
Use regular expressions for parsing - if this option is checked, RegKeeper will use regular expressions defined in the Parser Indicators for parsing the order source.
Automatically generate order number - check to allow RegKeeper to automatically assign an order number, in the event that the original order number cannot be retrieved from the order. RegKeeper will search the database to find the highest order number, will increase it by one, and assign it to the order being parsed.
Skip header when numbering lines - check to instruct RegKeeper to skip e-mail header lines from the order source. The header is separated from the message's source by an empty line.
Decimal separator - the symbol that the service provider uses as a decimal separator. Usually this is a period or a comma.
Thousands separator - the symbol that the service provider uses as a thousand separator. Usually this is a period or a comma.
Date/time format - select the date and time stamp that will be used for a new order: Internet date time - the time and date of the e-mail message received form the provider. Any other entry describes the time format that the provider uses in its orders.
Non-paid order indicator - type here the string which can be found in the order notification message source that indicates that this order wasn't paid. If this string is subsequently found in the order source, the order will be marked as Non-paid.
Use external DLL for parsing - activate this option if you will use the external DLL for parsing the order source. Be sure to specify the valid DLL file in External parser DLL field. In order to be able to use the external DLL for order parsing, the DLL should export the following functions:
Delphi syntax:
procedure InitializeParser(Content: PChar); stdcall;
function GetStrByIndicator(Indicator: PChar; Value: PChar; var ValueLen: DWORD): Boolean; stdcall;
procedure SetCurrentProduct(const Product: Integer); stdcall;
C++ syntax:
__declspec(dllexport) __stdcall void InitializeParser(char *Content);
__declspec(dllexport) __stdcall bool GetStrByIndicator(char *Indicator, char *Value, DWORD * ValueLen);
__declspec(dllexport) __stdcall void SetCurrentProduct(int *Product);
Content contains the full text of order to parse.
Indicator indicates the field for which the value should be returned.
Value is the buffer that must be filled with the parsed value.
ValueLen indicates the length of the returned value.
SetCurrentProduct will be called one time for every product in order. You can ignore this function if you don't use multiple products per order. Otherwise your DLL must internally update pointer to product information it will return upon request. When order has more than one product listed RegKeeper will call SetCurrentProduct() every time right before requesting ordered product details.
Translate umlauts - activate this option for translating accent characters like ä, ö, ß to ae, oe, ss and so on. This option was introduced in order to allow supporting of umlauts and other non-English characters in different locales and due to fact that some key generators don't support Unicode values for generating keys. Note: Don't use this option if you need to get actual values and your key generator supports Unicode.
Decode HTML encoded mails - activate this option in order to force the parser to perform HTML decode of the order message source before processing. This is useful when your order emails include any HTML encoded characters like =20, =3D and so on. Also if this option is ON Parser will UTF-8 decode returning value. This is done because most of the Service Providers encode Unicode data in order notification with UTF-8.
Indicators Tab
The Indicators table is used to define key strings that RegKeeper uses to locate indicators in the text of an incoming order. The table contains three columns. The Begins After and Ends Before columns contain the key strings that stand immediately before and after an indicator. The Line# should contain the line number where the indicator is located. If you leave this field empty, RegKeeper will search the whole order for this indicator. The Multiline field indicates that the returned string could be in several lines of the text. When you activate the Use regular expressions for parsing option, the first column will contain the regular expression for value, and the second column will contain the sub-expression number to use. The last column is not used in such a case.
Please check Indicators topic if you use Service Provider with multiple items per order!
When you add a new service provider, you have several options for filling in the Indicators table. You can do it manually, you can import it from a text file, or import it from RegKeeper's web-site. If the indicators for your new service provider are still not available, click Request indicators from the web link to request indicators from RegKeeper.
Notes Tab
Enter any additional information concerning the selected service provider.