DataManager  - AS3 ADEP Data Services

Instance d’une classe contrôlant les interactions avec le serveur.

Indique si les modifications apportées au cache local sont automatiquement validées. Les modifications validées sont envoyées immédiatement au service distant.

La valeur par défaut est true pour les instances DataService, qui sont les gestionnaires de données utilisés avec le service de gestion des données côté serveur.

La valeur par défaut est false pour les instances RPCDataManager, qui sont les gestionnaires de données procurant les fonctionnalités de gestion des données côté client aux composants de service RPC, tels que RemoteObject, HTTPMultiService et WebService.

Indique si ce service doit essayer d’établir une connexion pour les opérations qui nécessitent une connexion. Les opérations telles que fill(), getItem() et count() essaient d’établir une connexion si le service est déconnecté et que la valeur de autoConnect est true. Utilisez cette propriété pour contrôler le comportement des applications qui se connectent de façon occasionnelle.

La valeur par défaut est true.

Si la valeur est définie sur false, lorsque des modifications sont transférées de la destination distante vers le client, elles ne sont pas appliquées immédiatement. En revanche, la propriété mergeRequired est définie sur true.

Un gestionnaire d’événement peut être enregistré pour écouter les événements change liés à cette propriété, afin d’être informé lorsqu’une fusion est nécessaire.

Pour fusionner des modifications, appelez la méthode merge() pour que toutes les modifications soient appliquées.

Les modifications non validées ne peuvent pas être validées lorsque des modifications doivent être fusionnées.

Si la pagination est activée, toutes les demandes concernant des éléments non locaux sont mises en cache, jusqu’à ce que la méthode merge() soit appelée. Une fois la méthode merge() appelée, les demandes mises en cache sont traitées.

La valeur par défaut est true.

Vous pouvez stocker le cache local contenant les données et les modifications sur le disque. Lorsque la valeur de la propriété autoSaveCache est true, chaque fois qu’une modification est réalisée ou qu’une demande distante est renvoyée, ces données sont enregistrées sur le disque. Si un problème survient lors de l’enregistrement des données, soit parce que le disque est saturé, soit parce que les autorisations en écriture sont refusées, un événement FaultEvent est distribué ou une erreur Fault est renvoyée.

Si cette valeur est définie sur false (valeur par défaut), les données et les modifications ne sont pas enregistrées sur le disque. Pour forcer l’enregistrement sur le disque des données et modifications actuelles, utilisez la méthode saveCache().

La valeur par défaut est false.

Eléments de l’API associés

Lorsque la valeur est true, les demandes fill(), createItem() et getItem() renvoient les éléments qui écoutent les mises à jour réalisées sur ces éléments à partir de la destination distante. Lorsqu’une modification est apportée à cette valeur de propriété, elle est appliquée uniquement aux appels ultérieurs des méthodes, pas aux collections ou éléments existants.

Si des éléments apparaissent dans plusieurs collections et que certaines de ces collections ont été extraites avec autoSyncEnabled et que d’autres ont été remplies sans autoSyncEnabled, ces éléments continuent à recevoir des événements de mise à jour.

La valeur par défaut est true.

Permet d’accéder à l’identificateur de cache de ce service. Un identificateur de cache doit être défini avant de réaliser des opérations qui font appel à des données stockées localement sur disque. Si aucun identificateur de cache n’est défini, toutes les méthodes et propriétés du cache sont considérées comme étant incohérentes et une erreur DataServiceError est renvoyée lorsqu’une opération faisant appel à des données du disque local est réalisée. Cette propriété fournit un identificateur « session » unique pour les données stockées localement. Le développeur doit affecter à cette propriété une valeur unique dans l’ensemble de l’application.

La propriété est considérée comme non définie si sa valeur null ou une chaîne vide. Les demandes de données réalisées à l’aide des méthodes fill() et getItem() essaient d’accéder tout d’abord aux données locales du disque si la propriété cacheID a été définie. Si la propriété cacheID n’est pas définie, aucune tentative d’accès aux données locales n’est réalisée.

