Initial version

.gitattributes

@@ -1,4 +1,3 @@
+# Line ending.
 * text eol=lf
-
-*.png binary
-*.jpg binary
+*.cmd text eol=crlf

.github/workflows/build-docker.yml

@@ -0,0 +1,31 @@
+name: build-docker
+on:
+  push:
+    branches:
+      - 'main'
+      - 'develop'
+    tags:
+      - '*'
+jobs:
+  publish-docker:
+    runs-on: ubuntu-20.04
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+      - name: Login to Docker Registry
+        uses: docker/login-action@v2
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v2
+      - name: Build nad push
+        uses: docker/build-push-action@v3
+        with:
+          context: ./
+          file: ./Dockerfile
+          push: true
+          tags: ghcr.io/datagov-cz/ms-adapter:${{ github.ref_name }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

.gitignore

@@ -1,6 +1,10 @@
 # Build, tools, ...
 .*
-target/
-dist/
-data/
 *.iml
+/target/
+/dist/
+/data/
+
+#
+!.mvn/
+!.github

.mvn/wrapper/MavenWrapperDownloader.java

@@ -0,0 +1,117 @@
+/*
+ * Copyright 2007-present the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import java.net.*;
+import java.io.*;
+import java.nio.channels.*;
+import java.util.Properties;
+
+public class MavenWrapperDownloader {
+
+    private static final String WRAPPER_VERSION = "0.5.6";
+    /**
+     * Default URL to download the maven-wrapper.jar from, if no 'downloadUrl' is provided.
+     */
+    private static final String DEFAULT_DOWNLOAD_URL = "https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/"
+        + WRAPPER_VERSION + "/maven-wrapper-" + WRAPPER_VERSION + ".jar";
+
+    /**
+     * Path to the maven-wrapper.properties file, which might contain a downloadUrl property to
+     * use instead of the default one.
+     */
+    private static final String MAVEN_WRAPPER_PROPERTIES_PATH =
+            ".mvn/wrapper/maven-wrapper.properties";
+
+    /**
+     * Path where the maven-wrapper.jar will be saved to.
+     */
+    private static final String MAVEN_WRAPPER_JAR_PATH =
+            ".mvn/wrapper/maven-wrapper.jar";
+
+    /**
+     * Name of the property which should be used to override the default download url for the wrapper.
+     */
+    private static final String PROPERTY_NAME_WRAPPER_URL = "wrapperUrl";
+
+    public static void main(String args[]) {
+        System.out.println("- Downloader started");
+        File baseDirectory = new File(args[0]);
+        System.out.println("- Using base directory: " + baseDirectory.getAbsolutePath());
+
+        // If the maven-wrapper.properties exists, read it and check if it contains a custom
+        // wrapperUrl parameter.
+        File mavenWrapperPropertyFile = new File(baseDirectory, MAVEN_WRAPPER_PROPERTIES_PATH);
+        String url = DEFAULT_DOWNLOAD_URL;
+        if(mavenWrapperPropertyFile.exists()) {
+            FileInputStream mavenWrapperPropertyFileInputStream = null;
+            try {
+                mavenWrapperPropertyFileInputStream = new FileInputStream(mavenWrapperPropertyFile);
+                Properties mavenWrapperProperties = new Properties();
+                mavenWrapperProperties.load(mavenWrapperPropertyFileInputStream);
+                url = mavenWrapperProperties.getProperty(PROPERTY_NAME_WRAPPER_URL, url);
+            } catch (IOException e) {
+                System.out.println("- ERROR loading '" + MAVEN_WRAPPER_PROPERTIES_PATH + "'");
+            } finally {
+                try {
+                    if(mavenWrapperPropertyFileInputStream != null) {
+                        mavenWrapperPropertyFileInputStream.close();
+                    }
+                } catch (IOException e) {
+                    // Ignore ...
+                }
+            }
+        }
+        System.out.println("- Downloading from: " + url);
+
+        File outputFile = new File(baseDirectory.getAbsolutePath(), MAVEN_WRAPPER_JAR_PATH);
+        if(!outputFile.getParentFile().exists()) {
+            if(!outputFile.getParentFile().mkdirs()) {
+                System.out.println(
+                        "- ERROR creating output directory '" + outputFile.getParentFile().getAbsolutePath() + "'");
+            }
+        }
+        System.out.println("- Downloading to: " + outputFile.getAbsolutePath());
+        try {
+            downloadFileFromURL(url, outputFile);
+            System.out.println("Done");
+            System.exit(0);
+        } catch (Throwable e) {
+            System.out.println("- Error downloading");
+            e.printStackTrace();
+            System.exit(1);
+        }
+    }
+
+    private static void downloadFileFromURL(String urlString, File destination) throws Exception {
+        if (System.getenv("MVNW_USERNAME") != null && System.getenv("MVNW_PASSWORD") != null) {
+            String username = System.getenv("MVNW_USERNAME");
+            char[] password = System.getenv("MVNW_PASSWORD").toCharArray();
+            Authenticator.setDefault(new Authenticator() {
+                @Override
+                protected PasswordAuthentication getPasswordAuthentication() {
+                    return new PasswordAuthentication(username, password);
+                }
+            });
+        }
+        URL website = new URL(urlString);
+        ReadableByteChannel rbc;
+        rbc = Channels.newChannel(website.openStream());
+        FileOutputStream fos = new FileOutputStream(destination);
+        fos.getChannel().transferFrom(rbc, 0, Long.MAX_VALUE);
+        fos.close();
+        rbc.close();
+    }
+
+}

