B2B & Web Services Gateways - BT

stalksurveyorΑσφάλεια

3 Νοε 2013 (πριν από 3 χρόνια και 9 μήνες)

176 εμφανίσεις

B2B & Web Services Overview

Issue
1.4



5
th

October
2013


Page
1

of
16

Copyright


British Telecommunications plc 20
13




























BT Wholesale Business to Business
(B2B) and Web Services Gateways

Overview



B
T
W
holesale

B2B & Web Services Overview

Issue
1.4



5
th

October
2013


Page
2

of
16

Copyright


British Telecommunications plc 20
13

Legal and
Confidentiality Statement


The information contained in this document is confidential information as per your terms and
conditions with BT. Please treat it accordingly do not forward, republish or permit
unauthorised access.

For the avoidance of doubt, the

information contained in this
document

is for

information purposes only and does not constitute part of the contractual

terms and conditions.


All rights are reserved to BT and or its Licensors.


© British Telecommunications plc, 2011.

Registered office:
81, Newgate Street, London, EC1A 7AJ

Registered in England no. 1800000














B2B & Web Services Overview

Issue
1.4



5
th

October
2013


Page
3

of
16

Copyright


British Telecommunications plc 20
13

Contents

1.

INTRODUCTION

................................
................................
................................
................................
.......................

4

1.1

A
BOUT THIS HANDBOOK
.

................................
................................
................................
..............................

4

1.2

V
ERSION
C
ONTROL

................................
................................
................................
................................
......

4

1.3

F
URTHER
I
NFORMATION
.

................................
................................
................................
..............................

4

2.

B2B & WEB SERVICES G
ATEWAYS

................................
................................
................................
..................

5

2.1

T
HE
B2B

G
ATEWAY

................................
................................
................................
................................
.....

5

2.2

T
HE
W
EB
S
ERVICE
G
ATEWAY

................................
................................
................................
......................

5

3.

PRODUCTS/SERVICES OF
FERED VIA THE TWO GA
TEWAYS

................................
................................
...

6

4.

PHASES OF PRODUCT ES
TABLISHMENT

................................
................................
................................
.......

7

4.1

P
HASE
1:

P
RODUCT EDUCATION AND

CONTRACT SIGNING

................................
................................
.........

7

4.2

P
HASE
2:

O
NRAMPING WITH
PEM

T
EAM

................................
................................
................................
.....

7

4.3

S
ET
-
UP ON LIVE SYSTEMS

................................
................................
................................
..........................

10

4.4

P
ILOT
P
HASE
/T
RIAL PHASE

................................
................................
................................
........................

11

4.5

I
N
-
LIFE
(‘B
USINESS AS
U
SUAL
’)

................................
................................
................................
..................

11

6.

DOCUMENT HISTORY

................................
................................
................................
................................
..........

16


B2B & Web Services Overview

Issue
1.4



5
th

October
2013


Page
4

of
16

Copyright


British Telecommunications plc 20
13

1.

I
ntroduct
ion

1.1


About this handbook
.

This document
is
for communications providers
. It
gives you information
about the B2B
product establishment ,

including the Onramp process
,

and lists all services which are
supported by BT Wholesale via the Business to Business (B2B) Gateway and Web Servic
es
Gateway.

1.2


Version Control

Please ensure that you have the latest version of
this Handbook
.

1.3


Further Information
.

Please refer to the B2B and Web Services pages
on the BT Wholesale web site
for further
information

B2B & Web Services Overview

Issue
1.4



5
th

October
2013


Page
5

of
16

Copyright


British Telecommunications plc 20
13

2.

B2B & Web Services Gateways

There are
two strategic gateways that you can use. They are:

2.1

The B2B Gateway

The B2B gateway uses ebXML standards to communicate with you via a reliable messaging
interface.

To use this you will need a B2B gateway, e.g. Axway Activator or Hermes. There is no fixed
message session (asynchronous) and the message flow is reliable. Responses and
messages use unique reference keys.

2.2

The Web Service Gateway

The Web Services gateway uses WS
-
I standard technologies to support “synchronous” and
“basic callback” message patter
ns.

