Manage announcements¶

Add to an existing asset¶

To add an announcement to an existing asset:

dbt Java Python Kotlin Raw REST API

Add announcement to existing assets
models:
  - name: TOP_BEVERAGE_USERS # You must of course give the name of the object.

    meta:
      atlan:
        attributes: # The details for the announcement must be nested within the meta.atlan.attributes structure.

          announcementType: warning # You must provide a valid status for the announcement (information, warning or issue).

          announcementTitle: "Caution!" # (Optional) You can also provide a title for the announcement.

          announcementMessage: >- # (Optional) You can also provide a message to include in the announcement.

            This table was changed.

Add announcement to existing assets
Table result = Table.updateAnnouncement( // Use the updateAnnouncement() helper method, which for most objects requires a minimal set of information. This helper method will construct the necessary request, call the necessary API(s), and return with the result of the update operation all-in-one.

    client, // Because this operation will directly change the asset in Atlan, you must provide it an AtlanClient through which to connect to the tenant.

    "default/snowflake/1657037873/SAMPLE_DB/FOOD_BEV/TOP_BEVERAGE_USERS", // The qualifiedName of the object.

    AtlanAnnouncementType.WARNING, // The type of the announcement (the AtlanAnnouncementType enumeration gives the valid values).

    "Caution!", // A title for the announcement.

    "This table was changed."); // A message to include in the announcement.

Add announcement to existing assets
from pyatlan.client.atlan import AtlanClient
from pyatlan.model.assets import Table
from pyatlan.model.core import Announcement
from pyatlan.model.enums import AnnouncementType

client = AtlanClient()
announcement = Announcement( # Create the announcement.

    announcement_title="Caution",
    announcement_message="This table was changed.",
    announcement_type=AnnouncementType.WARNING, # The type of the announcement (the AnnouncementType enum gives the valid values).

)
table = client.asset.update_announcement( # Use the update_announcment() method, which for most objects requires a minimal set of information. This helper method will construct the necessary request, call the necessary API(s), and return with the result of the update operation all-in-one.

    asset_type=Table, # Specify the type of asset to be updated.

    qualified_name="default/snowflake/1657037873/SAMPLE_DB/FOOD_BEV/TOP_BEVERAGE_USERS",
    name="TOP_BEVERAGE_USERS",
    announcement=announcement,
)

Add announcement to existing assets
val result = Table.updateAnnouncement(  // Use the updateAnnouncement() helper method, which for most objects requires a minimal set of information. This helper method will construct the necessary request, call the necessary API(s), and return with the result of the update operation all-in-one.

    client, // Because this operation will directly change the asset in Atlan, you must provide it an AtlanClient through which to connect to the tenant.

    "default/snowflake/1657037873/SAMPLE_DB/FOOD_BEV/TOP_BEVERAGE_USERS",  // The qualifiedName of the object.

    AtlanAnnouncementType.WARNING,  // The type of the announcement (the AtlanAnnouncementType enumeration gives the valid values).

    "Caution!",  // A title for the announcement.

    "This table was changed.")  // A message to include in the announcement.

POST /api/meta/entity/bulk
{
  "entities": [ // All assets must be wrapped in an entities array.

    {
      "typeName": "Table", // You must provide the exact type name for the asset (case-sensitive).

      "attributes": {
        "name": "TOP_BEVERAGE_USERS", // You must provide the exact name of the asset (case-sensitive).

        "qualifiedName": "default/snowflake/1657037873/SAMPLE_DB/FOOD_BEV/TOP_BEVERAGE_USERS", // You must provide the exact qualifiedName of the asset (case-sensitive).

        "announcementType": "warning", // You must provide a valid type for the announcement.

        "announcementTitle": "Caution!", // (Optional) You can also provide a title and message for the announcement.

        "announcementMessage": "This table was changed."
      }
    }
  ]
}

Remove from an existing asset¶

1.4.0 4.0.0

To remove an announcement from an existing asset:

dbt Java Python Kotlin Raw REST API

It is currently not possible to remove an announcement from an asset via dbt.

Remove announcement from existing asset
Column column = Column.removeAnnouncement( // Use the removeAnnouncement() helper method, which for most objects requires a minimal set of information. This helper method will construct the necessary request, call the necessary API(s), and return with the result of the removal operation all-in-one.

    client, // Because this operation will directly change the asset in Atlan, you must provide it an AtlanClient through which to connect to the tenant.

    "default/snowflake/1657037873/SAMPLE_DB/FOOD_BEV/TOP_BEVERAGE_USERS/USER_ID", // The qualifiedName of the column (this is generally needed on all assets).

    "USER_ID"); // The name of the column (this varies by asset, but most assets need the name specified).

Remove announcement from existing asset
from pyatlan.client.atlan import AtlanClient
from pyatlan.model.assets import Table

client = AtlanClient()
table = client.asset.remove_announcement( # Use the asset.remove_announcement() helper method, which for most objects requires a minimal set of information. This helper method will construct the necessary request, call the necessary API(s), and return with the result of the removal operation all-in-one.

    asset_type=Table, # Specify the type of asset from which to remove the announcement.

    qualified_name="default/snowflake/1657037873/SAMPLE_DB/FOOD_BEV/TOP_BEVERAGE_USERS/USER_ID",
    name="USER_ID",
)

Remove announcement from existing asset
val column = Column.removeAnnouncement(  // Use the removeAnnouncement() helper method, which for most objects requires a minimal set of information. This helper method will construct the necessary request, call the necessary API(s), and return with the result of the removal operation all-in-one.

    client, // Because this operation will directly change the asset in Atlan, you must provide it an AtlanClient through which to connect to the tenant.

    "default/snowflake/1657037873/SAMPLE_DB/FOOD_BEV/TOP_BEVERAGE_USERS/USER_ID",  // The qualifiedName of the column (this is generally needed on all assets).

    "USER_ID")  // The name of the column (this varies by asset, but most assets need the name specified).

