Das Interface erlaubt den automatischen Import von SIP Benutzern und SIP Benutzerdaten per XML Schnittstelle (ab Version 2016.6.1 Build 22614).

Mittels HTTP POST senden Sie ein einfach strukturiertes XML an die Domain oder an die IP Adresse des Enterprise Provisionierungsservers.

Testseite zum Upload einer XML-Datei:

https://<;Ihre Domain>/ninjaautoprovwebservice/sendAccounts.aspx

Diese Seite erlaubt zu Testzwecken den Datenimport mit einer erstellten XML Datei.  Die Daten werden "real" importiert. Legen Sie dazu vorzugsweise ein Testschema an oder löschen ggf. die zu Testzwecken importierten Daten über die Enterprise Webmanagement Oberfläche.

HTTP POST Service URL für den LIVE Betrieb:

https://<;Ihre Domain>//ninjaautoprov/services.aspx?import_crm_accounts

Beispielaufbau eines XML Post:

<?xml version="1.0" encoding="utf-8" ?>

<Provisioning>

  <Tasks>

    <Task Type="3011" Description="Insert accounts">

      <Agents>

        <Agent>

          <LastModified>2016-06-22T16:26:00</LastModified>

          <SchemeGUID>12345eaeeaeeaeeae5103845e9dc2f7f</SchemeGUID>

          <GroupGUID></GroupGUID>

          <Active>0</Active>

          <CRMAgentGUID>5qvvjx8gb0pdhewr5zj3ea6z8kr4mjcf</CRMAgentGUID>

          <CRMSecurityToken><![CDATA[JP^*%$iQG!MnNvhPP!mhnFW&l%3LdlnN]]></CRMSecurityToken>

          <FirstName>Hlima</FirstName>

          <LastName>Saboundji</LastName>

          <PCProvisioningCriteria>1</PCProvisioningCriteria>

          <PCProvisioningAuth>PC-1025</PCProvisioningAuth>

          <IntUsername>HablaScan1025</IntUsername>

          <IntPassword><![CDATA[JNy@hB@TteYrv!db]]></IntPassword>

          <CostUnit></CostUnit>

          <SipAccounts>

            <SipAccount>

              <Index>0</Index>

              <DisplayName>Phillipa Bertger</DisplayName>

              <Username>112</Username>

              <Password><![CDATA[f&I8o1!BM&%FNUzy]]></Password>

              <AuthUsername>112</AuthUsername>

            </SipAccount>

            <SipAccount>

              <Index>1</Index>

              <DisplayName>Phillipa</DisplayName>

              <Username>355</Username>

              <Password><![CDATA[c5238v765sd]]></Password>

              <AuthUsername>355</AuthUsername>

            </SipAccount>

          </SipAccounts>

        </Agent>

       </Agents>

    </Task>

  </Tasks>

</Provisioning>

Der XML Header sowie die XML Elemente <Provisioning>, <Tasks> und <Task> sind feststehend. Individuelle Änderungen sind im Element <Agents> möglich, dass einzelne Attribute und Werte im Element <Agent> für Benutzerdaten umschließt. <Agent> umfasst Detailinformationen zu einem Benutzer inklusive dessen SIP Konten <SipAccounts><SipAccount>.

Benutzerattribute <Agent>

Definition und Erklärung der Attribute und Werte des XML Element <Agent>.

Benutzerattribute <SipAccount>

Definition und Erklärung der Attribute und Werte des XML Element <SIPAccount>.

Beispielaufbau des RESPONSE zu einem XML Post: 

Das RESPONSE umfasst die Anzahl der erfolgreichen Importvorgänge (Gruppen, Accounts, SIP Accounts).

<?xml version="1.0" encoding="utf-16"?>

<XmlAccountsImporter_Response xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

    <CountInsertsGroups>0</CountInsertsGroups>

    <CountInsertsAccounts>2</CountInsertsAccounts>

    <CountInsertsAccountCredentials>3</CountInsertsAccountCredentials>

    <Exceptions />

    <Skips />

</XmlAccountsImporter_Response>

Systemfehler und fehlgeschlagene Importvorgänge werden in den Elementen <Exceptions> und <Skips> dargestellt. Exception sind grundliegende Fehler im Aufbau oder an der Serviceschnittstelle. Skips definieren Fehler die durch angegebene Attributwerte ausgelöst werden.

Mögliche Fehlermeldungen in der Rückgabe

Mögliche Verarbeitungsfehler in der Rückgabe