Note: WS
-
I terminology comes from the WS
-
I message exchange pattern terminology. For
more information visit http://www.ibm.com/developerworks/webservices/library/ws
-
iuse/

B2B & Web Services Overview

Issue
1.4



5
th

October
2013


Page
6

of
16

Copyright


British Telecommunications plc 20
13

3.

Products/services offered via the two gateways


For ease of reference a

glossary of terms is set out towards the end of this guide.


Products/services
available

B2B Gateway

Web Services
Gateway

20CN IP
s
tream
Diagnostics





20CN IP
s
tream Repair





20CN IP
s
tream
Connect Diagnostics





20CN P
artial
P
rivate
C
ircuit (PPC)

Repair
and Diagnostics





20CN KBD





21CN WBC/WBMC
Dialogue





21CN WBC/WBMC
L2C & T2R





21CN KBD





20C CCSNR








B2B & Web Services Overview

Issue
1.4



5
th

October
2013


Page
7

of
16

Copyright


British Telecommunications plc 20
13

4.

Phases of product establishment

Below are the different phases of product establishment process.


4.1

Phase 1: Product
education and contract signing

During this phase, your Account Manager will talk to you about
our
products and if
appropriate
you
will
need to
sign the
applicable
contract
(s)
. The Account Manager is your
first point of contact
.

After this
,

you will
need to

complete the
applicable
customer requirements form
(s)
. This is
a
simple
order
document to make sure that
you use the correct
product establishment
process.

Before starting the product establishment process you should contact your respective
Account Manage
r
to check th
at

pre
-
requisites for
service
establishment have been
completed.

4.2

Phase 2: Onramping with PEM Team

4.2.1


What is BT Wholesale Onramp?

BT Wholesale Onramp environment is a self
-
service simulated trading environment which
allows you to connect
,

and t
est
,

B2B and Web services collaborations before moving to a
live trading environment.

It allows you to test your B2B and Web services collaborations effectively and provides a
dedicated server for these tests
-

giving you complete control for various test
scenarios.
These tests will return predefined simulated responses. You can also test the generation of
unsolicited responses (Notifications) from BT Wholesale’s systems and messaging error
scenarios. You can use BT Wholesale Onramp to test services exposed

on the B2B and
Web

S
ervices gateway within a test environment before connecting to the
live
production
environment. B2B and Sentry transactions in the Onramp environment are intended to
generate simulated responses that will mirror
behaviour

under live op
erational conditions.

The BT Wholesale Onramp environment has a firewall, message handling hardware and
software which are known as the ‘BT Wholesale B2B/Webservices Gateway’.

BT Wholesale Onramp will host services which are the same as those provided
unde
r

the
current Live Release
together with
any forthcoming
planned
changes to current services
which
should
generally
be available
in

the Onramp environment before
the
changes are
applied to the live system.

B2B & Web Services Overview

Issue
1.4



5
th

October
2013


Page
8

of
16

Copyright


British Telecommunications plc 20
13

The Onramp testing can be broken down into the
following phases:



First
,

you need to get your gateway up and ‘talking to’
your

back end systems
;



Then, your ebXML gateways need to ‘talk to’ the Onramp B2B ebXML gateway
; and



Finally you need to round trip your XML from your client system stack/message
han
dler to a test stub and back again.

Your
BT
Account manager will arrange a call with you and the PEM team to introduce
the
key
people
and ensure the correct access
es

are being requested.

The BT Account Manager will confirm that all the prerequisites
for
es
tablishment
have been

completed e.g. O/M (Order Management Reference (Unique identifier to all 20C systems))
to CUG (Customer user Group (Unique identifier to all 21C systems)) mapping, back
-
end
set
-
up on this initial call.

Note:
the
O/M number is your uni
que identifier in 20CN eCo systems while CUG is a special
identifier (internal to BT Wholesale), distinct for each communication
s

provider that is used
in the B2B gateway.

4.2.2



What is BT Wholesale Onramp
intended
for?

The Onramp environment is available to
BT Wholesale customers so that they can test:



