Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Info

The SolarVista Provider object is part of the overall ServiceBroker Configuration object, in the following location:

SolarVista Provider object is used within the context of a REST Objects Providers (itself part of an REST Objects Configuration) to represent the details of how ServiceBroker is to be integrated with a SolarVista CRM for the relevant tenant.    

 



Panel
borderColorgrey
bgColorwhitesmoke

On this page:

Table of Contents
maxLevel3

Related pages:


SolarVista Provider Object Format

Code Block
languagejs
firstline1
titleJSON Format
linenumberstrue
Include Pageunknown page (AC1B2805017C4895924997295675665F)unknown page (AC1B2805017C4895924997295675665F)
collapsetrue
{
    "SolarVista": {
        "Host": "https://api-hub-live.solarvista.com", // Base URL for SolarVista API calls.
        "Features": {
            "_queryCustomerApptInfo": {
                "Endpoint": "/ServiceCentre/v2/{AccountId}/default/jobs/{jobId}/jobActions", // Endpoint for querying customer appointment information, with placeholders for account ID and job ID.
                "ResponseOverwrite": {
                    "ApptSearchInfo": {
                        "WorkType": {
                            "Name": "AL2" // Specifies the type of work for the appointment.
                        },
                        "Days": "YYYYYYY", // Format or criteria for selecting appointment days.
                        "Index": 0, // Index for the starting point of appointment search.
                        "OfferOptions": {
                            "AllowEmpOT": true // Option to allow employee overtime for appointments.
                        }
                    },
                    "ApptBookingInfo": {} // Container for appointment booking information, currently empty.
                }
            },
            "_createCustomerAppt": {
                "Endpoint": "https://sv-servicepowerintegration-fn-westeu-prod.azurewebsites.net/api/{AccountId}/createjob?code={AccountCode}", // Endpoint for creating a customer appointment, includes placeholders for account ID and account code.
                "ResponseOverwrite": {
                    // Similar structure to _queryCustomerApptInfo, used for creating appointments.
                }
            },
            "queryCustomerInfo": {
                "Endpoint": "/ContactCentre/v2/{AccountId}/{InstanceId}/customers" // Endpoint for querying customer information, with placeholders for account ID and instance ID.
            },
            "_updateCustomerApptInfo": {
                "Endpoint": "/ServiceCentre/v2/{AccountId}/{InstanceId}/jobActions/{jobActionId}" // Endpoint for updating customer appointment information, with placeholders for various IDs.
            }
        },
        "Props": {
            "AuthEndpoint": "https://login.windows.net/live.solarvista.com/oauth2/token", // Authentication endpoint for obtaining OAuth2 tokens.
            "AuthClientId": "a237d059-xxxx-xxxx-b6ca-xxxxx", // Client ID for OAuth2 authentication.
            "AuthClientSecret": "xxxxxx+6IZn7sPT/xxxx=", // Client secret for OAuth2 authentication.
            "AuthGrantType": "client_credentials", // Type of grant used for OAuth2 authentication.
            "AuthResource": "http://live.solarvista.com/live-service", // The resource URI for OAuth2 authentication.
            "AccountId": "6708189d-xxxx-xxxx-a4ce-xxxxx", // Unique identifier for the account.
            "AccountCode": "D0Qb%xxxxx%xxxxxxxx%3D%3D", // Encoded account code used in API calls.
            "InstanceId": "default", // Instance ID, used to specify a particular instance in multi-instance setups.
            "customerEquipments": "/ContactCentre/v2/{AccountId}/default/customers/{customerId}/equipment", // Endpoint for querying customer equipment, with placeholders for account ID and customer ID.
            "problemCodes": "/ServiceCentre/v2/{AccountId}/default/jobs/{equipmentClassID}/relatedproblems" // Endpoint for querying problem codes related to a specific class of equipment.
        }
    }
}

SolarVista Provider Object Properties


PropertyTypeRequired?Description
HoststringYesTBCBase URL for SolarVista API calls.
FeaturesobjectYes

TBCAn array of objects for features.


