version 11 (Modified)
AP Create method (methodName; propertiesArray; methodCode{; folderName}) Longint
Parameter | Type | Description | |
methodName | String (31) | Name of the method (31 chars) | |
propertiesArray | Longint Array | Array of properties (6 elements) | |
methodCode | BLOB | BLOB containing the method text | |
folderName | String | Explorer folder in which the method will be created | |
Function result | Longint | Error code (0=no error) |
Description
The AP Create method command lets you add a project method in a 4D database structure (interpreted databases only).
Pass the name of the method in methodName. This name can be up to 31 characters long. It can contain any combination of letters, numbers, spaces and underlines with respect to the standard 4D objects naming rules. If the name contains more than 31 characters, it will be truncated to 31.
The propertiesArray parameter allows defining the method properties. It must have been declared previously as a longint array and must contain 4 items:
pass 1 in propertiesArray{1} if the method must be visible and 0 if not.
pass 1 in propertiesArray{2} if the method must be available for 4DACTION, 4DMETHOD and 4DSCRIPT, and 0 if not.
pass 1 in propertiesArray{3} if the method must be offered as a Web Service and 0 if not.
in case of propertiesArray{3}=1, pass 1 in propertiesArray{4} if the method must be published in WSDL and 0 for the other cases.
pass 1 in propertiesArray{5} if the method must be shared between components and the host database, and 0 in the opposite case.
pass 1 in propertiesArray{6} if the method must be available via SQL, and 0 in the opposite case.
Pass a BLOB containing the text of the method in methodCode. If you use the TEXT TO BLOB command to fill the BLOB, pass C string (or 0) in the third parameter of this command.
In folderName, pass the name of the Explorer folder in which the method will be created. These folders are managed on the Home page of the Explorer window and allow you to organize the objects in a customized manner. This parameter is optional; if it is omitted, the method will be created in the "Default Project Methods" folder.
If the operation is completed successfully, the function returns 0. Otherwise, it returns an error code:
1 = A bad parameter type has been passed.
2 = The database is running in compiled mode.
3 = The method name is an empty string.
Note: This command does not work when it is executed from a compiled application that has been merged with 4D Desktop.
See Also