topic Re: What Runtime license level do I need to sync edits for named users? in Qt Maps SDK Questions

What Runtime license level do I need to sync edits for named users?

MattStayner — Sat, 11 Dec 2021 19:29:37 GMT

I was told I would need "Basic" Runtime license level unless I used Esri named users. I am authenticating using Oauth2 and Esri named users, but when I try to run the code below, I get an error message,

"Attempt to use functionality that is not supported for the current license level".

My current license level is "Lite". Shouldn't I be able to sync with "Lite" using named users?

Thanks,

Matt

function executeSync(databasename,index) {
      resultProgress.value = 0;
    var content=layersModel.get(index);
    var synctaskid=content.layerId+"_syncTaskId";
    var x=content.layerUrl.substring(content.layerUrl.lastIndexOf("/"));
    var featurelayerid=x.replace("/","");
    var Urlsplitted=content.layerUrl.replace(content.layerUrl.substring(content.layerUrl.lastIndexOf("/")),"");
    syncLayerOptions.layerId=featurelayerid;
    var newObject1=ArcGISRuntimeEnvironment.createObject("Geodatabase", {id:"gdb",path:outputGdb+"/"+databasename,serviceUrl:Urlsplitted});
     var newObject2=ArcGISRuntimeEnvironment.createObject("GeodatabaseSyncTask", {id:synctaskid,url:Urlsplitted});
    syncJob =newObject2.syncGeodatabase(syncParameters, newObject1);
    delay(1000, function() {
        if (syncJob) {
            syncWindow.open();
               simpletimer.start();
          resultProgress.value += 1.0;
            syncJob.credential.token=app.portal.token;
            syncJob.jobStatusChanged.connect(updateSyncJobStatus);
            simpletimer.running=false;
            simpletimer.stop();
            syncJob.start();
        } else {
            syncWindow.open();
            statusText = "Sync failed";
            syncWindow.hideWindow(5000);
            console.log("sync else");
        }
    });

}‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

Re: What Runtime license level do I need to sync edits for named users?

LaurenBoyd — Wed, 02 Jan 2019 21:31:04 GMT

Hi Matt,

Did you license your application with the Named User license or are you inputting the Lite license key? To take advantage of the Named User license, you will need to access the LicenseInfo from the Portal and use this to license the application before any ArcGIS Runtime code is called.

You can find more information and a sample of this workflow at the following link under the License your app with a Named User account section: License your app—ArcGIS Runtime SDK for Qt | ArcGIS for Developers

If you have done the above and you are obtaining the license from the Named User, only a login that is a level 2 named user has the sync capabilities. You would need to login as a level 2 Named User in an ArcGIS Online organization or on-premises Portal. This would give you a Basic license and you could then synchronize edits to feature geometry, attributes, and attachments from a mobile geodatabase to a feature service. Lite licenses cannot synchronize edits, they can only download updates from a sync-enabled feature service to a mobile geodatabase.

Please take a look at the Licensing Capabilities page for more information.

Hope this helps!

Re: What Runtime license level do I need to sync edits for named users?

MattStayner — Wed, 02 Jan 2019 22:56:36 GMT

Hi Lauren,

Thanks for the info and the quick response!

I didn't realize there was an option to license our application with the Named User license. I checked out the link you sent and it looks pretty straight-forward. After the user signs in with their portal named user, then we can use info.licenseInfo and ArcGISRuntimeEnvironment.setLicense(licenseInfo) to license our application with the Named User license. Then, as long as the user is level 2 Name User, they will have access to the "Basic" level capabilities (sync, add, delete, edit). Did I get that right?

Thanks,

Matt

Re: What Runtime license level do I need to sync edits for named users?

LaurenBoyd — Wed, 02 Jan 2019 23:21:00 GMT

Hi Matt,

Exactly! Once they successfully log in as a level two named user and you grab and save the license info, they should be good to go with editing a syncing!

Re: What Runtime license level do I need to sync edits for named users?

MattStayner — Sat, 11 Dec 2021 19:29:40 GMT

Hi Lauren,

The named user licensing sounds perfect, but I'm having some issues accessing portal.portalInfo. For testing purposes, I created a new app using the Survey123 template. I added the following lines to the onSignedInChanged

function (see attached for the modified file).

console.log("Signed in!");
console.log("portal:"+portal);
console.log("portal.portalInfo:"+portal.portalInfo);
console.log("portal.portalInfo.licenseInf:"+portal.portalInfo.licenseInf);‍‍‍‍‍‍‍‍

And below is what I'm getting in the log:

portal.portalInfo is undefined. It appears that portal is a string and not a JSON object. What am I missing?

Thanks,

Matt

Re: What Runtime license level do I need to sync edits for named users?

MattStayner — Wed, 09 Jan 2019 03:54:11 GMT

Is anyone else having this issue where portal.portalInfo is undefined? I'm confused. I would have thought portal would be a big JSON object, not a string like is shown above. I must be missing something.

Re: What Runtime license level do I need to sync edits for named users?

ThomasDunn — Wed, 09 Jan 2019 16:54:40 GMT

Matt,