.mvn/wrapper/maven-wrapper.properties

@@ -0,0 +1,2 @@
+distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.6.3/apache-maven-3.6.3-bin.zip
+wrapperUrl=https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar

Dockerfile

@@ -0,0 +1,7 @@
+FROM openjdk:21-slim-bookworm as build
+WORKDIR /opt/ms-adapter/
+COPY ./ ./
+RUN ./mvnw package
+
+FROM openjdk:21-slim-bookworm
+COPY --from=build --chown=user /opt/ms-adapter/dist /opt/ms-adapter/

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Otevřená data ČR @ DIA
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,58 @@
+# Adaptér při přístup ke službám skrze Microsoft Graph API
+
+## Konfigurace
+Vyrabrané argumentyaplikace je možné nastavit skrze proměnné prostředí.
+- `MS_APPLICATION` - Identifikátor aplikace.
+  Lze získat v "Přehled" registoravné aplikace jako "ID aplikace (klienta)". 
+- `MS_TENANT` - Identifikátor tenanta.
+  Lze získat v "Přehled" detailu registoravné aplikace jako "ID adresáře (tenanta)".
+- `MS_SECRET` - Hodnota tajemství aplikace.
+  Lze získat v "Certifikáty a tajné kódy" registrované aplikace jaho "Hodnota" v záložec "Tajné kódy klienta".
+
+## Stažení SharePoint seznamu
+
+Argumenty:
+- `application` - Nahrazuje hodnotu z `MS_APPLICATION`. Volitelný argument.
+- `tenant` - Nahrazuje hodnotu z `MS_TENANT`. Volitelný argument.
+- `secret` - Nahrazuje hodnotu z `MS_SECRET`. Volitelný argument.
+- `site` - Identifikátor stránky, získání je popsáno v samosatné sekci.
+- `list` - Identifikátor seznamu, získání je popsáno v samosatné sekci.
+- `output` - Cesta k souboru pro uložení obsahu seznamu ve formátu TriG.
+
+Příklad spuštění:
+```bash
+java -jar microsoft-adapter.jar download-list --application {application} --tenant {tenant} --secret {secret} --site {site} --list {list} --output {output}
+```
+
+## Stažení obsahu adresáře ze SharePointu
+
+Argumenty:
+- `application` - Nahrazuje hodnotu z `MS_APPLICATION`. Volitelný argument.
+- `tenant` - Nahrazuje hodnotu z `MS_TENANT`. Volitelný argument.
+- `secret` - Nahrazuje hodnotu z `MS_SECRET`. Volitelný argument.
+- `site` - Identifikátor stránky, získání je popsáno v samosatné sekci.
+- `drive` - Jméno knihovny.
+  Název "Knihovny dokumentů" v Obsahu webu. Doporučená hodnota "Dokumenty".
+- `directory` - Jméno adresáře v knihovně.
+  Název adresáře ve složce "Dokumenty".
+- `output` - Cesta k adresáři kam uložit soubory.
+
+Příklad spuštění:
+```bash
+java -jar microsoft-adapter.jar download-directory --application {application} --tenant {tenant} --secret {secret} --site {site} --drive {drive} --directory {directory} --output {output}
+```
+
+## Získání identifikátoru stránky a seznamu
+K získání některých hodnot je možné použít [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer).
+
+K získání identifikátoru stránky je možné použít náseldující dotaz:
+```
+https://graph.microsoft.com/v1.0/sites?$select=id&search={název stránky}
+```
+
+K ziskání identifikátoru seznamu je možné otevřít nejprve seznam v prohlížeči.
+Dále pak v sekci nastavení, tlačítko kolečka vpravo nahoře, je možné se navigovat na "Nastavení seznamu".
+Identifikátor je pak součástí URL:
+```
+https://...sharepoint.com/sites/.../_layouts/.../listedit.aspx?List=%7B{identifikátor seznamu}%7D
+```