Child pages
  • PutRequest
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 16 Next »

Refresh page Mar 29, 2024 01:02

Supported Clients
SmartClient WebClient NGClient

Methods Summary
Boolean addFile(parameterName, jsFile) Add a file to the post.
Boolean addFile(parameterName, fileName, jsFile) Add a file to the post.
Boolean addFile(parameterName, fileName, fileLocation) Add a file to the post.
Boolean addHeader(headerName, value) Add a header to the request.
Boolean addParameter(name, value) Add a parameter to the post.
void executeAsyncRequest(username, password, workstation, domain, successCallbackMethod, errorCallbackMethod) Execute the request method asynchronous using windows authentication.
void executeAsyncRequest(username, password, successCallbackMethod, errorCallbackMethod) Execute the request method asynchronous.
void executeAsyncRequest(successCallbackMethod, errorCallbackMethod) Execute the request method asynchronous.
Response executeRequest() Execute the request method.
Response executeRequest(userName, password) Execute the request method.
Response executeRequest(userName, password, workstation, domain) Execute a request method using windows authentication.
void setBodyContent(content) Set the body of the request.
void setBodyContent(content, mimeType) Set the body of the request and content mime type.
void setCharset(charset) Set the charset used when posting.
Boolean setFile(file) Set a file to put.
Boolean setFile(filePath) Set a file to put.

Methods Details

addFile(parameterName, jsFile)

Add a file to the post.

Parameters

String parameterName ;
Object jsFile ;

Returns

Supported Clients

SmartClient,WebClient,NGClient

Sample

poster.addFile('myFileParamName','manual.doc','c:/temp/manual_01a.doc')
poster.addFile(null,'postXml.xml','c:/temp/postXml.xml') // sets the xml to post

var f = plugins.file.convertToJSFile('./somefile02.txt')
if (f && f.exists()) poster.addFile('myTxtFileParamName','somefile.txt', f)

f = plugins.file.convertToJSFile('./anotherfile_v2b.txt')
if (f && f.exists()) poster.addFile('myOtherTxtFileParamName', f)

addFile(parameterName, fileName, jsFile)

Add a file to the post.

Parameters

String parameterName ;
String fileName ;
Object jsFile ;

Returns

Supported Clients

SmartClient,WebClient,NGClient

Sample

poster.addFile('myFileParamName','manual.doc','c:/temp/manual_01a.doc')
poster.addFile(null,'postXml.xml','c:/temp/postXml.xml') // sets the xml to post

var f = plugins.file.convertToJSFile('./somefile02.txt')
if (f && f.exists()) poster.addFile('myTxtFileParamName','somefile.txt', f)

f = plugins.file.convertToJSFile('./anotherfile_v2b.txt')
if (f && f.exists()) poster.addFile('myOtherTxtFileParamName', f)

addFile(parameterName, fileName, fileLocation)

Add a file to the post.

Parameters

String parameterName ;
String fileName ;
String fileLocation ;

Returns

Supported Clients

SmartClient,WebClient,NGClient

Sample

poster.addFile('myFileParamName','manual.doc','c:/temp/manual_01a.doc')
poster.addFile(null,'postXml.xml','c:/temp/postXml.xml') // sets the xml to post

var f = plugins.file.convertToJSFile('./somefile02.txt')
if (f && f.exists()) poster.addFile('myTxtFileParamName','somefile.txt', f)

f = plugins.file.convertToJSFile('./anotherfile_v2b.txt')
if (f && f.exists()) poster.addFile('myOtherTxtFileParamName', f)

addHeader(headerName, value)

Add a header to the request.

Parameters

String headerName ;
String value ;

Returns

Supported Clients

SmartClient,WebClient,NGClient

Sample

method.addHeader('Content-type','text/xml; charset=ISO-8859-1')

addParameter(name, value)

Add a parameter to the post.

Parameters

String name ;
String value ;

Returns

Supported Clients

SmartClient,WebClient,NGClient

Sample

poster.addParameter('name','value')
poster.addParameter(null,'value') //sets the content to post

executeAsyncRequest(username, password, workstation, domain, successCallbackMethod, errorCallbackMethod)

