©Centre for Development of Advanced Computing SSDG Connector s in.Net.

©Centre for Development of Advanced Computinghttp://nsdg.gov.in

SSDG Connector sin

SAP GenericApplication Specific

SPGeneric Application Specific

SAP Generic Connectors

Generic SAP API

SubmitRequest() - This function should be used for making initial request to SSDG for availing a service.DocumentPoll() – This function is used to check the status of the request which has been submitted through asynchronous mode.DocumentDelete() –This function is used to delete the request and response which have already been fulfilled successfully.DocumentList() – It helps in getting the status of all the requests submitted to SSDG during a particular period.

Note: Only SubmitRequest() is used for Synchronous as well as asynchronous Requests while all the other functions will use Synchronous based requests only.

Generic Responses

Success Status –Actual Response

Failed Status

Resubmit

SAP Generic Connector Elements

Element Name : ClassValue

Data Type : String

Mandatory : YES (for all functions)

Description :Service ID of the service registered at gateway.

Element Name :TransactionId

Data Type : String

Mandatory : Optional (Depends on the SAP Application Specific Connector)

Description :Used by the SAP application to club multiple Submit Request into single transaction.

Element Name : BodyContent

Data Type : XMLElement[ ]

Mandatory : YES (for SubmitRequest() )

Description : Payload or body content. SAP and SP must adhere to the schema of payload.

Element Name : CorrelationID

Data Type : String (32 bit character value)

Mandatory : YES (for functions DocumentPoll(), DocumentDelete() )

Description : Unique identifier of the message received from gateway.

Element Name : ResponseMode

Data Type : Enum

Description :Response mode specifies the type of communication needed by Service.

ASYNCHRONOUSSYNCHRONOUS

Element Name : SenderID

Data Type : String

Mandatory : YES(for SubmitRequest() and DocumentList() methods only)

Description :User Id of SAP for authentication at gateway.

Element Name :Password

Data Type : String

Mandatory : YES (Required in SubmitRequest() and DocumentList() methods only)

Description :Password to authenticate SAP.

Element Name :TargetEndpoint

Data Type : String

Description :URL of the Gateway.

Element Name : AuthMode

Data Type : Enum

Mandatory : YES ( Required in SubmitRequest() and DocumentList() methods only. )

Description : Indicates how the SAP will be authenticated to gateway. There are three types of Authentication Modes

Clear -AuthMode.ClearSHA-1-AuthMode.SHA1;W3C signed-AuthMode.W3CSigned

Element Name : SignedAuthentication

Data Type : Enum

Mandatory : OptionalDescription : Indicates whether the payload

should be signed or not.False –indicates payload should not be signed.

True-SAP will sign payload and signature verification of payload should be done by SP.

Sequences

Synchronous Submit Request from

SAP to SP

Synchronous Submit RequestSynchronous Submit Request from SAPfrom SAP

SAP (portal) Gateway SP( Back off )

synSubmitRequest()

Synchronous Response

SubmitRequest()

ConnectorInterface inter = new ConnectorInterface ( );

//Optional Field set by Client

inter.TransactionId = "12345678912345678912345678912345";

inter .CorrelationID = "";

//Type of Service Requested i.e. Synchronous

inter.ResponseMode = ResponseMode.Synchronous;

//Valid Service Class

inter.ClassValue = "http://127.0.0.1/22";

//Address of SSDG

inter.TargetEndPoint="http://nsdg.staging.cdacmumbai.in/gateway/services/NSDGService";

//Authentication Details received after registration of SAP

inter.AuthMode = AuthMode.Clear;

inter.SenderID = "SAP130720081454";

inter.Password = "[B@13a87a0";

XmlElement[] body =Body received from SAP Application Specific Connector ;

inter.BodyContent = body;

//Calling of SSDG through Generic Connector API

ConnectorInterface.SubmitRequest(ref inter);

Synchronous Response for Synchronous submit request

Gateway SP Generic Connector

SP Application Specific Connector

synSubmitRequest()

Sending Submit ResponseSending Submit Response

