文稿教程说明onstar bdif pvn interface spec

BDIFandProvisioningInterfaceOnStarBDIFOnStarBDIFSunMicrosystems)SunMicrosystems)Page ©SunMicrosystems()ShirleyLu Date SOSBDIFPMShiYu Date SOSProvisioningPMLiLi Date SunBDIFPMRevisionSummaryofmjorchangesAnnSunJunInitialJunModificationsaftermeetingwithProvisioningAddedprovision3.4.2Shipped_sentData3.4.3Scrap_sentData3.4.2Shipped_sentData3.4.3Scrap_sentData3.4EDI53.5CellularESNJunUpdatedafter2ndroundreviewwithProvisioningUpdatedschemaEDI5AddedPairedErrfeedUpdatedschemaEDI2UpdatedschemaCelluarESNJunUpdatedInterfaceList:sectionModifiedEDI5interfaces:sectionModifiedEDI2interfaces:sectionAddedActivatedfeedinterfaces:sectionModifiedCellular_ESNinterface:sectionModifiedExceptionHandlingapproach:sectionYongKongUpdatedActivatedSchemaUpdatedCellular_EsnfeeddescriptioninUpdatederrorhandlingruleinJunReadyforJun NumberDeactivationNotificationschemachangetoadd‘status’to‘ImsiEsnPair’CorrectedUserEnrollment_ParaelementJunUpdatedCarrierNotificationServiceImplementationWSDLfile(embedded)JunUpdated,,,JohnHungAddedsection3.8forProvisioningJMSdetailsandupdatedtheWSDLfileCarrierNotificationInterface.UpdatedstagingtablesinformationinsectionJunUpdatedqueuenaming3.4.4,JunUpdatedbdif_pvn_edi5.xsdtoaddxmlnamespaceJunUpdatedPVNstagingtablesschema3.6.3UpdatedSequenceNumberdefinitionnotesJohnUpdatedXSDforSHIPPED_SENTandSCRAP_SENTandAllowemptyrecordsetinSHIPPED_SENTandRemovedSTIDUniquenessRemovedtypesandenumerationsforPairedError,whicharefromtheoldEDI5flow.JunAddedpredefinedvaluesforFeedName,SourceID,etc.–,,,,,,JunRevertedthechangetoSHIPPED_SENT/SCRAP_SENTschematonotallowzerodatarecord–,,,RitaAddedvalidvaluesforstatus–AddeddescriptionforEDI_ERROR_CD–RitaUpdated2realtimeinterfacesaccordingtoCT’sinterfacewith3.1MDN/IMSIDeactivationReal-UpdatedminDeactivationAdded Updated 3.3UserEnrollmentReal-UpdateduserEnrollmentAddedUpdatednotifyUserEnrollmentResultAdded1realtimeinterfaceunitCancellation3.4MDN/IMSICancellationReal-AddedAddedAddedJunBDIF_PVN.wsdlsplitintotwowsdlBDIF_PVN_PromotionChange.wsdlandBDIF_PVN_Disconnect.wsdl(section,)OnStarBDIFOnStarBDIF Interface Inteface MDN/IMSIDeactivationReal-time MDN/IMSIActivationReal-time(outofscopeforR1) minActivation UserEnrollmentReal- userEnrollment MDN/IMSICancellationReal-time unitCancellation EDI5–ShippedMIN/ESNandScrapMIN/ESNfilesBatch EDI5ProcessFlow SHIPPED_SENT SCRAP_SENT BDIF_PVN_EDI5Interface(SHIPPED_ERR/SHIPPED_APP/SCRAP_APP/ OriginalEDI2–MarriedIMSI/ESNfileBatchFeed EDI2ProcessFlow A ctivatedESN/MDN/IMSIfileBatch DefinitionofPVNStaging notifyActivatedSentJMSMessage notifyActivatedReceivedJMSMessage Cellular_ESNDataFeed CellularESNData ProvisioningJMSModule Exception/ErrorHandling ErrorNotification SunSunMicrosystems)PageOnStarBDIFOnStarBDIFSunMicrosystems)SunMicrosystems)PageThisistheprimarydetailedrequirementsdescriptionofallinterfacesbetweenBDIFsystemandPVNsystem.ThisincludesBDIFownedinterfacesexposedtoPVNsystem,forwhichthisshouldberegardedastheprimarysource.ItalsolistsPVNownedinterfacesexposedtoBDIF,totheextentasunderstoodatthistime,forcontractualandreferencepurpose,butshouldnotberegardedastheprimarysourceofthatinformation. shouldbereadandunderstoodbyallsystemstakeholderswithaninterestinthedetailedinterfacespecificationbetweenBDIFandPVN.Mostimportantly,thisincludesthosewhoarebuildingthesystemandthosewhowilluseittocarryouttheirbusinessresponsibilities.Theinterfacesspecificationoutlinedinthis describethedetailedtechnicalviewofcallinterface,elementsdefinition,error/exceptionhandlingetc.allpertinentinformationnecessarystousetheinterfaceeffectivelyandSeeDataSharingAgreement(DSA)andSystemRequirementSpecification(SRS)forthedetaileddatausage,sharingandsystemrequirements,usecasesandprojectscope.InterfaceDataMDN/IMSIDeactivationReal-ESN/MDN/IMSIreal-timeESN/MDN/IMSIreal-timedeactivationordernotificationESN/MDN/IMSIreal-timedeactivationresultnotificationUserEnrollmentReal-UserESN/MDN/IMSIreal-timeUserEnrollmentordernotificationESN/MDN/IMSIreal-timeUserEnrollmentresultnotificationUnitCancellationReal-UserESN/MDN/IMSIreal-timeUnitCancellationordernotificationESN/MDN/IMSIreal-timeUnitCancellationresultnotificationMDN/IMSIActivationReal-ESN/MDN/IMSIreal-timeactivation(outofscopeforR1)ESN/MDN/IMSIreal-timeactivationnotification(outofscopeforR1)EDI5–ShippedMIN/ESNandScrapMIN/ESNfilesShippedfilesentdataScrapfilesentdataProcessresponseforShipped/Scrap:SHIPPEDERRmessagesentSHIPPED_APPmessagesentSCRAP_APPmessagesentSCRAP_ERRmessagesentOriginalEDIEncryptedPairedwithA-KeyfileActivatedESN/MDN/IMSIEncryptedPairedwithA-KeyfilewillbesenttoConti,afterPVNhasnotifiedBDIFthattheActivatedfeedisgood;theoriginalActivatedfilewillalsobesentalongsothatConticancrosscheckwiththeEncryptedfilecontentActivatedESN/MDN/IMSIACTIVATED_SENTLoadActivated_SentESN/MDN/IMSIfilefromintoPVSStagingNotifyPVNtheActivated_SentloadingisACTIVATED_ERRGenerateACTIVATED_ERRfilefromPVNStagingforNotifyBDIFtheprocessingresultofActivated_SentStagingdata(BDIFdependsonthisnotificationtodecidewhethertoholdontheencryptedCellularESNmessgeIntefaceThissectiondefinesthedatafeedinterfacesbetweenBDIFandPVNMDN/IMSIDeactivationReal-minDeactivationInterfaceInterfaceSOAPUsage2500usersperday,20concurrent1KperInterfaceDefinitionWSDLSchemaminDeactivationRequestminDeactivationResponseStatusCodes- Whatarethevalidstatuscodes?StatusMessage- Whatarethevalidstatusmessages?Jma:theresponsemessageschemahereisleftunchangedfromtheoriginaldesignfortwoKeeptheinterfacedesignascoherentasForfutureextensionpurpose,wheninterfacewith goesWebServiceseventuallyCurrentlythisresponsemessageisusedmainlyjustforacknowledgement.StatusCode–0(requestreceivedOK)StatusMessage–RequestReceived -WhatarethevalidCode? -WhatarethevalidmessageEAIExtResultSet–WhyisthereanJma:theBaseResultisusedtowraptheexternalresultreturnedfrom ,incurrentcase,itwouldbeempty.ElementElementDataMandatory/Identifiesthecurrenttransaction:IdentifiestheSourceApplication:CountofTimestampofInputIdentifiesthe : Data Mandatory/Uniqueid,withfixedlength16,willbeusedtotracktherequest,generatedby接触流水号IDKeepthesameas受理工号021ThiselementisforextendpurposelaterOnStarBDIFOnStarBDIF MDNFixedlengthData ElementMandatory/IdentifiesBDIFinstanceforthetransaction,forcorrelationpurposeBDIFreturnStatus0–Success;1–Status ProcessedrecordsTimestampofData ElementFaultFault FaultInterfaceDefinitionSunSunMicrosystems)PagenotifyEnrollmentDeactivationOrderInterfaceInterfaceSOAPUsage2500userperday,20concurrent1KperInterfaceDefinitionWSDLSchemaOnStarBDIFOnStarBDIFSunMicrosystems)SunMicrosystems)PageNotificationFaultElementElementDataMandatory/IdentifiestheuniqueBDIFid,whichshouldbeusedtotracktheoriginalresponsefromCTIdentifythe ,put ThetimewhengettheElementDataMandatory/Uniquerequestid,lenthisfixedto0–Success,1–errorcodeinthecaseoffailure,maxlengthisreasonoferror,maxlengthisOrdernumberfortherequestidentifiedbyrequestid,maxlengthis20OrderIdfortherequestidentifiedbyrequestid,maxlengthis32thetimewhenrequestwasacceptedby*BDIFshouldmakesurerequestIdcanreprensenttheoriginalrequestsenttoElementDataMandatory/0–Success1–ElementDataWebServiceFaultWebServiceFault WebServiceFaultOnStarBDIFOnStarBDIFInterfaceDefinitionSunSunMicrosystems)PagenotifyEnrollmentDeactivationResultInterfaceInterfaceSOAPUsage2500userperday,20concurrent1KperInterfaceDefinitionWSDLSchemaEnrollmentDeactivationResultNotification(PVN:pleasechangethesubelementsoccurrencefromsingletomultiplicity,asalreadyreflectedinthediagrambelow):Eachdeactivationrequestmayreturndifferentstatus,somemaybesuccessfulandsomemaybefailure.Theycannotbegroupedtogether.Jma:Yestheycan,ineachpair,the‘ImsiEsnPair’and‘status’aregroupedasoneoccurrence,asalreadyupdatedbelow:OnStarBDIFOnStarBDIFSunMicrosystems)SunMicrosystems)Page eactivationNotificationFaultElementElementDataMandatory/IdentifiestheuniqueBDIFid,whichshouldbeusedtotracktheoriginalresponsefromCTIdentifythe ,put ThetimewhengettheElementDataMandatory/Uniquerequestid,lenthisfixedtoOrdernumberfortherequestidentifiedbyrequestid,maxlengthis20Directory SubscriberIdentification ElectronicSerialNumber(ESN)fortheVehicleCommunication 0–Success,1–errorcodeinthecaseoffailure,maxlengthisreasonoferror,maxlengthisAcknowledgeResultNotificationElementDataMandatory/0–Success1–ElementDataWebServiceFaultWebServiceFault WebServiceFaultInterfaceDefinition<CarrierNotificationServiceImplementation.wsdl>(seesectionMDN/IMSIActivationReal-time(outofscopeforminActivationInterfaceInterfaceSOAPUsage2500usersperday,20concurrent1KperInterfaceDefinitionWSDLSchemaminActivationRequestOnStarBDIFOnStarBDIFSunMicrosystems)SunMicrosystems)PageminActivationResponseElementElementDataIdentifiesthecurrenttransaction,equalsthenameoftheinterfacecallIdentifiestheSourceCountofTimestampofInputElementData客户名证件类证件号客户类路设备号套餐名ESN号ImsiElementDataIdentifiesBDIFinstanceforthetransaction,forcorrelationpurposeBDIFreturnStatusStatusProcessedrecordsTimestampofInterfaceDefinition<BDIF_PVN.wsdl>(seesectionnotifyNumberActivationInterface InterfaceSOAPUsage2500userperday,20concurrent1KperNotimplementedforreleaseInterfaceDefinitionWSDLSchemaNumberActivationNotificationAcknowledgeNumberActivationNotificationFaultElementTheElectronicSerialNumber(ESN)fortheVehicleCommunicationtform(VCP).InternationalSubscriberIdentificationDirectoryNumber.WebServiceFaultWebServiceFaultFauWebServiceFaultInterfaceDefinition<CarrierNotificationServiceInterface.wsdl>(seesectionUserEnrollmentReal-userEnrollmentInterfaceInterfaceSOAPUsage2500usersperday,20concurrent1KperInterfaceDefinitionWSDLOnStarBDIFOnStarBDIFSunMicrosystems)SunMicrosystems)PageSchemauserEnrollmentRequestuserEnrollmentResponseElementElementDataIdentifiesthecurrenttransaction:IdentifiestheSourceApplication:CountofTimestampofInputIdentifiesthe : Data Mandatory/Uniqueid,withfixedlength16,willbeusedtotracktherequest,generatedby接触流水号IDKeepthesameas受理工号021Thiselementisforextendpurposelater MDNFixedlengthData ElementMandatory/IdentifiesBDIFinstanceforthetransaction,forcorrelationpurposeBDIFreturnStatus0–Success;1–Status ProcessedrecordsTimestampofData ElementFaultFaultFauFaultInterfaceDefinition<BDIF_PVN.wsdl>(seesectionNotifyEnrollmentDeactivationOrderRefertosectionnotifyEnrollmentDeactivationResultRefertosectionMDN/IMSICancellationReal-unitCancellationInterfaceInterfaceSOAPUsage2500usersperday,20concurrent1KperInterfaceDefinitionWSDLOnStarBDIFOnStarBDIFSunMicrosystems)SunMicrosystems)PageSchemaunitCancellationRequestunitCancellationResponseElementElementDataMandatory/Identifiesthecurrenttransaction:IdentifiestheSourceApplication:CountofTimestampofInputIdentifiesthe : Data Mandatory/Uniqueid,withfixedlength16,willusedtotracktherequest,generatedby接触流水号IDKeepthesameas受理工号021Thiselementisforextendpurposelater MDNFixedlength“其他Data ElementMandatory/IdentifiesBDIFinstanceforthetransaction,forcorrelationpurposeBDIFreturnStatus0–Success;1–Status ProcessedrecordsTimestampofOnStarBDIFOnStarBDIFData ElementFaultFaultFauFaultInterfaceDefinitionSunSunMicrosystems)PagenotifyUnitCancellationOrderInterfaceInterfaceSOAPUsage2500userperday,20concurrent1KperInterfaceDefinitionWSDLSchemaOnStarBDIFOnStarBDIFSunMicrosystems)SunMicrosystems)PageNotificationFaultElementElementDataMandatory/IdentifiestheuniqueBDIFid,whichshouldbeusedtotracktheoriginalresponsefromCTIdentifythe ,put ThetimewhengettheElementDataMandatory/Uniquerequestid,lenthisfixedto0–Success,1–errorcodeinthecaseoffailure,maxlengthisreasonoferror,maxlengthisOrdernumberfortherequestidentifiedbyrequestid,maxlengthis20OrderIdfortherequestidentifiedbyrequestid,maxlengthis32thetimewhenrequestwasacceptedbyElementDataMandatory/0–Success1–ElementDataWebServiceFaultWebServiceFault WebServiceFaultInterfaceDefinition<CarrierNotificationServiceImplementation.wsdl>(seesectionnotifyUnitCancellationResultInterfaceInterfaceSOAPUsage2500userperday,20concurrent1KperInterfaceDefinitionWSDLSchemaOnStarBDIFOnStarBDIFSunMicrosystems)SunMicrosystems)PageUnitCancellationResultNotification eactivationNotificationFaultElementElementDataMandatory/IdentifiestheuniqueBDIFid,whichshouldbeusedtotracktheoriginalresponsefromCTIdentifythe ,put ThetimewhengettheElementDataMandatory/Uniquerequestid,lenthisfixedtoOrdernumberfortherequestidentifiedbyrequestid,maxlengthis20Directory SubscriberIdentification ElectronicSerialNumber(ESN)fortheVehicleCommunication 0–Success,1–errorcodeinthecaseoffailure,maxlengthisreasonoferror,maxlengthisAcknowledgeResultNotificationElementDataMandatory/0–Success1–ElementDataWebServiceFaultWebServiceFault WebServiceFaultInterfaceDefinition<CarrierNotificationServiceImplementation.wsdl>(seesectionEDI5–ShippedMIN/ESNandScrapMIN/ESNfilesBatchEDI5ProcessFlow1EDI-864ShippedMIN/ESN1EDI-8642EDI-9972EDI-997EDI-864EDI-8644EDI-9971EDI-864ScrapMIN/ESNprocess1EDI-8642EDI-2EDI-997EDI-86444EDI-997EDI-EDI-864ProvisioningsystemisresponsibleforEDI5datafeedsinterfaceofSHIPPED_SENTandOnStarBDIFOnStarBDIFSunMicrosystems)SunMicrosystems)PageBDIFsystemisresponsibleforEDI5datafeedsinterfaceofSHIPPED_APP,SHIPPED_ERR,SCRAP_APP,SCRAP_ERR. BDIFEDI5interfaceutilizesoneunifiedinterfacedefinition.SHIPPED_SENTInterfaceInterfaceUsageDaily2500InterfaceDefinitionSchemaShippedSentschemaElementShippedSentUniqueIDfortheNumbermustbeequaltonumberofshipsentDateTimeofthisEDISenderShippedSentIMSI–Numericalwithalengthof14–ESN–NumericalwithalengthofMDN–NumericalwithalengthofOnStarBDIFOnStarBDIFStationID–Numericalupto15ReworkTagmaxlengthofTimestampofShippedDateTheIMSI,ESN,MDN,STIDmustbeuniqueperInterfaceDefinitionSCRAP_SENTInterfaceInterfaceUsageDaily2500InterfaceDefinitionSchemaScrapSentschemaSunSunMicrosystems)PageOnStarBDIFOnStarBDIFSunMicrosystems)SunMicrosystems)PageElementScrapSentUniqueIDfortheNumbermustbeequaltonumberofshipsentDateTimeofthisEDISenderScarpSentIMSI–Numericalwithalengthof14–ESN–NumericalwithalengthofMDN–NumericalwithalengthofStationID–Numericalupto15ReworkTagmaxlengthofTimestampofShippedDateTheIMSI,ESN,MDN,STIDmustbeuniqueperInterfaceDefinition<PleaserefertoBDIF_PVN_EDI5Interface(SHIPPED_ERR/SHIPPED_APP/SCRAP_APP/InterfaceInterfaceJMSusername/passwordUsageDaily2500InterfaceDefinitionXMLschemaElementCreationOnStarBDIFOnStarBDIFSEQUENCEMessageSequenceFEEDFeedNamerequired:FEEDFeedsource:FEEDF=Full,MessageCorrelationTheElectronicSerialNumber(ESN)fortheVehicleCommunicationtform(VCP). SubscriberIdentificationDirectoryStationAuthenticationReworkErrorRECORDThecountofrecordsinthefileforthisInterfaceDefinitionSunSunMicrosystems)PageOriginalOriginalEDI2–MarriedIMSI/ESNfileBatchEDI2ProcessFlowEncryptedPairedwithA-KeyfilewillbesenttoConti,afterPVNhasnotifiedBDIFthattheActivatedfeedisgood. ctivatedctivatedESN/MDN/IMSIfileBatchInterfaceInterfaceUsageMonthlyProjectedthebatchtobe60KRecordsin5years,whichwillbe20MbytesinsizeBDIFwillloadtheActivateddataitreceivesfromintoPVNstagingtable,andnotifyPVNviaJMSmessagewhentheloadisdone.InterfacePVN_STAGEDatabaseThistablewillcontaintheheaderdescriptionforeachfeed.ThistablewillcontainthedataforeveryACTIVATEDandACTIVATED_ERRORfeedThistablewillbealookuptableforthestatusDefinitionofPVNStagingUniqueSequenceNumberforeveryThisnumberissystemassignedfromanOracleSequenceSEQ_PVN_STAGE_META/ContiMessageIDUsedformessageTransactionTypeofthefeedValidvalues:ACTIVATED(whenBDIFstagesfeed)TTotalnumberofrecordsforeachfeed;ThisnumbershouldmatchtherowcountofthedatatableOnStarBDIFOnStarBDIFSunMicrosystems)SunMicrosystems)PageSENDERID:RECEIVERID:CreatedCreatedbyID:BDIF(whenBDIFstagesUpdatedbyUniqueSequenceNumberforeveryThisnumberissystemassignedfroman OnerowcorrespondingtoeverydataOnerowcorrespondingtoeverydataOnerowcorrespondingtoeverydataOnerowcorrespondingtoeverydataValidEDIstatusshouldbe0(Accepted)whenBDIFfirststagesthefeedValidprocessingstatusshouldbe10(Staged)whenBDIFfirststagesthefeedForeignKeyassociatedwithSEQUENCE_NUMBERofCreatedbyID:BDIF(whenBDIFstagesCreatedUpdatedbyDetailedEDI_STATUScodesdefinitiontobeprovidedby0Datais1CannotlocateESNtheESN2CannotlocateIMSItheIMSI3CannotlocateMDNtheMDN4DuplicateIMSI5DuplicateESN6DuplicateMDN7Invalid8Invalid9InvalidInvalid无效Invalid无效CannotprocessdataRECORDhasbeenRECORDhasbeenRECORDisbeingProvisioninghasbeenupdatedwithdatainthisrecordProvisioninghascompletedprocessingcycleonthisstagedrecordnotifyActivatedSentJMSMessageInterfaceInterfaceJMSOnStarBDIFOnStarBDIFUsageWhenBDIFhasdoneloadingthestagingtable,BDIFwillnotifyPVNvianotifyActivatedSentJMSInterfaceDefinitionXMLschemaElementFieldTypeoffeed,fromIDofthisnotificationNumberofrecordsintheSourceofDestinationofSequencenumberfromMessageCreationDateInterfaceInterfaceSunSunMicrosystems)PageOnStarBDIFOnStarBDIFSunMicrosystems)SunMicrosystems)PageUsageMonthlyProjectedthebatchtobe60KRecordsin5years,whichwillbe20MbytesinsizeIncasethatthereisACTIVATED_ERR,BDIFwillreadfromPVN.InterfaceThesamestagingtablePVN_STAGE_ACTIVATEDwillbenotifyActivatedReceivedJMSMessageInterfaceInterfaceJMSUsageAfterPVNhasprocessedtheActivatedrecordsinthestagingtable,therecouldbetwocases:IfPVNfindsanyerrorintheActivateddata,itwillmarktheerroneousrecordsasACTIVATED_ERRinthestagingtable,andnotifyBDIFvianotifyActivatedReceivedJMSmessage;BDIFwillholdontheencryptedPairedfileIfthedataisgood,itwillalsonotifyBDIFnotifyActivatedReceivedJMSmessage,BDIFwillthenforwardtheencryptedPairedfiletoContiInterfaceDefinitionXMLschemaElementElementDataCreationdate,YYYY-MM-MessagesequenceForsuccesscondition,thesequencenumberisthesameofinboundsequencenumber.Forfailurecondition,thesequencenumberisthenewsequencenumber(whichisassociatedwithinboundfeedthroughBDIFmessageID)Feedname:Feedsource:Feedtype:CountofdetailElementDataOnStarBDIFOnStarBDIFResult––ErrorErrorExtensionResultExtensionResultElementExtensionResultElementExtensionResultElementExtensionResultElementInterfaceDefinitionCellular_ESNDataOnceBDIFhasreceivedActivatedReceivednotificat