Page Comparison

...

Web Page Upload Work Flow

1. Call StartWebPageUploadSession() using  using parameters for the webpage file and associated content files. Retrieve the initialized session and upload tokens from the WebPageUploadStatus return.
2. Call StartFileUpload() using  using parameters for the webpage file, as well as the session token and primary upload token from the WebPageUploadStatus return. Make sure to specify the [enum]ContentType as “Webpage”.
3. Call AppendChunk() for  for the number of times needed to complete the webpage file upload. Use the session token and primary upload token from the WebPageUploadStatus return.
4. Call CompleteFileUpload() using  using the same content upload arguments utilized in Step 2.
5. Repeat the following steps for each webpage asset file:
   1. Call StartFileUpload() using  using parameters for the asset file, as well as the session token and asset upload token from the WebPageUploadStatus return.
   2. Call AppendChunk() for  for the number of times needed to complete the asset file upload. Use the session token and asset upload token from the WebPageUploadStatus return.
   3. Call CompleteFileUpload() using  using the same content upload arguments utilized in Step 5a.
6. Call CompleteWebPageUploadSession() using  using the same content upload arguments utilized in Step 1.

...

1. Call StartWebPageUploadSession() using  using an existing [string]WebPageId parameter and arguments for the new webpage file. Retrieve the initialized session and upload tokens from the WebPageUploadStatus return.
2. Call StartFileUpload() using  using parameters for the new webpage file, as well as the session and upload tokens from the WebPageUploadStatus return. You will also need to specify the [string] ContentId (which is the same as the [string]WebPageId) of the webpage file to update. Ensure the [enum] ContentType is  is specified as “Webpage”.

3. Call AppendChunk() for  for the number of times needed to complete the webpage file upload. Use the session token and primary upload token from the WebPageUploadStatus return. 

   Note
   title Note
   When updating a webpage, the main HTML file must always be updated (even if changes are only being made to asset files).

4. Call CompleteFileUpload() using  using the same content upload arguments utilized in Step 2.
5. Repeat the following steps for each webpage asset file:
   1. Call StartFileUpload() using  using parameters for the asset file, as well as the session token and asset upload token from the WebPageUploadStatus return. The ContentUploadStatus return will contain an optional Content Negotiation response.
   2. If the Content Negotiation status matches the current asset, call CancelFileUpload() using  using the session and asset upload tokens.
   3. If the Content Negotiation status does not match the current asset:
      1. Call AppendChunk() for  for the number of times needed to complete the asset file upload. Use the session token and asset upload token from the WebPageUploadStatus return.
      2. Call CompleteFileUpload() using  using the same content upload arguments utilized in Step 5a.

...

Initializes the content upload process by returning an upload token, which is a descriptor value that is utilized by the AppendChunk() and  and CompleteFileUpload() methods methods. This method may also receive an upload token if it is being used to upload a webpage file.

...

Content: Upload Content

Parameters

• [string] uploadToken: The token of an upload that was initialized by the StartWebPageUploadSession() method method. This parameter is only specified if the file being uploaded is a webpage file.
• [string] sessionToken: The token of an upload session initialized by the StartWebPageUploadSession() method method. This parameter enables uploading of files related to a webpage file; it should only be specified if a webpage file or associated asset file is being uploaded.
• [string] filename: The name of the file to be uploaded. A descriptive error will be returned if any of the following conditions occur:
  • This string is empty.
  • The string has more than 128 characters.
  • The file name is not valid.
• [long] filesize: The size of the file in bytes. This parameter must be an unsigned integer value no greater than 5000000000 (i.e. 5GB). A descriptive error will be returned if the value is negative.
• [int] chunksCount: The number of chunks the file consists of (starting at 1). The optimal chunk size is 256KiB. Files that are larger than this chunk size must be split into smaller parts by the client. Multiple chunks should be uploaded using multiple AppendChunk() calls  calls specifying the same upload token.
• [enum: Auto, Image, Video, Audio, Webpage] contentType: The type of the content file. The default type is “Image”.
• [DateTime] fileLastModifiedDate: A value representing the last time the associated file was modified on the user storage (e.g. the "Date modified" value in Windows). This value can also be initialized later by modifying the Content entity.
• [string] virtualPath: The path in the BSN Library to which the file should be uploaded (the default is “\Shared\Incoming\”). If the path does not exist, it will be created. It must also contain leading and trailing slashes and be no longer than 128 characters.
• [base64Binary] fileThumb: The optional thumbnail data as a binary attachment. This parameter will be generated by the server if it is not specified.
• [string] sha1Hash: The SHA1 hash of the current file. The server performs verification of the uploaded file using the specified hash. A descriptive error will be returned if the specified hash does not match the hash value calculated by the server. This parameter is optional; the server-side hash verification process is skipped if this parameter is not specified.

...

Parameters

