Api.Atelier.v7 provides version 7 APIs for Atelier More...

Inheritance diagram for v7:

[legend]

Collaboration diagram for v7:

[legend]

Static Public Member Functions
_.Library.Status	ExportToXMLFile (_.Library.String pNamespace)
	Api.Atelier.v7 provides version 7 APIs for Atelier More...

_.Library.Status	ListDocumentsInXMLFiles (_.Library.String pNamespace)
	This method gets the names and timestamps of documents contained in legacy XML files. More...

_.Library.Status	LoadXMLFiles (_.Library.String pNamespace)
	This method loads and optionally compiles the selected documents within legacy XML files. More...

Static Public Member Functions inherited from v6
_.Library.Status	Query (_.Library.String pNamespace)
	Api.Atelier.v6 provides version 6 APIs for Atelier More...

Static Public Member Functions inherited from v5
_.Library.Status	RunDebugger ()
	Api.Atelier.v5 provides version 5 APIs for Atelier

Static Public Member Functions inherited from v4
_.Library.Status	GetDoc (_.Library.String pNamespace, _.Library.String pDocName)
	Api.Atelier.v4 provides version 4 APIs for Atelier More...

_.Library.Status	Index (_.Library.String pNamespace)
	This method returns the indices for the all the specified documents in the namespace. More...

Static Public Member Functions inherited from v2
_.Library.Status	GetCSPDebugId ()
	Api.Atelier.v2 provides version 2 APIs for Atelier More...

_.Library.Status	GetMacroDefinition (_.Library.String pNamespace)
	Input request: More...

_.Library.Status	GetMacroExpansion (_.Library.String pNamespace)
	Input request: More...

_.Library.Status	GetMacroList (_.Library.String pNamespace)
	Input request: More...

_.Library.Status	GetMacroLocation (_.Library.String pNamespace)
	Input request: More...

_.Library.Status	GetMacroSignature (_.Library.String pNamespace)
	Input request: More...

_.Library.Status	PutDoc (_.Library.String pNamespace, _.Library.String pDocName)
	This method saves the supplied document. More...

_.Library.Status	Search (_.Library.String pNamespace)
	This method searches a set of documents using a Regular Expression or a text string. More...

Static Public Member Functions inherited from v1
_.Library.Status	Compile (_.Library.String pNamespace)
	Api.Atelier.v1 provides version 1 APIs for Atelier More...

_.Library.Status	CvtClientDocToXml (_.Library.String pNamespace)
	This method converts a client Doc to the corresponding XML. More...

_.Library.Status	CvtXmlToClientDoc (_.Library.String pNamespace)
	This method converts a XML to the corresponding client document format. More...

_.Library.Status	DeleteDoc (_.Library.String pNamespace, _.Library.String pDocName)
	This method deletes the named document in the specified namespace. More...

_.Library.Status	DeleteDocs (_.Library.String pNamespace)
	This method deletes the list of named documents which is passed in the body of the http request. More...

_.Library.Status	GetAdpInputOutputClass (_.Library.String pNamespace, _.Library.String pAdpName)
	This method returns the input and output type for the adapter. More...

_.Library.Status	GetCSPApps (_.Library.String pNamespace)
	This method returns a list csp apps defined on the server (or namespace) More...

	GetDocNames (_.Library.String pNamespace, pCat, pType)
	This method returns a list of document names. More...

_.Library.Status	GetDocs (_.Library.String pNamespace)
	This method returns the text for the all the specified documents in the namespace. More...

_.Library.Status	GetEnsClassType (_.Library.String pNamespace, _.Library.Integer pClassType)
	This method returns a list of Ensemble class names. More...

_.Library.Status	GetJobs ()
	This method returns a list of running jobs in the InterSystems IRIS instance. More...

_.Library.Status	GetMetaData (_.Library.String pDataBaseName)
	This method returns the binary contents of the METADATA.zip file for the named database. More...

