Skip to content

Commit

Permalink
EN-96202 [Scripting] Document ManagedImage.checkOut() and ManagedImag…
Browse files Browse the repository at this point in the history
…e.checkIn() scripting calls

EN-96202 [Scripting] Document ManagedImage.checkOut() and ManagedImage.checkIn() scripting calls
Added articles for checkIn and checkOut scripting calls, including a small sample.
Updated search indexes and TOC using generate.php
Did not test it locally.
  • Loading branch information
CarlodeBoerWW committed Jun 11, 2024
1 parent eb13cb4 commit 5dd62f6
Show file tree
Hide file tree
Showing 10 changed files with 527 additions and 383 deletions.
71 changes: 38 additions & 33 deletions _data/smart-connection-scripting-guide/toc.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -513,39 +513,6 @@ toc:
path: smart-connection-scripting-guide/ManagedArticles/Methods/count.md
url: smart-connection-scripting-guide/ManagedArticles/Methods/count.html
permalink: 1149-count
- title: ManagedImage
layout: section
path: smart-connection-scripting-guide/ManagedImage/index.md
url: smart-connection-scripting-guide/ManagedImage/index.html
permalink: 1151-index
children:
- title: ManagedImage methods
layout: section
path: smart-connection-scripting-guide/ManagedImage/Methods/index.md
url: smart-connection-scripting-guide/ManagedImage/Methods/index.html
permalink: 1153-index
children:
- title: create
layout: chapter
path: smart-connection-scripting-guide/ManagedImage/Methods/create.md
url: smart-connection-scripting-guide/ManagedImage/Methods/create.html
permalink: 1152-create
- title: ManagedImage properties
layout: section
path: smart-connection-scripting-guide/ManagedImage/Properties/index.md
url: smart-connection-scripting-guide/ManagedImage/Properties/index.html
permalink: 1155-index
children:
- title: entMetaData
layout: chapter
path: smart-connection-scripting-guide/ManagedImage/Properties/entMetaData.md
url: smart-connection-scripting-guide/ManagedImage/Properties/entMetaData.html
permalink: 1154-entMetaData
- title: pageItem
layout: chapter
path: smart-connection-scripting-guide/ManagedImage/Properties/pageItem.md
url: smart-connection-scripting-guide/ManagedImage/Properties/pageItem.html
permalink: 1156-pageItem
- title: ManagedImages
layout: section
path: smart-connection-scripting-guide/ManagedImages/index.md
Expand Down Expand Up @@ -1120,6 +1087,44 @@ toc:
url: smart-connection-scripting-guide/z4-OverruleAddingOfCreatedEnterpriseImageToDossier/index.html
permalink: 1243-index
children:
children:
- title: ManagedImage methods
layout: section
path: smart-connection-scripting-guide/ManagedImage/Methods/index.md
url: smart-connection-scripting-guide/ManagedImage/Methods/index.html
permalink: 1153-index
children:
- title: checkIn
layout: chapter
path: smart-connection-scripting-guide/ManagedImage/Methods/checkIn.md
url: smart-connection-scripting-guide/ManagedImage/Methods/checkIn.html
permalink: 1154-checkIn
- title: checkOut
layout: chapter
path: smart-connection-scripting-guide/ManagedImage/Methods/checkOut.md
url: smart-connection-scripting-guide/ManagedImage/Methods/checkOut.html
permalink: 1153-checkOut
- title: create
layout: chapter
path: smart-connection-scripting-guide/ManagedImage/Methods/create.md
url: smart-connection-scripting-guide/ManagedImage/Methods/create.html
permalink: 1152-create
- title: ManagedImage properties
layout: section
path: smart-connection-scripting-guide/ManagedImage/Properties/index.md
url: smart-connection-scripting-guide/ManagedImage/Properties/index.html
permalink: 1155-index
children:
- title: entMetaData
layout: chapter
path: smart-connection-scripting-guide/ManagedImage/Properties/entMetaData.md
url: smart-connection-scripting-guide/ManagedImage/Properties/entMetaData.html
permalink: 1154-entMetaData
- title: pageItem
layout: chapter
path: smart-connection-scripting-guide/ManagedImage/Properties/pageItem.md
url: smart-connection-scripting-guide/ManagedImage/Properties/pageItem.html
permalink: 1156-pageItem
- title: Custom menu items
layout: section
path: smart-connection-scripting-guide/z2-CustomMenuItems/index.md
Expand Down
636 changes: 325 additions & 311 deletions assets/smart-connection-scripting-guide/search_data.json

