Document Properties
Introduction
This concept describes the sharing of media assets from parent domains.
The Intershop Commerce Management (ICM) uses Intershop Shared Files, an instance of the file-based data storage system to store files (such as images, videos, PDFs) to be referenced with products, categories, CMS components, etc. It is an application-server controlled directory structure holding files. Each organization, sales channel, partner channel, partner, and application has its own subdirectory in Intershop Shared Files. Depending on the domain names used in the REST API call path, media assets are returned in the JSON response.
Prior to ICM 14.2.3, only media assets belonging to the REST API call path were returned. From ICM 14.2.3, shared media assets are returned as well when using the parameter share=true.
Shared media assets are files and folders belonging to parents of the REST call path domain.
References
Organization Structure
An organization structure can contain multiple levels of sales channels, partner channels, partners, and applications. Each level can have media assets to be shared to its children. For example, the organization shares media assets with its applications, etc.
This concept is based on the following example organization structure:
TestPartnerChannel shares media assets with its children TestPartner, TestPartnerChannel2, TestPartner2, as well as TestSalesChannel3, TestSalesChannel23, and their B2C applications. TestEnterprise shares media assets to all of its children.
Locally Stored Media Assets
The default value of the new parameter shared (=false) ensures the resulting JSON does not change. Only the media assets from the REST call's domain are returned.
REST API Call
Organization: TestEnterprise
URL: https://localhost:443/INTERSHOP/rest/WFS/TestEnterprise-Site/-;loc=en_US/mediaassets
The JSON response returns only TestEnterprise-Site media assets.
Sales Channel: TestSalesChannel3
URL: https://localhost:443/INTERSHOP/rest/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3;loc=en_US/mediaassets
The JSON response returns only TestSalesChannel3 media assets.
Application: TestSalesChannel3-B2CApplication
URL: https://localhost:443/INTERSHOP/rest/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf;loc=en_US/mediaassets
The JSON response returns only TestSalesChannel3-consumer-test-sf media assets.
JSON Example
{
"data": {
"directories": [
"TE_TP2_SC3_App_L_max"
],
"files": [
"TE_TP2_SC3_App_8806086070188_Back.jpg",
"TE_TP2_SC3_App_L_201807205_front.jpg"
]
},
"info": {
"directories": [
{
"name": "TE_TP2_SC3_App_L_max",
"shared": false
}
],
"files": [
{
"name": "TE_TP2_SC3_App_8806086070188_Back.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestPartner2-TestSalesChannel3-consumer-test-sf/en_US/TE_TP2_SC3_App_8806086070188_Back.jpg",
"descriptor": "TestPartner2-TestSalesChannel3-consumer-test-sf:/TE_TP2_SC3_App_8806086070188_Back.jpg",
"shared": false
},
{
"name": "TE_TP2_SC3_App_L_201807205_front.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestPartner2-TestSalesChannel3-consumer-test-sf/en_US/TE_TP2_SC3_App_L_201807205_front.jpg",
"descriptor": "TestPartner2-TestSalesChannel3-consumer-test-sf:/TE_TP2_SC3_App_L_201807205_front.jpg",
"shared": false
}
],
"hasMoreElements": false,
"limit": 50,
"offset": 0,
"total": 3
},
"messages": [
{
"code": "limit.set.info",
"message": "A limit of 50 has been set.",
"level": "INFO"
}
]
}
Shared Media Assets
Setting the new parameter shared=true results in the JSON response containing local media assets as well as shared ones, starting from the REST call's domain all the way to its root organization.
In the info block of the JSON response, shared media assets have the attribute shared=true and local media assets have the attribute shared=false.
REST API Call
The following JSON responses refer to the example organization structure used in this document.
Organization: TestEnterprise
URL: https://localhost:443/INTERSHOP/rest/WFS/TestEnterprise-Site/-;loc=en_US/mediaassets
The JSON response returns only TestEnterprise-Site media assets.
Sales Channel: TestSalesChannel3
URL: https://localhost:443/INTERSHOP/rest/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3;loc=en_US/mediaassets
The JSON response returns local TestSalesChannel3 media assets and shared media assets from all its parents all the way to its organization.
Media assets are shared from TestEnterprise, TestPartner, TestPartnerChannel2, etc.
Application: TestSalesChannel3-B2CApplication
URL: https://localhost:443/INTERSHOP/rest/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf;loc=en_US/mediaassets
The JSON response returns local TestSalesChannel3-consumer-test-sf media assets and shared media assets from all its parents all the way to its organization.
Media assets are shared from TestEnterprise, TestPartner, TestPartnerChannel2, etc.
JSON Example
{
"data": {
"directories": [
"LXbilder@TestPartner2",
"L_TE_TP_TPC2_TP2_bilder@TestPartner2",
"M_TE_TP_TPC2_TP2_bilder@TestPartner2",
"L_TE_bilder@TestEnterprise",
"M_TE_bilder@TestEnterprise",
"L_TE_TP2_SC_bilder@TestPartner2-TestSalesChannel3",
"M_TE_TP2_SC_bilder@TestPartner2-TestSalesChannel3",
"L_TE_PC_bilder@TestEnterprise-TestPartnerChannel",
"M_TE_PC_bilder@TestEnterprise-TestPartnerChannel",
"TE_TP2_SC3_App_L_max"
],
"files": [
"1397099-5382.jpg@TestPartner2",
"1402008-8226.jpg@TestPartner2",
"1402009-1998.jpg@TestPartner2",
"1422902-7811.jpg@TestPartner2",
"1423642-1731.jpg@TestPartner2",
"1423642_1690.jpg@TestPartner2",
"1423642_1694.jpg@TestPartner2",
"1451744-5158.jpg@TestPartner2",
"1454627-2352.jpg@TestPartner2",
"1454627_4467.jpg@TestPartner2",
"1454627_5639.jpg@TestPartner2",
"1454642-3828.jpg@TestPartner2",
"1454642_1017.jpg@TestPartner2",
"1454642_2417.jpg@TestPartner2",
"1454662-141.jpg@TestPartner2",
"1454662_1811.jpg@TestPartner2",
"1454662_2046.jpg@TestPartner2",
"1454984-9326.jpg@TestPartner2",
"1456432-8154.jpg@TestPartner2",
"1456467_7852.jpg@TestPartner2",
"152996-5823.jpg@TestPartner2",
"342110-7834.jpg@TestPartner2",
"11139626-2339-TE.jpg@TestEnterprise",
"27583-9068-TE.jpg@TestEnterprise",
"28901-6276.jpg@TestEnterprise",
"L_TE_TP2_SC_localRoot_28918-6725.jpg@TestPartner2-TestSalesChannel3",
"TE_PC_28918-6725.jpg@TestEnterprise-TestPartnerChannel",
"TE_TP2_SC3_App_8806086070188_Back.jpg",
"TE_TP2_SC3_App_L_201807205_front.jpg"
]
},
"info": {
"directories": [
{
"name": "LXbilder",
"origin": "TestPartner2",
"id": "LXbilder@TestPartner2",
"shared": true
},
{
"name": "L_TE_TP_TPC2_TP2_bilder",
"origin": "TestPartner2",
"id": "L_TE_TP_TPC2_TP2_bilder@TestPartner2",
"shared": true
},
{
"name": "M_TE_TP_TPC2_TP2_bilder",
"origin": "TestPartner2",
"id": "M_TE_TP_TPC2_TP2_bilder@TestPartner2",
"shared": true
},
{
"name": "L_TE_bilder",
"origin": "TestEnterprise",
"id": "L_TE_bilder@TestEnterprise",
"shared": true
},
{
"name": "M_TE_bilder",
"origin": "TestEnterprise",
"id": "M_TE_bilder@TestEnterprise",
"shared": true
},
{
"name": "L_TE_TP2_SC_bilder",
"origin": "TestPartner2-TestSalesChannel3",
"id": "L_TE_TP2_SC_bilder@TestPartner2-TestSalesChannel3",
"shared": true
},
{
"name": "M_TE_TP2_SC_bilder",
"origin": "TestPartner2-TestSalesChannel3",
"id": "M_TE_TP2_SC_bilder@TestPartner2-TestSalesChannel3",
"shared": true
},
{
"name": "L_TE_PC_bilder",
"origin": "TestEnterprise-TestPartnerChannel",
"id": "L_TE_PC_bilder@TestEnterprise-TestPartnerChannel",
"shared": true
},
{
"name": "M_TE_PC_bilder",
"origin": "TestEnterprise-TestPartnerChannel",
"id": "M_TE_PC_bilder@TestEnterprise-TestPartnerChannel",
"shared": true
},
{
"name": "TE_TP2_SC3_App_L_max",
"shared": false
}
],
"files": [
{
"name": "1397099-5382.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestPartner2/en_US/1397099-5382.jpg",
"descriptor": "TestPartner2:/1397099-5382.jpg",
"origin": "TestPartner2",
"id": "1397099-5382.jpg@TestPartner2",
"shared": true
},
{
"name": "1402008-8226.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestPartner2/en_US/1402008-8226.jpg",
"descriptor": "TestPartner2:/1402008-8226.jpg",
"origin": "TestPartner2",
"id": "1402008-8226.jpg@TestPartner2",
"shared": true
},
{
"name": "1402009-1998.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestPartner2/en_US/1402009-1998.jpg",
"descriptor": "TestPartner2:/1402009-1998.jpg",
"origin": "TestPartner2",
"id": "1402009-1998.jpg@TestPartner2",
"shared": true
},
{
"name": "1422902-7811.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestPartner2/en_US/1422902-7811.jpg",
"descriptor": "TestPartner2:/1422902-7811.jpg",
"origin": "TestPartner2",
"id": "1422902-7811.jpg@TestPartner2",
"shared": true
},
{
"name": "1423642-1731.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestPartner2/en_US/1423642-1731.jpg",
"descriptor": "TestPartner2:/1423642-1731.jpg",
"origin": "TestPartner2",
"id": "1423642-1731.jpg@TestPartner2",
"shared": true
},
{
"name": "1423642_1690.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestPartner2/en_US/1423642_1690.jpg",
"descriptor": "TestPartner2:/1423642_1690.jpg",
"origin": "TestPartner2",
"id": "1423642_1690.jpg@TestPartner2",
"shared": true
},
{
"name": "1423642_1694.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestPartner2/en_US/1423642_1694.jpg",
"descriptor": "TestPartner2:/1423642_1694.jpg",
"origin": "TestPartner2",
"id": "1423642_1694.jpg@TestPartner2",
"shared": true
},
{
"name": "1451744-5158.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestPartner2/en_US/1451744-5158.jpg",
"descriptor": "TestPartner2:/1451744-5158.jpg",
"origin": "TestPartner2",
"id": "1451744-5158.jpg@TestPartner2",
"shared": true
},
{
"name": "1454627-2352.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestPartner2/en_US/1454627-2352.jpg",
"descriptor": "TestPartner2:/1454627-2352.jpg",
"origin": "TestPartner2",
"id": "1454627-2352.jpg@TestPartner2",
"shared": true
},
{
"name": "1454627_4467.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestPartner2/en_US/1454627_4467.jpg",
"descriptor": "TestPartner2:/1454627_4467.jpg",
"origin": "TestPartner2",
"id": "1454627_4467.jpg@TestPartner2",
"shared": true
},
{
"name": "1454627_5639.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestPartner2/en_US/1454627_5639.jpg",
"descriptor": "TestPartner2:/1454627_5639.jpg",
"origin": "TestPartner2",
"id": "1454627_5639.jpg@TestPartner2",
"shared": true
},
{
"name": "1454642-3828.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestPartner2/en_US/1454642-3828.jpg",
"descriptor": "TestPartner2:/1454642-3828.jpg",
"origin": "TestPartner2",
"id": "1454642-3828.jpg@TestPartner2",
"shared": true
},
{
"name": "1454642_1017.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestPartner2/en_US/1454642_1017.jpg",
"descriptor": "TestPartner2:/1454642_1017.jpg",
"origin": "TestPartner2",
"id": "1454642_1017.jpg@TestPartner2",
"shared": true
},
{
"name": "1454642_2417.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestPartner2/en_US/1454642_2417.jpg",
"descriptor": "TestPartner2:/1454642_2417.jpg",
"origin": "TestPartner2",
"id": "1454642_2417.jpg@TestPartner2",
"shared": true
},
{
"name": "1454662-141.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestPartner2/en_US/1454662-141.jpg",
"descriptor": "TestPartner2:/1454662-141.jpg",
"origin": "TestPartner2",
"id": "1454662-141.jpg@TestPartner2",
"shared": true
},
{
"name": "1454662_1811.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestPartner2/en_US/1454662_1811.jpg",
"descriptor": "TestPartner2:/1454662_1811.jpg",
"origin": "TestPartner2",
"id": "1454662_1811.jpg@TestPartner2",
"shared": true
},
{
"name": "1454662_2046.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestPartner2/en_US/1454662_2046.jpg",
"descriptor": "TestPartner2:/1454662_2046.jpg",
"origin": "TestPartner2",
"id": "1454662_2046.jpg@TestPartner2",
"shared": true
},
{
"name": "1454984-9326.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestPartner2/en_US/1454984-9326.jpg",
"descriptor": "TestPartner2:/1454984-9326.jpg",
"origin": "TestPartner2",
"id": "1454984-9326.jpg@TestPartner2",
"shared": true
},
{
"name": "1456432-8154.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestPartner2/en_US/1456432-8154.jpg",
"descriptor": "TestPartner2:/1456432-8154.jpg",
"origin": "TestPartner2",
"id": "1456432-8154.jpg@TestPartner2",
"shared": true
},
{
"name": "1456467_7852.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestPartner2/en_US/1456467_7852.jpg",
"descriptor": "TestPartner2:/1456467_7852.jpg",
"origin": "TestPartner2",
"id": "1456467_7852.jpg@TestPartner2",
"shared": true
},
{
"name": "152996-5823.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestPartner2/en_US/152996-5823.jpg",
"descriptor": "TestPartner2:/152996-5823.jpg",
"origin": "TestPartner2",
"id": "152996-5823.jpg@TestPartner2",
"shared": true
},
{
"name": "342110-7834.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestPartner2/en_US/342110-7834.jpg",
"descriptor": "TestPartner2:/342110-7834.jpg",
"origin": "TestPartner2",
"id": "342110-7834.jpg@TestPartner2",
"shared": true
},
{
"name": "en_US_images-backup.zip",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestPartner2/en_US/en_US_images-backup.zip",
"descriptor": "TestPartner2:/en_US_images-backup.zip",
"origin": "TestPartner2",
"id": "en_US_images-backup.zip@TestPartner2",
"shared": true
},
{
"name": "11139626-2339-TE.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestEnterprise/en_US/11139626-2339-TE.jpg",
"descriptor": "TestEnterprise:/11139626-2339-TE.jpg",
"origin": "TestEnterprise",
"id": "11139626-2339-TE.jpg@TestEnterprise",
"shared": true
},
{
"name": "27583-9068-TE.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestEnterprise/en_US/27583-9068-TE.jpg",
"descriptor": "TestEnterprise:/27583-9068-TE.jpg",
"origin": "TestEnterprise",
"id": "27583-9068-TE.jpg@TestEnterprise",
"shared": true
},
{
"name": "28901-6276.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestEnterprise/en_US/28901-6276.jpg",
"descriptor": "TestEnterprise:/28901-6276.jpg",
"origin": "TestEnterprise",
"id": "28901-6276.jpg@TestEnterprise",
"shared": true
},
{
"name": "L_TE_TP2_SC_localRoot_28918-6725.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestPartner2-TestSalesChannel3/en_US/L_TE_TP2_SC_localRoot_28918-6725.jpg",
"descriptor": "TestPartner2-TestSalesChannel3:/L_TE_TP2_SC_localRoot_28918-6725.jpg",
"origin": "TestPartner2-TestSalesChannel3",
"id": "L_TE_TP2_SC_localRoot_28918-6725.jpg@TestPartner2-TestSalesChannel3",
"shared": true
},
{
"name": "TE_PC_28918-6725.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestEnterprise-TestPartnerChannel/en_US/TE_PC_28918-6725.jpg",
"descriptor": "TestEnterprise-TestPartnerChannel:/TE_PC_28918-6725.jpg",
"origin": "TestEnterprise-TestPartnerChannel",
"id": "TE_PC_28918-6725.jpg@TestEnterprise-TestPartnerChannel",
"shared": true
},
{
"name": "TE_TP2_SC3_App_8806086070188_Back.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestPartner2-TestSalesChannel3-consumer-test-sf/en_US/TE_TP2_SC3_App_8806086070188_Back.jpg",
"descriptor": "TestPartner2-TestSalesChannel3-consumer-test-sf:/TE_TP2_SC3_App_8806086070188_Back.jpg",
"shared": false
},
{
"name": "TE_TP2_SC3_App_L_201807205_front.jpg",
"uri": "/INTERSHOP/static/WFS/TestPartner-TestPartnerChannel2-Site/TestSalesChannel3-consumer-test-sf/TestPartner2-TestSalesChannel3-consumer-test-sf/en_US/TE_TP2_SC3_App_L_201807205_front.jpg",
"descriptor": "TestPartner2-TestSalesChannel3-consumer-test-sf:/TE_TP2_SC3_App_L_201807205_front.jpg",
"shared": false
}
],
"hasMoreElements": false,
"limit": 50,
"offset": 0,
"total": 40
},
"messages": [
{
"code": "limit.set.info",
"message": "A limit of 50 has been set.",
"level": "INFO"
}
]
}
Disclaimer
The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Website, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.