_.Library.Status	GetModifiedDocNames (_.Library.String pNamespace, _.Library.String pType)
	This method is passed a list of database keys and hashes as a json array. More...

_.Library.Status	GetNamespace (pNamespace)
	This method returns information about a specific namespace. More...

_.Library.Status	HeadDoc (_.Library.String pNamespace, _.Library.String pDocName)
	This method returns the HttpHeader for the named document and namespace. More...

Static Public Member Functions inherited from REST
_.Library.Status	Http500 (_.Exception.AbstractException pE)
	Use our special format Http500 handler.

_.Library.Status	Page (_.Library.Boolean skipheader)
	Sets the response's localization domain (something that CSP.REST should do, in theory) and then invokes default super class behavior.

_.Library.Status	RenderResponseBody (_.Library.Status pStatus, _.Library.DynamicArray pMsgPart, _.Library.DynamicObject pResPart)
	Render the three-part Response Body which contains an status, console, and a result part.

_.Library.Status	ReportHttpStatusCode (pHttpStatus, _.Library.Status pSC)
	User our special format handler for other status codes.

_.Library.Status	ServeDoc (_.Library.String pDocName, _.Library.Status pStatus, _.Library.DynamicArray pMsgArray, _.Library.String pResArray, _.Library.String pTimeStamp, _.Library.Boolean pUpToDate, _.Library.DynamicObject pExtensionContent)
	This private helper method server wraps the message and document and returns it to the caller.

_.Library.Status	ServeXml (_.Library.String pDocName, _.Library.Status pStatus, _.Library.DynamicArray pMsgArray, _.Library.Stream pStream, _.Library.String pTimeStamp)
	This private helper method server wraps the message and document and returns it to the caller.

	SetClientServerHash (_.Library.String pHash)
	Set the clients version of the server hash.

Static Public Member Functions inherited from REST
_.Library.Boolean	AcceptsContentType (_.Library.String pType)
	This method tests the HTTP_ACCEPT header and returns true if. More...

_.Library.Status	AccessCheck (_.Library.Boolean pAuthorized)
	This method performs a basic access check. More...

_.Library.Status	DispatchRequest (_.Library.String url, _.Library.String method, _.Library.Boolean forwarded, args)
	Dispatch a REST request according to URL and Method. More...

_.Library.Status	Error (_.Library.Boolean skipheader)
	Called for a REST page in the event of an error being trapped by CSP server.

_.Library.String	GetAuthChallenge ()
	This method determines what challenge will be sent with a 401 (Unauthorized) response. More...

_.Library.Status	Http403 (_.Library.Status pSC)
	Issue a '403' error (Deprecated, use ..ReportHttpStatusCode)

_.Library.Status	Http404 (_.Library.Status pSC)
	Issue a '404' error (Deprecated, use ..ReportHttpStatusCode)

_.Library.Status	Http405 (_.Library.String pSupportedVerbs)
	Issue a '405' error ( user can override)

_.Library.Status	Login (_.Library.Boolean skipheader)
	Called for a REST page in the event of a login being required.

_.Library.Status	OnPreDispatch (_.Library.String pUrl, _.Library.String pMethod, _.Library.Boolean pContinue)
	This method gets called prior to dispatch of the request. More...

	SetResponseHeaderIfEmpty (_.Library.String pHeader, _.Library.String pValue)
	This utility method sets a response header only if it currently does not have a value.

_.Library.Status	StatusToJSON (_.Library.Status pSC, _.Library.DynamicObject pJSON)
	Render a Status as JSON.

_.Library.Status	StatusToProxyObject (_.Library.Status pSC, _.ZEN.proxyObject pJSON)
	Render a Status as JSON (in the form of an array of objects representing each status value).

_.Library.Status	SupportedVerbs (pUrl, _.Library.String pVerbs)
	This generator creates the SupportedVerbs Method used to determine supported verbs to return for the OPTIONS request.