Détermine s’il existe des modifications non validées et si la méthode commit() doit être appelée. Lorsque la valeur de cette propriété change, un événement est distribué. Cette propriété peut être utilisée dans une application pour fournir une réponse visuelle.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement propertyChange .

Permet d’accéder à l’implémentation actuellement utilisée pour détecter les conflits liés aux opérations distantes transférées vers cette instance DataManager.

Contient un objet Conflicts, c’est-à-dire une instance ArrayList d’instances Conflict.

Les conflits doivent être résolus avant d’appeler la méthode commit(). Les conflits peuvent être résolus en parcourant la liste des conflits et en résolvant un à un chacun d’entre eux, ou en appelant la méthode acceptAllClient() ou acceptAllServer() sur cette propriété.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement propertyChange .

Indique si l’instance DataService est connectée à la destination distante.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement propertyChange .

Contient un objet de type mx.data.DataStore. L’instance DataStore gère l’ensemble des modifications entrantes et sortantes d’une ou plusieurs instances DataManager, qui peuvent contenir des références les unes aux autres. Lorsque vous procédez à une validation dans une instance DataStore, toutes les modifications en attente de toutes les instances DataManager utilisant cette instance DataStore sont validées.

Par défaut, une instance DataManager partage la même instance DataStore avec d’autres instances DataManager si elles possèdent des propriétés d’association gérées et partagent le même ensemble de canaux. Lorsque des instances DataStore sont partagées, un appel de la méthode commit sur une instance DataManager valide toutes les modifications de toutes les instances DataManager utilisant ce magasin de données. L’ordre des opérations est ainsi préservé, dans le cas où il existe des dépendances entre les modifications présentes dans les lots de modifications non validées.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement propertyChange .

Par défaut, lorsque vous appelez la méthode removeItemAt() sur une collection remplie gérée, elle lance un appel de suppression d’élément vers le serveur pour supprimer physiquement l’élément. Vous pouvez ainsi utiliser un code utilisant une collection gérée et une collection non gérée de la même manière. Cependant, dans certaines situations, il peut être utile de supprimer l’élément de la collection du client sans le supprimer du serveur. Pour ce faire, définissez cet indicateur sur false avant d’appeler la méthode removeItemAt().

Notez que les collections qui sont des associations ne sont pas affectées. Seules sont concernées les collections qui ont été utilisées avec la méthode fill().

La valeur par défaut est true.

Indique si le stockage hors connexion doit être chiffré pour les clients AIR qui utilisent un adaptateur SQL déconnecté.

Pour les clients Flex basés sur navigateur, les données déconnectées ne peuvent pas être chiffrées.

Cet indicateur détermine si l’application doit réaliser une requête sur le magasin local lorsqu’il n’est pas connecté. Par défaut, lorsque l’adaptateur déconnecté est configuré pour prendre en charge l’exécution des requêtes dynamiques, l’appel de la méthode fill() n’entraîne pas l’interrogation du magasin local lorsque l’application n’est pas connectée. Si l’instance fallBackToLocalFill est définie sur true, le magasin local est également interrogé lorsque l’application est déconnectée.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement propertyChange .

Les associations peuvent éventuellement répertorier les événements de modification de propriété relatifs aux propriétés des instances associées. Vous pouvez définir ce comportement pour une association à l’aide de l’attribut de configuration hierarchical-events. Si vous ne définissez pas l’attribut hierarchical-events, les associations d’une destination particulière utilisent cette propriété pour déterminer la valeur par défaut.

La valeur par défaut est false. Dans le cas des objets stockés dans une arborescence (et non dans un graphe cyclique), il peut parfois être utile de définir cette propriété sur true pour certaines destinations. Si vous utilisez les propriétés de vos propriétés dans un rendu d’élément, par exemple, le fait de définir cette valeur sur true pour cette propriété d’association provoque l’actualisation de la grille lorsque les propriétés de ces propriétés changent. Le système est conçu de telle sorte qu’il évite d’envoyer des événements récursifs ou de créer de grandes chaînes d’événements (par exemple parent.child[0].child[1].child[3]).

