Énumération SYNC_SAVE_ACTION

Article
08/18/2010

Représente le type d'action indiqué par une modification.

Syntaxe

typedef enum
{
  SSA_CREATE,
  SSA_UPDATE_VERSION_ONLY,
  SSA_UPDATE_VERSION_AND_DATA,
  SSA_UPDATE_VERSION_AND_MERGE_DATA,
  SSA_DELETE_AND_STORE_TOMBSTONE,
  SSA_DELETE_AND_REMOVE_TOMBSTONE,
  SSA_RENAME_SOURCE_AND_UPDATE_VERSION_AND_DATA,
  SSA_RENAME_DESTINATION_AND_UPDATE_VERSION_AND_DATA,
  SSA_DELETE_CONFLICTING_AND_SAVE_SOURCE_ITEM,
  SSA_STORE_MERGE_TOMBSTONE,
  SSA_CHANGE_ID_UPDATE_VERSION_AND_MERGE_DATA,
  SSA_CHANGE_ID_UPDATE_VERSION_AND_SAVE_DATA,
  SSA_CHANGE_ID_UPDATE_VERSION_AND_DELETE_AND_STORE_TOMBSTONE,
  SSA_CHANGE_ID_UPDATE_VERSION_ONLY,
  SSA_CREATE_GHOST,
  SSA_GHOST_ITEM,
  SSA_UNGHOST_ITEM,
  SSA_UPDATE_GHOST,
  SSA_DELETE_GHOST_AND_STORE_TOMBSTONE,
  SSA_DELETE_GHOST_WITHOUT_TOMBSTONE
}  SYNC_SAVE_ACTION;

Membres