Static Public Member Functions inherited from Login
	DrawCSS3STYLE ()
	Draw the style definitions for the login page. More...

	DrawHEAD (pTitle)
	Draw the HEAD section of the login page. More...

	DrawSTHEAD ()
	Draw the HEAD section of the security token page. More...

	DrawSTTitle (_.Library.String pTitle)
	Draw the title section of the security token page. More...

	DrawSTYLE ()
	Draw the style definitions for the login page. More...

	DrawTitle (_.Library.String pTitle)
	Draw the title section of the login page. More...

	DrawTitleSection (_.Library.String msgs)
	Draw the title section of the page. More...

_.Library.Status	OnHandleCorsRequest (_.Library.String url)
	This is the CORS request handler. More...

_.Library.Status	OnHandleOptionsRequest (_.Library.String url)
	This methods provides handling of the options request for this CSP application. More...

_.Library.Status	OnPage ()
	Output the default login page as HTML.

_.Library.Boolean	OnPreHTTP ()
	Determine if we need login CSRF tokens and if so add them. More...

Static Public Member Functions inherited from Page
_.Library.Status	ConvertParameter (_.Library.String url, _.Library.String name, _.Library.String value)
	You pass this the <parameter>url</parameter> of the page you are going to and a. More...

_.Library.Binary	Decrypt (_.Library.String data)
	Decrypts the input string using the session.Key value that is unique to. More...

_.Library.String	Encrypt (_.Library.Binary data)
	Encrypts the input string using the session.Key value that is unique to this. More...

_.Library.String	EscapeHTML (in)
	This method converts input HTML text into Escaped HTML text.

_.Library.String	EscapeURL (_.Library.String in, _.Library.String charset)
	This method converts the in input URL string into Escaped URL string. More...

_.Library.String	HyperEventCall (_.Library.String methodName, _.Library.String args, _.Library.Integer type, _.Library.Boolean mobile)
	This method returns the string that needs to be written to the current. More...

_.Library.String	HyperEventHead (_.Library.Boolean iframeOnly, _.Library.Boolean strict, _.Library.Boolean optionalBroker)
	This method returns the string that needs to be written to the current. More...

	Include (_.Library.String url)
	Include another csp page or file in the output at this point. More...

_.Library.String	InsertHiddenField (_.Library.String url, _.Library.String name, _.Library.String value, _.Library.String extra)
	Inserts a '<input type="hidden" name="Name" value="Value">' tag into the current document. More...

_.Library.String	InsertHiddenFields (_.Library.String url, _.Library.String query)
	Return the string containing the hidden form tags. More...

_.Library.Boolean	IsPrivate ()
	Returns 1 if this page is in fact a private page (see <parameter>PRIVATE</parameter>).

_.Library.String	Link (_.Library.String link, _.Library.String query, _.Library.Boolean addQ)
	Tranforms the link specified by link into a URL and returns it as a string. More...

_.Library.Status	OnHTTPHeader (_.Library.Boolean OutputBody)
	Event handler for PAGE event: this is invoked in order to More...

	OnPageError (_.Library.Status sc)
	Event handler for any error that occurs on the page. More...

	OnPostHTTP ()
	Event handler for POSTPAGE event: this is invoked after the data. More...

_.Library.Status	OnPostHyperEvent (_.Library.String class, _.Library.String method)
	Event handler which is invoked after a hyperevent method is called on this page.

_.Library.Status	OnPreHyperEvent (_.Library.String class, _.Library.String method)
	Event handler which is invoked before a hyperevent method is called on this page. More...

_.Library.String	QuoteJS (in)
	This method converts input string into quoted JavaScript literal.