La valeur par défaut est false.

Indique si les modifications apportées aux collections gérées doivent être ignorées au lieu d’être communiquées au serveur lors d’une validation.

La valeur par défaut est false.

Pour optimiser la vitesse de votre application, définissez cette propriété sur false si le nombre de remplissages ou de références concernant les éléments gérés par cette instance DataManager et issus des propriétés d’association d’autres éléments est relativement limité.

Indique si les métadonnées associées à cette instance DataManager sont initialisées.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement propertyChange .

Permet d’accéder à l’instance ManualSyncConfiguration de chaque instance DataManager. La classe ManualSyncConfiguration permet de s’abonner aux modifications réalisées par d’autres clients ou sur le serveur et de contrôler la manière dont vos modifications sont publiées auprès des autres clients abonnés à cette interface.

Détermine le nombre maximal de messages par seconde que l’instance DataManager souhaite recevoir. Un serveur comprenant cette valeur l’utilise comme entrée pour déterminer la vitesse d’envoi des messages à l’instance DataManager.

La valeur par défaut 0 signifie que l’instance DataManager n’a pas de préférence concernant la vitesse d’envoi des messages. Cette propriété doit être définie avant que l’instance DataManager ne s’abonne. En outre, les modifications apportées après l’abonnement ne seront pas appliquées tant que l’abonnement de l’instance DataManager n’aura pas été résilié, puis réactivé.

La valeur par défaut est 0.

Indique s’il existe des modifications en attente à fusionner.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement propertyChange .

Renvoie un objet de type mx.data.DataServiceOfflineAdapter. L’adaptateur déconnecté contrôle l’implémentation de la façon dont les objets sont conservés dans le magasin local(SQLLite/LSO).

Permet d’accéder à la taille de page actuelle de toutes les collections.

Indique si la destination distante est configurée pour autoriser les demandes de page.

Priorité par défaut des messages envoyés par l’instance DataManager. Les valeurs possibles sont les valeurs comprises entre 0 et 9 (0 correspondant à la priorité la plus faible), ainsi que -1, qui signifie que l’instance DataManager n’a pas de niveau de priorité attribué. Si un niveau de priorité est déjà défini pour le message, cette propriété est prioritaire par rapport à la valeur déjà définie.

Permet d’accéder au délai d’expiration des demandes d’une opération, en secondes. Une valeur inférieure ou égale à zéro empêche l’expiration des demandes. Lorsqu’une opération actuelle expire parce que la limite requestTimeout a été atteinte, une erreur est distribuée pour cette opération, pour indiquer que la demande a expiré. Lorsqu’une opération expire, cela ne signifie pas dans tous les cas que le serveur n’a pas reçu cette opération. Cela peut provoquer ainsi une désynchronisation entre l’état du client et le serveur.

Lorsque cette propriété est définie sur true, un événement RESET est envoyé une fois l’opération terminée. Lorsque cette propriété a la valeur false, seuls les événements incrémentiels ADD/REMOVE sont envoyés pour chaque élément renvoyé par le résultat du remplissage. Cette propriété s’applique à toutes les méthodes fill que vous initiez. Si vous la modifiez alors qu’une opération fill est en cours, celle-ci n’est pas affectée par la modification.

La valeur par défaut est true.

Contrôle le nombre de tentatives de réabonnement à sa destination qu’une instance DataManager déconnectée peut effectuer. La valeur par défaut -1 signifie que le réabonnement doit être retenté jusqu’à ce que le client parvienne à se reconnecter.

La valeur par défaut est -1.

Contrôle le délai, en millisecondes, entre les tentatives de réabonnement. La valeur par défaut est 5000, ce qui induit une tentative de réabonnement toutes les 5 secondes.

La valeur par défaut est 5000.

Indique s’il existe des modifications qui n’ont pas été enregistrées dans le cache local et que la méthode saveCache() doit être appelée. Cette méthode peut renvoyer la valeur false lorsque commitRequired doit renvoyer true, indiquant que des changements sont enregistrés dans le cache local, mais qu’ils ne sont pas validés sur le serveur.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement propertyChange .

