A PowerServerLabel system object is used to group and send multiple requests to the server in merge mode.
As suggested by the object name, this object and its functions only take effect when the application is deployed via the PowerServer project. This object and its functions will not be executed or modify how the application works in the traditional client/server environment (they will be ignored when the application is deployed via the PowerClient project or the Application project).
Note
PowerServerLabel (as well as HTTPClient, CrypterObject, CoderObject, CompressorObject, DotNetAssembly, JSONGenerator, JSONParser, JSONPackage, OAuthClient, PDF Builder objects, RESTClient, SMTPClient, PowerServerResult) does not support multi-threading.
|
PowerServerLabel property |
Datatype |
Description |
|---|---|---|
|
MergeEnabled |
Boolean |
Enables the StartMerge and EndMerge functions. The default value is true. |
|
MaxMergeCalls |
Long |
Specifies the maximum number of merge calls that can be queued. The default is 100. This value helps prevent the application from using too many resources. When the limit is reached, the application throws an exception to indicate that no more merge calls can be accepted. Our tests show that setting MaxMergeCalls to a value higher than 10,000 can cause serious performance issues and may even lead to application crashes. For this reason, do not set this value above 10,000. |
|
ClassDefinition |
PowerObject |
An object of type PowerObject containing information about the class definition of the object or control. |
|
Results[] |
The result of the request merged operation. |
|
PowerServerLabel function |
Datatype returned |
Description |
|---|---|---|
|
String |
Returns the name assigned to the user object. |
|
|
Integer |
Indicates the merge mode stops and requests will be submitted immediately. |
|
|
Integer |
Creates a reference to a context-specific instance of the specified service. |
|
|
PowerObject |
Returns a reference to the name of the parent object. |
|
|
Boolean |
Adds an event to the end of the message queue of the user object. |
|
|
Integer |
Indicates the merge mode starts. |
|
|
Integer |
Sends an event to the user object and executes the script associated with the event. |
|
|
Object |
Returns the type of the user object. |
