Topics
6 minute read
Topics are used for publishing data to other parties. Topics do not send data directly but act as a notification system that alerts subscribers to pull data.
The topic defines the types of data (tables and fields) that are available to be transferred to other parties. Conditions can be added to filter and control which data should be transferred.
Topic card
- Choose the 🔎 icon, enter Topics (IDM), and select the related link. Fill in the fields as necessary. Hover over a field to read a short description. Some of the most important fields are as follows:
| Field | Comment |
|---|---|
| Message processing | Pryme Intercompany Masterdata -> Generic |
| Pryme Intercompany Project -> Project, Time entries or Project ledger entries. | |
| Subscription type | This field is used to restrict the topic to a specific Party or to a group of Parties. |
| Subscription Code | If the Subscription Type is Party or Group, add the Party or Party group to whom data is published the topic. |
- Open the Topic Tables action under Related.
Transfer time entries
Two pre-defined templates are provided for transferring time entries and project ledger entries.
Time entries
This template transfers both time and resources. Once time entries are submitted, they are transferred to the external time entries table in the receiving company. This enables project managers in the selling company to preview the entries. Additionally, an approval flow is included for informational purposes.
When time entries are posted in the performing company, project ledger entries are automatically created in both the selling and performing companies.
Project ledger entries
This template transfers time (excluding resources), expenses, and item entries. It creates transactions in a project journal, and when posted, project ledger entries are generated in the selling company. Unlike the time entries template, this option does not include preview or approval functionality when the timesheet is submitted in the performing company.
Both templates can’t be used simultaneously for time entries, as this will result in duplicate project ledger entries. However, the templates can be used in combination for different purposes:
- Time Entries: For transferring time and resources.
- Project Ledger Entries: For transferring expenses and item entries (add a condition to only include type g/l account and Item).
Note!
The template project ledger entries is a preview feature and should be tested in a sandbox environment. Contact support for use in a production environment.Topic tables
There is a difference between the two intercompany apps when setting up topic tables:
Pryme Intercompany Masterdata - Tables and table definitions must be added manually. By default, all fields are included in the data message unless specified otherwise.
Pryme Intercompany Project - Predefined templates are available, with tables and table definitions already populated.
Note!
When you have setup the Topic, you must go back to the topic card Set status to Ready and then restart the company.Pryme Intercompany Masterdata
- Select New and search for the table to add.
- Fill in the fields as necessary. Hover over a field to read a short description. Some of the most important fields are as follows:
| Field | Comment |
|---|---|
| Allow On-Demand Publish | Enables users to manually publish records to this topic using an on-demand page action, provided the conditions are fulfilled. This field is valid only for tables with special on-demand functionality. |
| Conditions | Use this field to set filters that define whether data should be included or excluded in the Topic record. |
- If you want to restrict the number of fields that are included in the Topic message, click on Included fields.
- When the Topic is setup, go back to the topic card and Set status to Ready.
- Restart the company. The changelog will be updated with new and updated entries that will generate topic records for the subscribers.
Pryme Intercompany Project
In Pryme Intercompany project you have predefined templates. They are populated with tables and table definitions (the fields that are included in the data message). It’s possible add or delete tables and fields. Note that if you make changes in a topic that is already related to a subscription you must also update the subscription.
- If you add or delete a table, add or delete the same table in the subscription.
- If you add or delete a field this is how you update the subscription.
Update the template
- To add a new table, select New and search for the table to add.
- Fill in the fields as necessary. Hover over a field to read a short description. Some of the most important fields are as follows:
| Field | Comment |
|---|---|
| Allow On-Demand Publish | Enables users to manually publish records to this topic using an on-demand page action, provided the conditions are fulfilled. This field is valid only for tables with special on-demand functionality. |
| Conditions | Use this field to set filters that define whether data should be included or excluded in the Topic record. |
- If you want to restrict the number of fields that are included in the Topic message, click on Included fields.
- When the Topic is setup, go back to the topic card and Set status to Ready.
- Restart the company. The changelog will be updated with new and updated entries that will generate topic records for the subscribers.
Template - Project
| Table | Table Name |
|---|---|
| 167 | Job |
| 352 | Default dimension |
| 1001 | Job task |
| 1002 | Job task dimension |
| 14045676 | Permissions PM (PGS) |
| 14045713 | Budget Entry (PGS) |
| 14045718 | Milestones (PGS) |
| 14046302 | Project Team members PGS |
| 14046351 | Project attribute PGS |
| 14046352 | Project attribute Value PGS |
| 14046353 | Project Attr. Value mapping PGS |
| 70230251 | IC TIme Approval Outb. ICPRYME |
Note!
If the transfer pricing list is in another currency than LCY, you must add the fields Invoice currency code and Time sheet currency code in the Job table definition.Note!
If you don’t want to transfer the Project attributes, you must delete 3 tables;
- Project attribute PGS
- Project attribute Value PGS
- Project Attr. Value mapping PGS.
Template - Time entries
| Table | Table Name |
|---|---|
| 156 | Resource |
| 352 | Default dimension |
| 14045726 | Time entry (PGS) |
Template - Project ledger entries
| Table | Table Name |
|---|---|
| 169 | Job ledger entry |
Transfer all entries in a table
The intercompany apps only transfer new and updated entries. To ensure consistency across all subscribing companies, transfer all entries in a table using the Topic Table -> Create Messages function. Key points to remember:
- Use this for Master data tables after setting up the topic to synchronize data across companies.
- This action adds and updates entries but does not delete records in subscribing companies.
- If invalid records exist in subscribing companies, manual cleanup may be required.
Update a topic with new fields
To add a new field to an existing topic, follow these steps:
- Choose the 🔎 icon, enter Topics (IDM), and select the related link.
- Set the Topic to On hold.
- Open the Topic Tables action under Related.
- Click on Included fields. Message Data Content (IDM) will open.
- Go back to the Topic card and Set status to Ready.
- Restart the company.
- Add the field in the Subscription. See Updating a Subscription after changing the Topic.