SSA_CREATE
L'élément est nouveau et créé dans le magasin d'éléments de destination.
SSA_UPDATE_VERSION_ONLY
Les données d'élément ne sont pas modifiées dans le magasin d'éléments de destination. La version est remplacée dans les métadonnées de destination. Cette action se produit également lorsque l'élément du fournisseur de destination est sélectionné en tant que gagnant d'un conflit.
SSA_UPDATE_VERSION_AND_DATA
Les données d'élément sont appliquées au magasin d'éléments de destination. Les données existantes sont remplacées. La version fournie remplace la version existante dans les métadonnées de destination. Cette action correspond à une création d'élément, mise à jour d'élément ou mise à jour d'unité de modification dans le réplica source. Cette action se produit également lorsque l'élément du fournisseur de source est sélectionné en tant que gagnant d'un conflit.
SSA_UPDATE_VERSION_AND_MERGE_DATA
Les données d'élément sont appliquées au magasin d'éléments de destination. Les données d'élément existantes sont fusionnées avec les données d'élément mises à jour via une méthode spécifique au fournisseur. La version remplace la version existante dans les métadonnées de destination. Cette action se produit quand l'action de résolution de conflit est SRA_MERGE.
SSA_DELETE_AND_STORE_TOMBSTONE
L'élément est supprimé du magasin d'éléments de destination. Un objet tombstone est enregistré dans les métadonnées de destination. Cette action correspond à la suppression d'un élément dans le réplica source.
SSA_DELETE_AND_REMOVE_TOMBSTONE
L'élément est supprimé du magasin d'éléments de destination. Un objet tombstone n'est pas conservé dans les métadonnées de destination. Si un objet tombstone existe pour l'élément dans les métadonnées de destination, il doit être supprimé. Cette action est appelée pendant la récupération de connaissance oubliée et correspond aux suppressions d'élément où le réplica source a nettoyé l'objet tombstone.
SSA_RENAME_SOURCE_AND_UPDATE_VERSION_AND_DATA
La modification envoyée du fournisseur de source est renommée afin qu'elle n'entre plus en conflit avec l'élément en conflit sur le réplica de destination, et la modification de la source est appliquée au réplica de destination.
SSA_RENAME_DESTINATION_AND_UPDATE_VERSION_AND_DATA
L'élément en conflit sur le réplica de destination est renommé afin qu'il n'entre plus en conflit avec la modification envoyée du fournisseur de source, et la modification de la source est appliquée au réplica de destination.
SSA_DELETE_CONFLICTING_AND_SAVE_SOURCE_ITEM
La modification de la source est appliquée au réplica de destination et l'élément de destination en conflit est supprimé de ce dernier.
SSA_STORE_MERGE_TOMBSTONE
Stocker un objet tombstone de fusion dans les métadonnées de destination. Prenons l'exemple d'une action de fusion qui spécifie id1 comme ID d'élément perdant et id2 comme ID d'élément gagnant. L'objet tombstone de fusion contient id1 comme ID d'élément perdant et id2 comme ID d'élément gagnant. Si un objet tombstone de fusion existe déjà dans le réplica de destination qui contient id1 comme ID d'élément perdant et un autre ID d'élément, id3, comme ID d'élément gagnant, procédez comme suit.
1. Si id2 est inférieur à id3, créez et stockez deux objets tombstone de fusion. Un objet tombstone de fusion contient id1 comme ID d'élément perdant et id2 comme ID d'élément gagnant. L'autre objet tombstone de fusion contient id2 comme ID d'élément perdant et id3 comme ID d'élément gagnant. Il est possible que ce deuxième objet tombstone de fusion existe déjà, auquel cas il est simplement conservé inchangé. Ainsi, une chaîne d'objets tombstone de fusion est créée, classée par ID d'élément.
2. Si id3 est inférieur à id2, retournez une erreur.
SSA_CHANGE_ID_UPDATE_VERSION_AND_MERGE_DATA
Les données de l'élément source sont combinées à l'élément de destination. Stocker un objet tombstone de fusion pour l'ID d'élément perdant, en suivant les mêmes étapes que celles présentées pour SSA_STORE_MERGE_TOMBSTONE.
SSA_CHANGE_ID_UPDATE_VERSION_AND_SAVE_DATA
Stocker un objet tombstone de fusion pour l'ID d'élément perdant, en suivant les mêmes étapes que celles présentées pour SSA_STORE_MERGE_TOMBSTONE.
SSA_CHANGE_ID_UPDATE_VERSION_AND_DELETE_AND_STORE_TOMBSTONE
Stocker un objet tombstone de fusion pour l'ID d'élément perdant, en suivant les mêmes étapes que celles présentées pour SSA_STORE_MERGE_TOMBSTONE. Supprimer l'élément identifié par l'ID d'élément gagnant, puis stocker un objet tombstone pour lui.
SSA_CHANGE_ID_UPDATE_VERSION_ONLY
Stocker un objet tombstone de fusion pour l'ID d'élément perdant, en suivant les mêmes étapes que celles présentées pour SSA_STORE_MERGE_TOMBSTONE. Appliquer uniquement des métadonnées pour la modification d'élément gagnant.
SSA_CREATE_GHOST
Créer un élément fantôme pour l'élément. Un élément fantôme est un élément qui contient à la fois une valeur indiquant s'il se trouvait récemment dans le filtre et une version d'exclusion. Une version d'exclusion indique la version de la modification qui a exclu l'élément du filtre.
SSA_GHOST_ITEM
Remplace l'élément actif par un élément fantôme. Pour ce faire, stockez une valeur qui indique que l'élément se trouvait récemment dans le filtre, stockez la version de cette modification sous la forme d'une version d'exclusion de l'élément et supprimez les données d'élément du magasin d'éléments.
SSA_UNGHOST_ITEM
Activer l'élément fantôme. Pour ce faire, supprimez la version d'exclusion des métadonnées et stockez les données d'élément dans le magasin d'éléments.
SSA_UPDATE_GHOST
Mettre à jour la version d'un élément fantôme. Il s'agit d'une mise à jour vers la version actuelle de l'élément, et non vers la version d'exclusion.
SSA_DELETE_GHOST_AND_STORE_TOMBSTONE
Remplacer un élément fantôme par un objet tombstone. Cela indique que l'élément a été supprimé. Pour ce faire, stockez une valeur qui indique que l'élément a été supprimé.
SSA_DELETE_GHOST_WITHOUT_TOMBSTONE
Supprimer l'élément fantôme du magasin des métadonnées et ne pas stocker d'objet tombstone pour l'élément.

Notes

Lorsque le fournisseur n'utilise pas de transaction pour tout le lot de modifications, il doit récupérer la connaissance mise à jour à partir de l'objet ISaveChangeContext et enregistrer cette connaissance en même temps qu'il applique la modification.