_.Library.String	RewriteURL (_.Library.String url)
	This method will rewrite a URL to use #url()# if needed.

	ShowError (_.Library.Status sc)
	Display a <class>Status</class> error code to the CSP Page.

	StartTimer (_.Library.String name)
	Used to get performance information on your CSP pages. More...

	StopTimer (_.Library.String name)
	Used to time performance information on your CSP pages. More...

	ThrowError (_.Library.Status sc)
	Passed a <class>Status</class> code this goes to the error page passing this status code.

_.Library.String	UnescapeHTML (in)
	This method converts Escaped HTML text into normal HTML text.

_.Library.String	UnescapeURL (_.Library.String in, _.Library.String charset)
	This method converts the in Escaped URL string back to its original form. More...

Additional Inherited Members
Static Public Attributes inherited from REST
	DOMAIN = None
	Atelier.REST classes are unlikely to actually define messages with $$$Text More...

Static Public Attributes inherited from REST
	HandleCorsRequest = None
	This parameter influences the CORS support. More...

	TokenLoginEndpoint = None
	If the REST application is using token authentication, then this parameter gives the path to use for the "login" endpoint. More...

	TokenLogoutEndpoint = None
	If the REST application is using token authentication, then this parameter gives the path to use for the "logout" endpoint. More...

	TokenRefreshEndpoint = None
	If the REST application is using token authentication, then this parameter gives the path to use for the "refresh" endpoint. More...

	TokenRevokeEndpoint = None
	If the REST application is using token authentication, then this parameter gives the path to use for the token revocation endpoint. More...

	UseSession = None
	This parameter controls the CSP session support. More...

Static Public Attributes inherited from Login
	DOMAIN = None
	Provide a default login and security-token pages for CSP applications. More...

	FAVORITEICON = None
	Home favorite icon.

	HandleCorsRequest = None
	This parameter influences the CORS support for the CSP application that has this login page assigned. More...

	LOGINTITLE = None
	Title displayed for login page. More...

	STYLESHEET = None
	Name of stylesheet used for login page. More...

Static Public Attributes inherited from Page
	CHARSET = None
	The <CLASS>CSP.Page</CLASS> object serves as an event handler for CSP requests. More...

	CONTENTTYPE = None
	Specifies the default content type for the page. More...

	CONVERTINPUTSTREAM = None
	Specifies if input request.Content or request.MimeData values are converted from their. More...

	CSPFILE = None
	If this page was compiled from a .csp file, then this parameter contains the. More...

	CSPSTRICT = None
	The CSPSTRICT parameter is set to 1, if the DOCTYPE indicates that this. More...

	CSPURL = None
	This parameter is used to make sure that if multiple. More...

	CSPXHTML = None
	The CSPXHTML parameter is set to 1, if the DOCTYPE indicates that this. More...

	DOMAIN = None
	The default domain for csp:text, span and div tags. More...

	ENCODED = None
	Controls how the query parameters for this page are passed, it can. More...

	ERRORPAGE = None
	Specify a custom error page to call if there are any problems with generating this page. More...

	EXPIRES = None
	Specified the default value for the response.Expires. More...

	NOCHARSETCONVERT = None
	Specifies if we wish to turn off charset conversion for this page. More...

	PAGETIMING = None
	If this parameter is true then we automatically record timing statistics of how long it takes to. More...

	PRIVATE = None
	Controls the access to the page, it can be set to one of the following: More...

	SECURITYRESOURCE = None
	This is a comma-delimited list of system Resources and associated. More...

	TIMINGSLOTS = None
	Used by the timing to decide how many slots a day should be divided up into. More...

	UseSession = None
	This parameter controls the CSP session support. More...

Detailed Description

Api.Atelier.v7 provides version 7 APIs for Atelier

Member Function Documentation

◆ ExportToXMLFile()

_.Library.Status ExportToXMLFile ( _.Library.String pNamespace )

static

Api.Atelier.v7 provides version 7 APIs for Atelier

This method gets the text of one or more documents in a single legacy XML file.

The method expects a content body to be encoded in JSON and contain an
array of items (document names) to be exported. Note that items may also
use ? or * wild cards and if you wish to exclude items pass ' before the item name:

    [ "User.Test.cls", "abc*.mac" ]

