Changing metadata of an image object using DocumentObj 2.5 SetMetaData

Question

I'm wring a PowerShell script to change objects metadata at once. My script woks properly for topic objects. However, it does not work for image objects. I wrote the following code to change metadata using DocumentObj 2.5.

function DocumentObj-SetMetaData()

{

$functionName = "DocumentObj-SetMetaData"

$documentObjUrl = $infosharewsurl + "DocumentObj25.asmx?WSDL"

$documentObjWebService = new-webServiceProxy -uri $documentObjUrl -UseDefaultCredential

try

{

$psXMLMetadata = "<ishfields>"

$psXMLMetadata += "<ishfield name='FTITLE' level='logical'>" + $ftitle + "</ishfield>"

$psXMLMetadata += "<ishfield name='FKUBOTAMODELCLASSIFICATION' level='version'>" + $classification + "</ishfield>"

$psXMLMetadata += "<ishfield name='FKUBOTAMODELSERIES' level='version'>" + $modelseries + "</ishfield>"

$psXMLMetadata += "<ishfield name='FKUBOTAMODEL' level='version'>" + $model + "</ishfield>"

$psXMLMetadata += "<ishfield name='FKUBOTAREGION' level='version'>" + $region + "</ishfield>"

$psXMLMetadata += "<ishfield name='FKUBOTACOUNTRY' level='version'>" + $country + "</ishfield>"

$psXMLMetadata += "<ishfield name='FKUBOTAKEYWORD' level='version'>" + $keywords + "</ishfield>"

$psXMLMetadata += "</ishfields>"

$psXMLRequiredCurrentMetadata = "<ishfields/>"

# Write-Host($psXMLMetadata)

Write-Host($id)

$result = $documentObjWebService.SetMetaData([REF]$context, $id, [REF]$version, $language, $resolution, $psXMLMetadata, $psXMLRequiredCurrentMetadata)

}

catch [System.Web.Services.Protocols.SOAPException]

{

("error at " + $functionName)

Return-Result $Error[0].Exception.InnerException.Message

}

$result #returning the function value by simply outputting it

}

When this function is called, following ishfields are given via $psXMLMetadata variable.

<ishfield name='FTITLE' level='logical'>OM-GUIDE-0001</ishfield>

<ishfield name='FKUBOTAKEYWORD' level='version'>guide</ishfield>

<ishfield name='FRESOLUTION' level='lng'>Thumbnail</ishfield>

</ishfields>

An exception occurs when the $documentObjWebService.SetMetaData is executed and it returns '-102003' as the error code. I looked into the error code explanation in the following page. But I cannot figure out the reason of the error.

https://docs.sdl.com/806356/751995/sdl-tridion-docs-14-sp3/error-codes

Please give me advises to resolve this issue.

Kind regards,

Naoki

Dave De Meyer · Answer

Hi Naoki, 
 Nice to see you write PowerShell scripts on the (deprecated) ASMX-SOAP API functions using INTERNAL authentication. Where INTERNAL refers to that the Docs CMS user profile holds the password. 
 The number '-102003' uses the following error description "The {objecttype} "{object}" cannot be returned, because it is not initialized." where the two parameter mentioned (so {...}) are filled in in your runtime. I will guess that you did not offer a value for "$resolution" - like Low, High, Default,... - so in turn you didn't specify an exact object that the system can work on. 
 
 I cannot really derive which Tridion Docs version (like 14SP3/14.0.3) you are using? I do wonder why you decide not to use ISHRemote, see https://github.com/sdl/ISHRemote [...] New-IshSession -WsBaseUrl " ">https://example.com/ISHWS/" -PSCredential "Admin" $ishTopicMetadata = Set-IshMetadataField -Name "FTITLE" -Level Logical -Value "Topic $timestamp" | Set-IshMetadataField -Name "FAUTHOR" -Level Lng -ValueType Element -Value $ishUserAuthor | Set-IshMetadataField -Name "FSTATUS" -Level Lng -ValueType Element -Value $ishStatusDraft $ishObject = Add-IshDocumentObj -FolderId $ishFolderTopic.IshFolderRef -IshType ISHModule -Lng $ishLng -Metadata $ishTopicMetadata -FileContent $ditaTopicFileContent $ishObject = Set-IshDocumentObj -IshObject $ishObject -Metadata (Set-IshMetadataField -IshSession $ishSession -Name "FSTATUS" -Level Lng -ValueType Element -Value $ishStatusReleased)[...]

Dave De Meyer · Answer

In essence the ASMX-SOAP and WCF-SOAP are equal regarding business calls, but differ in the security paradigm they respect. So I'm not forcing you into ISHRemote. Some background on the API and its future is available here: https://community.sdl.com/product-groups/sdl-tridion/tridion-docs/m/videos/4533 
 As I developed on ISHRemote I think it does its best to wrap WCF-SOAP in a PowerShell pipeline object friendly way. The ASMX-SOAP will force you more in raw xml structures. 
 On the essence, finding one object by GUID. That is actually the main difference between a Find-* and Get-* cmdlet, with Find-* you do not know the identifier, with Get-* you do (as in your scenario). So regarding the last piece of code, what about: 
 $metadataFilter = Set-IshMetadataFilterField -Level Version -Name VERSION -FilterOperator Equal -Value $cur_version | Set-IshMetadataFilterField -Level Lng -Name DOC-LANGUAGE -FilterOperator Equal -Value $lang Get-IshDocumentObj -LogicalId $cur_GUID -MetadataFilter $metadataFilter # and ISHRemote already takes care of the returned object in pretty-print for you and retrieves a bunch of nice descriptive fields for you 
 And on https://github.com/sdl/ISHRemote are some extra links, also ISHRemote repects the Get-Help some-cmdlet principle with examples.

Tridion Docs Developers > 03 - Developer Forum

Changing metadata of an image object using DocumentObj 2.5 SetMetaData