Datei hochladen

Mit dieser API können Sie eine Datei hochladen.

API

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

Geltungsbereich und AuthZ

  • Sie benötigen den Geltungsbereich mcs:oci:api:User, um auf diese API zugreifen zu können.
  • Sie können auf diese Informationen für Ihre Kunden-CSI und den verfügbaren serviceType zugreifen.
  • Sie können die CEMLI-Datei-API nur verwenden, wenn sich Ihr Kunde für die CEMLI-Funktionalität angemeldet hat.

Header

  • Autorisierung: Bearer <Token>

    Dabei ist <Token> das OAUTH-Token, das vom Autorisierungsserver zurückgegeben wird (JWT-Token).

  • ID: <JWKS Identifier>

    Dabei ist <JWKS Identifier> die GUID, die generiert wird, wenn die JWKS-URI vom Kundenadministrator in der Selfserviceplattform festgelegt wird.

Basispfad

/cemli/v1/

Abhängigkeit

Funktionalität

  • Mit dieser API kann eine bestimmte Datei in UMP hochgeladen werden, die für einen Kunden, einen Service und ein Produkt relevant ist.
  • {supportIdentifier}, {serviceType} und {product} können aus der angegebenen Abhängigkeit abgerufen werden.
  • Die Anforderungs-Payload enthält Dateimetadaten und den base64-Dateiinhalt.
  • Die Antwort gibt eine Erfolgs- oder Fehlermeldung mit fileId und version zurück.

Verb

POST

Parameter

Name Typ Beschreibung Obligatorisch
supportIdentifier Pfadparameter CSI-Nummer Ja
serviceType Pfadparameter Servicetyp (z.B. EBSO, EBSZ, EBSI) Ja
product Pfadparameter Gibt den Kurznamen des benutzerdefinierten Produkts an (z.B. xbol) Ja

Beispielanforderung (nicht-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"
    }
  ]
}

Beispielantwort (Nicht-zip)

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

Beispielanforderung (ZIP-Upload)

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

Beispielantwort (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"
}