Methods
include(scriptPath)
- Description:
Inserts the content of the JSS script file at the given path into the script file that calls the function. The scope of the script is the same as the scope from which the function was called.
- Source:
Parameters:
Name | Type | Description |
---|---|---|
scriptPath |
String | path of JSS script file. |
publish(name, funcOrObj, instructionsopt)
- Description:
Adds the given object (usually a function) to the global scope using the given name. If the published object is a function then it will be made available via RPC unless 'serverOnly' is supplied in the instructions argument.
Functions declared in the global scope and those referenced by
publish
(without theserverOnly
flag) are automatically made available via RPC when the URL of the.jss
file in which they're defined are referenced by allowed<script>
tag in HTML. The Javascript code required to call them is automatically generated by CompleteFTP. Refer to JSS Web-App Basics for more information.The following example illustrates some usages:
function globalFunction() { } (function () { function publishedFunction() { } function serverOnlyFunction() { } function internalFunction() { } publish("publishedFunction", publishedFunction); publish("serverOnlyFunction", serverOnlyFunction, { serverOnly: true }); }());
Both
globalFunction()
andpublishedFunction()
are available for RPC, the former because it's a global function and the latter because it's published using thepublish
function. NeitherinternalFunction()
andserverOnlyFunction()
are not available via RPC, butserverOnlyFunction()
may be called by any other.jss
file that includes it using the include function because it's published with theserverSide
flag.
- Source:
Parameters:
Name | Type | Attributes | Description | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
name |
String | Name via which the object is to be referenced |
|||||||||||||
funcOrObj |
FunctionOrObject | Object or function to be published |
|||||||||||||
instructions |
Object |
<optional> |
Specifies how the object is to be published. Properties
|
Type Definitions
ChangeConfigCallback(config)
Parameters:
Name | Type | Description |
---|---|---|
config |
Config | Object encapsulating the CompleteFTP configuration. |
Connection
- Description:
Connection information.
- Source:
Properties:
Name | Type | Description |
---|---|---|
sessionID |
String | ID of session to which the connection belongs. |
siteID |
String | ID of site that the connection is connected to. |
connectTime |
Date | Time when the connection was established. |
loginTime |
Date | Time when the client logged in. |
userName |
String | Username of the session. |
siteName |
String | Name of site that the connection is connected to. |
localPort |
Number | Local port that that the connection is connected to. |
remoteAddress |
String | IP address of client. |
remotePort |
Number | Port of client end of the connection. |
protocol |
String | Protocol being used. |
diskUsage |
Number | Disk usage (null if no quota is set for the user). |
Connection information.
Type:
- Object
FileInfo
Properties:
Name | Type | Description |
---|---|---|
name |
String | Name of the file or folder |
length |
Number | Length of the file (0 if folder) |
isDirectory |
Boolean | Is this a folder? |
modified |
Date | Date when the file (or folder - excluding contents) was last modified. |
permissions |
String | Permissions of the file or folder. |
owner |
String | Name of the user account which owns the file or folder. |
group |
String | Name of the group to which the folder belongs. |
Represents a single file or folder in a file listing
Type:
- Object
HttpConfiguration
Properties:
Name | Type | Description |
---|---|---|
params |
Object | Query arguments. These may alternatively be included in the |
timeout |
Number | Timeout in milliseconds. |
headers |
Object | HTTP headers. |
contentType |
Object | MIME type. |
Configuration of HTTP request
Type:
- Object
HttpResponse
Properties:
Name | Type | Description |
---|---|---|
body |
String | The body of the response |
status |
HttpResponseStatus | The response code and its description |
Encapsulates the response to a HTTP request.
Type:
- Object
HttpResponseStatus
Properties:
Name | Type | Description |
---|---|---|
code |
number | The response code |
description |
String | The response description |
Encapsulates the status of an HTTP response
Type:
- Object
IdentityProvider
Properties:
Name | Type | Description |
---|---|---|
name |
String | Name of the IDP. |
id |
String | Identifier of the IDP (usually its URL). |
Contains information about an SAML IDP (IDentity Provider)
Type:
- Object
PublicKeyInfo
Properties:
Name | Type | Description |
---|---|---|
type |
String | The algorithm of the key: DSA, RSA, ECDSAsha2Nistp256, ECDSAsha2Nistp384 or ECDSAsha2Nistp512. |
fingerprint |
String | The fingerprint of the key. |
encodedKey |
String | The same key encoded in OpenSSH format (no comment included). |
Public key information.
Type:
- Object
ShareConfig
- Description:
Specifies how the file is to be shared, as well as its size.
- Source:
Properties:
Name | Type | Description |
---|---|---|
expiryDateUTC |
Date | Expiry date of the share (UTC). |
expectedFileSize |
Number | Size of the file to be shared. |
password |
String | (Optional) password of the share. If no password is provided then the file is shared without a password. |
Specifies how the file is to be shared, as well as its size.
Type:
- Object
ShareDirectoryPaths
- Description:
Directory paths related to sharing.
- Source:
Properties:
Name | Type | Description |
---|---|---|
globalShareDirectoryPath |
String | The virtual file-system path of the sharing index (usually /Shares). |
userShareDirectoryPath |
String | The path of the user's shared files (usually /Home/UserName/Shares). |
Directory paths related to sharing.
Type:
- Object
ShareInfo
- Description:
Contains all information about a shared file.
- Source:
Properties:
Name | Type | Description |
---|---|---|
fileName |
String | Name of the file. |
sharePath |
String | Path of the share within the virtual file-system. This, appended to the hostname, is the sharing URL. |
id |
String | Unique identifier of the share file (last part of the sharePath) |
expectedFileSize |
Number | Size of the file once it's fully uploaded. |
actualFileSize |
Number | Current size of the file on the server (it may be less than the expectedFileSize if it hasn't finished uploading). |
expiryDateUTC |
Date | Expiry date of the sharing (UTC) or null of the file is not shared. |
modifiedDateUTC |
Date | Time when the sharing information was last modified (note this is not the same as the modification time of the file itself). |
createdDateUTC |
Date | Time when the sharing information was created. |
fileModifiedDateUTC |
Date | Time when the file was last modified (note this is different from the modification time of the share). |
Contains all information about a shared file.
Type:
- Object
SingleSignOn
Properties:
Name | Type | Description |
---|---|---|
enabled |
Boolean | Is SAML SSO enabled? |
path |
String | Path under which SAML requests are processed (usually /SAML). |
identityProviders |
Array.<IdentityProvider> | Array of SAML IDPs (IDentity Providers). |
Contains information about SAML Single Sign-On (SSO).
Type:
- Object
SiteCertificate
- Description:
Provides access to JWK objects representing the site's certificate and that certificate's public key, as well as methods for decrypting and encrypting strings with the certificate's private key.
- Source:
Properties:
Name | Type | Description |
---|---|---|
toJWK |
function | Returns the site certificate as a JWK object. |
publicKeyToJWK |
function | Returns the site certificate's public key as a JWK object. |
decryptWithPrivateKey |
function | decrypts the given string using the site certificate's private key. |
encryptWithPrivateKey |
function | encrypts the given string using the site certificate's private key. |
Provides access to JWK objects representing the site's certificate and that certificate's public key, as well as methods for decrypting and encrypting strings with the certificate's private key.
Type:
- Object
SiteInfo
Properties:
Name | Type | Description |
---|---|---|
name |
String | Name of the site. This name is not shown to users. |
label |
String | Name of the site shown to users where required, such as in two-factor authentication (Enterprise Edition).. |
welcomeMessage |
String | Welcome-message of the site. |
singleSignOn |
SingleSignOn | Single Sign-on (SAML) settings. |
loginPath |
String | Path to the login page (usually /Login). |
publicAccessEnabled |
Boolean | True if public HTTP/HTTPS access is enabled on this site. |
httpEnabled |
Boolean | True if HTTP is enabled on this site. |
httpsEnabled |
Boolean | True if HTTPS is enabled on this site. |
sharingEnabled |
Boolean | True if sharing is enabled on this site. |
tfaEnabled |
Boolean | True if two-factor authentication is enabled on this site. |
allowOverWriteOnRename |
Boolean | True if existing files with same names will be overwritten when renaming. |
logoutPath |
String | Path to the logout page (usually /Logout). |
accountPath |
String | Path to the account management page (usually /Account) |
includePath |
String | Path to the include folder (usually /Invluce) |
certificate |
SiteCertificate | Site certificate. |
Contains information about a site
Type:
- Object