AXL announcement operations

[stephan.steiner]

I'm looking into possibly manage announcements in my application through AXL. When I compare what can be done with ccmadmin versus the AXL documentation, I have some questions:

in ccmadmin, I define an announcement by setting a unique identifier, a description and a default announcement (optional). In AXL, I have the same three properties, but announcementFile is a string. Is there a way to list possible values (it's a dropdown in ccmadmin so the values are predefined). can I just list announcements and use their names?

then, once created, I can upload wav files and specify the locale for the wav file. How do I do that through AXL? updateAnnouncement only lists the standard three properties.

[dstaudt]

It looks like <updateAnnouncement> expects the friendly name of the announcement file:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <soapenv:Body>
      <ns:getAnnouncementResponse xmlns:ns="http://www.cisco.com/AXL/API/12.5">
         <return>
            <announcement uuid="{CA8D24EA-1CE3-A1C3-4522-EC788E058866}">
               <name>testAnnouncement</name>
               <description/>
               <announcementFile>ReorderTone</announcementFile>
            </announcement>
         </return>
      </ns:getAnnouncementResponse>
   </soapenv:Body>
</soapenv:Envelope>

However <listAnnouncement> returns an enum, this is likely a defect:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://www.cisco.com/AXL/API/12.5">
   <soapenv:Body>
      <ns:listAnnouncementResponse>
         <return>
            <announcement uuid="{CA8D24EA-1CE3-A1C3-4522-EC788E058866}">
               <name>testAnnouncement</name>
               <announcementFile>3</announcementFile>
            </announcement>
         </return>
      </ns:listAnnouncementResponse>
   </soapenv:Body>
</soapenv:Envelope>

(<getAnnouncement> returns the friendly name...)

You should be able to get the announcement file enum->name mapping from the table typeannouncementfile.

Unfortunately there is no mechanism in AXL for uploading new announcement files - that has to be done manually via CCM Admin.  (I did come across this **unsupported** project which reverse-engineers the CUCM admin pages to do that: https://github.com/bmeade90/BulkTFTP/blob/master/CUCM-Bulk-TFTP-Upload.py)

[dstaudt]

CSCvv71334 has been created to track the <listAnnouncement> issue