6
1 Release Notes Tripolis Dialogue Version 3.23 – September 2016

Release Notes Dialogue 3.23 WORKING3 IMPROVEMENTS AND FEATURES REST API – API 3.0 In addition to our existing SOAP API service (API 2.0) we have created a Restful API (API 3.0)

  • Upload
    others

  • View
    21

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Release Notes Dialogue 3.23 WORKING3 IMPROVEMENTS AND FEATURES REST API – API 3.0 In addition to our existing SOAP API service (API 2.0) we have created a Restful API (API 3.0)

1

Release Notes Tripolis Dialogue

Version 3.23 – September 2016

Page 2: Release Notes Dialogue 3.23 WORKING3 IMPROVEMENTS AND FEATURES REST API – API 3.0 In addition to our existing SOAP API service (API 2.0) we have created a Restful API (API 3.0)

2

TABLE OF CONTENTS Improvementsandfeatures 3

RESTAPI–API3.0 3

TImezonesupportforcampaigns 4

Campaignnodedetailsinpreview 5

ChangestoAuditLogs 5

Bugfixes&smallimprovements 6

Contacts 6

Content 6

Publishing 6

Reports 6

SMS 6

Campaigns 6

Page 3: Release Notes Dialogue 3.23 WORKING3 IMPROVEMENTS AND FEATURES REST API – API 3.0 In addition to our existing SOAP API service (API 2.0) we have created a Restful API (API 3.0)

3

IMPROVEMENTS AND FEATURES

REST API – API 3.0 InadditiontoourexistingSOAPAPIservice(API2.0)wehavecreatedaRestfulAPI(API3.0).TheschemasforthisareavailableinYAML(foruseinswaggercompatiblecodegeneratorssuchashttp://editor.swagger.io-highlyrecommended),JSONandXML(foruseinSoapUIforexample).DocumentationDocumentationandexamplesfordebuggingandcodingfortheAPI3.0canbefoundhere:https://services.tripolis.com/support/api/api3/.Linkstotheschema’sandthedocumentationpagecanbefoundhere:http://tdxx.tripolis.com/api3/(replacetdxxwiththecorrectinstance).AvailableMethodsThefollowingoperationsareavailable:- ContactDatabases: GET- Contacts: DELETE- Subscriptions: POST/GET/PATCHContactDatabases:GET<endpointurl>/contactdatabases- Returnsalistofavailablecontactdatabases,includingthecontactDatabaseId.GET<endpointurl>/contactdatabases/{contactDatabaseId}- Returnsasinglecontactdatabaserecord.Contacts:delete<endpointurl>/contactdatabases/{contactDatabaseId}/contacts/{contactId}- Deletesacontactfromthedatabase.Subscriptions:POST<endpointurl>/contactdatabases/{contactDatabaseId}/subscriptions- Createsanewcontactwithfieldvaluesandgroupmemberships.Optionallyupdatesanexistingcontact

basedonkeyfieldvaluesbysettingupdateExistingtotrue.GET<endpointurl>/contactdatabases/{contactDatabaseId}/subscriptions/{contactId}- Returnssubscriptiondetailsofacontactwithfieldvaluesandcontactgroupmemberships,including

groupmembershipstatus(confirmed/unconfirmed).PATCH<endpointurl>/contactdatabases/{contactDatabaseId}/subscriptions/{contactId}- Updatesthesubscriptiondetails(fieldvalues,contactgroupmembershipsandgroupmembershipstatus)

ofacontact.

Page 4: Release Notes Dialogue 3.23 WORKING3 IMPROVEMENTS AND FEATURES REST API – API 3.0 In addition to our existing SOAP API service (API 2.0) we have created a Restful API (API 3.0)

4

AuthenticationAuthenticationforusesausername+key.TheauthenticationkeyisuserandClientspecificandcanbegeneratedbyassigninganAPIroletothatuserandsavingit.ForusersthatalreadyhaveanAPIrolebutnokeyyet,amessage“Notavailableyet.Saveformtogenerateakey”willshowandsavingtheformwillgeneratethekey.Akeycanbeinvalidatedandthenre-generatedbycheckingtheappropriateboxforitandsavingtheform:

EncryptedID’svisibleintheapplicationOnthedetailsoreditpagesofobjectsthatareoftenusedinAPIintegrationwehaveaddedafield“APIid”thatshowstheencryptedIDoftheobject.ThisIDcanalsostillbefoundintheobjectURL. Timezone support for campaigns Itisnowpossibletocreatecampaignsinaspecifictimezone.Whencreatingthecampaigntheusercanchooseatimezonethatwillbeusedforthiscampaign.Thedefaultwillbechosenfromtheuser’ssettings.Alltimersettingsincampaignnodeswillbeintheselectedtimezone.Wehavefixedthebugthatexistedfor“everyXatHH:MM”settingswheretheuserhadtorecalculatethetimetoAmsterdamtime.AllcampaignjobswillbepublishedusingthetimezoneoftheCampaign.

Page 5: Release Notes Dialogue 3.23 WORKING3 IMPROVEMENTS AND FEATURES REST API – API 3.0 In addition to our existing SOAP API service (API 2.0) we have created a Restful API (API 3.0)

5

Display node details when clicking on a campaign node in the preview ClickingonanodeinpreviewmodeofaCampaigndefinitionorrunwillshowapopupwithnodedetails.InthiswayallcampaigndetailscanbeseenwithoutstartingtheJavawebapp.

Changes to Audit Logs TheAuditlogspageinSetupwasredesignedtomakeiteasiertoextendauditlogginginfuturereleases.Additionally,wehaveaddedloggingforthefollowingoperationsonDialogueusers:resetpassword,edit,createandassign.FiltershavebeenaddedforFieldtypeandObjecttype.IntheauditlogsweaddedcolumnsforDatabaseandWorkspacethatdisplaythelabelandshowthenameonmouseover.Likewise,theObjectcolumnshowsthelabelsoftheobjectpath(nowwithouttheworkspace)andamouseoverrevealsthenames.OldlogentriesstillshowtheoldstyleObjectpathsanddon’thaveseparateentriesforDatabaseandWorkspace.

Page 6: Release Notes Dialogue 3.23 WORKING3 IMPROVEMENTS AND FEATURES REST API – API 3.0 In addition to our existing SOAP API service (API 2.0) we have created a Restful API (API 3.0)

6

BUG FIXES AND SMALL IMPROVEMENTS CONTACTS - ContactgroupscannowbefilteredonGrouptypeonthegroupslistpage.- Contactfieldsarenowdisplayedinthecorrectorderinthelistview. CONTENT - TheTinyMCEcontenteditorwasupdatedtothelatestversion.- Changinganarticleconditionforprofiletogroupnowworksasexpected.- Theorderofpicklistitemsinarticlefieldscannowbechanged.- Editingafieldgroupdoesn’tcauseanerror.

PUBLISHING - Analtattributehasbeenaddedtotheopentrackerimage(“trackingpixel”)forbetterdeliveryandto

keepthisfromcomingupwhencheckinganemailHTMLforerrors.- UserswithoutpublishingrightscannowsendaQuickTestagain.REPORTS - ClicksonlinksfromthetrackingXmlImporterarenowincludedintheSummaryReport.SMS - WenowallowspacesintheSMSoriginatorfield.- ThelinkforcontentpreviewforSMScommunicationhistorywasremoved.- ThedefaultSMSgatewaywasupdatestousethenewversionoftheprovider’sAPI.CAMPAIGNS - Campaigntimerswith“everyXatY”syntaxnowcorrectlyusethetimezoneofthecampaign.