renameAsset renameasset

Benennt ein Asset um.

NOTE
Der Parameter renameFiles wurde in früheren Versionen nicht mehr unterstützt und aus renameAsset entfernt. Der virtuelle Dateipfad wird so geändert, dass er mit dem neuen Asset-Namen übereinstimmt (wobei die Dateierweiterung beibehalten wird), während die physischen Dateipfade nicht betroffen sind. API-Clients müssen beim Aktualisieren auf die neue API-Version Verweise auf diesen Parameter entfernen.

Autorisierte Benutzertypen section-cc27ad713c6d498b8f056850b20976f4

  • IpsUser
  • IpsAdmin
  • IpsCompanyAdmin
  • ImagePortalAdmin
  • ImagePortalContrib
  • ImpagePortalContribUser
NOTE
Der Benutzer muss Lese- und Schreibzugriff auf das Asset haben.

Parameter section-ef95a994106841e0ab346dd4cf672258

Input (renameAssetParam)

Name
Typ
Erforderlich
Beschreibung
companyHandle
xsd:string
Ja
Das Handle des Unternehmens, zu dem das Asset gehört.
assetHandle
xsd:string
Ja
Das Handle für das Asset, das Sie umbenennen möchten.
newName
xsd:string
Ja
Der neue Name des Assets.
validateName
xsd:boolean
Ja
Wenn validateName den Wert true aufweist und der Asset-Typ eine eindeutige IPS-ID erfordert, wird der neue Name auf globale Eindeutigkeit überprüft und renameAsset gibt einen Fehler aus, wenn er nicht eindeutig ist.

Ausgabe (renameAssetReturn)

Die IPS-API gibt keine Antwort für diesen Vorgang zurück. Einschränkungen zu diesem Element finden Sie in der Beschreibung des Elements <ns1:validateName> .

Beispiele section-a0ddffd62bec42e09069f22ceb486f8a

Mit diesem Codebeispiel wird ein Asset umbenannt

Anfrage

<ns1:renameAssetParam xmlns:ns1="http://www.scene7.com/IpsApi/xsd">
   <ns1:companyHandle>47</ns1:companyHandle>
   <ns1:assetHandle>24265|1|17061</ns1:assetHandle>
   <ns1:newName>My Newly Renamed Image</ns1:newName>
   <ns1:validateName>true</ns1:validateName>
   <ns1:renameFiles>true</ns1:renameFiles>
</ns1:renameAssetParam>

Antwort

Keine.

recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681