Updating the object-centric Shipped Not Invoiced app
When there’s an update for the Shipped Not Invoiced app, you’ll see an UPDATE AVAILABLE button next to the package name in the Dependencies tab in the package settings. The package settings are available from the package’s context menu (the three vertical dots by the package name).
Updates with new features are announced in the Release Notes, and all the updates for the Shipped Not Invoiced app are listed at the end of this topic. Update your app regularly to benefit from our new developments.
Here’s how to update your app:
Check the change history at the end of this topic for all the releases that have happened since your current version, to see what changes were made since you last updated the app. If there’s any action you need to take, such as manually updating a KPI or reapplying some of your customizations, we’ll tell you here.
Tip
Your current app version is shown in the Dependencies tab in the package settings.
In Studio, click Publish Package to publish your current app package, so that you can revert to this in case there are any problems during the update.
In the Dependencies tab in the package settings, click the UPDATE AVAILABLE button to update the app to the latest version. The popup lists the updated assets - click Update to proceed.
In the visual editor for the app’s Knowledge Model, check that the Knowledge Model Key variable is still set to the value of the Knowledge Model key for your local app installation. If you have multiple copies of the app, the update might overwrite it. Setting the Knowledge Model Key variable for the object-centric Shipped Not Invoiced app tells you how to find the local Knowledge Model key and set the variable value.
In Studio, make any required manual updates that we’ve noted in the change history for your new app version, or for the other versions since you last updated the app.
Check all the app’s views to make sure everything works correctly, all the fields are populated, and the numbers look as you’d expect.
If there’s an issue and you’re sure you made any required manual changes correctly, see Contacting support to find how to get help.
If everything’s working, click Publish Package to publish your updated package and make it available to your users.
Change history
Version 1.4.0
We’ve flattened the view architecture by removing base views and reducing the depth of embedded views, so it’s simpler for you to customize the app. Views deleted in version 1.4.0 of the object-centric Shipped Not Invoiced applists the deleted views and their keys, and where the content has gone to in Version 1.4.0.
In the app’s Knowledge Model, we’ve revised the PQL queries to make them more intuitive to read and understand. The PQL statements are refactored, simplified and reformatted, but the underlying logic stays the same. KPI changes in version 1.4.0 of the object-centric Shipped Not Invoiced app lists the KPI IDs that have changed.
We optimized some PQL queries, which in some cases significantly improves performance when opening profile views.
Important
When you upgrade to or beyond this release, you'll need to transfer any customizations you made to the views and KPIs that are being removed in this version of the app, to the equivalent views and KPIs in the new version. If you have significant customizations in the Shipped Not Invoiced app, we recommend that you use the following upgrade instructions for Version 1.4.0 in place of the standard procedure.
In these steps, you'll customize a temporary instance of the app package, and then overwrite your original app package with it. Doing the customization work in a separate instance means that you can avoid downtime for your end users. Overwriting the original app package rather than just using the new instance means that you can keep your augmented attributes, tasks, and their transactional activity history.
Install a second, temporary instance of the object-centric Shipped Not Invoiced app from the Celonis Marketplace.
Check the views and KPIs components listed in the tables below for any customizations you've made to them in your original Shipped Not Invoiced app installation. If you have made any customizations to the listed entities, move these to the equivalent view or KPI in your temporary instance of the Shipped Not Invoiced app. Also copy all custom created assets that are not in the default Shipped Not Invoiced app to your temporary instance. Verify that everything in the temporary instance looks as you expect.
Publish a version of your original Shipped Not Invoiced app, so that you can revert to it quickly in case of any issues.
Use the copy-to functionality to overwrite the content of your existing Shipped Not Invoiced app package with the content of the package for the temporary instance.
Verify that the update was successful, then publish another version of your Shipped Not Invoiced app.
Remove the temporary instance of the Shipped Not Invoiced app.
View Name | Key | Where the content is now |
|---|---|---|
Item Table |
| Component |
Item Tabs |
| Layout moved to |
Open Item Table |
| Component |
Closed Item Table |
| Table component moved to |
Sidebar |
| Layout and components moved to |
Sidebar Filters |
| Layout and components moved to |
Sidebar Filters Open |
| Layout and components moved to |
Sidebar Filters Closed |
| Layout and components moved to |
Delivery Items of Delivery |
| Reusing |
Delivery Items of Sales Order Item |
| Reusing |
Sales Order Items of Sales Order |
| Reusing |
Sales Orders of Customer |
| Reusing |
Previous KPI ID | New KPI ID |
|---|---|
FORMULA_DELIVERYITEM_CALC_BILLING_DELAY | Split into: FORMULA_DELIVERYITEM_CALC_BILLING_DELAY_IN_DAYS_BILLED FORMULA_DELIVERYITEM_CALC_BILLING_DELAY_IN_DAYS_UNBILLED |
FORMULA_DELIVERYITEM_CALC_HOURS_BETWEEN_PGI_AND_INVOICE_CREATION_OR_TODAY | Split into: FORMULA_DELIVERYITEM_CALC_HOURS_BETWEEN_GI_INVOICE_CREATION FORMULA_DELIVERYITEM_CALC_HOURS_BETWEEN_GI_AND_NOW |
FORMULA_DELIVERYITEM_PARAMETER_GOODS_ISSUE_DATE | FORMULA_DELIVERYITEM_PARAMETER_LAST_GOODS_ISSUE_TIMESTAMP |
FORMULA_DELIVERYITEM_INDICATOR_UNBILLED_ORDER | Deleted |
KPI_DELIVERYITEM_SUM_UNBILLED | KPI_DELIVERYITEM_COUNT_UNBILLED_ITEMS |
FORMULA_DELIVERYITEM_PARAMETER_INVOICE_CREATION_DATE | FORMULA_DELIVERYITEM_PARAMETER_LAST_INVOICE_CREATION_TIMESTAMP |
FORMULA_DELIVERYITEM_CALC_BILLING_DELAY_HISTORICAL | FORMULA_DELIVERYITEM_CALC_BILLING_DELAY_IN_DAYS_BILLED |
KPI_DELIVERYITEM_AVG_BILLING_DELAY_HISTORICAL | KPI_DELIVERYITEM_AVG_BILLING_DELAY_IN_DAYS_BILLED |
FORMULA_DELIVERYITEM_CALC_BILLING_DELAY_CURRENT | FORMULA_DELIVERYITEM_CALC_BILLING_DELAY_IN_DAYS_UNBILLED |
KPI_DELIVERYITEM_AVG_BILLING_DELAY_CURRENT | KPI_DELIVERYITEM_AVG_BILLING_DELAY_IN_DAYS_UNBILLED |
FORMULA_CUSTOMER_CALC_DAYS_SINCE_GI | Deleted |
FORMULA_TIMELINECOLUMN_DISPLAY_INVOICE_CREATION_DATE_DAY | FORMULA_TIMELINECOLUMN_DISPLAY_INVOICE_CREATION_DAY |
FORMULA_TIMELINECOLUMN_DISPLAY_INVOICE_CREATION_DATE_MONTH | FORMULA_TIMELINECOLUMN_DISPLAY_INVOICE_CREATION_MONTH |
FORMULA_TIMELINECOLUMN_DISPLAY_INVOICE_CREATION_DATE_QUARTER | FORMULA_TIMELINECOLUMN_DISPLAY_INVOICE_CREATION_QUARTER |
FORMULA_TIMELINECOLUMN_DISPLAY_INVOICE_CREATION_DATE_YEAR | FORMULA_TIMELINECOLUMN_DISPLAY_INVOICE_CREATION_YEAR |
Previous ID | New ID |
|---|---|
DELIVERY_ITEM.INVOICE_CREATION_DATE_DAY (attribute) | DELIVERY_ITEM.INVOICE_CREATION_DAY |
DELIVERY_ITEM.INVOICE_CREATION_DATE_MONTH (attribute) | DELIVERY_ITEM.INVOICE_CREATION_MONTH |
DELIVERY_ITEM.INVOICE_CREATION_DATE_QUARTER (attribute) | DELIVERY_ITEM.INVOICE_CREATION_QUARTER |
DELIVERY_ITEM.INVOICE_CREATION_DATE_YEAR (attribute) | DELIVERY_ITEM.INVOICE_CREATION_YEAR |
FILTER_BILLING_RELEVANT (filter) | FILTER_DELIVERYITEM_BILLING_RELEVANT |
Version 1.3.0:
We added user names to activity history in the object modal views.
We updated descriptions in the user guide and other smaller improvements.
Version 1.2.0: We updated field names in the Knowledge Model to match version 1.0.0 of the Celonis object types and event types.
Version 1.1.2 and Version 1.1.3:
We activated advanced filters to allow business users to add their own filters to the Action View in Apps.
Fix: We removed unused entities from the Knowledge Model.
We now ensure that attributes do not return NULL if a display text is missing in the data.
Version 1.1.0:
We updated the realized value calculation of cash flow freed up from reducing the time to bill. You'll find the details in the Settings and User Guide views.
We replaced the event log specified in the Knowledge Model with the event log specified in Objects & Events for faster query times.
Fix: We now refer to the runtime variable to exclude items based on the specified activities.
Version 1.0.0 : The GA release of the object-centric Shipped Not Invoiced app.