topic Re: Aikau: How to call a repo webscript from an aikau widget in Alfresco Forum

Aikau: How to call a repo webscript from an aikau widget

francesco_forna — Thu, 15 Feb 2018 16:01:58 GMT

##Dear All,I need to add a new button on Share Search result page that allow users to export search metadata results as Excel file.So, I made the repo webscript to make the Excel outputstream based on user search data (i.e: terms, query, etc..) and I'm looking to bind to the Share Aikau Search Resul

Re: Aikau: How to call a repo webscript from an aikau widget

afaust — Fri, 16 Feb 2018 09:13:07 GMT

For doing calls to Repository-tier web scripts you either have to provide custom services that perform those Xhr calls or use the CrudService for generic Xhr handling. This platform contains a mini example for using the CrudService. Since some widgets may require very specific requests / response formats, using a CrudService is not possible in every use case, and generally I would say it is recommended to provide custom services instead to improve on the abstraction between widgets and backend calls, making your Aikau UIs simpler to upgrade when backend web scripts change.

Re: Aikau: How to call a repo webscript from an aikau widget

francesco_forna — Fri, 16 Feb 2018 16:16:28 GMT

Ok Faust,

I've added a new widget like this:

define(["dojo/_base/declare",
        "alfresco/services/BaseService",
        "alfresco/core/CoreXhr",
        "service/constants/Default",
        "alfresco/core/PathUtils",
        "alfresco/enums/urlTypes",
        "dojo/_base/lang",
        "dojo/_base/array"],
    function(declare, BaseService, CoreXhr, AlfConstants, PathUtils, urlTypes, lang, array) {
        this.alfLog("log", "myFunction called");

        return declare([BaseService, CoreXhr, PathUtils], {

            constructor: function alfresco_services_BaseService__constructor(args) {
                this.alfSubscribe("EXPORT_SEARCH_RESULTS_SERVICE", lang.hitch(this, this.onAction));
            },
            onAction: function facetedsearch_DocumentService_onAction(payload) {
                this.alfLog("onAction", payload);
                  
                 //TODO - CALL the serviceXhr

            },
            onSuccess: function facetedsearch_DocumentService_onSuccess(response, originalRequestConfig) {
                var msg = "Export generated successfully";
                this.alfLog("log", msg, response, originalRequestConfig);
                Alfresco.util.PopupManager.displayMessage({ title: "Info", text: msg});
            },
            onFailure: function facetedsearch_DocumentService_onFailure(response, originalRequestConfig) {
                var msg = "Something went wrong.";
                this.alfLog("log", msg, response, originalRequestConfig);
                Alfresco.util.PopupManager.displayMessage({ title: "Info", text: msg});
            }
        })
    }
);

How can I use it in my AlfButton? By using the publishTopic and publishPayload?

Re: Aikau: How to call a repo webscript from an aikau widget

afaust — Fri, 16 Feb 2018 18:27:24 GMT

Precisely...

Note: The Alfresco.util.PopupManager utility is legacy YUI. In Aikau you create notifications by triggering a publication on topics of either the DialogService (for complex/custom displays incl. data entry) or NotificationService.

Re: Aikau: How to call a repo webscript from an aikau widget

francesco_forna — Mon, 19 Feb 2018 16:10:58 GMT

Ok.

Could you suggest me the right way to pass search parameters in the payload? I have to get user search terms from the faceted-search widgets. I put my new button in the SEARCH_RESULTS_MENU_BAR and I was able to call my remote webscript set in publishTopic field.

Regards.

Re: Aikau: How to call a repo webscript from an aikau widget

francesco_forna — Tue, 20 Feb 2018 11:03:35 GMT

Ok Guys,

we've found the solutions. I report some basic steps to solve this mess J.

1) Write your JS backend widget service and register it to the Aikau runtime; for example a servce to make XHR repository calls:

define(["dojo/_base/declare",
        "alfresco/services/BaseService",
        "alfresco/core/CoreXhr",
        "service/constants/Default",
        "alfresco/core/PathUtils",
        "alfresco/enums/urlTypes",
        "dojo/_base/lang",
        "dojo/_base/array",
        "alfresco/util/hashUtils"],
    function(declare, BaseService, CoreXhr, AlfConstants, PathUtils, urlTypes, lang, array, hashUtils) {

        return declare([BaseService, CoreXhr, PathUtils], {

            constructor: function alfresco_services_BaseService__constructor(args) {
                this.alfSubscribe("EXPORT_SEARCH_RESULTS_SERVICE", lang.hitch(this, this.onAction));
            },
            onAction: function facetedsearch_DocumentService_onAction(payload) {
                
               //  hashUtils.getHash() - IT CONTAINS YOUR SEARCH PARAMETERS
               // query - scope - searchTerm
                console.log(hashUtils.getHash());
                
                this.serviceXhr({
                    url: AlfConstants.PROXY_URI + "/api/YOUR_WEBSCRIPT_AND_SEARCH_PARAMS",
                    method: "GET",
                    successCallback: this.onSuccess,
                    callbackScope: this
                });

            },
            onSuccess: function facetedsearch_DocumentService_onSuccess(response, originalRequestConfig) {

                Alfresco.util.PopupManager.displayMessage({ title: this.message("export.search.result"), text: this.message("export.search.result.ok")});
            },
            onFailure: function facetedsearch_DocumentService_onFailure(response, originalRequestConfig) {

                Alfresco.util.PopupManager.displayMessage({ title: this.message("export.search.result"), text: this.message("export.search.result.no")});
            }
        })
    }
);

2) Declare your new faceted-search widgets override, for example by adding a new button:

//PUT THE NEW SERVICE IN PREVIOUS MODEL SERVICE LIST
model.jsonModel.services.push("widgets/medica-search-export");

//ADD YOUR BUTTON AND CALL THE NEW SERVICE BY USING the publishTopic config element.
var searchResultsMenuBar  = widgetUtils.findObject(model.jsonModel, "id", "SEARCH_RESULTS_MENU_BAR");
searchResultsMenuBar.config.widgets.push({
    id: "EXPORT_BUTTON_SEARCH",
    name: "alfresco/buttons/AlfButton",
    config: {
        label : "medica.export.search.result",
        additionalCssClasses:"call-to-action",
        publishPayloadType: 'PROCESS',
        publishTopic: "EXPORT_SEARCH_RESULTS_SERVICE"
    }
});