feat: add metadata_template support and filter_fields to legal hold assignments (box/box-openapi#625)

.codegen.json

@@ -1 +1 @@
-{ "engineHash": "88c0ae7", "specHash": "a0e8038", "version": "10.20.0" }
+{ "engineHash": "88c0ae7", "specHash": "74452eb", "version": "10.20.0" }

docs/legalholdpolicyassignments.md

@@ -38,7 +38,7 @@ Returns a list of legal hold policy assignments.
 
 ## Assign legal hold policy
 
-Assign a legal hold to an item type of: file, file version, folder, user, ownership, or interactions.
+Assign a legal hold to an item type of: file, file version, folder, user, ownership, interactions, or metadata template.
 
 This operation is performed by calling function `createLegalHoldPolicyAssignment`.
 

src/main/java/com/box/sdkgen/managers/legalholdpolicyassignments/CreateLegalHoldPolicyAssignmentRequestBody.java

@@ -1,8 +1,11 @@
 package com.box.sdkgen.managers.legalholdpolicyassignments;
 
+import com.box.sdkgen.internal.NullableFieldTracker;
 import com.box.sdkgen.internal.SerializableObject;
+import com.box.sdkgen.schemas.legalholdpolicyassignmentfilterfield.LegalHoldPolicyAssignmentFilterField;
 import com.fasterxml.jackson.annotation.JsonFilter;
 import com.fasterxml.jackson.annotation.JsonProperty;
+import java.util.List;
 import java.util.Objects;
 
 @JsonFilter("nullablePropertyFilter")
@@ -16,6 +19,13 @@ public class CreateLegalHoldPolicyAssignmentRequestBody extends SerializableObje
   @JsonProperty("assign_to")
   protected final CreateLegalHoldPolicyAssignmentRequestBodyAssignToField assignTo;
 
+  /**
+   * List of metadata template field filters. Only required when `assign_to.type` is
+   * `metadata_template`.
+   */
+  @JsonProperty("filter_fields")
+  protected List<LegalHoldPolicyAssignmentFilterField> filterFields;
+
   public CreateLegalHoldPolicyAssignmentRequestBody(
       @JsonProperty("policy_id") String policyId,
       @JsonProperty("assign_to") CreateLegalHoldPolicyAssignmentRequestBodyAssignToField assignTo) {
@@ -24,6 +34,14 @@ public CreateLegalHoldPolicyAssignmentRequestBody(
     this.assignTo = assignTo;
   }
 
+  protected CreateLegalHoldPolicyAssignmentRequestBody(Builder builder) {
+    super();
+    this.policyId = builder.policyId;
+    this.assignTo = builder.assignTo;
+    this.filterFields = builder.filterFields;
+    markNullableFieldsAsSet(builder.getExplicitlySetNullableFields());
+  }
+
   public String getPolicyId() {
     return policyId;
   }
@@ -32,6 +50,10 @@ public CreateLegalHoldPolicyAssignmentRequestBodyAssignToField getAssignTo() {
     return assignTo;
   }
 
+  public List<LegalHoldPolicyAssignmentFilterField> getFilterFields() {
+    return filterFields;
+  }
+
   @Override
   public boolean equals(Object o) {
     if (this == o) {
@@ -42,12 +64,14 @@ public boolean equals(Object o) {
     }
     CreateLegalHoldPolicyAssignmentRequestBody casted =
         (CreateLegalHoldPolicyAssignmentRequestBody) o;
-    return Objects.equals(policyId, casted.policyId) && Objects.equals(assignTo, casted.assignTo);
+    return Objects.equals(policyId, casted.policyId)
+        && Objects.equals(assignTo, casted.assignTo)
+        && Objects.equals(filterFields, casted.filterFields);
   }
 
   @Override
   public int hashCode() {
-    return Objects.hash(policyId, assignTo);
+    return Objects.hash(policyId, assignTo, filterFields);
   }
 
   @Override
@@ -60,6 +84,35 @@ public String toString() {
         + "assignTo='"
         + assignTo
         + '\''
+        + ", "
+        + "filterFields='"
+        + filterFields
+        + '\''
         + "}";
   }
+
+  public static class Builder extends NullableFieldTracker {
+
+    protected final String policyId;
+
+    protected final CreateLegalHoldPolicyAssignmentRequestBodyAssignToField assignTo;
+
+    protected List<LegalHoldPolicyAssignmentFilterField> filterFields;
+
+    public Builder(
+        String policyId, CreateLegalHoldPolicyAssignmentRequestBodyAssignToField assignTo) {
+      super();
+      this.policyId = policyId;
+      this.assignTo = assignTo;
+    }
+
+    public Builder filterFields(List<LegalHoldPolicyAssignmentFilterField> filterFields) {
+      this.filterFields = filterFields;
+      return this;
+    }
+
+    public CreateLegalHoldPolicyAssignmentRequestBody build() {
+      return new CreateLegalHoldPolicyAssignmentRequestBody(this);
+    }
+  }
 }

src/main/java/com/box/sdkgen/managers/legalholdpolicyassignments/CreateLegalHoldPolicyAssignmentRequestBodyAssignToTypeField.java

@@ -18,7 +18,8 @@ public enum CreateLegalHoldPolicyAssignmentRequestBodyAssignToTypeField implemen
   FOLDER("folder"),
   USER("user"),
   OWNERSHIP("ownership"),
-  INTERACTIONS("interactions");
+  INTERACTIONS("interactions"),
+  METADATA_TEMPLATE("metadata_template");
 
   private final String value;
 

src/main/java/com/box/sdkgen/managers/legalholdpolicyassignments/GetLegalHoldPolicyAssignmentsQueryParamsAssignToTypeField.java

@@ -18,7 +18,8 @@ public enum GetLegalHoldPolicyAssignmentsQueryParamsAssignToTypeField implements
   FOLDER("folder"),
   USER("user"),
   OWNERSHIP("ownership"),
-  INTERACTIONS("interactions");
+  INTERACTIONS("interactions"),
+  METADATA_TEMPLATE("metadata_template");
 
   private final String value;
 

src/main/java/com/box/sdkgen/managers/legalholdpolicyassignments/LegalHoldPolicyAssignmentsManager.java

@@ -81,8 +81,8 @@ public LegalHoldPolicyAssignments getLegalHoldPolicyAssignments(
   }
 
   /**
-   * Assign a legal hold to an item type of: file, file version, folder, user, ownership, or
-   * interactions.
+   * Assign a legal hold to an item type of: file, file version, folder, user, ownership,
+   * interactions, or metadata template.
    *
    * @param requestBody Request body of createLegalHoldPolicyAssignment method
    */
@@ -93,8 +93,8 @@ public LegalHoldPolicyAssignment createLegalHoldPolicyAssignment(
   }
 
   /**
-   * Assign a legal hold to an item type of: file, file version, folder, user, ownership, or
-   * interactions.
+   * Assign a legal hold to an item type of: file, file version, folder, user, ownership,
+   * interactions, or metadata template.
    *
    * @param requestBody Request body of createLegalHoldPolicyAssignment method
    * @param headers Headers of createLegalHoldPolicyAssignment method

src/main/java/com/box/sdkgen/schemas/legalholdpolicy/LegalHoldPolicyAssignmentCountsField.java

@@ -28,6 +28,10 @@ public class LegalHoldPolicyAssignmentCountsField extends SerializableObject {
   /** The number of users this policy is applied to with the `interactions` type assignment. */
   protected Long interactions;
 
+  /** The number of metadata templates this policy is applied to. */
+  @JsonProperty("metadata_template")
+  protected Long metadataTemplate;
+
   public LegalHoldPolicyAssignmentCountsField() {
     super();
   }
@@ -40,6 +44,7 @@ protected LegalHoldPolicyAssignmentCountsField(Builder builder) {
     this.fileVersion = builder.fileVersion;
     this.ownership = builder.ownership;
     this.interactions = builder.interactions;
+    this.metadataTemplate = builder.metadataTemplate;
     markNullableFieldsAsSet(builder.getExplicitlySetNullableFields());
   }
 
@@ -67,6 +72,10 @@ public Long getInteractions() {
     return interactions;
   }
 
+  public Long getMetadataTemplate() {
+    return metadataTemplate;
+  }
+
   @Override
   public boolean equals(Object o) {
     if (this == o) {
@@ -81,12 +90,13 @@ public boolean equals(Object o) {
         && Objects.equals(file, casted.file)
         && Objects.equals(fileVersion, casted.fileVersion)
         && Objects.equals(ownership, casted.ownership)
-        && Objects.equals(interactions, casted.interactions);
+        && Objects.equals(interactions, casted.interactions)
+        && Objects.equals(metadataTemplate, casted.metadataTemplate);
   }
 
   @Override
   public int hashCode() {
-    return Objects.hash(user, folder, file, fileVersion, ownership, interactions);
+    return Objects.hash(user, folder, file, fileVersion, ownership, interactions, metadataTemplate);
   }
 
   @Override
@@ -115,6 +125,10 @@ public String toString() {
         + "interactions='"
         + interactions
         + '\''
+        + ", "
+        + "metadataTemplate='"
+        + metadataTemplate
+        + '\''
         + "}";
   }
 
@@ -132,6 +146,8 @@ public static class Builder extends NullableFieldTracker {
 
     protected Long interactions;
 
+    protected Long metadataTemplate;
+
     public Builder user(Long user) {
       this.user = user;
       return this;
@@ -162,6 +178,11 @@ public Builder interactions(Long interactions) {
       return this;
     }
 
+    public Builder metadataTemplate(Long metadataTemplate) {
+      this.metadataTemplate = metadataTemplate;
+      return this;
+    }
+
     public LegalHoldPolicyAssignmentCountsField build() {
       return new LegalHoldPolicyAssignmentCountsField(this);
     }

src/main/java/com/box/sdkgen/schemas/legalholdpolicyassigneditem/LegalHoldPolicyAssignedItemTypeField.java

@@ -18,7 +18,8 @@ public enum LegalHoldPolicyAssignedItemTypeField implements Valuable {
   FOLDER("folder"),
   USER("user"),
   OWNERSHIP("ownership"),
-  INTERACTIONS("interactions");
+  INTERACTIONS("interactions"),
+  METADATA_TEMPLATE("metadata_template");
 
   private final String value;
 

src/main/java/com/box/sdkgen/schemas/legalholdpolicyassignment/LegalHoldPolicyAssignment.java

@@ -4,6 +4,7 @@
 import com.box.sdkgen.schemas.legalholdpolicyassigneditem.LegalHoldPolicyAssignedItem;
 import com.box.sdkgen.schemas.legalholdpolicyassignmentbase.LegalHoldPolicyAssignmentBase;
 import com.box.sdkgen.schemas.legalholdpolicyassignmentbase.LegalHoldPolicyAssignmentBaseTypeField;
+import com.box.sdkgen.schemas.legalholdpolicyassignmentfilterfield.LegalHoldPolicyAssignmentFilterField;
 import com.box.sdkgen.schemas.legalholdpolicymini.LegalHoldPolicyMini;
 import com.box.sdkgen.schemas.usermini.UserMini;
 import com.box.sdkgen.serialization.json.EnumWrapper;
@@ -12,11 +13,12 @@
 import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
 import com.fasterxml.jackson.databind.annotation.JsonSerialize;
 import java.time.OffsetDateTime;
+import java.util.List;
 import java.util.Objects;
 
 /**
  * Legal Hold Assignments are used to assign Legal Hold Policies to an item type of: Users, Folders,
- * Files, File Versions, Ownership, or Interactions.
+ * Files, File Versions, Ownership, Interactions, or Metadata Templates.
  *
  * <p>Creating a Legal Hold Assignment puts a hold on the File-Versions that belong to the
  * Assignment's 'apply-to' entity.
@@ -49,6 +51,13 @@ public class LegalHoldPolicyAssignment extends LegalHoldPolicyAssignmentBase {
   @JsonDeserialize(using = DateTimeUtils.DateTimeDeserializer.class)
   protected OffsetDateTime deletedAt;
 
+  /**
+   * List of metadata template field filters. Only present when `assigned_to.type` is
+   * `metadata_template`.
+   */
+  @JsonProperty("filter_fields")
+  protected List<LegalHoldPolicyAssignmentFilterField> filterFields;
+
   public LegalHoldPolicyAssignment() {
     super();
   }
@@ -60,6 +69,7 @@ protected LegalHoldPolicyAssignment(Builder builder) {
     this.assignedBy = builder.assignedBy;
     this.assignedAt = builder.assignedAt;
     this.deletedAt = builder.deletedAt;
+    this.filterFields = builder.filterFields;
     markNullableFieldsAsSet(builder.getExplicitlySetNullableFields());
   }
 
@@ -83,6 +93,10 @@ public OffsetDateTime getDeletedAt() {
     return deletedAt;
   }
 
+  public List<LegalHoldPolicyAssignmentFilterField> getFilterFields() {
+    return filterFields;
+  }
+
   @Override
   public boolean equals(Object o) {
     if (this == o) {
@@ -98,12 +112,14 @@ public boolean equals(Object o) {
         && Objects.equals(assignedTo, casted.assignedTo)
         && Objects.equals(assignedBy, casted.assignedBy)
         && Objects.equals(assignedAt, casted.assignedAt)
-        && Objects.equals(deletedAt, casted.deletedAt);
+        && Objects.equals(deletedAt, casted.deletedAt)
+        && Objects.equals(filterFields, casted.filterFields);
   }
 
   @Override
   public int hashCode() {
-    return Objects.hash(id, type, legalHoldPolicy, assignedTo, assignedBy, assignedAt, deletedAt);
+    return Objects.hash(
+        id, type, legalHoldPolicy, assignedTo, assignedBy, assignedAt, deletedAt, filterFields);
   }
 
   @Override
@@ -136,6 +152,10 @@ public String toString() {
         + "deletedAt='"
         + deletedAt
         + '\''
+        + ", "
+        + "filterFields='"
+        + filterFields
+        + '\''
         + "}";
   }
 
@@ -151,6 +171,8 @@ public static class Builder extends LegalHoldPolicyAssignmentBase.Builder {
 
     protected OffsetDateTime deletedAt;
 
+    protected List<LegalHoldPolicyAssignmentFilterField> filterFields;
+
     public Builder legalHoldPolicy(LegalHoldPolicyMini legalHoldPolicy) {
       this.legalHoldPolicy = legalHoldPolicy;
       return this;
@@ -176,6 +198,11 @@ public Builder deletedAt(OffsetDateTime deletedAt) {
       return this;
     }
 
+    public Builder filterFields(List<LegalHoldPolicyAssignmentFilterField> filterFields) {
+      this.filterFields = filterFields;
+      return this;
+    }
+
     @Override
     public Builder id(String id) {
       this.id = id;