Connectivity to and from BT Wholesale Gateway via the Internet and any proxies and
firewalls that may be on the routes involved.



Creation, format conversion (if required), and installation of any certificates t
hat may
be used to support the https connections.



Business level messages for passing across the B2B interface; for final testing, the
messages should come from and go back to your systems.

4.2.3



What is BT Wholesale Onramp not

intended

for?

Onramp does not:



P
rovide you with a full end
-
to
-
end testing environment



Faithfully re
plicate

the performance in the production environment



Exhaustively test possible data values and error conditions sent to or returned by
Openreach



Facilitate load or performance testing



Wo
rk for live orders

B2B & Web Services Overview

Issue
1.4



5
th

October
2013


Page
9

of
16

Copyright


British Telecommunications plc 20
13

4.2.4



How long will you use BT Wholesale Onramp for?

The testing phase on
the
Onramp systems depends on the complexity of your management
and development processes. Fundamental connectivity testing can take anything from one
day to over a mo
nth and message testing may take days or months. However, in normal
circumstances
,

the set
-
up on the
BT
Wholesale side
should
take no more than four working
days from the provision of details.

The main causes of any delays are

due to
:



Incorrectly
-
configur
ed digital and Certificate Authority (CA) certificates on web
servers



Firewall and proxy setup problems



Development and integration with your backend systems

4.2.5



Set
-
up at your end

Your
Account Manager will arrange
an
introduction conference call. For some
Lines
-
of
-
Business (LoBs) and Customers, the Account Manager will have to arrange the interface
conference calls.

You will need to provide
various
details to our PEM Team


these are listed in
the
onramp
user guides
available from the BT Wholesale Web site
and you can contact PEM team if
you have any technical queries.

Once we have the set
-
up details it will
typically
take a minimum of four working days to set
up your account. You can then test the services you have opted for on Onramp. Just make
sure you do

this within 20 working days

or you will need to restart the process.
.

Note: The customer’s MSH (Message Handler) should handle the asynchronous and
synchronous responses and notifications sent from BT Wholesale as appropriate.

4.2.6


Onramp exit criteria

These are the set of tests which need to be done on the Onramp systems before moving to
the live environment.
The
Live server set up starts after the Onramp signoff.

You simply have to complete the onramp exit criteria report and send this to the PEM team
.

They will then verify the tests performed and provide the signoff from Onramp.

4.2.7



Software Development Kit (
SDK
)

and Emulator:

Our SDK and Emulator tools help you when using the BT Wholesale 21CN Wholesale
Broadband Connect (WBC)/Wholesale Broadband Manag
ed Connect (WBMC) services

and
21CN KBD services
. The Wholesale Broadband Connect B2B SDK provides the tools,
sample code and documentation that the customers need to quickly and easily integrate
with the BT Wholesale B2B gateway.

B2B & Web Services Overview

Issue
1.4



5
th

October
2013


Page
10

of
16

Copyright


British Telecommunications plc 20
13

The SDK provides a Java A
PI which allows you to create, validate, send and receive
Wholesale Broadband Connect (WBC) B2B XML. The SDK is only available in Java, you
simply need to be able to integrate this into your existing environment.

The SDK encapsulates the ebXML process thro
ugh the use of the Hermes B2B Gateway. It
also provides a locally deployable test environment to allow simulated end to end testing
before connecting to BT.

The Emulator tool can be used to develop and test the integration of the SDK into the
customer's p
rocessing stack. It performs automatic validation of inbound messages and
gives the facility to generate the relevant responses. The Emulator gives you the ability to
generate simulated BT responses on demand.

Therefore the use of SDK
-
Emulator
should

mean
faster integration with BT systems.

The SDK code is to be used to connect to the Emulator deployed on the Onramp
environment,
to
complete the testing
;

the code

can then be used
to place orders against
the Live environment.

All you need to do is register

your connect Data Universal Numbering System (DUNS) ID
with the PEM team. You can then download the latest SDK/Emulator and documentation
from the link
:

http://wssdk.wholesale.bt.com/SDKPortal/


