renameAsset renameasset
Benennt ein Asset um.
NOTE
Die
renameFiles
-Parameter wurde für frühere Versionen nicht mehr unterstützt und aus entfernt renameAsset
. 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
Eingabe (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 die Variable
validateName
is true
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 dieser nicht eindeutig ist.Ausgabe (renameAssetReturn)
Die IPS-API gibt keine Antwort für diesen Vorgang zurück. Siehe Beschreibung der <ns1:validateName>
-Element mit Einschränkungen zu diesem Element.
Beispiele section-a0ddffd62bec42e09069f22ceb486f8a
Mit diesem Codebeispiel wird ein Asset umbenannt.
Anforderung
<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