Page tree
Skip to end of metadata
Go to start of metadata

API Klassen und deren Funktionen können nur mit TecArt-System Version >= 3.2 genutzt werden

1. Methoden

1.1. addCall

Syntax:

int addCall( array $call )

Beschreibung:

Fügt einen Anruf hinzu

Gibt eine call_id zurück

Wirft eine CRMException im Fehlerfall.

$call ist ein assoziatives Array

Um Kontakte zuzuweisen müssen Sie die contact id oder einige Eigenschaften des Kontakts( aus $call_contact ) übergeben, das System erledigt den Rest.

Eigenschaften von $call array:

Type(Length)            Eigenschaft                  Beschreibung
---------------------------------------------------------------------------------------------
string(255)             $cid                      Contact-Id (Format: Contact-Id:Person-Id;Contact-Id2:Person-Id2;...) 
string(255)             $name                     Contact-Name 
int                     $time                     Anruf-Zeit (Unix-Timestamp)
string(255)             $subject                  Betreff des Anrufs
binary                  $body                     Nachricht des Anrufs
string(255)             $userid                   Userids (Format: User-Id1:User-Id2), -1 for NO userid
int                     $pid                      Projekt-Id 
int                     $ticket_id                Ticket-Id ( ab Version >= 4.1 )
int                     $orderid                  Auftrag-Id ( ab Version 4.2 )
int                     $duration                 Anrufdauer in Sekunden
int                     $done                     0 für "Anruf nicht erledigt", 1 für "Anruf erledigt"  
int                     $io                       0 für eingehenden Anruf, 1 für ausgehenden Anruf 
string(128)             $lnumber                  Lokale Telefonnummer (Angerufener)
string(128)             $rnumber                  Entfernte Telefonnummer (Anrufer)
string(128)             $city                     Ort des Anrufers
double                  $costs                    Anrufkosten in der gegebenen Währung( $currency )
string(3)               $currency                 Währung der Anrufkosten
string(255)             $category                 Kategorien, Format: Category1; Category2; ... 
double                  $obligingness             Die Kulanz für den Anruf
int                     $rem                      Wiedervorlage (1: wenn an den Anruf erinnert werden soll, 0 wenn nicht)
int                     $remtime                  Unix-Timestamp für die Wiedervorlage
int                     $private                  Privater Anruf (1: wenn der Anruf privat sein soll, 0: wenn öffentlich) (Version >= 3.2.2970)
int                     $ext_id                   Externe ID ( ab Version 4.2 )
array                   $call_contacts            Array mit contact values

Eigenschaften von $call_contacts array:

Type(Length)            Eigenschaft                  Beschreibung
---------------------------------------------------------------------------------------------
string(255)             $cid                      Contact Id ( Format: Cid:Pid )
int                     $ext_id                   Externe ID ( ab Version 4.2 )
string(128)             $firstname                Vorname 
string(128)             $lastname                 Nachname
string(128)             $displayname              Name, der in Listen erscheint 
string(128)             $nickname                 Spitzname
string(255)             $emailadr1                Erste E-Mail-Addresse
string(255)             $emailadr2                Zweite E-Mail-Addresse 
int                     $email_format             Bevorzugtes E-Mail-Format 
                                                  0 = Text
                                                  1 = HTML
