collection externalId

src/Core/Models/Api/Public/CollectionBaseModel.cs

@@ -0,0 +1,14 @@
+using System.ComponentModel.DataAnnotations;
+
+namespace Bit.Core.Models.Api.Public
+{
+    public abstract class CollectionBaseModel
+    {
+        /// <summary>
+        /// External identifier for reference or linking this collection to another system.
+        /// </summary>
+        /// <example>external_id_123456</example>
+        [StringLength(300)]
+        public string ExternalId { get; set; }
+    }
+}

src/Core/Models/Api/Public/GroupBaseModel.cs

@@ -18,7 +18,7 @@ namespace Bit.Core.Models.Api.Public
         [Required]
         public bool? AccessAll { get; set; }
         /// <summary>
-        /// External identifier linking this group to another system, such as a user directory.
+        /// External identifier for reference or linking this group to another system, such as a user directory.
         /// </summary>
         /// <example>external_id_123456</example>
         [StringLength(300)]

src/Core/Models/Api/Public/MemberBaseModel.cs

@@ -46,7 +46,7 @@ namespace Bit.Core.Models.Api.Public
         [Required]
         public bool? AccessAll { get; set; }
         /// <summary>
-        /// External identifier linking this member to another system, such as a user directory.
+        /// External identifier for reference or linking this member to another system, such as a user directory.
         /// </summary>
         /// <example>external_id_123456</example>
         [StringLength(300)]

src/Core/Models/Api/Public/Request/CollectionUpdateRequestModel.cs

@@ -3,7 +3,7 @@ using Bit.Core.Models.Table;
 
 namespace Bit.Core.Models.Api.Public
 {
-    public class CollectionUpdateRequestModel
+    public class CollectionUpdateRequestModel : CollectionBaseModel
     {
         /// <summary>
         /// The associated groups that this collection is assigned to.
@@ -12,8 +12,7 @@ namespace Bit.Core.Models.Api.Public
 
         public Collection ToCollection(Collection existingCollection)
         {
-            // TODO
-            // existingCollection.ExternalId = ExternalId;
+            existingCollection.ExternalId = ExternalId;
             return existingCollection;
         }
     }

src/Core/Models/Api/Public/Response/CollectionResponseModel.cs

@@ -10,7 +10,7 @@ namespace Bit.Core.Models.Api.Public
     /// <summary>
     /// A collection.
     /// </summary>
-    public class CollectionResponseModel : IResponseModel
+    public class CollectionResponseModel : CollectionBaseModel, IResponseModel
     {
         public CollectionResponseModel(Collection collection, IEnumerable<SelectionReadOnly> groups)
         {
@@ -20,7 +20,7 @@ namespace Bit.Core.Models.Api.Public
             }
 
             Id = collection.Id;
-            // ExternalId = group.ExternalId; TODO: Add external is for referencing purposes
+            ExternalId = collection.ExternalId;
             Groups = groups?.Select(c => new AssociationWithPermissionsResponseModel(c));
         }
 

src/Core/Models/Api/Request/CollectionRequestModel.cs

@@ -13,6 +13,8 @@ namespace Bit.Core.Models.Api
         [EncryptedString]
         [EncryptedStringLength(1000)]
         public string Name { get; set; }
+        [StringLength(300)]
+        public string ExternalId { get; set; }
         public IEnumerable<SelectionReadOnlyRequestModel> Groups { get; set; }
 
         public Collection ToCollection(Guid orgId)
@@ -26,6 +28,7 @@ namespace Bit.Core.Models.Api
         public Collection ToCollection(Collection existingCollection)
         {
             existingCollection.Name = Name;
+            existingCollection.ExternalId = ExternalId;
             return existingCollection;
         }
     }

src/Core/Models/Api/Response/CollectionResponseModel.cs

@@ -19,11 +19,13 @@ namespace Bit.Core.Models.Api
             Id = collection.Id.ToString();
             OrganizationId = collection.OrganizationId.ToString();
             Name = collection.Name;
+            ExternalId = collection.ExternalId;
         }
 
         public string Id { get; set; }
         public string OrganizationId { get; set; }
         public string Name { get; set; }
+        public string ExternalId { get; set; }
     }
 
     public class CollectionDetailsResponseModel : CollectionResponseModel

src/Core/Models/Table/Collection.cs