• [string] uploadToken: The token of the upload that was initialized by the StartFileUpload() or  or StartWebPageUpload() method method. A descriptive error is returned if the string value is empty or not specified.
• [string] sessionToken: The token of the upload session initialized by the StartWebPageUpload() method method. This token should only be provided if the client is uploading a set of webpage assets.
• [int] partNumber: The number of the part, starting from 0.
• [base64Binary] data: The binary data of the file chunk.
• [long] offset: The offset of the current file chunk. The first chunk has an offset of 0. A descriptive error is returned if the offset value is not positive.

...

Returns the Content ID of the uploaded file if file upload is successful. Otherwise, it returns a descriptive error. If a specified parameter is different between the StartFileUpload() and  and CompleteFileUpload() calls  calls on a file, the specification in the CompleteFileUpload() call  call will overwrite the original StartFileUpload() specification specification.

Required Permissions

Content: Upload Content

Parameters

• [string] uploadToken: The token of the upload that was initialized by the StartFileUpload() method. A descriptive error is returned if the string value is empty or not specified.
• [string] sessionToken: The token of the upload session initialized by the StartWebPageUpload() method. This token should only be provided if the client is uploading a set of webpage assets.
• [string] filename: The name of the uploaded file. A descriptive error will be returned if any of the following conditions occur:
  • This string is empty.
  • The string has more than 128 characters.
  • The file name is not valid.
• [long] filesize: The size of the video file in bytes. This parameter must be an unsigned integer value no greater than 5000000000 (i.e. 5GB). A descriptive error will be returned if the value is negative.
• [int] chunksCount: The number of chunks the file consists of (starting at 1). The optimal chunk size is 256KiB. Files that are larger than this chunk size must be split into smaller parts by the client. Multiple chunks should be uploaded using multiple AppendChunk() calls specifying the same upload token.
• [string] sha1Hash: The SHA1 hash of the current file. The server performs verification of the uploaded file using the specified hash. A descriptive error will be returned if the specified hash does not match the hash value calculated by the server. This parameter is optional; the server-side hash verification process is skipped if this parameter is not specified.
• [enum: Auto, Image, Video, Audio, Webpage] contentType: The type of the content file. The default type is Image.
• [DateTime] fileLastModifiedDate: A value representing the last time the associated file was modified on the user storage (e.g. the "Date modified" value in Windows). This value can also be initialized later by modifying the Content entity.
• [string] virtualPath: The path in the BSN Library to which the file should be uploaded (the default is “\Shared\Incoming\”). If the path does not exist, it will be created. It must also contain leading and trailing slashes and be no longer than 128 characters.
• [base64Binary] fileThumb: The optional thumbnail data as a binary attachment. This parameter will be generated by the server if it is not specified.

...

Initializes a session for uploading a set of webpage asset files. This method accepts a set of parameters for the HTML file similar to StartFileUpload(). It also accepts an array of parameters for each asset file associated with the webpage. If successful, this method will return a session token that will be utilized in each individual set of StartFileUpload()/CompleteFileUpload() transactions transactions.

This method will return a descriptive error if the size of the SOAP message (i.e. XML payload) is greater than 2MiB.

...

Content: Upload Content

Parameters

• [array] webpageAssets: An array of one or more sets of WebPageAssetUploadArguments, which can contain the following:
  • [string] filename: The name of the file to be uploaded. A descriptive error will be returned if any of the following conditions occur:
    • This string is empty.
    • The string has more than 128 characters.
    • The file name is not valid.
  • [long] filesize: The size of the file in bytes. This parameter must be an unsigned integer value no greater than 5000000000 (i.e. 5GB). A descriptive error will be returned if the value is negative.
  • [int] chunksCount: The number of chunks the file consists of (starting at 1). The optimal chunk size is 256KiB. Files that are larger than this chunk size must be split into smaller parts by the client. Multiple chunks should be uploaded using multiple AppendChunk() calls  calls specifying the same upload token.
  • [enum: Auto, Image, Video, Audio, Webpage] contentType: The type of the asset file. The default type is Image.
  • [string] virtualPath: The path in the BSN Library to which the file should be uploaded. If the path does not exist, it will be created. It must also contain leading and trailing slashes and be no longer than 128 characters.
  • [string] relativePath: The relative path of the associated asset file in relation to the webpage HTML file.
  • [string] sha1Hash: The SHA1 hash of the current file. The server performs verification of the uploaded file using the specified hash. A descriptive error will be returned if the specified hash does not match the hash value calculated by the server. This parameter is optional; the server-side hash verification process is skipped if this parameter is not specified.
  • [string] webpageAssetId 
• [string] filename: The name of the webpage file to be uploaded. A descriptive error will be returned if any of the following conditions occur:
  • This string is empty.
  • The string has more than 128 characters.
  • The file name is not valid.
