<< Click to Display Table of Contents >> Navigation: Other screens > CIF > CIF Patch registration interface data |
GetCabinetInclAllv4
This service can be reached at: http://cif.speerit.nl/coconservicetest/coconservice.asmx
Bouwbestand Columns
The following columns should be present in the bouwbestand:
Postcode, Straat, Huisnummer, Toevoeging, Kamer, Plaatsnaam, StartdatumCiviel, OpleverdatumCiviel, Opleverstatus, LC, WP, KastCIF, ODFladeCIF, PPCIF, KastOO, ODFladeOO, PPOO, Hasdatum, HasdatumGereed, ToestemmingKlant, EVPCode, Vezelwaarde1, Vezelwaarde2, Locatiestatus, Toelichting NA, Type FTU, Switchnumer / portnumber, Creation date, Leeg, POP_Locatie, AE, AF, AG, Patch afgerekend, Fiber Only, Kern / Buitengebied, Deelgebied, Gebiedscode, Eenmalige bijdrage
Bouwbestanden can be placed (if they have the right format and specifications) in this folder: C:\Apps\CIF17\Ftpinterface\CIF\BuildProgress\Input
This folder should contain:
A. A subfolder should be created in which .xlsx file extension is placed with the same name as the folder name.
This subfolder and its contents will be moved after processing to the Approved folder includes a log of any processing errors.
B. One or more .xlsx files can be placed in the Input folder. The contents will be moved, after processing, to the Approved folder, including a log file of any processing errors.
A processing batch will run every hour.
The results will be visible in Cocon by turning on the FTTH bar and activating the button for ' addresses'.
Thereby, all addresses will be placed in a dummy project called ' unknown' which will be generated (automatically) for this purpose.
The new batch report creates an Excel sheet which also works with the data from the ' bouwbestand' which are uploaded. Also the uploaded ChangeDevicePort data will be included.
The Coconimport is able to handle this new functionality. (Like POPs, frames and termination units which are placed into the IJselmeer on behalf of the ' bouwbestand' will not be deleted.)
Documentation of Webservices Login,ChangeDevicePort and Logout
Endpoint: http://cif.speerit.nl/CoconServices/FTTHManagement.asmx
WSDL: http://cif.speerit.nl/CoconServices/FTTHManagement.asmx?wsdl
ChangeDevicePort
The ChangeDevicePort webservice manages the registration of the patching inside a POP from a glasfiber (connected to a FTTH address) to a port on active equipment.
The FTTH fiber involved is identified by a Zipcode, HouseNumber, HouseNumberExtension, Room and Fiber (1 or 2)
The following parameters describe the information which is to be set:
strDevicePort: the identification of the active equipment port (AN100)
strOrderType: the type of order involving the new information, possible values are C (Patch change), P (Patch), D (De-Patch) , PP (Planned patch), PD (Planned de-patch)
strOrderId: the Order Id of the order (AN12)
strRequestUser: the active operator
The information is visible in Cocon for the terminated fibers in the POP
Possible error messages (SoapExceptions will be generated) include:
EquipmentportIdentification already provided on this patch (E-20012)
EquipmentportIdentification is required when Action code is P (E-20009)
EquipmentportIdentification must be empty when Action code is D (E-20008)
EquipmentportIdentification not provided on this patch (E-20015)
Fiber termination not found (E-20014)
Position involved in a normal patch (E-20013)
In order to call the ChangeDevicePort webservice one or more times the Login webservice must be called first, and all the ChangeDevicePort calls, the Logout has to be called.
The Login will start a Session and needs the caller support a cookiecontainer. The session will be ended after a Logout or after a certain time of no activity (typically 10 minutes or so).
It is important to end the session with a Logout to prevent the unnecessarily use of resources.
Login
The Login webservice has the following parameters:
strCentralCoconFolder: CIF17 or Cogas33;
strEnvironment: empty string
strUserName+strPassword: valid Cocon username and password to authenticate (Cocon permissions). A new username and password can be created by the SpeerIT servicedesk (servicedesk@speerit.nl)
strCulture=nl-NL for Dutch or en-US for English language (typically used for error rmessages)
Logout
The Logout webservice has no parameters
This call has to be fired at the end of a session so all the resources can be freed in a neat way.