string(128)             $screen_name              Screen Name, z.B. Messenger-Account 
string(128)             $phone_work               Telefonnummer Arbeit 
string(128)             $phone_home               Telefonnummer Privat 
string(128)             $phone_fax                Faxnummer Arbeit
string(128)             $phone_pager              Pager Nummer 
string(128)             $phone_mobil              Mobilnummer
string(128)             $home_address1            Adresszeile privat 1 
string(128)             $home_address2            Adresszeile privat 2 
string(128)             $home_city                Stadt
string(128)             $home_region              Region 
string(128)             $home_postcode            Postleitzahl 
string(128)             $home_country             Land 
string(128)             $home_website             Persönliche Website 
string(128)             $work_title               Titel auf Arbeit, z.B. CEO 
string(128)             $work_department          Abteilung
string(128)             $work_organisation        Organisations- oder Firmenname  
string(128)             $work_address1            Adresszeile Arbeit 1 
string(128)             $work_address2            Adresszeile Arbeit 2 
string(128)             $work_city                Stadt
string(128)             $work_region              Region 
string(128)             $work_postcode            Postleitzahl 
string(128)             $work_country             Land 
string(255)             $work_website             Offizielle Firmen-Website 
string(255)             $custom1                  Benutzerdefiniertes Feld 1 
string(255)             $custom2                  Benutzerdefiniertes Feld 2 
string(255)             $custom3                  Benutzerdefiniertes Feld 3 
string(255)             $custom4                  Benutzerdefiniertes Feld 4 
string(65535)           $notes                    Notizen

Beispiel

<?php
 
try {
	$call = array(
		'cid'           => 0,
		'time'          => time(),
		'name'          => "",
		'subject'       => 'test subject',
		'body'          => "Test body",
		'pid'           => "",
		'duration'      => 100,
		'done'          => 1,
		'lnumber'       => "036155656",
		'rnumber'       => "766333134",
		'city'          => "Erfurt",
		'costs'         => 12.77,
		'currency'      => "Euro",
		'category'      => "",
		'io'            => 1,
		'obligingness'  => '20,25',
		'rem'           => 1,
		'remtime'       => 1263830400,
		'call_contacts' => array(
			array(
				'firstname' => 'Axel',
				'lastname'  => 'Friedrich',
				'emailadr1' => 'axel.friedrich@dont-spam-me.de'
			),
			array(
				'firstname' => 'Thomas',
				'lastname'  => 'Fischer'
			)
		)
	);
 
	$crmapi_calls = crmapi::calls();
	$call_id      = $crmapi_calls->addCall($call);
}
catch (CRMException $e) {
	echo $e->getMessage();
}
 
echo $call_id;



1.2. getCall

Syntax:

array getCall( int $call_id )

Beschreibung:

Gibt den Anruf mit der gegebenen call id zurück.

Wirft eine CRMException im Fehlerfall.

Eigenschaften der zurückgegebenen call array:

sind die selben wie für getCalls

Beispiel:

<?php
try {
    $crmapi_calls = crmapi::calls();
 
    //Get call with id 5457:
    $result = $crmapi_calls->getCall(5457);
}
catch (CRMException $e) {
    echo $e->getMessage();
}
 
echo print_r($result, true);




1.3. changeCall

Syntax:

int changeCall( int $callid, array $call)

Beschreibung:

Ändert Eigenschaften eines bestehenden Anrufs.

Gibt eine $call_id zurück.

Wirft eine CRMException im Fehlerfall.

Eigenschaften von $call array:

same as for addCall

Beispiel:

<?php
try {
    $crmapi_calls = crmapi::calls();
     
    $call = array();
    $call['subject'] = 'changed test call';
 
    $result = $crmapi_calls->changeCall( 9228, $call );
}    
catch (CRMException $e) {
    echo $e->getMessage();
}
 
echo "Successfully changed call with id 9228.<br/>\n";



1.4. getCalls

Syntax:

array getCalls( int $userid, int $day, int $month, int $year )

Beschreibung:

Gibt ein calls Array zurück.

Wirft eine CRMException im Fehlerfall.

Wenn userid gegeben ist, werden Anrufe für den User nur zurückgegeben, wenn der authentifizierte Benutzer Leseberechtigungen hat. Wenn userid auf -1 gesetzt wird, werden alle Anrufe für den authentifizierten Nutzer zurückgegeben.

Wenn day, month and year gegeben sind, werden nur Anrufe für den entsprechenden Tag zurückgegeben.

Wenn month and year gegeben sind, werden nur Anrufe für den entsprechenden Monat zurückgegeben.

Wenn year gegeben ist, werden nur Anrufe für das entsprechende Jahr zurückgegeben.

