...
- add() provides a netid, nodename, other arguments to create a node
- delete() provide a nodename, tell NetAdmin to delete the record
- getBilling() provide a netid, receive whether or not PTAEO required
- getNodeList() provide a netid, receive a list containing zero or more nodename(s) that are associated with that netid
- getNodeDetails() provide a nodename, receive the details for that nodename
- update() provide a nodename, provide arguments to change on the node
Table of Contents |
---|
WSDL details
Kazi has provided a WSDL conforming to the SPEC defined here:
add()
Arguments for add:
netid of owner
nodename (needs to be unique, and NOT exist already in the system)
client category (DS,MW,WS). This field is called "Policy Group" on the netAdmin API.
charge code (charge_cd which comes back in a response to getBilling())
Client OS (Windows, Mac, Unix)
interval (backup time, or never)
PTAEO, passed as five separate strings
...
Add method needs to return an error code indicating whether or not the add request was accepted, and for errors should indicate the problem with the data.
What is a policy_group? Can we have some examples? A policy group is the same thing as a Client Category: DS,MW,WS
PTAEO details
PTAEO consists of five strings:
...
Arguments for delete:
nodename (needs to be unique, and exist)
datestamp for date to delete, formatted as Oracle date (31-JAN-2013). This is awkward for ServiceNow, but native for NetBill. Furthermore, ServiceNow already has a method that formats months in this way for previous Oracle interactions.
Note |
---|
Existing Oracle New ServiceNow API: FUNCTION expireCBAccount expireCBAccountViaSN (a_node_name IN VARCHAR2, a_expire_date IN DATEVARCHAR2)New ServiceNow API: FUNCTION expireCBAccountViaSN (a_node_name IN VARCHAR2, a_expire_date IN DATE) RETURN NUMBER RETURN NUMBER
a_expire_date input expected format:MM/DD/YYYY 0 success -10 cb node does not exist -n database error occurred |
Info |
---|
You must pass in an Oracle date. No time component. WebMethods must convert whatever input is received from ServiceNow. 4 digit year is STRONGLY recommended. - rng3 |
...
Note |
---|
We have a view for this. ViewName:smart.YUSTART_CB_DETAILS_V select node_name from smart.yustart_cb_details_v where owning_netid=? This returns all nodes one owner netid owns. To filter node list by status, select node_name from smart.yustart_cb_details_v where owning_netid=? and status_cd=? status_cd can be 'A'-Active, 'RA'-Request Active,'RL'-Request Lock (still active),'L'-Locked(inactive),'RD'-Request Delete (inactive),'D'-Deleted |
Note |
---|
Need to know the exact flags to set. We want only Active nodes, owned by the netid. What is the flag we should set for status_cd? 'A'. |
Info |
---|
If you want a list of active nodes, use "status_cd in ('A', 'RL'). RA has not been created yet, so you can't perform any action on it. L, RD and D are already closed, so you can't take further action on them. |
...
Note |
---|
Existing oracle API: PROCEDURE getCBDetail (a_node_name IN VARCHAR2, |
update()
Arguments for update:
charge_code (gathered from a previous call to getSrvcChargeInfo() )
nodename (needs to be unique, and already exist)
client category (DS,MW,WS)
Client OS (Windows, Mac, Unix)
interval (backup time, or never)
PTAEO, passed as five separate strings
Note |
---|
We need charge_cd as one of the input arguments, we don't netid as input argument. Existing oracle API: FUNCTION updateCBAccount NEW METHOD PROCEDURE getCBNodeDetailViaSN (a_node_name IN VARCHAR2, 0 success -2 nodename is invalid |
update()
Arguments for update:
charge_code (gathered from a previous call to getSrvcChargeInfo() )
nodename (needs to be unique, and already exist)
client category (DS,MW,WS)
Client OS (Windows, Mac, Unix)
interval (backup time, or never)
PTAEO, passed as five separate strings
Note |
---|
We need charge_cd as one of the input arguments, we don't netid as input argument. Existing oracle API: FUNCTION updateCBAccount (a_node_name IN VARCHAR2, 0 success -3 charge code invalid -5 nodename has space -10 nodename is invalid -n database error occurred |
update method needs to return an error code indicating whether or not the add request was accepted, and for errors should indicate the problem with the data.
...