Delete an Attribute and notify
This use case allows you to delete a LocalAttribute and notify the peers it is shared with.
Parameters
- The
attributeIdof the LocalAttribute you want to delete.
On Success
- The LocalAttribute will be deleted.
- All predecessors of the LocalAttribute will be deleted.
- If the LocalAttribute was succeeded, the
succeedsproperty of the successor will be set to undefined. - If there are AttributeForwardingDetails associated with the LocalAttribute belonging to the
attributeIdor a potential predecessor of it, they will be removed as well. - Any peer you shared the LocalAttribute or a potential predecessor of it with is informed that you deleted it.
A Notification with an OwnAttributeDeletedByOwnerNotificationItem, a ForwardedAttributeDeletedByPeerNotificationItem, or a PeerRelationshipAttributeDeletedByPeerNotificationItem is sent, depending on the LocalAttribute subtype.
Technically, the LocalAttribute at the peer’s side and all predecessors will get a
deletionInfowith"DeletedByEmitter"or"DeletedByRecipient"asdeletionStatusand the time of receiving the Notification asdeletionDate. - The
notificationIdsare returned.
On Failure
- If there is no LocalAttribute with the given
attributeId, it can’t be deleted.