How did you create the portal object? Did you declare it or create it in a function? I'm wondering whether the portal object was loaded after creation. See Portal QML Type | ArcGIS for Developers about the portInfo property.

TAD

Re: What Runtime license level do I need to sync edits for named users?

MattStayner — Sat, 11 Dec 2021 19:29:42 GMT

Hi Thomas,

I am just trying to use the Survey123 template. With the code for that app, it looks like the portal object is created on line 503 of SurveyApp.qml (see the file I uploaded previously and below).

Portal {
  id: portal
  ...
  onSignedInChanged: {
  ...
    if (signedIn) {
      userInfo = portal.user;
      writeUserInfo();

      console.log(qsTr("Signed in!"));
      console.log("Signed in!");
      console.log("portal:"+portal);
      console.log("portal.portalInfo:"+portal.portalInfo);
                
      console.log("portal.portalInfo.licenseInf:"+portal.portalInfo.licenseInf);

      ArcGISRuntime.license.setLicense(portal.portalInfo.licenseInfo)
    }
  }
}
‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

There is a function onSignedInChanged (see line 536) inside Portal. I'm just really confused with the object portal. When I use console.log to view portal, I just get a string. But when I use portal.user, it returns the user information. However, portal.portalInfo is undefined.

So, I have 2 questions.

What is up with the portal object? Why do I get a string with console.log("portal:"+portal) but I get an object with
```
console.log("portal:"+portal.user).
```
Shouldn't portal.portalInfo be defined in the code block above? What am I missing?

Thanks,

Matt

Re: What Runtime license level do I need to sync edits for named users?

ThomasDunn — Thu, 10 Jan 2019 01:06:32 GMT

Matt,

I recommend that you avoid using console.log alone to output the content of objects as a whole. This will only work with console.log happens to do the right thing, and you won't know for sure that it worked because you don't know how the object was converted to a string. In this case, the output string seems to be an internal-use string representing that object instance.

It's best to take complete control and be explicit in type conversion to strings. For objects that have a property containing its JSON representation, you can use console.log(JSON.stringify(myportalobject.json)). For objects that don't have a JSON representation, you can console.log a member of the object, appropriately converting to a string before using it in console.log.

TAD

Re: What Runtime license level do I need to sync edits for named users?

MattStayner — Sat, 11 Dec 2021 19:29:45 GMT

I just can't figure out if portal is an object or a string. Let me show you what I mean.

Below is what I put into the S123 app:

console.log("Signed in!");
console.log("portal:"+portal);
console.log("portal JSON:"+JSON.stringify(portal.json));
console.log("portal.user:"+JSON.stringify(portal.user));
console.log("portal.portalInfo:"+portal.portalInfo);‍‍‍‍‍

Here is what shows in the log:

When I try to stringify portal, I get undefined, but when I stringify portal.user I get an object. That doesn't make any sense to me. If portal.user contains information, then portal should be an object, right? What is going on?

Would it be helpful if I shared the entire codebase so you could run it yourself? It is simply the Survey123 template with the console.log added to onSignedInChanged in SurveyApp.qml.

Re: What Runtime license level do I need to sync edits for named users?

Anonymous User — Thu, 10 Jan 2019 22:57:54 GMT

Hi Matt.

Possibly the confusion here is that Survey123 doesn't actually use the Runtime Portal object, instead they have created a custom QML file called Portal.qml which handles all the requests/logins etc to AGOL/server etc.

If you look in the Survey123 code, there is a folder called Portal which contains a file called Portal.qml, which is the "portal" that it uses. This "portal" does not have a json representation, nor does it have a "portalInfo" property, which means that what you see being logged out to the console makes sense.

What you were probably expecting was the Portal object from the Runtime, as per this documentation link:

Portal QML Type | ArcGIS for Developers

This is the "portal" object you should be using if you wish to license your app for the Runtime. (Note that I don't think it has a json representation either, although it does have the portalInfo property you are looking for).

So, for your testing, you should probably use a different code base/sample to start with. Possibly the OAuth sample, or the "Portal User Info" sample?

cheers

-Paul

Re: What Runtime license level do I need to sync edits for named users?

MattStayner — Sat, 11 Dec 2021 19:29:48 GMT

Paul,

Yes! That is what I was missing. Survey123 doesn't use the Portal Runtime object. I switched to the sample "Portal User Info" and it worked great. If anyone is curious, below is the code I used:

Portal {
    id: portal
    credential: Credential {
        oAuthClientInfo: OAuthClientInfo {
            oAuthMode: Enums.OAuthModeUser
            clientId: "T3Gjh6a2d0MK14ke"
        }
    }

    Component.onCompleted: load();

    onLoadStatusChanged: {
        if (loadStatus === Enums.LoadStatusLoaded ) {
            console.log("**************** Signed in! ****************")
            console.log("license level before: "+ArcGISRuntimeEnvironment.license.licenseLevel)
        }

        if (loadStatus === Enums.LoadStatusFailedToLoad)
            retryLoad();
    }
}‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

Which resulted in:

License level 2! Just as I was hoping.

Thanks for everyone for helping with this!

Matt