# JS SDK: Examples

## Examples of Array Handling

### Example 1: **Finding Intersection of Arrays**

In this example, we will match candidates (structured as 'Cand') with job offers (structured as 'Jobs') by considering the intersection of skills, represented as arrays such as finance, management, and programming. The candidate's skills are stored in 'cand\_skills,' while the required skills (functions) for the job are stored in 'job\_functions.' The matching result will be saved in the 'Job' object, specifically in the 'candidate\_ids' field.

Here we use the following functions:

* [$D.getValueFromTemplate()](/javascript-sdk/internal-usdd-methods.md#get-field-value-of-the-current-object-usdd-getvaluefromtemplate)
* Standard JS method [.split(",")](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/split)
* Standard JS method [.forEach()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/forEach)
* [$D.store.get()](/javascript-sdk/internal-usdd-methods.md#get-an-object-from-different-structure-usdd-store-get)
* [$D.arrayContainsAny()](/javascript-sdk/internal-usdd-methods.md)
* [$D.concat()](/javascript-sdk/internal-usdd-methods.md)
* [$D.store.save()](/javascript-sdk/internal-usdd-methods.md#save-an-object-usdd-store-save)

Content within the [JS SDK Step](/scenarios/editing-scenarios/action-steps/js-sdk-step.md):

```javascript
// Scenario processes objects from Jobs

DirectualEngine.addEventListener(AppEvents.START, function(context){
  var candidates = $D.eval("{{candidates_ids}}")
  var functions = $D.eval("{{job_functions}}")
  var id = $D.eval("{{id}}")

  var matchCand = []
  
  if (candidates) {
  	candidates.split(",").forEach(function(cand) {
    	var candSkills = $D.store.get("Cand", cand, {fields: ["cand_skills"]});
       	if ($D.arrayContainsAny(candSkills, functions)) {
        	matchCand = $D.concat(matchCand,cand)
        }
    })
  }
  $D.store.save("Jobs", {"id": id, "candidate_ids": matchCand }, false)
  return true;
});
```

### Example 2: Composing JSON with Custom Property Names

While the [JSON step](/scenarios/editing-scenarios/action-steps/json-step.md) is useful, it doesn't support custom property names. Here's how to work around that limitation.

For instance, if you have structures for 'Authors' and 'Books' and want to compose JSON like this:

```javascript
{
    "name": "Leo Tolstoy",
    "book1": {
        "id": "book1",
        "title": "War and Peace"
    },
    "book2": {
         "id": "book2",
         "title": "Anna Karenina"
     }
 }
```

We can do that with the following JS SDK code:

```javascript
DirectualEngine.addEventListener(AppEvents.START, function(context){
  var id = $D.eval('{{id}}')
  var array = $D.eval('{{book_ids}}').split(',')
  var newObject = {}
  newObject.name = $D.eval('{{name}}')
  array && array.map(function(book) {
    newObject[book] = {}
    var bookObject = $D.store.get("Books", book, {fields: ["Title", "Year"]});
    for (var field in bookObject) {
    	newObject[book][field] = bookObject[field]
    }
  })
  //saving result object
  $D.store.save("WebUser", {"id": id, "json": JSON.stringify(newObject) }, false)
  return true
});
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://readme.directual.com/javascript-sdk/sdk-examples.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.