Attributes are an effective way to reduce the number of product/SKU combinations. Orders can be grouped by these in order to make production more efficient by printing products with the same attribute. They are available to be used on any product component and submitted to Site Flow in the order data. The brand (e.g. publisher) can now add Extra Data to a book or specification that can then be used in Site Flow as a product component attribute. 


The brand needs to inform the PSP that the extra data attribute has been added and can be used as an attribute.


Follow the steps below to add Extra Data in Piazza for a Book:


1. Click the Books tab on the main menu bar. The Books list is displayed.


To get a list of all published titles via API, use the base URL for this API is https://product-api.oneflowcloud.com. Then, use the GET {{piazza-base}}/api/books call. The response body provides the ISBN. For more information on API calls in Piazza, please reference https://docs.oneflowcloud.com/api-reference/piazza/.


2. Click to select the desired book. The Title Properties page opens.


Ensure the Title is unplublished before attempting to make any changes. 


Unpublish the Title by clicking the Unpublish button at the bottom right of the Title Properties page.


Or


Unpublish the Title via the following API call: (GET/books/{id}/unpublish). Then, make the API call to update a Title (PATCH/book/{id}) and make the desired changes. Republish the Title by using the following call: GET/books/{id}/publish. For more information on API calls in Piazza, please reference https://docs.oneflowcloud.com/api-reference/piazza/. 


3. Click the Properties tab in the Configuration section.


4. Click the Add Property button. The New Property dialog is displayed.


5. Input the desired Key and Value into the fields.


6. Click the Save button to close the dialog and save the property.


If the user is adding 


Follow the steps below to add Extra Data in Piazza for a Specification:


1. Click the Books tab on the main menu bar. 


2. Click to select the View Specifications option on the left-side navigation pane.


Ensure the Specification is pending before attempting to make any changes.


3. Click to select the desired specification. The Edit Specification page opens.


4. Click the New Property button under the Properties section. The New Property dialog is displayed.


5. Input the desired Key and Value into the fields.


6. Click the Save button to close the dialog and save the property.



Follow the steps below to add an Extra Data attribute in Site Flow:


1. Click the Products tab on the main menu bar.


2. Click to select the desired product from the Product List. The Product Details page appears.


3. Click to select the component to add the attribute. The Components List appears.


4. Click the Attributes option. The Attributes list appears.


5. Click to select an attribute from the drop-down menu.


Proceed to step 7 if the attribute already exists in the Attributes list.


6. Click the Add button. The attribute appears at the bottom of the Attributes List.


7. Click the formula button to the right of the desired attribute. The Attribute dialog appears.


8. Click the Piazza Item option from the Data list.


9. Click to select either Book Extra Data or Spec Extra Data from the list that appears below the Data list. 


Select the Book Extra Data option if applying the extra data to a book in Piazza. Click the Spec Extra Data option if applying the extra data to a specification in Piazza.


10. Review the formula from the Preview section.


11. Click the Test button to ensure the formula is working as expected, if desired.


12. Click the Done button to close the dialog and save the formula to the attribute.


13. Click the Save Product button to save the attribute.