Indique si l’instance DataManager est abonnée à la destination distante.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement propertyChange .

Définissez cette propriété sur false si vous souhaitez supprimer l’envoi d’erreurs d’éléments en attente lors de l’accès à des données récupérées à la demande ou non paginées. Au lieu de renvoyer une erreur, la valeur null est renvoyée pour une valeur de propriété ou un appel getItemAt() dans une instance ArrayCollection.

La méthode size() ne renvoie aucun élément pour les listes dont la taille n’a pas encore été récupérée auprès du serveur. Lorsque l’élément est renvoyé par le serveur, les événements PropertyChangeEvent et CollectionEvent concernés sont distribués.

Crée une instance de l’objet DataService en utilisant la destination spécifiée. La destination doit être une référence à une destination configurée dans le fichier services-config.xml.

Met en file d’attente une erreur si ce gestionnaire de données n’a pas encore été initialisé.

Efface les données stockées sur le disque lors d’un appel de la méthode saveCache() réalisé précédemment ou alors que la méthode autoSaveCache était définie sur true.

Paramètres

Efface du magasin local les données spécifiées par le descripteur transmis.

Paramètres

Valide les modifications en attente pour toutes les collections actuellement gérées par l’instance DataStore associée à cette instance DataManager. L’appel de cette méthode équivaut à appeler la méthode dataStore.commit().

Lorsque la valeur de la propriété autoCommit est true, les transactions ne sont pas utilisées et il n’est pas nécessaire d’appeler cette méthode. Pour utiliser des transactions, définissez la propriété autoCommit sur false et appelez cette méthode directement pour valider un lot de modifications.

En général, vous appelez simplement commit() sans utiliser d’argument pour valider toutes les modifications en attente. Vous pouvez spécifier des arguments facultatifs pour valider un sous-ensemble des modifications en attente. Vous devez résoudre tous les conflits en attente avant de valider les modifications apportées à un élément de l’instance DataStore.

Si l’assembleur est configuré de telle sorte que la propriété use-transactions est définie sur true, toutes les modifications sont validées de façon atomique. Si une opération échoue, aucune des opérations du lot n’est appliquée. Si la propriété use-transactions est définie sur false, les opérations sont validées une à une jusqu’à ce qu’un échec se produise, ce qui a pour effet d’arrêter le traitement. Les modifications intervenant avant l’erreur sont appliquées, mais celles qui interviennent après l’erreur ne le sont pas. Lorsqu’une erreur se produit dans le cadre du traitement d’un lot, les modifications sont replacées dans la file d’attente des modifications non validées. Si vous souhaitez supprimer les modifications qui ont provoqué l’erreur, vous devez appeler la méthode revertChanges.

Par défaut, la méthode de validation valide toutes les modifications en attente pour tous les éléments créés, modifiés et supprimés dans cette instance DataStore. Si vous souhaitez valider un sous-ensemble de ces modifications, vous pouvez spécifier une combinaison d’instances ArrayCollection et/ou d’éléments gérés qui définissent le sous-ensemble de modifications à inclure dans le lot. Pour chaque collection de tableaux spécifiée, toutes les modifications de l’appartenance ou de l’ordre des éléments de cette collection, ainsi que les modifications portant sur les éléments de cette collection eux-mêmes sont validées. Vous pouvez également spécifier une liste d’éléments gérés individuels, de sorte que seules les modifications concernant ces éléments soient validées. Si vous spécifiez dans le paramètre itemsOrCollections des objets qui ne sont pas des collections ou des éléments gérés, une erreur DataServiceError est envoyée.

Si vous utilisez le paramètre itemsOrCollections et que les propriétés d’association des éléments font référence à d’autres éléments, vous pouvez utiliser le paramètre cascadeCommit pour définir si les modifications apportées aux éléments associés doivent ou non être incluses dans le lot. Par exemple, si vous spécifiez un élément Group dans le paramètre items et que la propriété members d’une instance Group fait référence à une liste d’instances Person alors que la valeur de cascadeCommit est true, les modifications apportées à une instance Person seront également incluses dans l’ensemble de modifications validées. Si la valeur de cascadeCommit est false, seules les modifications apportées à l’instance Group sont incluses. Utilisez cascadeCommit=true pour faire en sorte que toutes les modifications dépendantes soient incluses dans le lot.

