Skip to main content

Celonis Product Documentation

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:

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. 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.

  7. 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.

  8. 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.

  1. Install a second, temporary instance of the object-centric Shipped Not Invoiced app from the Celonis Marketplace.

  2. 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.

  3. Publish a version of your original Shipped Not Invoiced app, so that you can revert to it quickly in case of any issues.

  4. 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.

  5. Verify that the update was successful, then publish another version of your Shipped Not Invoiced app.

  6. Remove the temporary instance of the Shipped Not Invoiced app.

Table 33. Views deleted in version 1.4.0 of the object-centric Shipped Not Invoiced app

View Name

Key

Where the content is now

Item Table

view-item-table

Component table-59c73dd6-c21b-48d9-aa58-0f4330e5d04a moved to action-view as open item table

Item Tabs

view-item-tabs

Layout moved to action-view

Open Item Table

view-open-item-table

Component table-59c73dd6-c21b-48d9-aa58-0f4330e5d04a moved to action-view

Closed Item Table

view-closed-item-table

Table component moved to action-view - new component ID table-943b1af1-52fe-44d6-9204-8939065e5f1f to resolve conflict with open item table

Sidebar

view-sidebar-base

Layout and components moved to view-sidebar-open and view-sidebar-closed

Sidebar Filters

view-sidebar-filters-base

Layout and components moved to view-sidebar-open and view-sidebar-closed

Sidebar Filters Open

view-sidebar-filters-open

Layout and components moved to view-sidebar-open

Sidebar Filters Closed

view-sidebar-filters-closed

Layout and components moved to view-sidebar-closed

Delivery Items of Delivery

view-delivery-items-of-delivery

Reusing view-delivery-item-table

Delivery Items of Sales Order Item

view-delivery-items-of-sales-order-item

Reusing view-delivery-item-table

Sales Order Items of Sales Order

sales-order-items-of-sales-order

Reusing view-sales-order-item-table

Sales Orders of Customer

view-sales-orders-of-customer

Reusing view-sales-order-table



Table 34. KPI changes in version 1.4.0 of the object-centric Shipped Not Invoiced app

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



Table 35. Other Knowledge Model changes in version 1.4.0 of the object-centric Shipped Not Invoiced app

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.