_queryCustomerApptInfo

objectYesTBCThe  query Customer Appointment information.


Endpoint

stringYesTBC"/ServiceCentre/v2/{AccountId}/default/jobs/{jobId}/jobActions", // Endpoint for querying customer appointment information, with placeholders for account ID and job ID.


ResponseOverwrite

objectYesTBCThe predefined Object to overwrite the appointment inform



ApptSearchInfo

objectYesTBCThe Appointment Search Informaton object.




WorkType

objectYesTBCThe Work Type object.





Name

stringYesTBCSpecifies the type of work for the appointment. e.g. "AL2"



Days

string

YesTBCFormat or criteria for selecting appointment days.



Index

integerYesTBCIndex for the starting point of appointment search.



OfferOptions

objectYesTBCc




AllowEmpOT

booleanYesTBCOption to allow employee overtime for appointments. e.g. true



ApptBookingInfo

objectYesTBCTBCContainer for appointment booking information, currently empty.









_createCustomerAppt

objectYesTBCThe Create Customer Appointment object array.


Endpoint

stringYesTBC"https://sv-servicepowerintegration-fn-westeu-prod.azurewebsites.net/api/{AccountId}/createjob?code={AccountCode}", // Endpoint for creating a customer appointment, includes placeholders for account ID and account code.


ResponseOverwrite

objectYesTBCSimilar structure to _queryCustomerApptInfo, use the preconfigured Object to overwrite the Appointment Search response.



ApptSearchInfo

objectYesTBCThe Appointment Search Informaton object.




WorkType

objectYesTBCThe Work Type object.





Name

stringYesTBCSpecifies the type of work for the appointment




Days

stringYesTBCFormat or criteria for selecting appointment days.




Index

integerYesTBCIndex for the starting point of appointment search.




OfferOptions

objectYesTBCThe Work Type object.





AllowEmpOT

booleanYesTBCOption to allow employee overtime for appointments. e.g. true



ApptBookingInfo

objectYesTBCTBCContainer for appointment booking information, currently empty.









_queryCustomerInfo

objectYesTBCThe  query Customer Appointment information.


Endpoint

stringYesTBCEndpoint for querying customer information, with placeholders for account ID and instance ID. e.g. "/ContactCentre/v2/{AccountId}/{InstanceId}/customers"

_updateCustomerApptInfo

objectYesTBCThe object that updates Customer Appointment information.


Endpoint

stringYesTBC"/ServiceCentre/v2/{AccountId}/{InstanceId}/jobActions/{jobActionId}" // Endpoint for updating customer appointment information, with placeholders for various IDs.

Props

objectYesTBCThe Props array object.

AuthEndpoint

stringYesTBC"/ServiceCentre/v2/{AccountId}/default/jobs/{jobId}/jobActions", // Endpoint for querying customer appointment information, with placeholders for account ID and job ID.

AuthClientId

stringYesTBC"xxx-xxxx-xx-xxx-xxxx", // Client ID for OAuth2 authentication.

AuthClientSecret

stringYesTBC"xxxxxxxxx=", // Client secret for OAuth2 authentication.

AuthGrantType

stringYesTBC"client_credentials", // Type of grant used for OAuth2 authentication.

AuthResource

stringYesTBC"http://live.solarvista.com/live-service", // The resource URI for OAuth2 authentication.

AccountId

stringYesTBC"xxxxx-xxxxx-4124-a4ce-xxxxx", // Unique identifier for the account.

AccountCode

stringYesTBC"xxxxxxxxxxxx", // Encoded account code used in API calls.

InstanceId

stringYesTBC"default", // Instance ID, used to specify a particular instance in multi-instance setups.

customerEquipments

stringYesTBC"/ContactCentre/v2/{AccountId}/default/customers/{customerId}/equipment", // Endpoint for querying customer equipment, with placeholders for account ID and customer ID.

problemCodes

stringYesTBC"/ServiceCentre/v2/{AccountId}/default/jobs/{equipmentClassID}/relatedproblems" // Endpoint for querying problem codes related to a specific class of equipment.