Paramètres

Indique s’il existe des modifications en attente pour cet objet particulier. Autorise l’activation granulaire dans l’interface utilisateur. (Voir la section commitRequired correspondant à la propriété liable pour les notifications).

Paramètres

Force ce service à réaliser une tentative de connexion à la destination distante. Cette méthode peut être utilisée conjointement avec la propriété autoConnect et la méthode disconnect() pour contrôler l’état de la connexion.

Appelle une méthode count sur la destination distante. La méthode count appelée est basée sur les balises <count-method> associées et sur les paramètres transmis. Supposons par exemple que l’appel count("firstName", "Bob") ci-dessous a été réalisé et que des balises <count-method> existent ou sont référencées dans le fichier services-config.xml de la destination associée :

            <count-method>
                <name>getCount</name>
                <params>java.lang.String,java.lang.String</params>
                <security-run-as name="freddie" password="nightmare" />
            </count-method>
     
            <count-method>
                <name>getCount</name>
                <security-constraint ref="sample-users" />
            </count-method>
      

Paramètres

Eléments de l’API associés

Demande la création de l’élément spécifié dans le magasin distant. Si une erreur se produit, un événement DataConflictEvent est distribué.

Paramètres

Demande la suppression de l’élément spécifié du magasin distant. Si une erreur se produit, un événement DataConflictEvent est distribué.

Paramètres

Déconnecte la connexion réseau de l’instance DataManager. Cette méthode n’attend pas que les opérations de réseau en attente se terminent.

Exécute une requête en utilisant le nom et les arguments spécifiés. Cette méthode est généralement utilisée avec l’instance RPCDataManager, dans laquelle les requêtes portent un nom spécifique. Vous pouvez également utiliser cette méthode avec les requêtes définies à l’aide de l’approche plus générale utilisant la méthode fill, à condition que le premier paramètre de la méthode fill soit une valeur de chaîne. La valeur queryName est utilisée comme premier paramètre de la méthode fill.

Lorsque vous n’avez plus besoin des objets renvoyés par cette méthode, vous devez appeler la méthode releaseCollection() pour les résultats de collection ou la méthode releaseItem pour les résultats d’élément de valeur unique. Vous pouvez également libérer toutes les références gérées extraites de cette instance DataManager, en appelant la méthode release().

Utilisez la méthode refreshCollection pour actualiser le contenu des collections renvoyées par cette méthode.

Paramètres

Remplit l’instance ListCollectionView (collection) spécifiée en fonction de la méthode de remplissage associée de la destination. Par exemple, pour une destination LiveCycle Data Services qui utilise un assembleur Hibernate, le premier paramètre de la méthode fill() est la collection à remplir, le second paramètre est la requête Hibernate à exécuter, et tous les autres paramètres sont des paramètres de requête Hibernate. Le même format s’applique aux méthodes fill() utilisées dans les classes service-wrapper pour le développement géré par modèles.

L’exemple suivant illustre une méthode fill() pour une destination qui utilise un assembleur Hibernate. L’assembleur dispose d’une requête nommée getByDescription qui prend un paramètre de requête nommé description :

     ProductService.fill(ac, "getByDescription", description);
     

Pour une destination LiveCycle Data Services faisant appel à la méthode de remplissage dans laquelle vous déclarez les méthodes de remplissage dans les éléments XML de la configuration de destination, si les éléments <fill-method> suivants sont dans la configuration de destination :

            <fill-method>
                <name>loadPersons</name>
                <params>java.lang.String,java.lang.String</params>
            </fill-method>
     
            <fill-method>
                <name>loadPersons</name>
                <security-constraint ref="sample-users" />
            </fill-method>
      

Paramètres