Sie können day auf 0 setzen um den kompletten Monat zu sehen oder day und month auf 0 setzen um das komplette Jahr zu sehen oder day, month und year auf 0 setzen um alle Anrufe zu sehen.

Eigenschaften der zurückgegebenen $calls array:

Type(Length)            Eigenschaft                  Beschreibung
---------------------------------------------------------------------------------------------
int                     $id                       Call-Id
int                     $ext_id                   Externe ID ( ab Version 4.2 )
string(255)             $cid                      Contact-Id (Format: Contact-Id:Person-Id;Contact-Id2:Person-Id2;...) 
string(255)             $name                     Contact-Name 
int                     $time                     Anruf-Zeit (Unix-Timestamp)
string(255)             $subject                  Betreff des Anrufs
binary                  $body                     Nachricht des Anrufs
string(255)             $userid                   Userids (Format: User-Id1:User-Id2
int                     $chguser                  Userid der letzten Änderung
int                     $chgtime                  Unix-Timestamp der letzten Änderung 
int                     $pid                      Project-Id 
int                     $ticket_id                Ticket-Id ( ab Version >= 4.1 )
int                     $orderid                  Auftrag-Id ( ab Version 4.2 )
int                     $duration                 Anrufdauer in Sekunden
int                     $done                     0 für "Anruf nicht erledigt", 1 für "Anruf erledigt"  
int                     $io                       0 für eingehenden Anruf, 1 für ausgehenden Anruf
string(128)             $lnumber                  lokale Telefonnummer ( Angerufener ) 
string(128)             $rnumber                  entfernte Telefonnummer ( Anrufer )
string(128)             $city                     Ort der entfernten Telefonnummer
double                  $costs                    Kosten in der gegebenen Währung( $currency )
string(3)               $currency                 Währung des Anrufs
int                     $createuser               Userid der Erstellung
int                     $createtime               Unix-Timestamp der Erstellung
string(255)             $category                 Kategorien, Format: Category1; Category2; ... 
double                  $obligingness             Kulanz des Anrufs
int                     $rem                      Wiedervorlage (1: an den Anruf wird erinnert, and 0: an den Anruf wird nicht erinnert)
int                     $remtime                  Unix-Timestamp der Wiedervorlage
int                     $private                  Privater Anruf (1: der Anruf ist private, und 0: der Anruf ist öffentlich) (Version >= 3.2.2970)
array                   $call_contacts            Array mit call Kontakt-Werte
array                   $call_projects            Array mit call Projekt-Werte (Version >= 3.4.5096)

Eigenschaften von $call_contacts array:

Type(Length)            Eigenschaft                  Beschreibung
---------------------------------------------------------------------------------------------
string(255)             $cid                      Contact Id ( Format: Cid:Pid )
int                     $ext_id                   Externe ID ( ab Version 4.2 )
string(128)             $firstname                Vorname
string(128)             $lastname                 Nachname
string(128)             $displayname              Name, der in Listen erscheint 
string(128)             $nickname                 Spitzname
string(255)             $emailadr1                First E-Mail-Address 
string(255)             $emailadr2                Second E-Mail-Address 
int                     $email_format             Preferred Format 
                                                  0 = Text
                                                  1 = HTML
string(128)             $screen_name              Screen Name, e.g. Messenger-Account 
string(128)             $phone_work               Phone Number at Work 
string(128)             $phone_home               Phone Number at Home 
string(128)             $phone_fax                Fax Number at Work 
string(128)             $phone_pager              Pager Number 
string(128)             $phone_mobil              Cellular Number
string(128)             $home_address1            Home Address Line 1 
string(128)             $home_address2            Home Address Line 2 
string(128)             $home_city                Hometown 
string(128)             $home_region              Home Region 
string(128)             $home_postcode            Home ZIP 
string(128)             $home_country             Home Country 
string(128)             $home_website             Personal Website 
string(128)             $work_title               Title at Work, e.g. CEO 
string(128)             $work_department          Department
string(128)             $work_organisation        Org- or Company Name  
string(128)             $work_address1            Work Address Line 1 
string(128)             $work_address2            Work Address Line 2 
string(128)             $work_city                Work City 
string(128)             $work_region              Work Region 
string(128)             $work_postcode            Work ZIP 
string(128)             $work_country             Work Country 
string(255)             $work_website             Offical Company Website 
string(255)             $custom1                  Custom Field 1 
string(255)             $custom2                  Custom Field 2 
string(255)             $custom3                  Custom Field 3 
string(255)             $custom4                  Custom Field 4 
string(65535)           $notes                    Notes
string                  $picture                  Contact Picture Data - base64 encoded
int                     $chguser                  Userid of last modification 
int                     $chgtime                  Unix-Timestamp of last modification 
int                     $createuser               Userid of task creation 
int                     $createtime               Unix-Timestamp of task creation 

Eigenschaften von $call_projects array:

Type(Length)      Eigenschaft             Beschreibung
-------------------------------------------------------------------
int               $pid                 Project-Id 
int               $ext_id              Externe ID ( ab Version 4.2 )
string(255)       $name                Projektname 
string(50)        $number              Projektnummer 
string(255)       $url                 URL des Projekts (Website) 
int               $start               Startdatum & Zeit als Unix-Timestamp 
int               $stop                Stopdatum & Zeit als Unix-Timestamp 
int               $done                Fertigstellung in Prozent
double            $budget              Projektbudget
string(65535)     $notes               Projektnotizen
int               $leader              Projektleiter Userid  
int               $substitute          Stellv. Projektleiter Userid 
string(65535)     $shortnotes          Projekt Kurzbeschreibung
int               $invoice             Rechnung erstellt? Mögliche Werte: 0, 1
int               $priority            Priorität, Mögliche Werte: -1 = niedrig, 0 = normal, 1 = hoch
string(255)       $category            Projektkategorien, Format: Category1:Category2:... 
int               $chguser             Userid der letzten Änderung
int               $chgtime             Unix-Timestamp der letzten Änderung 
int               $createuser          Userid der Erstellung
int               $createtime          Unix-Timestamp der Erstellung
string(255)       $user19              Benutzerdefiniertes Feld Nr. 19
string(255)       $user20              Benutzerdefiniertes Feld Nr. 20
   :                  :                           :
string(255)       $user80              Benutzerdefiniertes Feld Nr. 80 

Beispiel:

<?php
$crmapi_calls = crmapi::calls();
 
//Get all Calls for 10.10.2010:
$result = $crmapi_calls->getCalls(-1, 10, 10, 2010);
 
foreach($result as $call) {
 
	foreach($call as $key => $val) {
		echo "$key => $val<br>\n";
		if (is_array($val) && count($val) {
			print_r($val);
		}
	}
}



1.5. getCallsFrom

Syntax:

array getCallsFrom( int $userid, int $day, int $month, int $year ) 

Beschreibung:

Gibt ein Array mit call values ab dem gegebenem Datum zurück.

Wenn userid gegeben ist, werden Anrufe für den User nur zurückgegeben, wenn der authentifizierte Benutzer Leseberechtigungen hat. Wenn userid auf 0 gesetzt wird, werden alle Anrufe für den authentifizierten Nutzer zurückgegeben.

Wenn day, month and year gegeben sind, werden nur Anrufe für den entsprechenden Tag zurückgegeben.

Wenn month and year gegeben sind, werden nur Anrufe für den entsprechenden Monat zurückgegeben.

Wenn year gegeben ist, werden nur Anrufe für das entsprechende Jahr zurückgegeben.

Sie können day auf 0 setzen um den kompletten Monat zu sehen oder day und month auf 0 setzen um das komplette Jahr zu sehen oder day, month und year auf 0 setzen um alle Anrufe zu sehen.

Eigenschaften der zurückgegebenen calls array:

sind die selben wie für getCalls

Beispiel:

<?php
 
try {
    $crmapi_calls = crmapi::calls();
 
    //Get all Calls from 10.10.2010:
    $result = $crmapi_calls->getCallsFrom(-1, 10, 10, 2010);
}
catch (CRMException $e) {
    echo $e->getMessage();
}
foreach($result as $call) {
   
    foreach($call as $key => $val) {
        echo "$key => $val<br>  \n";
        if (is_array($val) && count($val) {
			print_r($val);
		}
    }
}



1.6. getChangedCalls

Syntax:

array getChangedCalls( int $userid, int $timestamp ) 

Beschreibung:

Gibt ein array mit calls zurück, die seit timestamp geändert wurden.

Wenn userid gegeben ist, werden Anrufe für den User nur zurückgegeben, wenn der authentifizierte Benutzer Leseberechtigungen hat. Wenn userid auf 0 gesetzt wird, werden alle Anrufe für den authentifizierten Nutzer zurückgegeben.

Eigenschaften von returned call objects:

sind die selben wie für getCalls

Beispiel:

<?php
try {
    $crmapi_calls = crmapi::calls();
 
    //Get Calls modified in the last 30 days:
    $result       = $crmapi_calls->getChangedCalls(0, time() - 60 * 60 * 24 * 30);
 
    foreach($result as $call) {
        foreach($call as $key => $val) {
            echo "$key => $val<br>\n";
            if (is_array($val) && count($val) {
				print_r($val);
			}
        }
    }
}
catch (CRMException $e) {
    echo $e->getMessage();
}



1.7. getChangedCallsLimit

Syntax:

array getChangedCallsLimit( int $userid, int $timestamp, int $count, int $offset )

Beschreibung:

Gibt ein Array mit calls zurück die Seit timestamp verändert wurden, limitiert durch count und offset.

Wirft eine CRMException im Fehlerfall.

Wenn userid gegeben ist, werden Anrufe für den User nur zurückgegeben, wenn der authentifizierte Benutzer Leseberechtigungen hat. Wenn userid auf 0 gesetzt wird, werden alle Anrufe für den authentifizierten Nutzer zurückgegeben.

Eigenschaften von $call array:

sind die selben wie für getCalls

Beispiel:

<?php
try {
    $crmapi_calls = crmapi::calls();
 
    //Get the 5 last calls modified in the last 30 days:
    $result       = $crmapi_calls->getChangedCallsLimit(0, time() - 60 * 60 * 24 * 30, 5, 0);
 
    foreach($result as $call) {
        foreach($call as $key => $val) {
            echo "$key => $val<br>\n";
            if (is_array($val) && count($val) {
				print_r($val);
			}
        }
    }
}
catch (CRMException $e) {
    echo $e->getMessage();
}


1.8. getCallIds

Syntax:

array getCallIds( int $userid, int $timestamp )

Beschreibung:

Gibt ein Array mit call Ids für Anrufe zurück, die seit timestamp verändert wurden.

Wirft eine CRMException im Fehlerfall.

Wenn userid gegeben ist, werden Anrufe für den User nur zurückgegeben, wenn der authentifizierte Benutzer Leseberechtigungen hat. Wenn userid auf 0 gesetzt wird, werden alle Anrufe für den authentifizierten Nutzer zurückgegeben.

Beispiel:

<?php
try {
    $crmapi_calls = crmapi::calls();
 
    //Get call ids modified in the last 30 days:
    $result = $crmapi_calls->getCallIds(0, time() - 60 * 60 * 24 * 30 );
}
catch (CRMException $e) {
    echo $e->getMessage();
}
 
foreach($result as $id) {
    echo "$id<br>  \n";
}



1.9. deleteCall

Syntax:

void deleteCall( int $callid )

Beschreibung:

Löscht den Anruf mit der gegebenen call id.

Wirft eine CRMException im Fehlerfall.

Beispiel:

<?php
try {
    $crmapi_calls = crmapi::calls();
 
    $result = $crmapi_calls->deleteCall( 9228 );
}
catch (CRMException $e) {
    echo $e->getMessage();
}
 
echo "Successfully changed call 9228\n"; 


1.10. getIdByExtId

(Version >= 4.2)

Syntax:

array getIdByExtId( string $external_id )

Beschreibung

Liefert interne ID(s) von Anrufen mit der übergebenen externen ID zurück.

Im Falle eines Fehlers wird eine CRMException mit mehr Fehlerdetails geworfen.

Eigenschaften des zurückgegebenen call ids array:

Type(Length)            Eigenschaft                  Beschreibung
---------------------------------------------------------------------------------------------
int			$id			      Task-Id 

Beispiel:

<?php
 
try {   
    $crmapi_calls = crmapi::calls();
   
    $result = $crmapi_calls->getIdByExtId(12345);
}
catch (CRMException $e) {
    echo $e->getMessage();
}
 
foreach($result as $id) {
    echo $id."<br>  ";
}



1.11. getAllExtIds

(Version >= 4.2)

Syntax:

array getAllExtIds( string $external_id )

Beschreibung

Liefert eine Liste aller externen IDs in Anrufen zurück.

Im Falle eines Fehlers wird eine CRMException mit mehr Fehlerdetails geworfen.

Eigenschaften des zurückgegebenen call ids array:

Type(Length)            Eigenschaft                  Beschreibung
---------------------------------------------------------------------------------------------
int			$id			      externe Task-Id 

Beispiel:

<?php
 
try {   
	$crmapi_calls = crmapi::calls();
   
	$result = $crmapi_calls->getAllExtIds();
}
catch (CRMException $e) {
	echo $e->getMessage();
}
 
foreach($result as $id) {
	echo $id."<br>  ";
}
 




1.12. getPermissions

(Version >= 4.5.17365)

Syntax:

array getPermissions( array $call_ids ) 

Beschreibung:

Gibt ein assoziatives $objects_permissions array mit den Berechtigungen für die Anrufe mit den gegebenen $call_ids zurück.

Setzt eine Lizenz mit Aktivitätenrechten und aktivierte Aktivitätenrechte für dieses Modul voraus.

Wirft eine CRMException im Fehlerfall.

Eigenschaften von $objects_permissions array:

Type(Length)	   Eigenschaft          Beschreibung
-------------------------------------------------------------------------------
int                Key                  Call ID
array		   Value                Array mit $permissions array

Eigenschaften von $permissions array:

Type(Length)	   Key                  Value       
-------------------------------------------------------------------------------
array		   user_perm            Array mit $user_permission arrays
array		   group_perm           Array mit $group_permission arrays

Eigenschaften von $user_permission array:

Type(Length)	   Eigenschaft          Beschreibung
-------------------------------------------------------------------------------
int                Key                  User's ID
array		   Value                read:   1 = gesetzt, 0 = nicht gesetzt, -1 = verweigert
                                        write:  1 = gesetzt, 0 = nicht gesetzt, -1 = verweigert
                                        delete: 1 = gesetzt, 0 = nicht gesetzt, -1 = verweigert

Eigenschaften von $group_permission array:

Type(Length)	   Eigenschaft          Beschreibung
-------------------------------------------------------------------------------
int                Key                  Group's ID
array		   Value                read:   1 = gesetzt, 0 = nicht gesetzt, -1 = verweigert
                                        write:  1 = gesetzt, 0 = nicht gesetzt, -1 = verweigert
                                        delete: 1 = gesetzt, 0 = nicht gesetzt, -1 = verweigert

Beispiel:

<?php
 
try {
    $crmapi_calls = crmapi::calls();
 
    $permissions  = $crmapi_calls->getPermissions( array(15, 20, 100) );
}
catch (CRMException $e) {
    echo $e->getMessage();
}
 
print_r($permissions);



1.13. setPermissions

(Version >= 4.5.17365)

Syntax:

array getPermissions( array $objects_permissions ) 

Beschreibung:

Setzt die Berechtigungen für mehrere Anrufe

Setzt eine Lizenz mit Aktivitätenrechten und aktivierte Aktivitätenrechte für dieses Modul voraus.

Wirft eine CRMException im Fehlerfall.

Eigenschaften von $objects_permissions array:

Type(Length)	   Eigenschaft          Beschreibung
-------------------------------------------------------------------------------
int                Key                  Call ID
array		   Value                Array mit $permissions array

Eigenschaften von $permissions array:

Type(Length)	   Key                  Value       
-------------------------------------------------------------------------------
array		   users                Array mit $user_permission arrays
array		   groups               Array mit $group_permission arrays

Eigenschaften von $user_permission array:

Type(Length)	   Eigenschaft          Beschreibung
-------------------------------------------------------------------------------
int                Key                  User's ID
array		   Value                read:   1 = gesetzt, 0 = nicht gesetzt, -1 = verweigert
                                        write:  1 = gesetzt, 0 = nicht gesetzt, -1 = verweigert
                                        delete: 1 = gesetzt, 0 = nicht gesetzt, -1 = verweigert

Eigenschaften von $group_permission array:

Type(Length)	   Eigenschaft          Beschreibung
-------------------------------------------------------------------------------
int                Key                  Group's ID
array		   Value                read:   1 = gesetzt, 0 = nicht gesetzt, -1 = verweigert
                                        write:  1 = gesetzt, 0 = nicht gesetzt, -1 = verweigert
                                        delete: 1 = gesetzt, 0 = nicht gesetzt, -1 = verweigert

Beispiel:

<?php
 
try {
    $crmapi_calls = crmapi::calls();
 
    $permissions = array(
		81941 => array(
			'users'  => array(
				'56' => array('read' => -1, 'write' => -1, 'delete' => -1)
			),
			'groups' => array(
				'4'  => array('read' => -1, 'write' => -1, 'delete' => -1) 
			)
		),
		79331 => array(
			'groups' => array(
				'4'  => array('read' => -1, 'write' => -1, 'delete' => -1)
			)
		)
	);
 
    $crmapi_calls->setPermissions($permissions);
}
catch (CRMException $e) {
    echo $e->getMessage();
}



1.14. getsearchfilteredCalls

(Version >= 4.7.20468)

Syntax:

array getsearchfilteredCalls(int $filter_id, string $search = "", int $count = 0, int $offset = 0, array $fields = false)

Beschreibung:

Gibt ein Array mit Anrufen zurück, die dem angegebenen Suchfilter und Suchbegriff entsprechen, limitiert von count und offset.

Der Parameter search repräsentiert die Eingabe im Suchfeld im CRM (Platzhalter <#search_field#> in Filterbedingungen)

Über den Parameter fields können die zurückgegeben Felder eingeschränkt werden (false = alle Felder)

Im Falle eines Fehlers wird eine CRMException mit mehr Fehlerdetails geworfen.

Hinweis: Es werden nur Anrufe und Felder zurückgegeben, für die der authentifizierte Nutzer Leseberechtigungen hat.

Eigenschaften:

Das sind dieselben wie für getCalls, evtl eingeschränkt nach Parameter fields.

Beispiel:

<?php
 
try {   
	$crmapi_calls = crmapi::calls();
 
	// Liefert die Felder Rufnummer, anrufende Nummer und die Dauer der ersten 10 gefundenen Anrufe, die dem Suchfilter 5 ohne eingegebenen Suchbegriff entsprechen
	$result = $crmapi_calls->getsearchfilteredCalls(5, "", 10, 0, array('lnumber', 'rnumber', 'duration'));
 
	// Liefert alle Felder aller Anrufe, die dem Suchfilter 5 mit eingegebenen Suchbegriff "test" entsprechen
	$result = $crmapi_calls->getsearchfilteredCalls(5, 'test', 0, 0, false);
}
catch (CRMException $e) {
	echo $e->getMessage();
}
 
print_r($result);
 
  • No labels