Designer

Designer enables you to design and view all of the objects in your event-driven architecture (EDA). You can use Designer to create events, associate payload schemas to the events, specify the events that applications publish and subscribe to, and create event APIs and Event API Products to share events.

If you're just getting started designing an EDA, you should also have a look at the Getting Started tutorial, Designing Your Event-Driven Architecture.

Using Designer

On the Designer homepage, you can access all of the application domains that you have access to. Your ability to view or edit an application domain depends on your user role and access level. For more information, see Configuring User Access to Application Domains.

To open Designer, perform these steps:

  1. Log in to the PubSub+ Cloud Console if you have not done so yet. The URL to access the Cloud Console differs based on your authentication scheme. For more information, see Logging into the PubSub+ Cloud Console.
  2. On the navigation bar, select Designer .

After you open Designer, you work within Application Domains to create and manage the following objects:

Using Custom Attributes

You can add custom attributes to application domains and object types in Designer to include additional data that's useful for your EDA.

Event Portal Users with Manager access to an application domains can create custom attributes that apply to the application domain and to objects within the application domain. Users with the Event Portal Manager or Administrator roles can also create and delete custom attributes that apply to all application domains or every instance of an object within all application domains.

When you add a custom attribute to an application domain or object type, a field for the attribute is added to every new and existing instance of the object in the current application domain or in all application domains. Users can set a value in the custom attribute field when they create or edit an application domain or object, just as they would enter a value for any other setting.

Custom attributes can be simple or complex. Simple custom attributes can be up 250 alphanumeric characters and you can use them as filters in Catalog. Complex custom attributes allow values up to 10,000 characters, including special characters but can't be used as filters or search terms in Catalog.

Custom attributes in two different application domains can have the same name if they are both simple or both complex. However, a custom attribute that applies to all application domains can't have the same name as a custom attribute that applies only to one or more specific application domains. If you move an object that has a custom attribute set to another application domain where the custom attribute doesn’t already exist, it is automatically added.

After you create a custom attribute, you can't rename it, but you can delete it. Deleting a custom attribute scoped to all application domains removes the attribute and value from all objects and application domains that it was added to. Deleting a custom attribute that is scoped to the current application deletes it only from that application domain and the objects it contains. The custom attribute is not deleted from other application domains that have a custom attribute with the same name.

When you add a custom attribute to an object type, you can add it to the object itself, or to object versions. If you add a versioned object attribute, users can set different values in different versions of the object. If you add the custom attribute to the object itself, the same value applies to all versions.

To create a custom attribute for an application domain, perform these steps:

  1. On the Application Domains page, click Create Application Domain.
  2. Click More Actionsfor the application domain and select Manage Custom Attributes.

  3. Click Add.

    Screenshot showing the settings described in the surrounding steps.

  4. Enter a name for the custom attribute.
  5. Select whether the custom attribute Type is Simple or Complex.
  6. Select whether the custom attribute applies to All application domains or only the Current application domain.
  7. Repeat steps 3 to 6 for each custom attribute that you want to add.
  8. Click Save.

To create a custom attribute for an object, perform these steps:

  1. In any application domain, select the tab for the type of object you want to create a custom attribute for.
  2. Perform one of the following actions:
    1. Click Create <Object-type> then click Manage Custom Attributes.
    2. Open an existing object or object version and click More Actionsfor the object, then select Manage Custom Attributes.
  3. Perform one of the following actions:
    1. If you want the custom attribute value to be the same for all versions on an object, click Add next to <Object-type> Attributes.

    2. If you want users to be able to set a different value in different versions of the object, click Add next to Versioned <Object-type> Attributes.

      Screenshot showing the settings described in the surrounding steps.

  4. Enter a name for the custom attribute.
  5. Select whether the custom attribute Type is Simple or Complex.
  6. Select whether the custom attribute applies to objects of the same type in All application domains or only the Current application domain.
  7. Repeat steps 3 to 6 for each custom attribute you want to add.
  8. Click Save.

After you save the custom attributes you can save any changes to the object or you can close the object and discard any changes. A field for the custom attribute displays when a user creates or edits an application domain or an object.

Setting the Kafka Delimiter

Kafka brokers don't recognize level delimiters in topics. If you want to include Kafka events in your EDA, you can specify a delimiter that Event Portal recognizes in Kafka topics. All Kafka topic domains and topic addresses in your organization's account must use the same delimiter.

If the Kafka delimiter is not set, when a user tries to add a Kafka topic domain or topic address, they are notified that a Kafka delimiter must first be set for your organization's account before. If the user has a role with sufficient access, the notification includes a link to set the delimiter. The Kafka delimiter can't be changed if it is currently in use for a Kafka topic domain or Kafka topic address.

To set the Kafka delimiter for your organization, perform these steps:

  1. On the Application Domains page, click More ActionsScreenshot showing the settings described in the surrounding steps..

  2. Select Kafka Settings.

    Screenshot showing the settings described in the surrounding steps.

  3. In the Kakfa Delimeter List, select Dot ., Underscore _, or Dash -.
  4. Click Save.