Large diffs are not rendered by default.

66 changes: 33 additions & 33 deletions assets/web-services-guide/search_data.json

Large diffs are not rendered by default.

59 changes: 59 additions & 0 deletions smart-connection-scripting-guide/ManagedImage/Methods/checkIn.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
---
layout: chapter
title: checkIn
sortid: 63
permalink: 1154-checkIn
---

## Syntax

![]({{ site.baseurl }}{% link smart-connection-scripting-guide/images/indesign.png %}) ![]({{ site.baseurl }}{% link smart-connection-scripting-guide/images/indesignserver.png %})

```javascript
ManagedImage.checkIn();
```

### Parameters

**Return value**

The `checkIn()` method does not return anything.

## Description

The `checkIn()` method checks-in the placed Image in the Studio Server system.

## Examples

**Example title**

```javascript
var doc = app.activeDocument;
var managedImages = doc.managedImages;

var im;
var md;
var core_name;
var id;

for(i=0; i<managedImages.length; i++) {
im = managedImages[i];
md = im.entMetaData;
core_name = md.get( "Core_Name");
id = doc.entMetaData.get("Core_ID");
alert( "image name = [" + core_name + "] ; document id = [" + id + "]");
im.checkOut();
alert( "Now update the image in the woodwing.noindex folder");
im.checkIn();
}

```

## Supported versions

| Adobe Version | Supported |
| ------------- | --------- |
| 2021 | |
| 2022 | |
| 2023 | |
| 2024 | 19.0.1+ ✔ |
62 changes: 62 additions & 0 deletions smart-connection-scripting-guide/ManagedImage/Methods/checkOut.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
---
layout: chapter
title: checkOut
sortid: 64
permalink: 1153-checkOut
---

## Syntax

![]({{ site.baseurl }}{% link smart-connection-scripting-guide/images/indesign.png %}) ![]({{ site.baseurl }}{% link smart-connection-scripting-guide/images/indesignserver.png %})

```javascript
ManagedImage.checkOut();
```

### Parameters

**Return value**

The `checkOut()` method does not return anything.

## Description

The `checkOut()` method checks-out the placed Image.

Note 1: The InDesign user interface is not capable of handling/showing checked out images. It is e.g. not possible to check out and check in images by using the interface, besides during an Edit Original operation. We advise to not use this function.

Note 2: After using this call you are also responsible to call checkIn to check the image back in.

## Examples

**Example title**

```javascript
var doc = app.activeDocument;
var managedImages = doc.managedImages;

var im;
var md;
var core_name;
var id;

for(i=0; i<managedImages.length; i++) {
im = managedImages[i];
md = im.entMetaData;
core_name = md.get( "Core_Name");
id = doc.entMetaData.get("Core_ID");
alert( "image name = [" + core_name + "] ; document id = [" + id + "]");
im.checkOut();
alert( "Now update the image in the woodwing.noindex folder");
im.checkIn();
}
```

## Supported versions

| Adobe Version | Supported |
| ------------- | --------- |
| 2021 | |
| 2022 | |
| 2023 | |
| 2024 | 19.0.1+ ✔ |
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
layout: chapter
title: create
sortid: 63
sortid: 65
permalink: 1152-create
---

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,4 +5,6 @@ permalink: 1153-index
---
Methods on the ManagedImage object.

* [create](./create.md)
* [checkIn](./checkIn.md)
* [checkOut](./checkOut.md)
* [create](./create.md)
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
layout: chapter
title: entMetaData
sortid: 64
sortid: 66
permalink: 1154-entMetaData
---

Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
layout: chapter
title: pageItem
sortid: 65
sortid: 67
permalink: 1156-pageItem
---

Expand Down
6 changes: 4 additions & 2 deletions smart-connection-scripting-guide/ManagedImage/index.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
---
---
layout: section
title: ManagedImage
sortid: 13
Expand All @@ -12,4 +12,6 @@ permalink: 1151-index

### Methods

* [create](Methods/create.md)
* [checkIn](Methods/checkIn.md)
* [checkOut](Methods/checkOut.md)
* [create](Methods/create.md)

0 comments on commit 5dd62f6

Please sign in to comment.