If you are currently live on the B2B gateway (using your own propriety software), and would
like to move to SDK messaging you simply need to go through
the
Onramp process at least
once to prove the SDK access.

At the moment SDK only supports 21CN Wholesale

Broadband Connect (WBC) services

and 21CN KBD services

. It
does not support any other set of services
such as

20CN
KBD,
PPC, IP
s
tream services. (See section 3 for

a

list

of services
)

The point of contact for the customers during the SDK testing w
ill

be

the PEM team
(wholesale.pem@bt.com).

4.3


Set
-
up on live systems

The PEM team provides sign
-
off from Onramp once testing is completed and then sets you
up on the live systems.

This means that you are now off the test platform and aligned to the live platform.

Systems
will be now be connected to all back
-
end production systems which you did not have during
the Onramp testing in live platform.

Set up takes place
at
an agreed

time on an agreed

date which would normally be out of
office hours. It
normally
take
s

ar
ound 30 minutes to one hour at the BT end to complete
(both for B2B and Webservices).

However a lead time of five
working
days is required after
providing the live set up details to have firewalls implemented and to prepare for live set up.

B2B & Web Services Overview

Issue
1.4



5
th

October
2013


Page
11

of
16

Copyright


British Telecommunications plc 20
13

You will need
to do a stack
-
to
-
stack test (test within your internal systems) to understand if
there are any problems etc. It would

also

help if you also performed some operational
readiness testing (for the procedures).
Y
ou
then
simply
need to
perform a low

volume live

pilot against the l
ive systems. The final phase is to go through trial testing on the live
systems within two weeks of connecting to the Live systems
.

4.4


Pilot Phase/Trial phase

Once you are live on the
P
roduction
G
ateway, you are required to run trial test
s

as set out
below
. If you are a new customer you have four weeks to complete these, if you are an
existing customer you have two weeks. After the completion of the
se

tests, you need to
provide sign
-
off that all message processing is working. During this t
rial period, the PEM
team will support you if you face any issues while placing orders against the live system.



The tests you need to complete are:
Test for all the services to be used on Live (this
would have been tested previously against Onramp) and cont
act the PEM team
(wholesale.pem@bt.com) if you have any issues.



Then inform PEM about the completion of tests.



These tests would be similar to those of the Onramp tests that you will have carried
out earlier (in terms of various services and XMLs used).

If you have any issues after successful
ly completing testing

as set out below
from the
product establishment process, you can contact broadband.eco.admin@bt.com.

Before moving into the In
-
Life phase, the Exit Criteria

needs to be met.
This is a simple
“exit” email that signals the completion of the product establishment process and ensures
smooth handover to “In Life”.

You need to contact you
r

Account Manager

after completing the test plan within the pilot
phase
.

4.5


In
-
life (‘Business as Usual’)

This is
the “Business as Usual”

(BAU)

phase. You
should

now
be
able to use the services
you have opted and tested for
in the

live environment. The technical support is now
provided / coordinated by the E
-
Helpdesk (Wholesale Customer Helpdesk).






B2B & Web Services Overview

Issue
1.4



5
th

October
2013


Page
12

of
16

Copyright


British Telecommunications plc 20
13

5.

Glossary of
Acronyms and Abbreviations

Acronym

Expansions

21CN

21st Century Network [BT]

ADQ

Application
-
Driven Quality of service [BT]

ADSL

Asymmetric Digital Subscriber Line

ADSL2+

Asymmetric Digital Subscriber Line 2 Plus [ITU
-
T]

AP

Aggregation Point [BT]

APS

Aggregation Point Set [BT]

B2B

Business To Business

BB

Broadband

BBCR

Broadb
and Customer Reporting [BT]

BBEU

WBC EUA Service ID

BEA

Broadband Edge Aggregator [BT]

BRAS

Broadband Remote Access Server

BT

British Telecommunications plc

BTW

BT
Wholesale [BT]

C7

CCITT Signalling System No. 7

CCDB

Customer Contact Database [BT]

CD
-
ROM

Compact Disc Read Only Memory

CDD

Committed Delivery Date [BT]

Contractual Delivery Date [BT]

CIS