HTTP Codes returned:-

HTTP 200 if OK
HTTP 400 if the posted content is empty or not valid json
HTTP 415 if content type is not application/json
HTTP 500 if an error occurs (details will be in status error array)

Returned content is an array of lines of the legacy XML file:

    {
      "status": {
        "errors": [],
        "summary": ""
      },
      "console": [],
      "result": {
        "content": [
          "&lt;?xml version="1.0" encoding="UTF-8"?&gt;",
          ...
        ]
      }
    }

◆ ListDocumentsInXMLFiles()

_.Library.Status ListDocumentsInXMLFiles ( _.Library.String pNamespace )

static

This method gets the names and timestamps of documents contained in legacy XML files.

The method expects a content body to be encoded in JSON and contain an array of objects, one for each XML file. Each object must contain a string to identify the file (for example, its filesystem path) and a content array containing the lines of the file:

    [
      {
        "file": "/path/to/file.xml",
        "content": [
          "&lt;?xml version="1.0" encoding="UTF-8"?&gt;",
          ...
        ]
      }
    [

HTTP Codes returned:-

HTTP 200 if OK
HTTP 400 if the posted content is empty or not valid json
HTTP 415 if content type is not application/json
HTTP 500 if an error occurs (details will be in status error array)

Return content is an array of objects, one per XML file. Each object contains the identifier of the XML file, an array containing the names and timestamps of the documents, and a status string if an error occurred while processing it:

    {
      "status": {
        "errors": [],
        "summary": ""
      },
      "console": [],
      "result": {
        "content": [
          {
            "file": "/path/to/file.xml",
            "status": "",
            "documents": [
              {
                "name": "User.Test.cls",
                "ts": "2016-01-04 14:00:04.000"
              }
            ]
          }
        ]
      }
    }

NOTE: If you are experiencing timeouts using this method, consider calling method Load() in class <CLASS>SYSTEM.OBJ</CLASS> from a terminal instead.

◆ LoadXMLFiles()

_.Library.Status LoadXMLFiles ( _.Library.String pNamespace )

static

This method loads and optionally compiles the selected documents within legacy XML files.

The method expects a content body to be encoded in JSON and contain an array of objects, one for each XML file. Each object must contain a string to identify the file (for example, its filesystem path) and a content array containing the lines of the file. An array of specific documents to import may be provided. If omitted, all documents in the XML file are imported:

    [
      {
        "file": "/path/to/file.xml",
        "content": [
          "&lt;?xml version="1.0" encoding="UTF-8"?&gt;",
          ...
        ],
        "selected": [
          "User.Test.cls"
        ]
      }
    [

HTTP Codes returned:-

HTTP 200 if OK
HTTP 400 if the posted content is empty or not valid json
HTTP 415 if content type is not application/json
HTTP 500 if an error occurs (details will be in status error array)

The URL parameter ?flags=<string> can be passed to modify the load
behavior. The list of supported flags or qualifiers can be displayed with
'Do $system.OBJ.ShowQualifiers()' and 'Do $system.OBJ.ShowFlags()'.

Return content is an array of objects, one per XML file. Each object contains the identifier of the XML file, an array containing the names of all documents from that file that were successfully imported, and a status string if an error occurred while importing it:

    {
      "status": {
        "errors": [],
        "summary": ""
      },
      "console": [],
      "result": {
        "content": [
          {
            "file": "/path/to/file.xml",
            "status": "",
            "imported": [
              "User.Test.cls"
            ]
          }
        ]
      }
    }

NOTE: If you are experiencing timeouts using this method, consider calling method Load() in class <CLASS>SYSTEM.OBJ</CLASS> from a terminal instead.

Static Public Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ ExportToXMLFile()

◆ ListDocumentsInXMLFiles()

◆ LoadXMLFiles()