Create a reference in a virtual folder to an asset stored elsewhere in Orange Logic
Call template
All DataTable calls can be POST or GET.
https://{OrangeLogicURL}/API/DataTable/V2.2/Documents-links:ParentChildLink?ParentRecord=\[DataTable/V2.2/Documents.Virtual-Folder.{asset subtype}:Read?{child asset identifier}&ChildRecords=\[DataTable/v2.2/Documents.{asset type}.{asset subtype}:Read?{parent asset identifier}
Virtual folders contain references to assets. They do not contain the assets themselves. Therefore, you can’t upload an asset directly to a virtual folder. When you add an asset to a virtual folder, the asset’s folder path doesn’t change. References to a single asset can exist in multiple virtual folders.
When you add a reference to a virtual folder, the DataTable call uses a Read action to identify the parent and child records you’re linking. It does not perform a Create or Update action, and it doesn’t change anything about the assets themselves.
Read
Example 1: Add an image to a virtual folder
This call creates a reference to an image with the identifier ZZ158 in the virtual folder with the identifier ZZ13VOQ.
/API/DataTable/V2.2/Documents-links:ParentChildLink?ParentRecord=[DataTable/V2.2/Documents.Virtual-Folder.Default:Read?CoreField.Identifier=ZZ13VOQ]&ChildRecords=[DataTable/v2.2/Documents.Image.Production-Still:Read?CoreField.Identifier=ZZ158]
Example call
curl --location --globoff --request POST 'https://mangovations.com/API/DataTable/V2.2/Documents-links:ParentChildLink?ParentRecord=[DataTable%2FV2.2%2FDocuments.Virtual-Folder.Default%3ARead%3FCoreField.Identifier%3DZZ13VOQ]&ChildRecords=[DataTable%2Fv2.2%2FDocuments.Image.Production-Still%3ARead%3FCoreField.Identifier%3DZZ158]' \
--header 'Authorization: Bearer f.uIWpWNe0syaNW@IaMeMzp4APNAuH2HAsg1naLacGPSehJi1gS5aaPlseDWlfhdqOKXxX4Jx9Qyty03YZ5V6Sk9BFw4oQPYW5Wuy6uvB.PmivqEj.YERsMjwoUgvP82' \
--header 'Cookie: AWSALB=HmiEnZEDBn1DkDHIkExLHb0l8AQWdNP16fFJs7Xk0G4/+CGQpWNtHk2SzwOVk4LVAeZGj8Zjxco/8o8gsqqaBLbDhThB7pGYtfSuLJVbg8aDOaX8zr4w7rx8lVCY; AWSALBCORS=HmiEnZEDBn1DkDHIkExLHb0l8AQWdNP16fFJs7Xk0G4/+CGQpWNtHk2SzwOVk4LVAeZGj8Zjxco/8o8gsqqaBLbDhThB7pGYtfSuLJVbg8aDOaX8zr4w7rx8lVCY; AWSALBTG=zkJYiRB2pdVvK6AIIRi5qbXbfFAlWAgPBAM2ESrK62uRt0AG/Kx9X4PE0kLF5ep8TjSTpRaBK5xT0ieT8kflvx91z3N1jVWHasEINE0HiS4MXQzRSdJJHHDSZl1nel4MkPo6FmSfqhaGhqzhVzAe2n2Uw9K+o+69qmplMUcQASUG; AWSALBTGCORS=zkJYiRB2pdVvK6AIIRi5qbXbfFAlWAgPBAM2ESrK62uRt0AG/Kx9X4PE0kLF5ep8TjSTpRaBK5xT0ieT8kflvx91z3N1jVWHasEINE0HiS4MXQzRSdJJHHDSZl1nel4MkPo6FmSfqhaGhqzhVzAe2n2Uw9K+o+69qmplMUcQASUG; CortexCID_ZZ1=NK2uiOOw0h7gcj0c; ZZ1-Session__1505=CfDJ8KSkO661hSREsDx7PGb48%2B3L%2F0f%2Fste%2Brbjff8jWFFhRUngAHR1au3gZ%2FrGTSnGMzfCLRVk13hFlSOflzhMPz5vFvUmzQceTXduQ7jRJRGnone6nBjyBhE54lEEwIjsLhDI6aXCEbG7SaAvDtBdRbNY7akN5WGssKuMnuSkXey%2F0; ZZ1-Session__1505-Alt=CfDJ8KSkO661hSREsDx7PGb48%2B3L%2F0f%2Fste%2Brbjff8jWFFhRUngAHR1au3gZ%2FrGTSnGMzfCLRVk13hFlSOflzhMPz5vFvUmzQceTXduQ7jRJRGnone6nBjyBhE54lEEwIjsLhDI6aXCEbG7SaAvDtBdRbNY7akN5WGssKuMnuSkXey%2F0'
Response
<Result>
<APIRequestInfo>
<ProviderVersion>KOBE.R2.2065G.216363</ProviderVersion>
<ProviderIdentity>CUY-T-USW2-APP</ProviderIdentity>
<ProviderID>44ddde3ac27a33c394335f249d4007d4</ProviderID>
<Module>DataTable</Module>
<APIVersion>V2.2</APIVersion>
<Resource>Documents-links:ParentChildLink</Resource>
<IsLoggedIn type="Boolean">True</IsLoggedIn>
<Status>LoggedIn</Status>
<UserLogin>ZZ1CT12218</UserLogin>
<Session>No session (production configuration)</Session>
<TimeoutPeriodMinutes type="Numeric">20</TimeoutPeriodMinutes>
</APIRequestInfo>
<RequestInterpretation>
<ParametersInformation>
<ParentRecord>
<Value>[DataTable/V2.2/Documents.Virtual-Folder.Default:Read?CoreField.Identifier=ZZ13VOQ]</Value>
<IsOptional type="Boolean">False</IsOptional>
<ValueCount type="Numeric">1</ValueCount>
</ParentRecord>
<ChildRecords>
<Value>[DataTable/v2.2/Documents.Image.Production-Still:Read?CoreField.Identifier=ZZ158]</Value>
<IsOptional type="Boolean">False</IsOptional>
<ValueCount type="Numeric">1</ValueCount>
</ChildRecords>
<OldLinkTypeToRemove>
<Value></Value>
<IsOptional type="Boolean">True</IsOptional>
<ValueCount type="Numeric">0</ValueCount>
</OldLinkTypeToRemove>
<ForcePrimaryLink>
<Value></Value>
<IsOptional type="Boolean">True</IsOptional>
<ValueCount type="Numeric">0</ValueCount>
</ForcePrimaryLink>
</ParametersInformation>
</RequestInterpretation>
<Response type="List">
<Result>
<Parameters>
<ParentRecord>2QDTWAO0A9I</ParentRecord>
<ChildRecords>2QDTWAO6WL</ChildRecords>
<OldLinkTypeToRemove></OldLinkTypeToRemove>
<ForcePrimaryLink></ForcePrimaryLink>
</Parameters>
<ExecutionStatus>Executed</ExecutionStatus>
<Result>Warning adding link between ZZ1DO000000000111 and ZZ1DO000000004393: . Status: AlreadyExists</Result>
</Result>
</Response>
</Result>
Example 2: Add a video to a virtual folder
This call creates a reference to a video with the identifier ZZ11CT in the virtual folder with the identifier ZZ13VOQ.
API/DataTable/V2.2/Documents-links:ParentChildLink?ParentRecord=[DataTable/V2.2/Documents.Virtual-Folder.Default:Read?CoreField.Identifier=ZZ13VOQ]&ChildRecords=[DataTable/v2.2/Documents.Video.Promo:Read?CoreField.Identifier=ZZ11CT]
Example call
curl --location --globoff --request POST 'https://mangovations.com/API/DataTable/V2.2/Documents-links:ParentChildLink?ParentRecord=[DataTable%2FV2.2%2FDocuments.Virtual-Folder.Default%3ARead%3FCoreField.Identifier%3DZZ13VOQ]&ChildRecords=[DataTable%2Fv2.2%2FDocuments.Video.Promo%3ARead%3FCoreField.Identifier%3DZZ11CT]' \
--header 'Authorization: Bearer [email protected]@btiJIUZ4Tw96zjDjQ1jdb02ntPPzxz1L62GUC@3R5bxhAarCXpNgHR1zwAU8Mrpwysukb5.OrIubHBFDXmxtiakYCVhMzDRu9LhAniBjr' \
--header 'Cookie: AWSALB=B363flkmW9GwWgnlZEVwABbIXXg9OTi/soTDVocE7jP9TdTML42LWOzAdY/8AMtjzJNuqLOgOiMnPz0fGLAe/8sJT96ilPjr48yTbbk7/c1gwEf5beBGCxvcXT2H; AWSALBCORS=B363flkmW9GwWgnlZEVwABbIXXg9OTi/soTDVocE7jP9TdTML42LWOzAdY/8AMtjzJNuqLOgOiMnPz0fGLAe/8sJT96ilPjr48yTbbk7/c1gwEf5beBGCxvcXT2H; AWSALBTG=ztqFDQM4SyUqSvPxA4g9bhj3RlA3+3qlz74q/g933rQNydEvt8NbxrC1BxLGhzPIbO5kqQclXvS7XhP1rRddgMrrlQzeSCkOjV+7WNyoylQD3y0l0aSfnEa1w3LIOzNWA9V2JWoWULTFf37DT85qEA6a1VVzqt1OC4ZfhqgARjKL; AWSALBTGCORS=ztqFDQM4SyUqSvPxA4g9bhj3RlA3+3qlz74q/g933rQNydEvt8NbxrC1BxLGhzPIbO5kqQclXvS7XhP1rRddgMrrlQzeSCkOjV+7WNyoylQD3y0l0aSfnEa1w3LIOzNWA9V2JWoWULTFf37DT85qEA6a1VVzqt1OC4ZfhqgARjKL; CortexCID_ZZ1=NK2uiOOw0h7gcj0c; ZZ1-Session__1505=CfDJ8KSkO661hSREsDx7PGb48%2B01ELnpWVT5aUVQ%2BNz%2B12jxlgLuu8UyCWJ2vu%2FEyYjhnSUrGkTARaxk4UPMVGdQv0Q2xwdJjNDzVKd0xHAgG8hDzRDzHznHJq%2FE23YEIzjNTRxPBm7kFDB76QJGsglYGydy%2FTwc6pPb95DZbF1fpGTY; ZZ1-Session__1505-Alt=CfDJ8KSkO661hSREsDx7PGb48%2B01ELnpWVT5aUVQ%2BNz%2B12jxlgLuu8UyCWJ2vu%2FEyYjhnSUrGkTARaxk4UPMVGdQv0Q2xwdJjNDzVKd0xHAgG8hDzRDzHznHJq%2FE23YEIzjNTRxPBm7kFDB76QJGsglYGydy%2FTwc6pPb95DZbF1fpGTY'
Response
<Result>
<APIRequestInfo>
<ProviderVersion>KOBE.R2.2065G.216363</ProviderVersion>
<ProviderIdentity>CUY-T-USW2-APP</ProviderIdentity>
<ProviderID>44ddde3ac27a33c394335f249d4007d4</ProviderID>
<Module>DataTable</Module>
<APIVersion>V2.2</APIVersion>
<Resource>Documents-links:ParentChildLink</Resource>
<IsLoggedIn type="Boolean">True</IsLoggedIn>
<Status>LoggedIn</Status>
<UserLogin>ZZ1CT12218</UserLogin>
<Session>No session (production configuration)</Session>
<TimeoutPeriodMinutes type="Numeric">20</TimeoutPeriodMinutes>
</APIRequestInfo>
<RequestInterpretation>
<ParametersInformation>
<ParentRecord>
<Value>[DataTable/V2.2/Documents.Virtual-Folder.Default:Read?CoreField.Identifier=ZZ13VOQ]</Value>
<IsOptional type="Boolean">False</IsOptional>
<ValueCount type="Numeric">1</ValueCount>
</ParentRecord>
<ChildRecords>
<Value>[DataTable/v2.2/Documents.Video.Promo:Read?CoreField.Identifier=ZZ11CT]</Value>
<IsOptional type="Boolean">False</IsOptional>
<ValueCount type="Numeric">1</ValueCount>
</ChildRecords>
<OldLinkTypeToRemove>
<Value></Value>
<IsOptional type="Boolean">True</IsOptional>
<ValueCount type="Numeric">0</ValueCount>
</OldLinkTypeToRemove>
<ForcePrimaryLink>
<Value></Value>
<IsOptional type="Boolean">True</IsOptional>
<ValueCount type="Numeric">0</ValueCount>
</ForcePrimaryLink>
</ParametersInformation>
</RequestInterpretation>
<Response type="List">
<Result>
<Parameters>
<ParentRecord>2QDTWAO0A9I</ParentRecord>
<ChildRecords>2QDTWA49EN</ChildRecords>
<OldLinkTypeToRemove></OldLinkTypeToRemove>
<ForcePrimaryLink></ForcePrimaryLink>
</Parameters>
<ExecutionStatus>Executed</ExecutionStatus>
<Result></Result>
</Result>
</Response>
</Result>