public void synSubmitRequest ( ref SPInterface interfaceSP )

//Retrieving the Values received from SAP through SSDG

XmlElement[] bodyArr = new XmlElement[1];

bodyArr = interfaceSP .Body;

//Processing of Body is done by SP application Specific Connector

//Business logic of body processing will come here

interfaceSP.Body[0] = bodyArr[0];

interfaceSP.SubmissionStatus = "response";

//If the content received in the body is incorrect. Also set the

body as per schema of Error giving the reason for the error.

setProperties .SubmissionStatus = "error";

SubmitRequest()

©Centre for Development of Advanced Computinghttp://nsdg.gov.in©Centre for Development of Advanced Computinghttp://nsdg.gov.in

Submit Response send to SAP

synSubmitRequest()

Synchronous Response /ErrorSynchronous Response/Error

SubmitRequest()

Submit Response

SAP (portal) Gateway

//If Status is error

string errorCode = inter .ErrorCode;

string[] errorList=new string[1];

errorList = inter .ErrorList;

string error=null;

if ( errorList != null )

{ error = errorList [ 0 ]; }

//Receiving Result

string status= inter.SubmissionStatus;

//if status is response

string corrID=inter.CorrelationID;

string classID = inter.ClassValue;

Synchronous SUBMIT_REQUEST

Synchronous Submit Request

ASynchronous Submit Request from

SAP to SP

Asynchronous Submit Request from SAP

asynSubmitRequest()

Submit Acknowledgement/ ErrorSubmit Acknowledgement/ Error

SubmitRequest()

//Optional Field set by Client

//Type of Service Requested i.e. Asynchronous

inter.ResponseMode = ResponseMode.ASynchronous;

//Address of SSDG

inter.AuthMode = AuthMode.Clear;

inter.SenderID = "SAP130720081454";

inter.Password = "[B@13a87a0";

XmlElement[] body =Body received from SAP Application Specific Connector;

ConnectorInterface.SubmitRequest(ref inter);

Submit Acknowledgement send to SAP

asynSubmitRequest()

Submit Acknowledgement/ ErrorSubmit Acknowledgement/ Error

SubmitRequest()

//if status is acknowledgement

//Process the ConnectorInterface object

string classID = inter.ClassValue;

string endPoint = inter .TargetEndPoint;

string error=null;

{ error = errorList [ 0 ]; }

Submit Poll from SAP

Document Poll

Submit Response /Submit Acknowledgement

DocumentPoll()

inter.TransactionId = "";

//It should contain the value as received in Asynchronous SubmitRequest

inter.CorrelationID = "34E17E40952F4EAEB37E7B1FD7BA67EF";

//Valid Service class

//End Point Url of the Gateway where DocumentPoll can be done

inter.DocumentPoll ( ref inter )

Submit Response Component of SP

SP Generic Connector

SP Application Specific Connector

public void SPResponse ( ref SPInterface interfaceSP )

interfaceSP.CorrelationID="Value stored in DB from asynchronous request";

interfaceSP.ClassValue=" Value stored in DB from asynchronous request ";

interfaceSP.TargetEndPoint="Address of SSDG";

//Create response in SP Application Specific connector code and write the business logic to store it in bodyArr element

interfaceSP.Body[0] = bodyArr[0];

interfaceSP.SubmissionStatus = "response";

SPImplSoapSoap callResponse = new SPImplSoapSoap ("path of Generic Connector");

callResponse .submitResponse ( ref interfaceSP );

Submit Acknowledgement / Submit Acknowledgement / Submit Response send to SAP from SPSubmit Response send to SAP from SP

Submit Poll

Submit Response /Submit AcknowledgementSubmit Response /Submit

Acknowledgement

DocumentPoll()

//Actual Response

//Can be retrieved for Business Error and response.

if ( inter.BodyContent != null )

element = inter .BodyContent

string error=null;

error = errorList [ 0 ];

//Receiving Result

/if status is acknowledgement, it means response is still awaited from SSDG.

string corrID=inter.CorrelationID

//Target End point for the Gateway

string responseEndPoint=inter.TargetEndPoint;

