Webmethods.io B2B :: Manage custom attributes

1. Introduction

This article explains how to manage custom attributes in webmethods.io B2B.

     Why we need custom attributes?

  • If customer wants to extract any other content apart from the existing system attributes.

For e.g.: Purchase order number from document

  • If user wants to have more attributes rather than the ones that are available after document creation.

For e.g : User created any XML document type and wants to have separate attribute for retrieving some additional content from the document.

2. Pre-Requisites

3. UseCase

      In this article, we are going to add custom attributes such as State or zip code to attribute list in webmethods.io B2B from the below XML sample. (apart from system attributes)

Here is the purchase order XML sample.

<?xml version="1.0"?>

<PurchaseOrder PurchaseOrderNumber="1" OrderDate="2020/04/22">

<Metadata>

<Sender>ABC</Sender>

<Receiver>ACME</Receiver>

</Metadata>

<Address Type="shipping">

<Name>ABC Corporation</Name>

<Street>ABC Street</Street>

<City>ABC City</City>

<State>ABC Street</State>

<Zip>560037</Zip>

<Country>ABC</Country>

</Address>

<DeliveryNotes>Office</DeliveryNotes>

<Items>

<Item PartNumber="1">

<ProductName>ACME</ProductName>

<Quantity>10</Quantity>

<USPrice>1000</USPrice>

<Comment>ACME</Comment>

<ShipDate>2020/04/22</ShipDate>

</Item>

</Items>

</PurchaseOrder>

 

3.1 Adding Custom attributes to document type

        Navigate to imported document i.e. purchaseorder, click on Document attributes -> Add Document Attribute

Navigate back to XML document -> Attributes, click on attribute State and you should see XPath expression changes accordingly.

Click on AddToAttributes and select the State from Attribute dropdown- > Update.

 

3.2 Send XML Message over AS2 from Postman

  • Testing from Postman requires the below features to be turned off on the channel.

  • Use the postman collection - https://www.getpostman.com/collections/186b1096086f600b39d8 to post the XML over AS2 inbound channel. You need to configure the below on postman before posting.
    • tenantname - > webMethods.io B2B Tenant Name
    • channelid -> Channel Unique identifier
    • AS2-From -> ABC in this use case, AS2 identifier of Partner
    • AS2-To -> ACME in this use case, AS2 identifier of Enterprise
    • Message-Id -> Unique identifier for the message
    • Authorization -> Partner User

Upon Successful sending XML message to B2B cloud, you should see the custom attribute in the transaction page.