• [long] filesize: The size of the webpage in bytes. This parameter must be an unsigned integer value no greater than 5000000000 (i.e. 5GB). A descriptive error will be returned if the value is negative.
• [int] chunksCount: The number of chunks the file consists of (starting at 1). The optimal chunk size is 256KiB. Files that are larger than this chunk size must be split into smaller parts by the client. Multiple chunks should be uploaded using multiple AppendChunk() calls  calls specifying the same upload token.
• [enum: Auto, Image, Video, Audio, Webpage] contentType: The type of the content file, which should be specified as “Webpage”.
• [string] virtualPath: The path in the BSN Library to which the file should be uploaded (the default is “\Shared\Incoming\”). If the path does not exist, it will be created. It must also contain leading and trailing slashes and be no longer than 128 characters.
• [base64Binary] fileThumb: The optional thumbnail data as a binary attachment. This parameter will be generated by the server if it is not specified.
• [string] sha1Hash: The SHA1 hash of the webpage file. The server performs verification of the uploaded file using the specified hash. A descriptive error will be returned if the specified hash does not match the hash value calculated by the server. This parameter is optional; the server-side hash verification process is skipped if this parameter is not specified.

WebPageUploadStatus CompleteWebPageUploadSession(array webpageAssets[], string sessionToken, string filename, long filesize, int chunksCount, enum ContentType, string virtualPath, base64Binary fileThumb, string sha1Hash)

Returns the Web Page ID of the uploaded webpage file if the upload session is successful. Otherwise, it returns a descriptive error. If a specified parameter is different between the StartWebPageUploadSession() and  and CompleteWebPageUploadSession() calls calls, the specification in the CompleteWebPageUploadSession() call  call will overwrite the original StartWebPageUploadSession() specification specification. This is true for both the webpage file and associated asset files.

...

Content: Upload Content

Parameters

• [array] webpageAssets: An array of one or more sets of WebPageAssetUploadArguments, which can contain the following:
  • [string] filename: The name of the file to be uploaded. A descriptive error will be returned if any of the following conditions occur:
    • This string is empty.
    • The string has more than 128 characters.
    • The file name is not valid.
  • [long] filesize: The size of the file in bytes. This parameter must be an unsigned integer value no greater than 5000000000 (i.e. 5GB). A descriptive error will be returned if the value is negative.
  • [int] chunksCount: The number of chunks the file consists of (starting at 1). The optimal chunk size is 256KiB. Files that are larger than this chunk size must be split into smaller parts by the client. Multiple chunks should be uploaded using multiple AppendChunk() calls  calls specifying the same upload token.
  • [enum: Auto, Image, Video, Audio, Webpage] contentType: The type of the asset file. The default type is Image.
  • [string] virtualPath: The path in the BSN Library to which the file should be uploaded. If the path does not exist, it will be created. It must also contain leading and trailing slashes and be no longer than 128 characters.
  • [string] RelativePath: The relative path of the associated asset file in relation to the webpage HTML file.
  • [string] sha1Hash: The SHA1 hash of the current file. The server performs verification of the uploaded file using the specified hash. A descriptive error will be returned if the specified hash does not match the hash value calculated by the server. This parameter is optional; the server-side hash verification process is skipped if this parameter is not specified.
  • [string] webpageAssetId: The [string] ContentId of  of the webpage asset file. The client should specify this value only when an asset file is being updated.
• [string] sessionToken: The token of the upload session initialized by the StartWebPageUpload() method method.
• [string] filename: The name of the uploaded webpage. A descriptive error will be returned if any of the following conditions occur:
  • This string is empty.
  • The string has more than 128 characters.
  • The file name is not valid.
• [long] filesize: The size of the webpage in bytes. This parameter must be an unsigned integer value no greater than 5000000000 (i.e. 5GB). A descriptive error will be returned if the value is negative.
• [int] chunksCount: The number of chunks the file consists of (starting at 1). The optimal chunk size is 256KiB. Files that are larger than this chunk size must be split into smaller parts by the client. Multiple chunks should be uploaded using multiple AppendChunk() calls specifying the same upload token.
• [enum: Auto, Image, Video, Audio, Webpage] contentType: The type of the content file, which should be specified as “Webpage”.
• [string] virtualPath: The path in the BSN Library to which the file should be uploaded (the default is “\Shared\Incoming\”). If the path does not exist, it will be created. It must also contain leading and trailing slashes and be no longer than 128 characters.
• [base64Binary] fileThumb: The optional thumbnail data as a binary attachment. This parameter will be generated by the server if it is not specified.
• [string] sha1Hash: The SHA1 hash of the webpage file. The server performs verification of the uploaded file using the specified hash. A descriptive error will be returned if the specified hash does not match the hash value calculated by the server. This parameter is optional; the server-side hash verification process is skipped if this parameter is not specified.

...

Required Permissions

None

Parameters

• [string] uploadToken: The token of the content upload that should be cancelled. If the content upload with the specified token does not exist, the method will immediately return Null without error.

...

Required Permissions

None

Parameters

• [string] sessionToken: The token of the upload session initialized by the StartFileUpload() method method. If the specified session token does not correspond to an existing session, the method will return Null without error.

...

Required Permissions

None

Parameters

• [string] sessionToken: The token of the upload session initialized by the StartWebPageUpload() method method. If the specified upload token does not correspond to an existing upload, the method will return Null without error.

...