ManagedQuery  - AS3 ADEP Data Services

Diese addItemToCollectionOperation()- und removeItemFromCollectionOperation()-Methoden sind optionale Vorgänge. Mit ihnen können Sie eine Funktion definieren, die aufgerufen wird, wenn ein Element einer Sammlung hinzugefügt oder daraus entfernt wird. In vielen Fällen wird die Zugehörigkeit von Elementen zur Abfrage implizit ermittelt, d. h. mithilfe der Eigenschaftswerte. Der Server muss diese Vorgänge daher nicht verarbeiten. In diesen Fällen werden sie ignoriert. Verwenden Sie diese Methoden, falls Sie explizit eine Verknüpfungstabelle verwalten, die das Element mit einer entsprechenden Sammlung verknüpft.

Name eines Vorgangs im Dienst mit den gleichen Parametern wie dieser Vorgang, der die Anzahl der Elemente in der Abfrage zurückgibt. Verwenden Sie dies, wenn Sie Paging aktivieren, um die exakte Sammlungsgröße zu erhalten. Wenn Sie keinen Zählvorgang definieren, verwendet das System einen dynamischen Größenänderungsmodus, der die Elemente in der Sammlung seitenweise aufruft, wobei ein leerer Einschub verbleibt. Wenn Sie auf diesen leeren Einschub nicht zugreifen, wird die nächste Seite nicht aufgerufen. Wenn Sie auf diesen Einschub zugreifen, wird die nächste Seite aufgerufen und die Sammlungsgröße nimmt zu, bis keine verbleibenden Elemente mehr in der Abfrage vorhanden sind.

Seitengröße für diese Abfrage, wenn Paging aktiviert ist.

Legen Sie dies als „true“ fest, um Paging zu aktivieren. Ist Paging aktiviert, muss Ihr Vorgang Start- und Zählparameter aufweisen, um die Untergruppe der zurückzugebenden Elemente zu definieren. Sie stellen diese nicht für den Dienst bereit, wenn Sie den Vorgang aufrufen – sie werden automatisch hinzugefügt, wenn das System Seiten von Ihrem Server über On-Demand aufruft, d. h. als Reaktion auf getItemAt()-Aufrufe. Diese Aufrufe haben einen optionalen prefetch-Parameter, mit dem Sie die Anzahl der aufgerufenen Elemente in einem gegebenen Aufruf bestimmen können.

Ist Paging aktiviert, muss Ihr Vorgang Start- und Zählparameter aufweisen, um die Untergruppe der zurückzugebenden Elemente zu definieren. Sie stellen diese nicht für den Dienst bereit, wenn Sie den Vorgang aufrufen – sie werden automatisch hinzugefügt, wenn das System Seiten von Ihrem Server über On-Demand aufruft, d. h. als Reaktion auf getItemAt()-Aufrufe. Diese Aufrufe haben einen optionalen prefetch-Parameter, mit dem Sie die Anzahl der aufgerufenen Elemente in einem gegebenen Aufruf bestimmen können. Standardmäßig müssen Start- und Zählparameter „startIndex“ und „numItems“ heißen und können an einer beliebigen Stelle in der Signatur des Vorgangs auftreten. Wenn Sie dieses Flag auf „true“ setzen, können Sie diese beiden Parameter auch anders benennen. In diesem Fall müssen sie jedoch die letzten beiden Parameter des Vorgangs sein. Der vorletzte Parameter wird als Startparameter und der letzte als Zählparameter interpretiert.

Ein String in der Form „a,b,c“, der die Eigenschaftsnamen des von dieser Abfrage zurückgegebenen verwalteten Elements auflistet. Wenn nicht festgelegt, gibt die Abfrage alle Eigenschaften des Objekts zurück.

Die addItemToCollectionOperation()- und removeItemFromCollectionOperation()-Methoden sind optionale Vorgänge. Mit ihnen können Sie eine Funktion definieren, die aufgerufen wird, wenn ein Element einer Sammlung hinzugefügt oder daraus entfernt wird. In vielen Fällen wird die Zugehörigkeit von Elementen zur Abfrage implizit ermittelt, d. h. mithilfe der Eigenschaftswerte. Der Server muss diese Vorgänge daher nicht verarbeiten. In diesen Fällen werden sie ignoriert. Verwenden Sie diese Methoden, falls Sie explizit eine Verknüpfungstabelle verwalten, die das Element mit einer entsprechenden Sammlung verknüpft.

Wenn ein Element aus einer Sammlung entfernt wurde und Sie das Element löschen möchten, ist die Verwendung dieses Vorgangs nicht erforderlich. Legen Sie stattdessen die deleteItemOnRemoveFromFill-Eigenschaft fest. Der deleteItem-Vorgang wird dann auf dem Server automatisch aufgerufen, wenn das Element aus der Sammlung entfernt wird.

Name eines Vorgangs im Dienst mit denselben Parametern wie diese Abfrage, die die geänderten Elemente der Abfrage seit der letzten Abfrage berechnet. D. h., es wird eine synchronizeFill() für eine verknüpfte fill() durchgeführt.

Erstellt eine ManagedQuery. Der nameParameter legt den Namen des Dienstvorgangs fest, auf dem die ManagedQuery basiert. Dies ist ein erforderlicher Parameter, der für diesen Zweck allerdings als optionaler verwendet wird, damit diese Klasse in MXML verwendet werden kann.

Initialisiert den verwalteten Vorgang und gibt Fehler bei allen dabei auftretenden Konfigurationsproblemen aus.