string classId = inter .ClassValue

Asynchronous CommunicationAsynchronous Communication

Asynchronous Submit Request

Submit poll

Submit ACKSubmit Response

Submit poll

RESPONSE

Asynchronous Submit Request

Submit ACK

List Request from SAP List Request from SAP

List Response

DocumentList()

//Type of Details Requested i.e. Asynchronous or Synchronous

inter .ResponseMode = ResponseMode.Asynchronous;

//Address of SSDG

inter .TargetEndPoint = "http://nsdgstaging.cdacmumbai.in/gateway/services/NSDGService";

inter .AuthMode = AuthMode .Clear;

inter .SenderID = "SAP1238072453839";

inter .Password = "[B@1f19353";

//Prepare Body as List request Schema provided in Manual Appendix

ConnectorInterface .DocumentList (ref inter );

List Response From SSDG to SAPList Response From SSDG to SAP

List Response

//Receiving Result

string status = inter .SubmissionStatus;

string classID = inter .ClassValue;

XmlElement [ ] element=new XmlElement[1] ;

if ( inter .BodyContent != null )

//Receive result as per schema mentioned in Manual

element = inter .BodyContent;

//in case of error

string error=null;

DocumentList()

Delete Request from SAP Delete Request from SAP

Delete Response / Delete Acknowledgement

DocumentDelete()

//or give response as it is optional field

inter.TransactionId = "";

//It should contain the value as received in Asynchronous SubmitRequest

inter.CorrelationID = "34E17E40952F4EAEB37E7B1FD7BA67EF";

//End Point Url of the Gateway where DocumentDelete can be done

inter.TargetEndPoint = “http://nsdg.staging.cdacmumbai.in/gateway/services/NSDGService";

inter.DocumentDelete ( ref inter );

Delete Response From SSDG to SAPDelete Response From SSDG to SAP

Delete Response / Delete Acknowledgement

//Receiving Result

//Target End point for the Gateway

string responseEndPoint=inter.TargetEndPoint;

string classId = inter .ClassValue;

string error=null

DocumentDelete()

Thank You

©Centre for Development of Advanced Computing SSDG Connector s in.Net.

Documents

Transcript of ©Centre for Development of Advanced Computing SSDG Connector s in.Net.

Network Programming Chapter 3: Network Programming in.NET.

Network Programming Chapter 2 Streams in.NET. Basic Outline Streams in.NET Stream Manipulation Serialisation.

-VAMSI SRI HARSHA VIDALA X.509 certificate management in.NET.

1.Net programmingGenericsNOEA / 2009 Generics 11. Generics in.NET and C#

XML DOM Functionality in.NET DSK Chakravarthy dskcheck@msn.com 94496 12273 .

SSDG (eForms & State Portal)

Introduction to Evidence-based security in.NET Framework Brad Merrill Program Manager.NET Frameworks Integration.

Role Management in.NET Shree Shalini Pusapati CS 795 11/17/20151.

Integrating application with SSDG

Electricity (DISCOM) - alwar.rajasthan.gov.in · Rajasthan Housing Board (RHB) & JDA 1 Rajasthan Housing Board ... Service Delivery through SSDG through e-Mitra network 1 SSDG Citizen's

EForms and Service Delivery through State Portal & SSDG Kavita Bhatia.

Domain Driven Design Implementation Patterns and Considerations in.NET.

Driving Growth In Emerging Markets - Neha Naik, .IN.NET

Open XML Developer Workshop XML Programming in.NET.

SSDG (eForms & State Portal) working of Approval Authority-Menu Screen SSDG (eForms & State Portal)

MultiThreading in.NET 2.0 Neal S. Buchalter NSB Consulting NBuchalter@rcn.com .

DIT - Standards & Interoperability E-Forms SSDG

ICINETIC Experts in.NET technologies and architectures.

The HORN Package Manager 2 options for creating DSLs in.NET.

Core runtime in.NET Framework Newer runtime pieces out-of-band (NuGet) Tooling in Visual Studio Runtime in.NET Framework Tooling in Visual Studio.