POST /api/meta/entity/bulk
{
  "entities": [ // All assets must be wrapped in an entities array.

    {
      "typeName": "Table", // You must provide the exact type name for the asset (case-sensitive).

      "attributes": {
        "name": "TOP_BEVERAGE_USERS", // You must provide the exact name of the asset (case-sensitive).

        "qualifiedName": "default/snowflake/1657037873/SAMPLE_DB/FOOD_BEV/TOP_BEVERAGE_USERS", // You must provide the exact qualifiedName of the asset (case-sensitive).

        "announcementType": null, // You must provide the value null for the type of the announcement, its title, and its message.

        "announcementTitle": null,
        "announcementMessage": null
      }
    }
  ]
}

When creating an asset¶

2.0.0 4.0.0

To add an announcement when creating an asset:

dbt Java Python Kotlin Raw REST API

Add announcement when creating asset
models:
  - name: TOP_BEVERAGE_USERS # You must of course give the name of the object.

    meta:
      atlan:
        attributes: # The details for the announcement must be nested within the meta.atlan.attributes structure.

          announcementType: information # You must provide a valid status for the announcement (information, warning or issue).

          announcementTitle: "New!" # (Optional) You can also provide a title for the announcement.

          announcementMessage: >- # (Optional) You can also provide a message to include in the announcement.

            This table is newly created.

Add announcement when creating asset
Table table = Table
    .creator("TOP_BEVERAGE_USERS", // Use the creator() method to initialize the object with all necessary attributes for creating it.

        "default/snowflake/1657037873/SAMPLE_DB/FOOD_BEV")
    .announcementType(AtlanAnnouncementType.INFORMATION) // Set the announcement that should be added (in this example, we're using INFORMATION).

    .announcementTitle("New!") // Add a title for the announcement.

    .announcementMessage("This table is newly created.") // Add a message for the announcement.

    .build(); // Call the build() method to build the enriched object.

AssetMutationResponse response = table.save(client); // Call the save() method to actually create the asset with this announcement. Because this operation will persist the asset in Atlan, you must provide it an AtlanClient through which to connect to the tenant.

assert response.getCreatedAssets().size() == 1 // The response will include that single asset that was created.

Add announcement when creating asset
from pyatlan.client.atlan import AtlanClient
from pyatlan.model.assets import Table
from pyatlan.model.core import Announcement
from pyatlan.model.enums import AnnouncementType
from pyatlan.model.response import AssetMutationResponse

client = AtlanClient()
table = Table.creator( # Use the create() method to initialize the object with all [necessary attributes for creating it.

    name="TOP_BEVERAGE_USERS",
    schema_qualified_name="default/snowflake/1657037873/SAMPLE_DB/FOOD_BEV",
)
announcement = Announcement( # Create the Announcement to be used.

    announcement_title="New!",
    announcement_message="This table is newly created.",
    announcement_type=AnnouncementType.INFORMATION,
)
table.set_announcement(announcement=announcement)
response = client.asset.save(table) # Invoke the save() method with asset. This method will return an AssetMutationResponse object that encapsulates the results.

assert response.assets_created(Table) # Since a save can add, update, delete or partially update multiple assets the assets_created() method can be used to return a list of the assets of the specified type that were added. The assert statement is present to ensure a Table asset was created.

table = response.assets_created(Table)[0] # Since only one Table should have been created we use an index of 0 to retrieve the newly created table.

Add announcement when creating asset
val table = Table
    .creator("TOP_BEVERAGE_USERS",  // Use the creator() method to initialize the object with all necessary attributes for creating it.

        "default/snowflake/1657037873/SAMPLE_DB/FOOD_BEV")
    .announcementType(AtlanAnnouncementType.INFORMATION)  // Set the announcement that should be added (in this example, we're using INFORMATION).

    .announcementTitle("New!")  // Add a title for the announcement.

    .announcementMessage("This table is newly created.")  // Add a message for the announcement.

    .build()  // Call the build() method to build the enriched object.

val response = table.save(client)  // Call the save() method to actually create the asset with this announcement. Because this operation will persist the asset in Atlan, you must provide it an AtlanClient through which to connect to the tenant.

assert(response.createdAssets.size == 1)  // The response will include that single asset that was created.

POST /api/meta/entity/bulk
{
  "entities": [ // All assets must be wrapped in an entities array.

    {
      "typeName": "Table", // You must provide the exact type name for the asset (case-sensitive).

      "attributes": {
        "name": "TOP_BEVERAGE_USERS", // You must provide a name for the asset.

        "qualifiedName": "default/snowflake/1657037873/SAMPLE_DB/FOOD_BEV/TOP_BEVERAGE_USERS", // In the case of a table, the qualifiedName must be the concatenation of the parent schema's qualifiedName and the name of the table.

        "atlanSchema": { // When creating a table, you must specify the schema to create it within. This is defined by the atlanSchema attribute. You must specify both the type (must be Schema) and qualifiedName of the schema within the atlanSchema attribute — and the schema must already exist.

          "typeName": "Schema",
          "uniqueAttributes": {
            "qualifiedName": "default/snowflake/1657037873/SAMPLE_DB/FOOD_BEV"
          }
        },
        "announcementType": "information", // You must provide a valid status for the announcement.

        "announcementTitle": "New!", // (Optional) You can also provide a title and message for the announcement.

        "announcementMessage": "This table is newly created."
      }
    }
  ]
}