Execute the request method asynchronous using windows authentication. Success callback method will be called when response is received. Response is sent as parameter in callback. If no response is received (request errors out), the errorCallbackMethod is called with exception message as parameter.

Parameters

String username the user name
String password the password
String workstation The workstation the authentication request is originating from.
String domain The domain to authenticate within.
Function successCallbackMethod callbackMethod to be called after response is received
Function errorCallbackMethod callbackMethod to be called if request errors out

Supported Clients

SmartClient,WebClient,NGClient

Sample

method.executeAsyncRequest('username','password','mycomputername','domain',globals.successCallback,globals.errorCallback)

executeAsyncRequest(username, password, successCallbackMethod, errorCallbackMethod)

Execute the request method asynchronous. Success callback method will be called when response is received. Response is sent as parameter in callback. If no response is received (request errors out), the errorCallbackMethod is called with exception message as parameter.

Parameters

String username the user name
String password the password
Function successCallbackMethod callbackMethod to be called after response is received
Function errorCallbackMethod callbackMethod to be called if request errors out

Supported Clients

SmartClient,WebClient,NGClient

Sample

method.executeAsyncRequest(globals.successCallback,globals.errorCallback)

executeAsyncRequest(successCallbackMethod, errorCallbackMethod)

Execute the request method asynchronous. Success callback method will be called when response is received. Response is sent as parameter in callback. If no response is received (request errors out), the errorCallbackMethod is called with exception message as parameter.

Parameters

Function successCallbackMethod callbackMethod to be called after response is received
Function errorCallbackMethod callbackMethod to be called if request errors out

Supported Clients

SmartClient,WebClient,NGClient

Sample

method.executeAsyncRequest(globals.successCallback,globals.errorCallback)

executeRequest()

Execute the request method.

Returns

Supported Clients

SmartClient,WebClient,NGClient

Sample

var response = method.executeRequest()

To be able to reuse the client, the response must be
closed if the content is not read via getResponseBody
 or getMediaData:

response.close()

executeRequest(userName, password)

Execute the request method.

Parameters

String userName the user name
String password the password

Returns

Supported Clients

SmartClient,WebClient,NGClient

Sample

var response = method.executeRequest()

To be able to reuse the client, the response must be
closed if the content is not read via getResponseBody
 or getMediaData:

response.close()

executeRequest(userName, password, workstation, domain)

Execute a request method using windows authentication.

Parameters

String userName the user name
String password the password
String workstation The workstation the authentication request is originating from.
String domain The domain to authenticate within.

Returns

Supported Clients

SmartClient,WebClient,NGClient

Sample

var response = method.executeRequest('username','password','mycomputername','domain');

setBodyContent(content)

Set the body of the request.

Parameters

String content ;

Supported Clients

SmartClient,WebClient,NGClient

Sample

method.setBodyContent(content)

setBodyContent(content, mimeType)

Set the body of the request and content mime type.

Parameters

String content ;
String mimeType ;

Supported Clients

SmartClient,WebClient,NGClient

Sample

method.setBodyContent(content, 'text/xml')

setCharset(charset)

Set the charset used when posting. If this is null or not called it will use the default charset (UTF-8).

Parameters

Object charset ;

Supported Clients

SmartClient,WebClient,NGClient

Sample

var client = plugins.http.createNewHttpClient();
var poster = client.createPostRequest('https://twitter.com/statuses/update.json');
poster.addParameter('status',scopes.globals.textToPost);
poster.addParameter('source','Test Source');
poster.setCharset('UTF-8');
var httpCode = poster.executeRequest(scopes.globals.twitterUserName, scopes.globals.twitterPassword).getStatusCode() // httpCode 200 is ok

setFile(file)

Set a file to put.

Parameters

Object file ;

Returns

Supported Clients

SmartClient,WebClient,NGClient

Sample

putRequest.setFile(jsFileInstance)

setFile(filePath)

Set a file to put.

Parameters

String filePath ;

Returns

Supported Clients

SmartClient,WebClient,NGClient

Sample

putRequest.setFile('c:/temp/manual_01a.doc')

  • No labels