Remplit l’instance ListCollectionView (collection) spécifiée en fonction de la méthode de remplissage associée de la destination. Un seul sous-ensemble des propriétés est rempli sur chaque objet, comme spécifié dans le paramètre propertySpecifier.

Paramètres

Exécute une requête qui renvoie un seul élément.

Paramètres

Renvoie un objet ArrayCollection ou un objet géré unique, issu du magasin local. L’appel de cette méthode ne met pas à jour l’heure du dernier accès.

Paramètres

Remplit l’instance ListCollectionView (collection) spécifiée avec des instances CacheDataDescriptor. Si aucun argument n’est spécifié, toutes les instances CacheDataDescriptor associées des données mises en cache pour ce service sont renvoyées.

Paramètres

Remplit l’instance ListCollectionView (collection) spécifiée avec tous les identificateurs de cache précédemment utilisés dans l’application.

Paramètres

Réalise une demande asynchrone concernant un élément correspondant à l’identité spécifiée. Si vous spécifiez une valeur defaultValue et que l’élément n’existe pas, l’élément est créé en utilisant les informations définies dans defaultValue. Cette méthode renvoie une instance ItemReference. Si vous recevez une instance valide de l’appel de la méthode getItem(), vous devez appeler la méthode releaseItem() pour libérer une instance de l’élément. Si vous faites appel à l’instance ItemReference, vous devez appeler la méthode releaseItem() sur la référence pour faire en sorte de libérer la référence correcte au cas où votre client aurait réalisé plusieurs appels de la méthode getItem() pour le même élément. Si vous ne faites pas appel à l’instance ItemReference, vous pouvez appeler la méthode releaseItem() sur l’instance DataManager en utilisant l’élément lui-même.

Paramètres

Recherche l’élément spécifié en utilisant l’identité indiquée. Si l’élément est déjà géré sur ce client, l’instance gérée est renvoyée. Sinon, la valeur null est renvoyée. Contrairement à l’appel de la méthode getItem, cet appel n’envoie pas de requête au serveur et n’ajoute pas de référence supplémentaire à l’élément.

Paramètres

Renvoie les informations sur la page de la collection spécifiée.

Paramètres

Renvoie l’opération en cours dans le cache de messages de l’élément spécifié. Utilisez cette méthode pour fournir à un utilisateur un aperçu visuel du type de modifications apportées à un élément.

Paramètres

Force l’initialisation de l’instance DataStore.

Renvoie true si la collection transmise est gérée par ce service. Si la collection est gérée par ce service, vous pouvez sans problème transmettre la collection à la méthode releaseCollection() pour la libérer et faire en sorte qu’elle ne soit plus gérée.

Paramètres

Renvoie true si la collection transmise utilise des fonctionnalités de pagination. Si la collection est paginée par ce service, vous pouvez sans problème transmettre la collection à la méthode releaseItemsFromCollection() afin de libérer les différents éléments de la collection et faire en sorte qu’ils ne soient plus gérés.

Paramètres

Renvoie true si la plage d’éléments spécifiée est intégralement paginée. Renvoie false dans le cas contraire.

Paramètres

Remplit l’instance ListCollectionView spécifiée en fonction des éléments <fill-method> associés, conformément aux données du magasin local. Elle appellera l’API offlineAdapter.executeOfflineQuery() pour interroger les données et ne tentera pas d’interroger la destination distante, même si l’application est connectée. Cette méthode est parfaitement adaptée lorsque les données sont synchronisées sur le client et que les requêtes locales sont exécutées par rapport.

Paramètres

Fusionne les mises à jour en attente dans l’ensemble d’objets géré. Le processus de fusion des modifications détecte les conflits et traite les éventuelles demandes d’élément en attente. Cette opération fusionne tous les messages des autres instances DataManager qui partagent cette instance DataStore.

Actualise toutes les données gérées par cette instance DataManager. Les remplissages, les demandes d’obtention d’élément et les demandes de page sont effectués sur le serveur pour récupérer tous les éléments gérés. Utilisez la méthode DataStore.refresh() pour actualiser également tous les éléments associés pour les associations pour lesquelles lazy = true.