@@ -8,6 +8,7 @@ namespace Bit.Core.Models.Table
         public Guid Id { get; set; }
         public Guid OrganizationId { get; set; }
         public string Name { get; set; }
+        public string ExternalId { get; set; }
         public DateTime CreationDate { get; internal set; } = DateTime.UtcNow;
         public DateTime RevisionDate { get; internal set; } = DateTime.UtcNow;
 

src/Sql/dbo/Stored Procedures/Collection_Create.sql

@@ -2,6 +2,7 @@
     @Id UNIQUEIDENTIFIER,
     @OrganizationId UNIQUEIDENTIFIER,
     @Name VARCHAR(MAX),
+    @ExternalId NVARCHAR(300),
     @CreationDate DATETIME2(7),
     @RevisionDate DATETIME2(7)
 AS
@@ -13,6 +14,7 @@ BEGIN
         [Id],
         [OrganizationId],
         [Name],
+        [ExternalId],
         [CreationDate],
         [RevisionDate]
     )
@@ -21,6 +23,7 @@ BEGIN
         @Id,
         @OrganizationId,
         @Name,
+        @ExternalId,
         @CreationDate,
         @RevisionDate
     )

src/Sql/dbo/Stored Procedures/Collection_CreateWithGroups.sql

@@ -2,6 +2,7 @@
     @Id UNIQUEIDENTIFIER,
     @OrganizationId UNIQUEIDENTIFIER,
     @Name VARCHAR(MAX),
+    @ExternalId NVARCHAR(300),
     @CreationDate DATETIME2(7),
     @RevisionDate DATETIME2(7),
     @Groups AS [dbo].[SelectionReadOnlyArray] READONLY
@@ -9,7 +10,7 @@ AS
 BEGIN
     SET NOCOUNT ON
 
-    EXEC [dbo].[Collection_Create] @Id, @OrganizationId, @Name, @CreationDate, @RevisionDate
+    EXEC [dbo].[Collection_Create] @Id, @OrganizationId, @Name, @ExternalId, @CreationDate, @RevisionDate
 
     ;WITH [AvailableGroupsCTE] AS(
         SELECT

src/Sql/dbo/Stored Procedures/Collection_Update.sql

@@ -2,6 +2,7 @@
     @Id UNIQUEIDENTIFIER,
     @OrganizationId UNIQUEIDENTIFIER,
     @Name VARCHAR(MAX),
+    @ExternalId NVARCHAR(300),
     @CreationDate DATETIME2(7),
     @RevisionDate DATETIME2(7)
 AS
@@ -13,6 +14,7 @@ BEGIN
     SET
         [OrganizationId] = @OrganizationId,
         [Name] = @Name,
+        [ExternalId] = @ExternalId,
         [CreationDate] = @CreationDate,
         [RevisionDate] = @RevisionDate
     WHERE

src/Sql/dbo/Stored Procedures/Collection_UpdateWithGroups.sql

@@ -2,6 +2,7 @@
     @Id UNIQUEIDENTIFIER,
     @OrganizationId UNIQUEIDENTIFIER,
     @Name VARCHAR(MAX),
+    @ExternalId NVARCHAR(300),
     @CreationDate DATETIME2(7),
     @RevisionDate DATETIME2(7),
     @Groups AS [dbo].[SelectionReadOnlyArray] READONLY
@@ -9,7 +10,7 @@ AS
 BEGIN
     SET NOCOUNT ON
 
-    EXEC [dbo].[Collection_Update] @Id, @OrganizationId, @Name, @CreationDate, @RevisionDate
+    EXEC [dbo].[Collection_Update] @Id, @OrganizationId, @Name, @ExternalId, @CreationDate, @RevisionDate
 
     ;WITH [AvailableGroupsCTE] AS(
         SELECT

src/Sql/dbo/Tables/Collection.sql

@@ -2,6 +2,7 @@
     [Id]             UNIQUEIDENTIFIER NOT NULL,
     [OrganizationId] UNIQUEIDENTIFIER NOT NULL,
     [Name]           VARCHAR (MAX)    NOT NULL,
+    [ExternalId]     NVARCHAR (300)   NULL,
     [CreationDate]   DATETIME2 (7)    NOT NULL,
     [RevisionDate]   DATETIME2 (7)    NOT NULL,
     CONSTRAINT [PK_Collection] PRIMARY KEY CLUSTERED ([Id] ASC),