Liste der Patches abrufen

Mit dieser API können Sie eine Liste der Patches abrufen.

API

/cemli/v1/customers/{supportIdentifier}/services/{serviceType}/products/patches

Geltungsbereich und AuthZ

  • Sie benötigen den Geltungsbereich mcs:oci:api:User, um auf diese API zugreifen zu können.
  • Sie können eine Liste der CEMLI-Patches nur für Ihren Kunden abrufen.
  • Sie können die CEMLI-Patch-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

  • Rufen Sie die Liste der Patches ab.
  • supportIdentifier ist einer der Werte aus Alle CSIs für einen Benutzer abrufen.
  • serviceType ist der relevante typeCode-Wert aus Konfiguration für eine CSI abrufen für eine bestimmte supportIdentifier.
  • patchId ist eine eindeutige ID für den Patch.
  • name ist der Name des Patches.
  • patchNumber ist die im Backend gespeicherte Patchnummer.
  • description ist eine Patchbeschreibung.
  • createdBy ist die E-Mail-ID der Person, die den Patch erstellt hat.
  • createdOn ist der Zeitpunkt, zu dem der Patch erstellt wurde.
  • products.name ist der Name des Produkts.
  • products.files.fileId ist die eindeutige ID für eine Datei, mit der Dateidetails abgerufen werden.
  • products.files.filename ist der Name der Datei.
  • products.files.description ist eine Beschreibung für die angegebene Datei.
  • products.files.version ist die Versionsnummer der angegebenen Datei.
  • products.files.fileType ist der Dateityp, z.B. SQL, Java, XML Publisher XLF-Datei.

Verb

GET

Parameter

Name Typ Beschreibung Obligatorisch Anmerkungen
serviceType Pfadparameter Servicetyp Ja
supportIdentifier Pfadparameter Kunden-CSI Ja
name Abfrageparameter Nein

Wenn dieser Parameter übergeben wird, kann er mit anderen optionalen Parametern wie description, patchFileName,

includeContent und includeDeletedPatches mit AND-Bedingung verwendet werden.

description Abfrageparameter Nein Wenn dieser Parameter übergeben wird, wird er mit anderen optionalen Parametern wie name, patchFileName, includeContent und includeDeletedPatches mit AND-Bedingung verwendet.
patchFileName Abfrageparameter Nein Wenn dieser Parameter übergeben wird, wird er mit anderen optionalen Parametern wie name, description, includeContent und includeDeletedPatches mit AND-Bedingung verwendet.
includeDetails Abfrageparameter Nein Wenn die möglichen Werte TRUE oder FALSE übergeben werden, werden Produktdetails zurückgegeben oder nicht zurückgegeben.
includeContent Abfrageparameter Nein Wenn die möglichen Werte TRUE oder FALSE übergeben werden, wird der PatchFile-Inhalt als Base64-Wert zurückgegeben oder nicht zurückgegeben.
includeDeletedPatches Abfrageparameter Nein Wenn dieser Parameter übergeben wird, wird er mit anderen optionalen Parametern wie name, description, includeContent und includeDeletedPatches mit AND-Bedingung verwendet. Bei "true" gibt die API gelöschte Patches zurück.
createdBy Abfrageparameter Nein Wenn dieser Parameter übergeben wird, wird er mit anderen optionalen Parametern wie name, description, patchFileName und includeDeletedPatches mit AND-Bedingung verwendet.
createdOn Abfrageparameter Nein Wenn dieser Parameter übergeben wird, wird er mit anderen optionalen Parametern wie name, description, patchFileName und includeContent mit AND-Bedingung verwendet.
q Abfrageparameter Nein Wenn dieser Parameter übergeben wird, setzt er andere optionale Parameter außer Kraft, wie name, description, patchFileName, includeContent und includeDeletedPatches, und die Suche wird basierend auf dem hier übergebenen Wert durchgeführt. Abgleich erfolgt mit allen Suchfeldern unter name, description, patchFileName, includeDetails,includeContent und includeDeletedPatches im Backend mit OR-Bedingung.
patchNumber Abfrageparameter Nein Mindestens eine Patchnummer kann als Abfrageparameter übergeben werden (<URL>?patchNumber= 10000001923&patchNumber =10000001927&patchNumber =10000001922)
Hinweis

Die Paginierung wird unterstützt. Weitere Informationen finden Sie im Abschnitt Paginierung.

Beispielantwort

[
  {
    "patchId": 7386,
    "name": "MyManufacturingPatch",
    "patchNumber": 10000002386,
    "patchFileName": "p10000002386_US_R12_cmli.zip",
    "description": "Patch for the myManufacturing module",
    "createdBy": "<user's email ID>",
    "createdOn": "2020-08-26T10:53:51-07:00",
    "products": [
      {
        "name": "xbol",
        "files": [
          {
            "fileId": 10882,
            "fileName": "XxExpenseReportLineEO.xml",
            "description": "CEMLI XML XLF Patch File",
            "version": "121.000001",
            "language": "US",
            "fileType": "xmlp_xlf",
            "phase": "first",
            "sequence": 1
          },
          {
            "fileId": 10886,
            "fileName": "XMLP_PUB_XLF_TILE.xmlp_xlf",
            "description": "CEMLI XML XLF Patch File Upload",
            "version": "121.000001",
            "language": "US",
            "fileType": "xmlp_xlf",
            "phase": "last",
            "sequence": 2
          }
        ]
      },
      {
        "name": "xxeis",
        "files": [
          {
            "fileId": 10980,
            "fileName": "APXCCPUT_XML.xlf",
            "description": "CEMLI XML XLF",
            "version": "121.000001",
            "language": "US",
            "fileType": "xmlp_xlf",
            "phase": "first",
            "sequence": 5
          }
        ]
      }
    ]
  }
]