Capability Integration Server [BT]

CLASS

Customer Line
Analogue Signalling System

CP

Communications Provider [BT]

CPD

Customer Promised Date [BT]

CPE

Customers' Premises Equipment

B2B & Web Services Overview

Issue
1.4



5
th

October
2013


Page
13

of
16

Copyright


British Telecommunications plc 20
13

CRF

Customer Requirements Form

CSV

Comma Separated Variable

dB

deciBel

DLM

Dynamic Line Management

DP

Distribution Point

DSL

Digital Subscriber Line

DSLAM

Digital Subscriber Line Access Multiplexer

EoI

Equivalence of Input [BT]

EP

Extension Path [BT]

EU

End User [BT]

FNF

Fault Not Found [BT]

FTR

Fault Threshold Rate [BT]

FTTC

Fibre To The Cabinet

FTTP

Fibre To The
Premises

GEA

Generic Ethernet Access

IA

Intermediate Agent [BT

ID

Identifier

IP

Internet Protocol [IETF]

ISP

Internet Service Provider

KCI

Keeping Customers Informed

L2TP

Layer 2 Tunnelling Protocol [IETF]

LLU

Local Loop Unbundling

LNS

L2TP
Network Server [Cisco]

MPF

Metallic Path Facility

MSAN

Multi
-
Service Access Node [BT]

MSIL

Multi Service Interconnect Link [BT]

B2B & Web Services Overview

Issue
1.4



5
th

October
2013


Page
14

of
16

Copyright


British Telecommunications plc 20
13

NDA

Non
-
Disclosure Agreement

NIPP

Network Implementation Publication Principles

NTE

Network
Termination Equipment

NTE5

Network Terminating Equipment No. 5

OF

Optical Fibre

OHP

Openreach Handover Point

ONT

Optical Network Termination

OR

Openreach

PC

Personal/Portable Compute

PCP

Primary Cross
-
connect Point

PEW

Planned Engineering Works

POH

Point of Handover

PPP

Point
-
to
-
Point Protocol [IETF]

PSTN

Public Switched Telephone Network

PSU

Power Supply Unit

PTA

PPP Termination and Aggregation

QOS

Quality Of Service

RA

Rate Adaptive

RATES

Remote Access and Testing Equipment System [BT]

REIN

Repetitive Electrical
Impulse Noise

RWT

Right When Tested [BT]

SCD

Security Control Desk

SID

Service Id

SIN

Supplier Information Note [BT]

SLA

Service Level Agreement

SLG

Service Level Guarantee [BT]

B2B & Web Services Overview

Issue
1.4



5
th

October
2013


Page
15

of
16

Copyright


British Telecommunications plc 20
13

SMPF

Shared Metallic Path Facility

SP

Service Provider

SSFP

Service
Specific Front Plate [BT]

STIN

Suppliers'
Trial
Information Note

TV

Television

UK

United Kingdom

US

Up Stream

VDSL

Very high speed Digital Subscriber Line

VLAN

Variable Length Account Number [BT]

Virtual Local Area Network

WBC

Wholesale Broadband
Connect [BT]

WE

Week Ending

WLR

Wholesale Line Rental

xDSL

ADSL, HDSL, SDSL, VDSL, etc.

XML

eXtensible Markup Language



B2B & Web Services Overview

Issue
1.4



5
th

October
2013


Page
16

of
16

Copyright


British Telecommunications plc 20
13

6.

Document History

This section provides a brief description of the changes between this issue of the
WBC

Handbook and the previous
issue. Please refer to the main body of the document for full
descriptions of each topic.

Revision


Author


Date


Notes


1.0

Wholesale PEM Team

01/11/2010

Issued as part of the Gift
Rap B2B improvement
project

1.1

Wholesale PEM Team

02/02/2011

Modified
to incorporate
comments from the review
teams

1.2

Wholesale PEM Team

14/02/2011

Updated following review

1.3

B2B document improvement

30/09
/2011

Tone of voice/structure edit

& using BTW template

1.4

Wholesale PEM Team

05/10/2011

Updated the document
with
new link for SDK Download