IPS_FindObjectID

 int IPS_FindObjectID (int $RemoteID, int $ServerID) 

Parameterliste

Rückgabewert

Lokale ID des gespiegelten Objekts. Ist keine Zuordnung vorhanden, wird 1 geliefert.

Beschreibung

Diese Funktion ist nur für den internen Gebrauch vorgesehen und kann sich jederzeit ohne Ankündigung ändern oder entfallen.

Die Funktion liest die Zuordnung der Objekt-IDs zwischen dem lokalen System und entfernten Systemen aus, welche von Sync Remote Instanzen gespiegelt werden (siehe Sync Remote). ServerID ist dabei die ID der lokalen Sync Remote Instanz.

Die Funktion liefert die lokale ID des Objekts, welches das Objekt RemoteID des entfernten Systems der Sync Remote Instanz ServerID spiegelt. Das Wurzelobjekt des entfernten Systems hat die RemoteID 0. Ist keine Zuordnung vorhanden, z.B. weil das Objekt noch nicht synchronisiert wurde, liefert die Funktion 1.

Die umgekehrte Richtung liefert IPS_GetRemoteObject.

Beispiel

$serverID = 54321; // ID der Sync Remote Instanz
$objectID = IPS_FindObjectID(23456, $serverID);
if ($objectID == 1) {
    echo "Das Objekt wird nicht gespiegelt";
} else {
    echo "Lokale ID: " . $objectID;
}

/* liefert z.B.:
Lokale ID: 12345
*/