Agentry Application. Screen Fields -> External Field documentation.

[Former Member]

Hi All

Could someone give me a reference to a documentation about

Screen Fields -> External Field documentation?

I try to use next reference but can't find info about External Field section.

Detail Screen Fields - Developer - SAP Library

[Former Member]

I have experience of using "Class Name" to assign OpenUI inherited class name

and "External Value" to pass value from OpenUI class to Agentry App.

I aslo want to know how to use Agentry Values, Actions and Scan Settings.

[mark_pe]

Konstantin,

Our doc team responded to me.  It is available here:

Agentry App Development 3.0 SP12 SDK > Agentry Language Reference > Module-Level User Interface Definitions Overview > Detail Screen Fields > Field Definitions With Edit Type-Specific Attributes > External Field - ActiveX Control

• External Field - ActiveX Control

http://help.sap.com/saphelp_smp3012sdk/helpdata/en/7c/14c5b6700610148f9985e424458fb2/content.htm

Not really easy to find I agree.

Best Regards,

Mark Pe
SAP Platinum Support Engineer

[Former Member]

Mark,

That isn't the ActiveX controls (as they don't even work with the WPF Clients) but that is the tab for the OpenUI controls so the client knows what class to call, also, what fields to pass to it, and what actions it can run.

[mark_pe]

Steve,

I know.  That is where the definition lies about scanning settings, Agentry values and others currently in the documentation as presented by the doc team.  May need to visit that topic with them and move it in a different section or add the equivalent to it. 

Regards,

Mark

[Former Member]

If you do manage to persuade them to visit this topic.

Please ask them to describe in detail the following sections:

- Agentry Values: what is it and example of code. How to use it in OpenUI project.

- Actions: what is it and example of code. How to use it in OpenUI project.

- Scan Settings: the same .

From this article

i got information how to use

"Class Name" and "External Value"

So to get "External Value" (Values from OpenUI project to Agentry project) you can use next code

public class Z_RFIDButtonAdapter extends ButtonDisplayAdapter implements OnClickListener

{

...

@Override

public String getExtensionString(String name)

{

  String value = "";

  if (name.equals("ExtRFID"))

  {

    value = NfcDataBean.getNfcValue();

  }

  return value;

}

Where "ExtRFID" is a name of a external value

"NfcDataBean.getNfcValue()" is a value of a external value

[bill_froelich]

In a nutshell

• Agentry Values - Allow you to reference other values beside the property the control extends from your Open UI control.  For example, you can use it to make your control more generic by passing in configuration values that your control reads and acts upon. 
• Actions - Defines what Agentry actions your Open UI control can invoke and what their target is.  From within your Open UI code you can then trigger these actions to execute.  For example in the GIS control you can select a point on the map and call an Agentry Action to create a new work order which would then display the Agentry transaction wizard screens.
• Scan Settings (Open Scan) - This is used to provide your own scanning interface to something like NFC, RFID or other input you want to treat as a scanned value.  The value your Open Scan code passes to Agentry as a scan value which will trigger the default controls.

I know there is example code for OpenScan and calling actions (MyAgentryActionExtension) already in the Framework SDK.  I would suggest starting by reviewing the sample code provided.

--Bill

[Former Member]

Hello Bill

I explored MyAgentryActionExtension.java file

The following code

_textView = new EditText(_context);
_textView.setHint("Enter an action name and press \"Run Action\"");
_actionButton = new Button(_context);
_actionButton.setText("Run Action");


String action = _textView.getText().toString();


ActionResult actionResult = _model.executeAgentryAction(action);

hints that

at run-time user can enter any action name to run.

So using _model.executeAgentryAction I can execute any action of Agentry application

Is it correct?

Why then it is needed to fill out the field Extrernal Field->Actions

How to access array of Extrernal Field->Actions in Java code?

Looks like MyAgentryActionExtension.java doesn't use Extrernal Field->Actions array of Agentry application.

[mark_pe]

Konstantin,

After dicussing it here, there is a logged document # (or SAP documentation tracking # SMPKM-586) to work on improving this part of the documentation based on the discussion herein. The date is TBD and will be scheduled accordingly based on resource, priority and time constraint. This may or may not be accomplished soon (will be pending review to be approved) but hopefully with proper planning in SAP this may be done for future documentation (Again we do not know when this will occur or which SMP 3.0 SP version it will be released).  For now I want to emphasize that we thank you for your comments here as we strive to improve our documentation. We in support have reach out to the dev/doc team and they have responded with the tracking number above.  At the moment, you are discussing your issue closely with Bill for their consulting experiences.

Best Regards,

Mark Pe
SAP Support Platinum Engineer (Mobility)

[Former Member]

That tab is for the OpenUI information: http://help.sap.com/saphelp_smp303sdk/helpdata/en/7c/0591b97006101489caceb9dee3539e/content.htm

[mark_pe]

Konstantin,

Hi. We will try to check where the documentation is for that feature set. We will try to ping the documentation team.  Hopefully they respond.

Best Regards,

SAP Mobile Support Team