Upload File

Use this API to upload a file.

API

/cemli/v1/customers/{supportIdentifier}/services/{serviceType}/products/{product}/files/

Scope and AuthZ

  • You must have mcs:oci:api:User scope to access this API.
  • You can access this information for your customer CSI and available serviceType.
  • You can use CEMLI File API only if your customer has opted-in for CEMLI functionality.

Headers

  • Authorization: Bearer <Token>

    Where <Token> is the OAUTH token returned by the Authorization Server (JWT Token).

  • Identifier: <JWKS Identifier>

    Where <JWKS Identifier> is the GUID generated when JWKS URI is set by customer admin in self-service platform.

Base Path

/cemli/v1/

Dependency

Functionality

  • This API allows a specific file upload to UMP relevant to a customer, service, and product.
  • {supportIdentifier}, {serviceType}, and {product} can be retrieved from the dependency mentioned.
  • Request payload includes file metadata and base64 file content.
  • Response returns a success or failure with fileId and version.

Verb

POST

Parameters

Name Type Description Mandatory
supportIdentifier Path parameter Customer Support Identifier (CSI) Yes
serviceType Path parameter Service type (For example, EBSO, EBSZ, EBSI) Yes
product Path parameter Specifies the short name of the custom product (For example, xbol) Yes

Sample request (non-zip)

{
  "fileName": "XxExpenseReportLineEO.xml",
  "fileContent": "QUNFIHRlc3QgUGF0Y2g=",
  "description": "CEMLI XML XLF Patch File",
  "fileType": "xmlp_xlf",
  "version": "121.000001",
  "language": "US",
  "parameters": [
    {
      "name": "APPS_SHORT_NAME",
      "value": "xbol",
      "type": "TEXT"
    },
    {
      "name": "TEMPLATE_CODE",
      "value": "APXCCPUT",
      "type": "TEXT"
    }
  ]
}

Sample response (non-zip)

{
  "fileId": 10882,
  "checksum": "5c4fd11fe84feb8dffc161589fa8ba8048b3a1f319859029ed9c90587f9ba15f",
  "checksumAlgorithm": "SHA-256",
  "uploadMessage": "A lower version of the file was uploaded",
  "version": "122.0.0.1"
}

Sample request (zip upload)

{
  "fileName": "XXCOOP_AP_INV_CONV.zip",
  "fileContent": "QUNFIHRlc3QgUGF0Y2g=",
  "manifestFileContent": "YXBwbG1nci9DRU1MSS9tb2R1bGVzL2ZpbGVzL3NxbC9YWEFQQ05WMDNBLmNfdGJ
   sLHhib2wsWFhBUENOVjAzQSBUYWJsZSBzcWwsY190YmwsbnVsbCxVUywwLDEyMC4wMDAwMDE="
}

Sample response (zip upload)

{
  "files": [
    {
      "fileId": 10882,
      "filePath": "applmgr/CEMLI/modules/files/sql/XXAPCNV03A.c_tbl",
      "uploadMessage": "Upload Successful",
      "version": "120.0.0.1"
    },
    {
      "fileId": 10883,
      "filePath": "applmgr/CEMLI/modules/files/sql/XXAPCNV03B.c_seq",
      "uploadMessage": "Upload Successful",
      "version": "121.0.0.1"
    }
  ],
  "checksum": "5c4fd11fe84feb8dffc161589fa8ba8048b3a1f319859029ed9c90587f9ba15f",
  "checksumAlgorithm": "SHA-256"
}