Your Projector account may be hosted on any one of multiple Projector servers. Before consuming web services, it is necessary that your program ascertain the url of the server that hosts your company's data. Therefore, the first thing that your web services code should do is get the correct url by calling the GetWebServiceUrl service. Below is a C# example of retrieving your service url.
OpsProjectorSvc svc = new OpsProjectorSvc (); svc.OpsAuthenticationHeaderValue = new OpsAuthenticationHeader (); svc.OpsAuthenticationHeaderValue.AccountName = "(account-name)"; svc.OpsAuthenticationHeaderValue.EmailAddress = "(user-name)"; svc.OpsAuthenticationHeaderValue.Password = "(password)"; GetWebServiceUrlRq rq = new GetWebServiceUrlRq (); GetWebServiceUrlRs rs = svc.GetWebServiceUrl (rq); if (rs.WebServiceUrl != null) { svc.Url = string.Format("{0}/OpsProjectorWebSvc/OpsProjectorSvc.asmx", rs.WebServiceUrl); } // Use svc to invoke further web services
Please note that while you bypass this web service by directly using your company's url - we do not recommend that approach. Using this web service will ensure that your programs will always work, even in the event that your account is moved to a different server.
Request
The service request contains no inputs.
Response
The service returns the following results:
Name |
Data Type |
Discussion |
---|---|---|
WebServiceUrl |
string |
The URL of the server to direct web service calls to. Note that you need to append the location of the web services (/OpsProjectorWebSvc/OpsProjectorSvc.asmx) to this value. This may be null, in which case you do not need to re-point the web services. |