Using library methods/AppResource Function



4 minute read

Appresource Functions are the functions in APPSeCONNECT that are written in the adapter (APPSeCONNECT supports calling external functions written in C# inside the adapter) which is used for the data transformation from the source Application to the Destination Application. AppResources are library functions added to DLL. This Appresource functions are coded to perform a definite task.

In APPSeCONNECT there are total 5 Appresource Functions:

  1. Native AppResources: - These Appresource are written with the adapter itself. When the Adapter is uploaded in the cloud, these appresource function are uploaded with the adapter itself.
  2. Sourcelib AppResources - The appresource functions of the source application is the Sourcelib appresources. These functions are referred by *sourcelib.**
  3. Destinationlib Appresources – The appresource function of the destination application is the Destination Appresources. These functions are referred by *destinationlib.**
  4. Generic AppResources: - The generic appresources are the functions that have general defined task which are provided by APPSeCONNECT itself. These functions are referred by *genericlib.**
  5. Cloud Appresources: The Cloud Appresources are the functions that are used when creating a touchpoint for a technology or custom app. These functions are written with the cloud portal itself. The function of the cloud appresources are referred by *cloudResourcelib.**

Prerequisites for working with AppResources

Click for knowing the common prerequisites.

Need to upload the adapter for accessing the appresources.Click to know more.

Note: For an Application, The Library Function can also be viewed in the APPS Sections. Navigate to APPS > Expand the Application Node > Functions. All the Library Function for that Application can be viewed.

Implementing the AppResources in Mapping

  1. Login to the APPSeCONNECT Portal and Navigate to the Touchpoint area for the connection which is required for the Transformation Process.
    Note: Here the connection used is Magento2 – SAP Business One.
  2. Click transform button in the touchpoint for which the transformation is to be done. Click to know more about the Mapping attribute mapping.
    Note: Here the Touchpoint used is Delivery Update Response.
  3. In the Mapping window of the attribute, expand the node Functions to view all the categories of the Appresources [Generic, Source, Destination and the Cloud].
  4. On Expanding the Generic Function Node, all the Generic Appresources can be viewed. Clicking on any of the function will be appear in the Mapping Panel.

  5. On Expanding the Source Function Node (Native Function) all the Native Appresources for the source function is viewed. Clicking on any of the function, will make it appear in the mapping Panel.
  6. On Expanding the Destination Function Node (Native Function) all the Native Appresources for the destination function is viewed. Clicking on any of the function, will make it appear in the mapping Panel.
  7. For Working with cloud appresource, the + (in Bold) button is needed to be clicked for creating the Cloud Resource.
    The Cloud Appresource window opens.
  8. The user can choose from the Code snippet template and language fundamentals templates also. The templates can be added in the code panel by drag and drop.
  9. The templates can be added in the code panel by Drag and Drop.
  10. Code the Appresource and click on Validate and SAVE. Now expand the Cloud resource Node for viewing the created function. Click any of the function, will make it appear in the mapping Panel.
  11. Once the mapping is done, click on the Submit button to save the mapping.

AppResource Function Name

APPSeCONNECT provides the flexibility to the users for customizing the pre-packaged touchpoints as per the business needs or requirements by following APPSeCONNECT’s own syntax functions.

Application Name Application Version FunctionId Function Name Description Example  
Salesforce 25 2207 GetContactPersons (AccountId) Get contact persons associated with an account id from Salesforce NULL  
Salesforce 25 2208 GetAccountAdderesses(AccountId) Get billTo and ShipTo addresses associated with an account id from Salesforce NULL  
Microsoft Dynamics NAV ≥ 2009R2 Generic 2214 GetStringValueFromCollection (pageService, collectionrootname, field1, value1, field2, value2, readfieldname, separatorbetweenstring, xnamespace) Using this function we can get string values with separator from collection of fields GetStringValueFromCollection (‘/Page/CommentList’, ‘CommentList’,’Table_Name’,’Item’, ‘No’, $itemNo,’Comment’,’new line’,’urn:microsoft-dynamics-schemas/page/commentlist’)
Microsoft Dynamics NAV ≥ 2009R2 Generic 2215 SetProductAndAdditionalAttribute (elementCollection, rootElement, uniqueChild, readoptionidfieldname, splitchar, stringkeys, stringvalues, nameSpace) Using this function, we can set a collection of Product Attribute and Additional attribute SetProductAndAdditionalAttribute ($allAttribute, ‘Web_ProductAttribute_Page’,’AttributeName’,’AttributeOptionId’,’~’,concat (‘msrp’,’~’,’meta_title’), concat(‘1’,’~’,’magentometa title’),’urn:microsoft-dynamics-schemas/page/itemcard’)  
Microsoft Dynamics NAV ≥ 2009R2 Generic 2216 GetNavValue (pageService, field1, value1, field2, value2, field3, value3, returnField) Using this function we can get a field value of a Page GetNavValue(‘/Page/webapplicationcustomerdata’,’ApplicationId’,’1’,’CustomerNo’,$customerNo,’’,’’,’WebCustomerId’)  
SAP B1 ≥ 8.8 2228 UpdateUserTableQurey(string tablename, string setfieldname, string setfieldvalue, string condfieldname, string condfieldvalue, string condfieldname2, string condfieldvalue2) You can Update SAP B1 User Table Function UpdateUserTableQurey(‘AECTRANDATA’, ‘U_SyncFlag’ ,’Y’, ‘U_KeyValue’, ‘Item001’, ‘U_ObjectCode’, ‘4’)  
SAP B1 ≥ 8.8 2229 SetCustomerAddressItems(XPathNavigator addressitem, string cardCode) This function will return unique Address collection from Magento addresses and SAP B1 Addresses SetCustomerAddressItems (MagentoAddressItems, SAPB1CardCode)  
Shopify 2230 CheckShipment (stringorderid, stringisShippingExist) This function is used for checking if an invoice/delivery is created for the order during partial invoice download CheckShipment(‘10000001’, 1)  
Shopify 2231 GetShippingTotal (decimaltotalPrice, decimaltotalTax, decimalitemsWithoutTax, stringshippingTotal) This funtion is used for calculating total shipping price of an order GetShippingTotal(totalPrice, totalTax, itemsWithoutTax, shippingTotal)  
SAP B1 SAP B1 S/L 9.0 2245 getData (stringserviceName, stringactionParam, stringmethodName, boolvalue) This function is used for getting data from SAP based on the action parameters passes getData (serviceName, actionParam, methodName, value)  
SAP B1 SAP B1 S/L 9.0 2246 getData (stringserviceName, stringactionParam, stringmethodName) This function is used to get data from SAP B1 based on the    
action parameter passed getData (serviceName, actionParam, methodName)          
SAP B1 SAP B1 S/L 9.0 2253 ImageToString (stringimgpath) Converts Image information at the path specified to base64 string ImageToString (imgpath)