Actualise une collection précédemment remplie en utilisant la méthode fill ou gérée en tant qu’association gérée. Cette méthode envoie une demande au serveur et récupère la nouvelle version des éléments résidents de la collection en utilisant les paramètres fill utilisés initialement avec cette collection ou en récupérant la propriété de l’élément parent. Si des modifications sont détectées, elles sont fusionnées dans la collection de façon incrémentielle.

Paramètres

Libère tous les éléments et collections gérés de l’instance DataManager.

Paramètres

Eléments de l’API associés

Libère un élément de la gestion dans la collection spécifiée, de sorte qu’il ne soit plus géré par cette instance DataManager. Si l’élément est présent dans plusieurs collections, une copie de l’élément est réalisée. Les modifications non validées apportées à un élément présent uniquement dans cette collection sont libérées, y compris les suppressions, créations et mises à jour.

Paramètres

Libère l’élément spécifié afin qu’il ne soit plus géré par cette instance DataManager. Si vous faites appel à une instance ItemReference, vous devez appeler la méthode releaseItem() sur l’instance ItemReference pour faire en sorte de libérer la référence correcte, au cas où plusieurs appels getItem() extrayant le même élément dans différentes parties de l’application cliente auraient été réalisés.

Cet appel libère les ressources associées, y compris les propriétés imbriquées. L’élément spécifié ne reçoit plus de mise à jour de la destination distante. Par ailleurs, s’il existe des modifications non validées pour cet élément et qu’il ne s’affiche pas dans une autre collection, ces modifications sont également libérées. Si l’élément spécifié est présent dans plusieurs collections, la valeur renvoyée est une copie de l’original, sauf si le paramètre allowCopy est défini sur false.

Paramètres

Libère une plage d’éléments de la collection. Lorsque la pagination est activée pour une collection volumineuse, il peut être utile de libérer les ressources occupées par les éléments de la collection et de résilier les abonnements aux mises à jour de ces éléments. Vous devez spécifier la valeur startIndex du premier élément à libérer, ainsi que le nombre d’éléments à libérer. Si un élément qui se trouve à cette position n’est pas encore paginé, cet index est ignoré.

Paramètres

Libère la valeur d’une association monovaluée. Si la valeur n’est pas paginée, la valeur false est renvoyée. Si la valeur est paginée, cette référence est libérée et la valeur true est renvoyée. S’il s’agissait de la dernière référence à l’élément spécifique, la tentative suivante pour accéder à cet élément entraîne une nouvelle récupération de l’erreur ItemPendingError et de la valeur.

Paramètres

Rétablit les modifications non validées apportées à l’élément spécifié. Si aucun élément n’est spécifié, toutes les modifications non validées sont rétablies. Si vous rétablissez une opération de création, l’élément est supprimé. Si vous rétablissez une opération de suppression, l’élément est à nouveau ajouté. Le fait de rétablir une mise à jour restaure les propriétés d’origine de l’élément, telles qu’elles étaient définies avant que vous ne commenciez à les modifier. L’appel de cette méthode équivaut à appeler la méthode dataStore.revertChanges().

Cette méthode est notamment utilisée lorsqu’une erreur survient. Ainsi, les modifications qui ont échoué sont replacées dans la liste des modifications non validées. A ce stade, vous pouvez soit modifier les modifications pour corriger le problème, soit les rétablir à l’aide de cette méthode, pour éviter qu’elles ne soient à nouveau appliquées.

Si un élément est fourni et que celui-ci ne comporte aucune modification, cette méthode renvoie false. Si aucun élément n’est fourni et qu’aucune modification n’est présente, cette méthode renvoie false. Dans le cas contraire, elle renvoie la valeur true.

Paramètres

Rétablit les modifications appliquées aux éléments contenus dans la collection spécifiée et devant être gérés par cette instance DataManager.

Paramètres

Cette méthode enregistre l’état actif du cache de l’instance DataManager. Le cache inclut les éléments en mémoire ainsi que les modifications apportées à ces éléments qui n’ont pas été envoyées à la destination distante.

Paramètres

Eléments de l’API associés

         var customerService:DataService = new DataService("customers");
         var customers:ArrayCollection = new ArrayCollection();
         customerService.fill(customers);
         // ...
         var customer:Customer = Customer(customers[0]);
         customer.priority = "top";
         customerService.saveCache();
         // now all of the changes and items in the customers collection
         // will be persisted locally
      

Indique s’il existe des modifications en attente pour cet objet particulier qui n’ont pas été enregistrées dans le cache local. Cette méthode peut renvoyer la valeur false lorsque comitRequiredOn doit renvoyer true, indiquant que le changement est enregistré dans le cache local, mais qu’il n’est pas validé sur le serveur.

Paramètres

Obtient les éléments modifiés pour tous les remplissages exécutés précédemment sur ce service de données (gestionnaire de données).

Une méthode pratique afin d’autoriser la synchronisation de l’ensemble des données locales : synchronizeAllFills() est invoqué sur chaque service de données spécifié(gestionnaire de données), de sorte que le jeton du résultat final ne soit rempli que lorsque tous les appels synchronizeAllFills() sont terminées.

Paramètres

Obtient les éléments modifiés qui ont changé sur le serveur depuis la dernière fois qu’une action fill ou synchronizeFill a été invoquée. Il s’agit des éléments créés, des éléments mis à jour et des éléments supprimés. Si aucun remplissage précédent ne s’est produit, cela équivaut à la réalisation d’un premier remplissage.

Paramètres

Déclenche une mise à jour de l’élément spécifié. Si vous appelez cette méthode en utilisant l’instance gérée, elle valide les modifications apportées à cet élément et renvoie un jeton que vous pouvez utiliser pour suivre ces modifications. S’il n’existe pas de modifications en attente pour cet élément, un jeton null est renvoyé. Si vous appelez cette méthode en utilisant une autre copie de l’instance, elle copie les propriétés modifiées du tableau des modifications dans le journal de l’instance gérée, puis valide ces modifications. Si la méthode autoCommit est définie sur la valeur true, les modifications pour cet élément sont validées immédiatement. Si elle est définie sur false, les modifications sont mises en file d’attente jusqu’à ce que la méthode commit() soit appelée.

Paramètres

L’événement DataConflictEvent.CONFLICT est distribué lorsqu’un conflit entre des modifications locales en attente et des modifications demandées par un autre client est détecté, ou lorsque des modifications demandées par ce client entrent en conflit avec celles de la destination distante. Chaque instance DataService envoie des événements de conflit uniquement pour les éléments associés à cette destination spécifique. Utilisez l’événement de conflit sur l’instance DataService si vous souhaitez traiter les conflits de tout un ensemble de destinations liées simultanément.

Les valeurs des propriétés de l’objet d’événement sont les suivantes :

L’événement DataManagerFaultEvent.FAULT est distribué lorsqu’un appel de service échoue en raison d’une erreur. Il est par exemple distribué lorsqu’un appel de la méthode fill() échoue. Cet événement est également envoyé pour chaque élément générant une erreur dans la cadre d’un résultat de validation. Dans ce cas, l’événement DataServiceFaultEvent contient le jeton renvoyé par la validation, mais l’élément et les chaînes de message d’erreur de l’erreur sont propres à l’élément qui a provoqué l’erreur.

Les valeurs des propriétés de l’objet d’événement sont les suivantes :

L’événement MessageEvent.MESSAGE est distribué lorsque la destination distante transfère une notification d’opération de données. Par exemple, lorsque des données sont mises à jour dans la destination distante, une opération de mise à jour est envoyée à tous les clients qui écoutent et cette opération est convertie en événement de message sur cette instance DataService.

La valeur de cette constante est "message".

Les valeurs des propriétés de l’objet d’événement sont les suivantes :

L’événement PropertyChangeEvent.PROPERTY_CHANGE est distribué lorsqu’une propriété de ce service change. Cela est le cas lorsque les propriétés suivantes sont modifiées :

• commitRequired
• mergeRequired
• connected